XML:Basic tutorial

Click to return to the main XML page.

This page contains information that is out of date. Please update this information to reflect where the community is at today.

This a step-by-step guide taking an ONCC modification as example.

It will give you an impression of the tools and workflow. Let's roll!

Windows

Open AEInstaller, then Vago

Open AEI, goto "Tools" > "Vago GUI (Win)". (Install Vago via Tools manager if necessary.)

When Vago is used for first time it ask you the AE path

Get Konoko's character file (ONCC) by spliting level0_Final.dat

In Vago goto "Levels" tab.

Drag and drop level0_Final.dat from AE\AEInstaller\vanilla into the "Sources" field. Click "Convert".

At the top, click onto the blue folder icon. Follow that path "Levels\DAT - ONI FILES\level0_Final".

Convert oni to xml

In level0_Final folder there are a lot of files. You want to convert ONCCk4_L.oni to xml format.

Goto Vago "XML" tab and drag and drop "ONCCk4_L.oni" into the "Sources" field. Click convert.

Edit xml

Click blue folder again and follow "XML\ONI - XML", there should be a "ONCCk4_L.xml" now.

Open that file with a plain text editor. (Windows: Start > notepad.exe)

Search for <HasSupershield> and set its value from 0 to 1.

Save file.

Convert the xml back to oni format

Vago, "XML" tab. Choose From "XML" To "Oni"

DnD your xml file into the "Sources" field. Convert.

Click blue folder again and follow "XML\ONI - XML".

Create a new folder "level0_Final" and put your ONCC*.oni file there.

For more information on Supershield see XML:ONCC page

Get the file back into the game

Vago supports AE package creation: in Vago, goto "Tools", "AEI Mod Package Wizard"

Fill all fields. Let Type be "Character". When choosing a number, replace the X and click "Check".

DnD your level0_Final folder into the "Common" field. Hit "Next". Leave the optional fields blank.

Test your mod

Copy your package into "Oni\AE\AEInstaller\packages"

Restart AEI and install your mod. (Type your mod's name into the Filter to find it faster.)

Start TCTF HQ redux (pre-last level).

The supershield becomes automatically switched on at 51% overpower (301 health points). "chenille" cheat works too.

Mac

[...]

remove pc, update mac section if needed

Mac:		PC:
converting an ONI file into an XML file
Open Edition's AETools_Data folder and create a new folder named "ONIfiles". Run AETools, choose "Extract" tab. Click on checkbox "Expract as .xml file". Then click on "Extract .oni file(s)" and choose "ONCCk4_L.oni". See "XMLfiles" in "AETools_Data". There you should find "ONCCk4_L.xml".		Open Edition's GameDataFolder and create two new folders named "XML" and "ONI". Run the GUI, choose "ONI - XML" tab and its upper section. Click first browse button and search for "ONCCk4_L.oni" inside the level0_Characters folder. Click second browse button and choose the XML folder as target. Now click on Convert button.
modifing the XML file
Open the extracted file with a simple text editor. Search for "HasSupershield" tag and set its value to "1". Save file.		Open the extracted file with a simple text editor. Search for "HasSupershield" tag and set its value to "1". Save file.
creating the ONI file
Choose "Convert" tab. Now click onto "Select File(s) for Conversion" button and mark "ONCCk4_L.xml". Click "Choose" button. Then click "Select Destination Folder". Search for your ONIfiles folder, mark it, and click "Choose button." Made a mistake when modified the XML file? The terminal window would appear now and telling you the trouble making line. Find the line in you XML file and fix it. Line number isn't always accurate. (It can shift - often by 1.) Then try again creating the file.		Goto "XML -> ONI" section. Click first browse button and search for "ONCCk4_L.xml" inside the XML folder. Click second browse button and choose the ONI folder as target. Now click on Convert button. Try THIS method if no oni file was created. Use then "onisplit -create ONI XML/ONCCk4_L.xml" and look for error messages. Find the line in you XML file and fix it. Line number isn't always accurate. (It can shift - often by 1). Then try again creating the file.
creating and installing a mod package
Choose "Package" tab. The GUI is actually pretty much self-explaining. Fill the editboxes with following: 90000 Test [Test] 1 That's a package to test new mods. YourNameHere Then click "Create package" button and search for your ONIfiles folder. Mark it and click "Choose" button. AEInstaller should automatically open now, select your test package. Hit "Install!" button.		Click on GUI's "AE Package" tab. The GUI is actually pretty much self-explaining. Fill the editboxes with following: 90000 Test [Test] 1 That's a package to test new mods. YourNameHere Browse Edition's GameDataFolder and choose the ONI folder as source folder. Browse Edition's install folder and choose the package folder as target. Open AEInstaller and select your test package. Hit "Install!" button.
testing the modification
Let's test our modification. Therefore we start TCTF HQ redux (pre-last level). The supershield becomes automatically switched on at 51% overpower (301 health points). "chenille" cheat works too.		Let's test our modification. Therefore we start TCTF HQ redux (pre-last level). The supershield becomes automatically switched on at 51% overpower (301 health points). "chenille" cheat works too.