Difference between revisions of "Legends Of Aria Toolkit"

From Legends of Aria Admin and Modding Wiki
Jump to: navigation, search
Line 9: Line 9:
  
 
=== Upgrading Versions ===  
 
=== 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. Consult the toolkit change log for any importance notices that might affect upgrading.
+
* 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. Consult the toolkit change log for any importance notices that might affect upgrading.
 +
 
 +
==== Slow/Safer Method ====
 
* 1. Upgrade or install another Unity to the proper version.  
 
* 1. Upgrade or install another Unity to the proper version.  
 
* 2. Backup your project.  
 
* 2. Backup your project.  
Line 21: Line 23:
 
* 10. Restart Unity / Reload your project.
 
* 10. Restart Unity / Reload your project.
 
* 11. 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.
 
* 11. 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.
 +
 +
==== Faster / Risky ====
 +
* 1. Upgrade or install another Unity to the proper version.
 +
* 2. Backup your project.
 +
* 3. Import the new toolkit bundle as from step 3 of Installation of a fresh project.
 +
* 4. Hopefully everything works, but it may not.
  
 
=== ChangeLog ===
 
=== ChangeLog ===

Revision as of 21:20, 22 February 2019

Installation / Fresh Project

  • 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 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. Consult the toolkit change log for any importance notices that might affect upgrading.

Slow/Safer Method

  • 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. (Make sure you don't have any project specific files stored in here)
  • 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. From your backup copy over the following files from Assets\Legends of Aria Toolkit\Scripts\Editor\Toolkit\ (ToolsData.asset, ToolkitSettings.asset, WorldStreamManageData.asset ) into the freshly installed Assets\Legends of Aria Toolkit\Scripts\Editor\Toolkit\ folder.
  • 10. Restart Unity / Reload your project.
  • 11. 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.

Faster / Risky

  • 1. Upgrade or install another Unity to the proper version.
  • 2. Backup your project.
  • 3. Import the new toolkit bundle as from step 3 of Installation of a fresh project.
  • 4. Hopefully everything works, but it may not.

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.