|
|
Line 1: |
Line 1: |
| ==XML tutorial for 2009-7 AE release== | | ==XML tutorial for Anniversary Edition== |
| '''What is XML modding?''' | | '''What is XML modding?''' |
| : Binary data becomes converted into more human-readable form which allows easier modding. All supported file types can be seen [[#supported_file_types|HERE]]. | | : Binary data becomes converted into more human-readable form which allows easier modding. All supported file types can be seen [[#supported_file_types|HERE]]. |
Line 17: |
Line 17: |
| : If you need some ideas look at this page: '''[[Modding_brainstorms|modding brainstorms]]'''. | | : If you need some ideas look at this page: '''[[Modding_brainstorms|modding brainstorms]]'''. |
| : If you want to contribute AE: [[AE:Bug-fix_and_feature_requests|bug-fixes and feature requests]]. | | : If you want to contribute AE: [[AE:Bug-fix_and_feature_requests|bug-fixes and feature requests]]. |
| :: Check also [[Anniversary_Edition/Team#Current_To-Do|AE's current To-Do page]] and maybe there are fields that need a modder. | | :: Check also the [[Anniversary_Edition/To-do|AE's current To-Do page]] and maybe there are fields that need a modder. |
|
| |
|
| '''Is there an easy exercise to get me started?''' | | '''Is there an easy exercise to get me started?''' |
Line 116: |
Line 116: |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img6.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img6_TN.png] | | |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img6.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img6_TN.png] |
| |} | | |} |
|
| |
| <!--
| |
| ==XML tutorial for pre-2009-7 AE release==
| |
| '''What is XML modding?'''
| |
| : Binary data becomes converted into more human-readable form which allows easier modding. All supported file types can be seen [[#supported_file_types|HERE]].
| |
|
| |
| '''Okay, what do I need?'''
| |
| : [[OniSplit]] will be your tool. It's part of [[AE]]. Installing AE spares you some work because it splits the level achieves right away and globalize some more data. Global data can be used in any level.
| |
|
| |
| '''AE installed. What now?'''
| |
| : OniSplit cannot be opened in a classic way. But you are lucky. Now we have a GUI (graphical user interface) for it.
| |
| :: Mac user will want to get '''"[http://edt.oni2.net/AETools/AEToolsBeta.zip AETools (Beta)]"'''
| |
| ::: Unpack and put "AETool" and "AETools_Data" into your "edition" folder.
| |
| :: Windows user will want to get '''"[http://oni.bungie.org/community/forum/viewtopic.php?id=692 OniSplit GUI]"'''
| |
| ::: Unpack and put the executables into your "edition" folder.
| |
|
| |
| '''What mod possibilities do I have?'''
| |
| : See [[#supported_file_types|HERE]] again. It's an overview what you could do. But note that some types can be more difficult to mod than other.
| |
| : If you need some ideas look at this page: '''[[Modding_brainstorms|modding brainstorms]]'''.
| |
| : If you want to contribute AE: [[AE:Bug-fix_and_feature_requests|bug-fixes and feature requests]].
| |
| :: Check also [[Anniversary_Edition/Team#Current_To-Do|AE's current To-Do page]] and maybe there are fields that need a modder.
| |
|
| |
| '''Is there an easy exercise to get me started?'''
| |
| : Just see at the following table. Read left side if you use a Macintosh, read right side if you use Windows.
| |
|
| |
|
| |
| {|class="wikitable" width="100%"
| |
| !colspan=4|converting an ONI file into an XML file
| |
| |-
| |
| |valign="top"|Open AETools. Click on "Export" tab, select checkbox "Export as .xml file", then click on "Export .oni file" and choose "ONCCk4_L.oni". See "XMLfiles" in "AETools_Data". There you should find "ONCCk4_L.xml".
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img1.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img1_TN.png]
| |
| |valign="top"|Open the GUI. Choose "ONI - XML" tab. Write "GameDataFolder/level0_Final/ONCCk4_L.oni" into the first line. "extracted" into the other. After clicking on "Convert" you should see a new folder named "extracted".
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img1.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img1_TN.png]
| |
| |-
| |
| !colspan=4|modifing the XML file
| |
| |-
| |
| |valign="top"|Open the extracted file with a simple text editor. Search for "HasSupershield" tag and set its value to "1". Save file.
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img2.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img2_TN.png]
| |
| |valign="top"|Open the extracted file with a simple text editor. Search for "HasSupershield" tag and set its value to "1". Save file.
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img2.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img2_TN.png]
| |
| |-
| |
| !colspan=4|creating, <font color="#999999">debugging,</font> and transporting the file
| |
| |-
| |
| |valign="top"|Let's choose the "Import" tab now. Click on the first drop down menu in case there is not level0_Final already chosen. AETools will create the ONI file in that folder.
| |
|
| |
|
| |
| Now click on "Import source file" button. Navigate to your XML file, select it and click "Choose source" button.
| |
|
| |
|
| |
| <font color="#888888">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.</font>
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img3.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img3_TN.png]
| |
|
| |
|
| |
| [http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img4.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img4_TN.png]
| |
| |valign="top"|Goto GUI's "XML -> ONI" section and write "extracted/ONCCk4_L.xml" into its first line and "created" into its second line. After clicking "Convert" you should see a new folder named "created".
| |
|
| |
|
| |
| <font color="#888888">Try [[#way_without_Windows_GUI:_local_called_CMD|THIS]] method if no oni file was created. Use then "onisplit -create created extracted/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.</font>
| |
|
| |
|
| |
| Copy the file from "created" folder and insert it into the "level0_Final" folder which is located in the "GameDataFolder". Confirm the replacement.
| |
|
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img3.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img3_TN.png]
| |
|
| |
|
| |
| [http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img4.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img4_TN.png]
| |
| |-
| |
| !colspan=4|recombining the level archive
| |
| |-
| |
| |valign="top"|Click on "Select Level to rebuild" and then "LEVEL 0: GLOBAL DATA".
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img5.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_mac_img5_TN.png]
| |
| |valign="top"|Let's choose the GUI's first tab now, "Compile". Write "GameDataFolder/level0_Final" into the first line, "level0_Final" into the second and "GameDataFolder" into the third line. Click now on "Compile" and wait until onisplit's black window disappears again.
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img5.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img5_TN.png]
| |
| |-
| |
| !colspan=4|testing the modification
| |
| |-
| |
| |valign="top"|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.
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img6.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img6_TN.png]
| |
| |valign="top"|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.
| |
| |[http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img6.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/XML_tutorial_img6_TN.png]
| |
| |}
| |
| -->
| |
|
| |
|
| ==supported file types== | | ==supported file types== |