NOTE: This guide is no longer relevant, it was only for mission files made before 2016
---
As requested, here is a full guide to Eden conversion. Every person crazy enough to attempt this is strongly recommended to
read it in its entirety, even if you managed to convert it before. The A3W dev branch has already been converted, so you don't need to follow this guide if you are using it.
- Before importing the old mission.sqm in Eden, first you need to open it in a text editor and do the following:
- For each store NPC, change side="LOGIC"; to side="CIV"; - there should be 2 of those per NPC. But be careful, do NOT change the side of HeadlessClients.
- For the very first player slot (Item0), change player="PLAY CDG"; to player="PLAYER COMMANDER";
- (Optional) If you wish for player spawns to retain their original positions, you will need to do some text replacing with regular expressions. I will explain how to do it in Notepad++ as this is what I use.
- Open up the "Replace" box (Ctrl+H)
- Find what: ^((\s+)player=".+?";)
- Replace with: \1\r\n\2special="NONE";
- Tick "Wrap around"
- Select "Regular expression"
- Here's how it should look like at this point: http://i.imgur.com/rq4Q5k9.png
- Click "Replace All"
- Regarding the above, if you fail to change store NPCs to civilians before the conversion, they will be turned into static objects that are unable to change stance. The only side effect of this is that they will permanently appear to be holding a gun, even if they don't have one, and that cannot be fixed after the conversion without some super-fancy regex magic.
- Now save the file, and import it into Eden
- After importing the mission in Eden, first you want to open the "Save As" dialog, untick "Binarize the Scenario File", then save the mission. This will ensure that the mission.sqm is saved in text format.
- If you have not done the optional step above for player spawns, you should first notice that slots on spawn island are messed up. If you don't care, that's fine, you can leave them as-is. But if you're OCD like me, you will want to fix them. You can either delete all your player slots and copypaste those from the vanilla mission (if you do, don't forget to set first unit as "Player"), or place them manually:
- Enable "Toggle Translation Grid" in the Eden toolbar (icon looks like a Rubik's cube)
- Set the translation grid to like 0.5m via the dropdown arrow on the right of the button
- Place your units however you want, ideally in the same order as they appear on the role selection menu; in vanilla A3W, the leader is a medic, 2nd is a diver or sniper, 3rd is the other medic, and 4th is an engineer. Eden places converted units in an inverted "V" shape by default; the 3rd slot should be on the leader's left, and the 2nd & 4th on the right, so reordering them the correct way is advised.
- I recommend placing groups in a diagonal way, so that the new group icons do not overlap with unit icons, kinda like this: http://i.imgur.com/DplpEov.png
- Now, the buildings; If you look around in the editor, most custom buildings will appear tilted to the slope of the ground even thought they were leveled correctly before (especially on Stratis). There are 2 reasons for this:
- The first one is that the tilt of many buildings is actually adjusted using init commands on mission startup, as it was not possible to tilt them manually in the old editor. In that case, they will look tilted in Eden, but will spawn in leveled on mission startup. If you want, you can go over those buildings individually to adjust them like I did, by right-clicking them and selecting "Transform" > "Orient to Sea Normal", but this is not necessary. Vanilla A3W Stratis has many buildings affected by this, but Altis only has a few.
- The second one is due to an oversight by BIS with the Eden conversion process. Certain buildings and objects are normally supposed to always spawn in leveled without special commands, however BIS ignored this, and thus those buildings are incorrectly ported with ground slope tilt. ATMs and cargo buildings are affected in particular, so you need to go over each one of those manually, by right-clicking them and selecting "Transform" > "Orient to Sea Normal". Otherwise, they will be titled in awkward manner, for instance one of the ATMs on Altis is given a 45° angle by the conversion. There are not that many fixes needed for this in the vanilla mission:
- on both maps you need to go over the 6 custom ATMs
- on Altis you need to go over the cargo patrol posts in the "Dump" town
- on Stratis you need to go over the cargo buildings at LZ Connor (south of Camp Maxwell)
If you followed this process correctly, normally the mission should play like before.
Don't hesitate if you have questions, but please read the full text beforehand.
Also, I have made a Python script for Notepad++ which recalculates all Item numbers and IDs from the start of the SQM file, as to allow reordering of items without a massive headache:
https://gist.github.com/AgentRev/c0ff379c54a9c7ab6c8d - however be advised that I will not help you if you don't already know how to run Python scripts in NP++ beforehand.