🚧 Basic Migration Guide

Author: SnaveSutit

TODO.md

@@ -1,46 +1,59 @@
+# General
+
+- [ ] Replicate API _legacy_ routes statically for backwards compatability.
+
+# Docs
+
+- [ ] Migration guide for 0.4.8 to 1.0.0
 
 # Docs Structure
+
 - Introduction
-	- What is Animated Java?
+
+  - What is Animated Java?
 
 - Getting Started
-    - Installing Animated Java
-    - Creating a new Blueprint
-    - Exporting your Blueprint
-    - Summoning a Rig in Minecraft
-    - Troubleshooting
+
+  - Installing Animated Java
+  - Creating a new Blueprint
+  - Exporting your Blueprint
+  - Summoning a Rig in Minecraft
+  - Troubleshooting
 
 - FAQ
-	- What model limitations does Animated Java have?
-	- Are there any performance concerns with Animated Java? / What can I do to improve performance?
-	- Can I use vanilla item / block models?
-	- Can I have multiple exported rigs in a single Data Pack / Resource Pack?
-	- Can I play multiple animations at the same time?
-	- Can I use custom fonts in Text Displays?
-	- Can I smoothly transition between animations?
+
+  - What model limitations does Animated Java have?
+  - Are there any performance concerns with Animated Java? / What can I do to improve performance?
+  - Can I use vanilla item / block models?
+  - Can I have multiple exported rigs in a single Data Pack / Resource Pack?
+  - Can I play multiple animations at the same time?
+  - Can I use custom fonts in Text Displays?
+  - Can I smoothly transition between animations?
 
 - The Blueprint Format
-	- Overview
-	- Settings
-	- Variants
-	- Bones / Groups
-	- Animations
-	- Locators
-	- Vanilla Item Displays
-	- Vanilla Block Displays
-	- Text Displays
-	- Cameras
+
+  - Overview
+  - Settings
+  - Variants
+  - Bones / Groups
+  - Animations
+  - Locators
+  - Vanilla Item Displays
+  - Vanilla Block Displays
+  - Text Displays
+  - Cameras
 
 - Exported Rigs
-	- Overview
-	- Summoning a new Rig Instance
-	- Controlling a Rig Instance
-	- Entity Structure
-	- Data Pack Structure
-	- Resource Pack Structure
+
+  - Overview
+  - Summoning a new Rig Instance
+  - Controlling a Rig Instance
+  - Entity Structure
+  - Data Pack Structure
+  - Resource Pack Structure
 
 - Legacy Versions
-	- Index
-	- Using Legacy Versions
-	- v0.4.8 (1.19.4 - 1.20.6)
-	- v0.2.4 (1.16.4 - 1.19.3)
+  - Index
+  - Using Legacy Versions
+  - v0.4.8 (1.19.4 - 1.20.6)
+  - v0.2.4 (1.16.4 - 1.19.3)

src/routes/docs/[...5]resources/[...2]migrating-from-older-versions/+page.md

@@ -0,0 +1,32 @@
+---
+title: Migrating from Older Versions
+description: Learn how to migrate your Projects from older versions of Animated Java to the latest version.
+---
+
+# {$frontmatter.title}
+
+{$frontmatter.description}
+
+## Upgrading `.ajmodel` Files
+
+On the Blockbench start screen, you can scroll down to find the `Update .ajmodel` option.
+
+![Update .ajmodel](/img/steps/migrate/1.png)
+
+Clicking this will open a file dialog, allowing you to select the `.ajmodel` file you wish to update.
+
+## Cleaning up Outdated Exports
+
+Any old exported files from previous versions of Animated Java should be removed from both your Data Pack and Resource Pack _before_ exporting a `.ajblueprint`.
+
+### Files / Folders to Remove
+
+- `<data_pack_root>/data/animated_java/`
+- `<data_pack_root>/datapack.ajmeta`
+- `<resource_pack_root>/assets/animated_java/`
+- `<resource_pack_root>/resourcepack.ajmeta`
+
+You will also need to remove the Animated Java function references from the `minecraft:tick` and `minecraft:load` tags in your Data Pack.
+
+- `<data_pack_root>/data/minecraft/tags/functions/tick.json`
+- `<data_pack_root>/data/minecraft/tags/functions/load.json`