Contents creation
Last updated
Last updated
Note: though is recommended to learn the info in the links below, you don't need to read all of them now to follow the content creation steps.
The contents are related between each other, so you need to create them in the following order:
Ways to create the game contents:
Through the available as commands.
Through the generators and imports available in the .
Manually creating each entity in the administration panel.
Directly with queries in the database using any client (not recommended).
For the documentation we will create 2 classes: "Warrior" and "Mage".
You can create as many as you like, but at least 1 is required for the platform to work (even when later you don't show it anywhere in the game).
You need to place these files in the following folder: [your-game-folder]/theme/[your-theme]/assets/custom/sprites/
By doing that, the files will be included in your dist next time you build the game client through the buildClient command.
Here we will use the generators available on the commands to get as much data as possible to later process with the importers.
Then run the command to get the result:
Then copy the generated file and rename it to class-paths.json.
In that file (class-paths.json), we will include our classes paths information.
In the JSON example below we are including different "labels" for the paths at different levels (50 and 100), this will represent our class paths changes (with code you could customize the behavior to make the players change classes through an NPC).
Additionally, in the same file we will include another parameter called "preAppendRace" = true, which will be used by the importer later.
Copy the generated file and rename it to stats.json.
In that file (stats.json), we will include our "stats" basic data for the importer, like this:
Here you can see we are adding custom data on the HP and MP "stats" to make these show their base value in the client. This will make the properties display like HP 23/30 (current value / base value) instead of HP 23 (current value only).
When running the import of this file it will generate the required "stats" and then the variations.
With the generated files (class-paths.json and stats.json) we have enough data to run the imports.
Open a console on your game root folder.
Reminder, for every command replace [your-theme-name] by your game theme name, in the examples is my-game.
Run the two imports in the following order
At this point, by default the class paths generator should have created your classes by all disabled.
Start, your server, go to the admin panel > Classes & Levels > Class Paths > edit each, set the enabled = true, and save.
[Know bug v4.0.0-beta.38.3] - Fix the records directly in the database with a query like the following:
After running the two imports, you should be able to start your server, register a player and reach the class path selection screen:
At this point you could:
The next step will be to change the default config to set your player initial class and map.
In the admin panel go to the configuration section and filter by the following paths:
players/initialState/room_id
players/actions/initialClassPathId
By default, these values are set as "1", but since you created two class paths, and multiple town maps here you need to set the IDs if any of those.
For example, if you like to have a mage as default class path, or if you like to start in town 4 instead of town 1.
With the maps generated you are able to get into your game already!
First thing you will note is: sub-generated maps will be automatically linked (like houses in town which were automatically generated with the town map), but there isn't any link between the town and the forest maps or between each forest.
For the objects creation and import we will use the "Objects Import" tool available in the administration panel under the "Wizards" item in the main menu.
Once you have it, you can upload it or copy/paste it and click on the "Generate" button.
For the skills creation and import we will use the "Skills Import" tool available in the administration panel under the "Wizards" item in the main menu.
Once you have it, you can upload it or copy/paste it and click on the "Generate" button.
Prepare your configuration files for every generator and then go crazy:
Update the files and complete the required data manually to get your "class paths" and "stats" ready for import:
Prepare your objects and skills data files and import those through the administration panel.
Prepare your maps config files and go crazy again on the Maps Wizard in the administration panel.
Each class path will require their own :
Check the documentation for the to create your players experience configuration file: ./generate-data/players-experience-per-level.json.
Or use the .
Your final class-paths.json file should look like this :
Now, use the to create the "stats" with their incremental values per level for each of your classes or use this .
Your final stats.json file should look like this :
To get your game up and running at this point you need a .
The main requirement to create a RoomScene is the , which needs to follow all the name conventions and rules in order to work properly.
Use the app to .
Use in the admin panel which will generate and import the maps for you.
For these contents creation documentation we will use the , so follow the instructions in the link.
To fix that, we need to create change points and return points on each map manually, follow the instructions on .
If you click on the Set Sample Data in "Generator Data" button, you will get a JSON with the data to create two simple enemies, but here you can see a more complete example: .
Follow the to create a JSON for the objects you need.
If you click on the Set Sample Data in "Generator Data" button, you will get a JSON with the data to create two simple enemies, but here you can see a more complete example: .
Follow the to create a JSON for the skills you need.
With all the basic contents created you can .
