Stop! Intersect upgrades must be done in order! You cannot skip from Alpha 1.X or Beta 1 to Beta 5. Make sure you are using Intersect Beta 4.9 or 4.9.1 before following the instructions in this guide.

Intersect Beta 4.9.X Upgrade Instructions

Step 1: Make a backup of your game!

Nothing will go wrong but it's better to have a backup just in case. Copy your Intersect Beta 4 folder and paste it somewhere else for safe keeping.

MakeABackup


Step 2: Download Intersect Beta 5

Download Intersect Beta 5 here. Save it somewhere on your machine.


Step 3: Extract the Intersect Beta 5 archive

Extract the Intersect Beta 5 files on top of your current Intersect Beta 4.9.X installation. Replace/overwrite any files that already exist. OverwriteBeta4


Step 4: Run the Migration Tool

Fair Warning! The migration from B4 to B5 is extensive, and has only been tested on a few games thus far! Please be on the lookout and report migration errors if you find any!
.Net Upgrade Required! You might need to download .Net Framework 4.6.1+ for this version of Intersect to run. If you have trouble launching the migration tool try updating your .Net Framework (or Mono if you're on Mac/Linux)

The migration tool is located in your server folder. Hit y to begin and follow the prompts on screen. We recommend sticking with sqlite databases for everything, so you can just hit 1 and then 1 again. Wait for the migration to complete, it could take a few minutes.

Migrate


Step 5: Download new Beta 5 UI Config

Click here to download the new Client UI configuration files for Intersect Beta 5.


Step 6: Extract the new Intersect B5 UI Config

Extract the Intersect Beta 5 UI files on top of your current installation. Replace/overwrite any files that already exist.

OverwriteUI


Step 7: Delete your editor Map Cache

Delete Client and Editor/resources/mapcache.db - this is super important, else your editor will not work at all!


Step 8: (Important) Make sure everything starts!

Delete Client and Editor/resources/mapcache.db - this is super important, else your editor will not work at all!

We're not done yet! But run the Client, Editor, and Server to make sure they will all launch. Upon launching they will generate a few new files that we need to configure. If you're client UI is messed up then repeat steps 5 & 6 above. Once the Client, Editor, and Server all start close them, and complete the last few steps below.


Step 9: Fix your client & editor config!

Intersect no longer uses xml files for its config. We need to fix our client and editor config files.

Open both of the following files: Client and Editor/Resources/config.xml Client and Editor/Resources/config.json

Change the Host and Port values in the config.json file to match the Host and Port values from the old config.xml file.

After this step you can delete the old config.xml file.


Step 10: Fix your server formulas/colors config!

Intersect no longer uses xml files for its colors and formula files.

If you have never modified the formulas or colors.xml files then you can ignore this step.

Much like Step 8 above, you will need to migrate any changes you made to the Server/Resources/formulas.xml to the new Server/Resources/formulas.json file manually.

You will also need to manually migrate any changes you made to Server/Resources/colors.xml to the new Server/Resources/colors.json file as well.

After this step the colors.xml and formulas.xml files are no longer required and can be deleted.


Delete the following files or folders if they exist, they are no longer used and your project will be a lot cleaner without them:

  • Client and Editor/Logs/

  • Client and Editor/Resources/Logs/

  • Client and Editor/Resources/Gui/InGame.xml

  • Client and Editor/Resources/Gui/MainMenu.xml

  • Client and Editor/Resources/Languages/

  • Server/Logs

  • Server/Resources/Logs/

  • Server/Resources/config.xml

  • Server/Resources/colors.xml

  • Server/Resources/formulas.xml

  • Server/Resources/Backups/

  • Server/Resources/Languages/

Old Databases:

  • Server/Resources/intersect.db (Old B4 database, don't delete if you don't have a backup)
  • Server/Resources/intersect_vXX_date.db (All files like this are old databases before past migrations, they are not needed anymore if you'd like to delete them)

Step 12: You're done!

Startup your server, and then your client and editor and make sure you can still edit and play your game! If you have any problems please make Q/A threads at AGD!

Have fun creating your MMO!