Difference between revisions of "Legends Of Aria Toolkit"

Revision as of 19:17, 22 February 2019

1. Create a new Unity project. Consult the Toolkit ChangeLog to see which version of Unity is supported with the given version of the toolkit.
2. From the Unity Asset Store search for Standard Assets and import the Unity provided Standard Assets.
3. From the Unity menu select Assets -> Import Packages -> Custom Package, select the Legends of Aria Toolkit that has been downloaded and import it completely.
4. Optionally from the Unity Asset Store search for Post Processing, and import the Unity provided Post Processing Stack.
- Note: With Unity 2018.3 and higher the Post Processing Stack asset has some errors which need manually corrected, as the asset is out of date.
- In the file MinDrawer.cs change all references of MinAttribute to UnityEngine.PostProcessing.MinAttribute to resolve the namespace conflict.
5. At this time you should now have a LoA Toolkit Menu bar item present, and you should also be able to open and run the ShardsToolkit scene without issue.

Upgrading to a new version of the toolkit can be an easy or difficult process. This is in part as it means also upgrading to a new Unity version which often can cause problems. Below is a slower but safer route for upgrades. Consult the toolkit change log for any importance notices that might affect upgrading.
1. Upgrade or install another Unity to the proper version.
2. Backup your project.
3. Delete the Legends of Aria Toolkit folder from your project's Assets directory.
4. Delete the Library folder from your project's root directory. (This will force Unity to do a full re-import)
5. Open your project in the upgraded or new Unity version.
6. Import the new toolkit bundle as from step 3 of Installation of a fresh project.
7. Hopefully at this point you will have a LoA Toolkit menu item again.
8. From LoA Toolkit Menu execute Utils -> Generate LOA Required Tags and Layers
9. Restart Unity / Reload your project.
10. Ideally at this point everything will be working. You may have issues with 3rd party assets/etc that also need updates for the newer Unity version.

Major release, uses Unity version 2018.3.4f1
- Updates the toolkit to work with Legends of Aria client versions 0.8.5.
- Updates to latest world objects, and base game maps, including expanded dungeons.
- Resolves locale issues that could result in xml data being saved out that the ShardServer can not load correctly.
- Updates the default dungeon camera to have correct culling layers.

@@ Line 9: / Line 9: @@
 === Upgrading Versions ===
-* Upgrading to a new version of the toolkit can be an easy or difficult process. This is in part as it means also upgrading to a new Unity version which often can cause problems. Below is a slower but safer route for upgrades.
+* Upgrading to a new version of the toolkit can be an easy or difficult process. This is in part as it means also upgrading to a new Unity version which often can cause problems. Below is a slower but safer route for upgrades. Consult the toolkit change log for any importance notices that might affect upgrading.
 * 1. Upgrade or install another Unity to the proper version.
 * 2. Backup your project.
 * 3. Delete the Legends of Aria Toolkit folder from your project's Assets directory.
@@ Line 20: / Line 20: @@
 * 9. Restart Unity / Reload your project.
 * 10. Ideally at this point everything will be working. You may have issues with 3rd party assets/etc that also need updates for the newer Unity version.
-=== Troubleshooting ===
 === ChangeLog ===
+==== 0.8.5 ====
+* Major release, uses Unity version 2018.3.4f1
+** Updates the toolkit to work with Legends of Aria client versions 0.8.5.
+** Updates to latest world objects, and base game maps, including expanded dungeons.
+** Resolves locale issues that could result in xml data being saved out that the ShardServer can not load correctly.
+** Updates the default dungeon camera to have correct culling layers.