This application provides you a streamlined way to create and store Templates
for your games/apps.
If you go to the latest github release you should see an option to download the editor-app
there, which will be a zip file containing the application.
Run the OpenRpg.Editor.exe
which will ask you to Create/Load a project, for now you wont have a project but just go ahead and make a folder where you want to store your project data and it will automatically create a few things:
project.json
- Contains configuration data/assets
- Optional folder for providing visual assets (i.e sword icon shown in screenshot)/templates
- Folder for storing templatejson
files/locales
- Folder for storing locale strings related to templates
You can then use the editor to create/edit templates and locale information, then you can save all the changes using the Save
button at the top.
The choice for this was more for ease of use within teams and source control systems.
To expand on this imagine you have a project in git and two people both adding content to the editor project in their own branches. The first editor pushes up, and the second editor now has to merge those changes in.
When the templates are all in their own files in raw json
it is quite easy for the 2nd person to see what has changed and merge the changes in, however if we were using a database (i.e sqllite, litedb) you would not be able to easily handle these merge scenarios, and everyone would cry real tears.
It is planned to add support for exporting project data as a self-contained database at some point.
When you create your project you have a project.json
which contains project data i.e where directories are etc, feel free to change these as needed.
The folders created by default are for:
templates
- all your template data is stored here in ajson
file per template typeassets/*
- any assets you want to show up in the editor, i.e if you have an item with anasset-code
it will look in/assets/items/{asset-code}.png
and show it in the editor.locales
- any locale data with a file per locale, i.een-gb.json
,fr.json
This functionality may get added but due to use using potentially large data sets which are changing frequently it would put a lot of strain on your computer if we saved every change you made, so instead it's left to you to decide when you want to save your changes.
This may be updated in the future to auto save every
n
minutes or something
You fork it and make your own changes, but going forward we will try to look into supporting a plugin based mechanism to let you write plugins that can just be included, as well as configure what genres should be used, as right now it only uses the Fantasy
genre out the box.