Modding Guide

Necessary Tools

For the time being, modding is only feasible on Windows machines.

1. Unity 3D editor: Download Unity3D Installer version 2018.1.9 (at least version 5.6). You will need to create an account.
2. Lua editor: Download Sublime Text or any other editor with syntax highlighting, e.g. Notepad++.
3. The latest Legends of Aria Toolkit.

Creating a new project, based or not on the Celador map

Cf. this video introducing the setup NOTE: You must have first installed a LoA server before to proceed with the direction below.

1. In Windows Explorer. Create a new folder under the <server>\mods folder, with the name of your new mod (whether you are going to mod the Celador map or that you are going to create a new mod)
2. Launch Unity3D
3. Create a "New" "3D" project, assigning it with a name, preferably in a folder of your choice. No Unity Analytics is needed.
4. Import assets: in "Assets" menu, "Import Package" and import both "Effects" and "Environment" (Press "Import" for each new window opening).
5. From the Assets store (in "Window" menu, select "Asset Store"), search for the "Post Processing Stack" package ("Unity Essentials" from "Unity Technologies").
6. in "Assets" menu, "Import Package", import "Custom Package" and select the Legends of Aria Toolkit you previously downloaded. Click "Import" on the new widow, this will take several minutes.
7. You should now have a new "LoA Toolkit" menu item in Unity3D.
8. Under that new menu item, select "Settings". Let's say you installed the LoA server on path <server>.
9. "Browse" the "Base Path" to reflect the path: <server>\Build\base
10. "Browse" the "mods Path" to reflect the path: <server>\mods
11. Select the consistent module name you create in step 1 in the "Mod" pull-down list (You might have to "save" first and reopen the Settings). Then "Save".

Modding the Celador maps

1. When the toolkit is loaded, look in the "Project" widget, select the "Legends of Aria Toolkit" folder and double-click on the "ShardsToolkit.unity" Unity asset (It's a scene map loader helper).
2. Select the "Game" above the viewer window and press the "Play" button on the top right of that same window.
3. You can select any scene map to be loaded by pressing its button. For "New Celador", there is an exception: The map is split into sub-scene because it is very big.
4. Open "LoA Toolkit" then "Utils" then "World Streamer Manager" and you can select a "Preset" selection of scene respective to the area you are looking to edit. You can alternatively load individual scenes by clicking on them.
5. Switch to the "Scene" view by pressing the "#Scene" button above the Unity viewer (from the "Game" view you currently are on).

Saving your mod

Make sure you have save your Unity project, built your map data (if applies, cf. above), and saved all your seed objects (see below).

To make sure your server loads your modifications, make sure you consistently edit the "<Mod>" section of the ClusterConfig.xml file, i.e. put your mod name there. If you have created a new map, make sure you add a "<ClientBundle>" subsection in that section and add or edit the consistent "<Region>".

Also, make sure you clean up all your server backups before to reload it (careful of what you delete as well, like characters' data, if you're in production).

Seed Objects

Seed objects are dynamic object that spawns when the server resets or when loaded the first time. They can be grouped, under "categories", so they can be loaded, saved and edited all at once or separately. Celador base map's Seed Objects are grouped by zone and types.

To access Seed Objects functionality, go to "LoA Toolkit", "Dynamic Editors" then "Seed Object Editor".

Loading

If you are editing from the Celador base map, select the "Default" "Mod", otherwise load your module's specific group (if not already loaded). You can select in the "Seed Object Editor" to "Load All Seed Objects" or the specific "Group" that you want to load to edit.

Creating

It is advised to create groups/categories to have a finer detail of finding, editing and saving/loading of seed objects. In order to do this, click on "Create New Category" on the "Seed Object Editor" window. You can rename each category or seed object from Unity's "Hierarchy" widget. Then you can "Create New Seed Object" from the "Seed Object Editor" window. You will want to drag that "New Seed" object within the consistent category (that you created above) in Unity's "Hierarchy" widget, and rename it. Then select that seed in the "Hierarchy" widget and you will see Unity's "Inspector" widget updating, as well as the bottom of the "Seed Object Editor" window, showing "Seed Object Selected". You can "Select" a template to be used for that seed (You might have to re-select "Default" for "Mod" to get all the templates if you had changed it before).

Make sure you save your seed objects when done.

Saving

If you have modified any group of seed object or single object from the "Default" Celador map, make sure you select your "Mod" in the "Seed Object Editor" before saving. Ditto if you want to override any "Default" group, you can also create a group of the same name of a "Default" Celador group to override. You can choose to "Save All Seed Objects" or select individual groups/categories to be saved. Make sure you Save the seeds as often as possible not to loose your work (since it's independent from Unity's scene/project saving).