XML:Basic tutorial

From OniGalore
Revision as of 08:58, 3 May 2015 by Paradox-01 (talk | contribs) (updated Windows section)
Jump to navigation Jump to search
Click to return to the main XML page.


Aged parchment-60px.jpg

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 TRAM*.oni to xml format.
Goto Vago "XML" tab and drag and drop for instance "ONCCk4_L.oni.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.
File:HasSuperShield 1.png
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 healh 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".

XML_tutorial_mac_1C_TN.png 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.

XML_tutorial_1C_TN.png
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. XML_tutorial_mac_2C_TN.png Open the extracted file with a simple text editor. Search for "HasSupershield" tag and set its value to "1". Save file. XML_tutorial_2B_TN.png
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.

XML_tutorial_mac_3C_TN.png

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.

XML_tutorial_3C_TN.png

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.

XML_tutorial_mac_4C_TN.png



XML_tutorial_mac_5C_TN.png

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.

XML_tutorial_4C_TN.png


XML_tutorial_6B_TN.png

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 healh points). "chenille" cheat works too. XML_tutorial_img6_TN.png Let's test our modification. Therefore we start TCTF HQ redux (pre-last level).
The supershield becomes automatically switched on at 51% overpower (301 healh points). "chenille" cheat works too.
XML_tutorial_img6_TN.png