| 1 |
Readme.txt |
| 2 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 3 |
XmlTools v2.0e |
| 4 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 5 |
|
| 6 |
---------------------------------- |
| 7 |
Description: |
| 8 |
---------------------------------- |
| 9 |
|
| 10 |
XmlTools is a command-line modding tool that operates on XML files. |
| 11 |
|
| 12 |
It supports many operations in XML files and even non implemented operations using custom javascript code. |
| 13 |
|
| 14 |
It is developed in C++ and works in both Mac OS and Windows. |
| 15 |
|
| 16 |
An additional guide with examples can be read here: http://wiki.oni2.net/XmlTools |
| 17 |
|
| 18 |
---------------------------------- |
| 19 |
Full Features: |
| 20 |
---------------------------------- |
| 21 |
|
| 22 |
-Update all values in a set of XML elements. (e.g., to reposition an OBAN animation or adjust pelvis height for a TRAM). |
| 23 |
|
| 24 |
-Inverts a set of XML elements. (e.g., invert an OBAN animation). |
| 25 |
|
| 26 |
-Add new values to a set of XML elements (e.g., add the 'unkillable' flag to some characters in a level). |
| 27 |
|
| 28 |
-Remove values from a set of XML elements (e.g., remove boss shields from characters in a level). |
| 29 |
|
| 30 |
-Replace values in a set XML elements (e.g., increase the health of characters by replacing the old HP value). |
| 31 |
|
| 32 |
-Patch file support allows the modder to list multiple commands in a file, to all be performed at once. |
| 33 |
|
| 34 |
-Add custom XML to existing files (patch only). |
| 35 |
|
| 36 |
-Remove XML from existing files (patch only). |
| 37 |
|
| 38 |
-Select elements using element name, parent element name, attribute name/value and XPath 1.0. |
| 39 |
|
| 40 |
-Powerful custom XML editing using javascript (for what you can't do with native operations) (patch only). |
| 41 |
|
| 42 |
---------------------------------- |
| 43 |
Installation (standalone version): |
| 44 |
---------------------------------- |
| 45 |
|
| 46 |
Extract XmlTools folder to any place in your computer. Open it with command line on windows or terminal in Mac OS. |
| 47 |
|
| 48 |
---------------------------------- |
| 49 |
Contacts: |
| 50 |
---------------------------------- |
| 51 |
|
| 52 |
s10k, "faob2@hotmail.com" |
| 53 |
|
| 54 |
Oni Central Forum: |
| 55 |
http://oni.bungie.org |
| 56 |
->Select forum |
| 57 |
|
| 58 |
Oni Wiki: |
| 59 |
http://wiki.oni2.net |
| 60 |
|
| 61 |
---------------------------------- |
| 62 |
Change Log: |
| 63 |
---------------------------------- |
| 64 |
2.0e, 16-02-2019 |
| 65 |
-Fixed bug in the processing of patch files when the target XML contained an apostrophe (') in the path |
| 66 |
---------------------------------- |
| 67 |
2.0d, 05-10-2017 |
| 68 |
-Fixed bug in the processing of javascript files for XML custom processing (some files were not being processed) |
| 69 |
-Some code refactoring to make the code more modular and easier to build (now uses s10k's "shared" libraries for |
| 70 |
qtcreator projects) |
| 71 |
---------------------------------- |
| 72 |
2.0c, 30-10-2016 |
| 73 |
-Fixed bug in --update-elements operation |
| 74 |
-Added some exception handling |
| 75 |
-Started migrating some of the source code to C++14 |
| 76 |
-Upgraded pugixml to latest 1.7 version |
| 77 |
-Dropped openmp since apple clang doesn't support it, using Qt threads mechanisms now |
| 78 |
---------------------------------- |
| 79 |
2.0b, 13-06-2014 |
| 80 |
-Minor code fixes (use of singleton pattern) |
| 81 |
-Fixed segmentation fault when providing a non-existing element name in patch files operations |
| 82 |
---------------------------------- |
| 83 |
2.0a, 02-03-2014 |
| 84 |
-Added multithreading support for @CUSTOM_CODE (performance may increase over 3 times in a quadcore) |
| 85 |
-Now a warning is given if a user javascript code (@CUSTOM_CODE) takes too much time to finish |
| 86 |
-Fixed small bug when applying patches with @COMMAND + --no-verbose where some std output should not be displayed |
| 87 |
-Added double single quotes in @COMMAND to allow single quotes in XPath expressions |
| 88 |
---------------------------------- |
| 89 |
2.0, 08-02-2014 |
| 90 |
-Rewrite XmlTools fom the scratch from C# to C++ in order to increase (much!) the performance of the program |
| 91 |
-The program now uses the following libraries: Qt5, pugixml and jsxml js library |
| 92 |
-The commands were simplified (they now use unix like syntax) |
| 93 |
-Update node operation (old updatechainvalues) it now receives the DIFFERENCE between the old value |
| 94 |
and the new value instead of the new value |
| 95 |
-Update node operation (old updatechainvalues) relation parameter was removed |
| 96 |
-The program now only edits files with .xml extension |
| 97 |
-The program now only reads patches files with .patch or .oni-patch extensions |
| 98 |
-The patch files now have a XmlTools minimum version |
| 99 |
-Some patch files operations were renamed and some extra arguments added |
| 100 |
-Added option to select xml elements by attribute name and value |
| 101 |
-Added option to select xml elements by XPath 1.0 (should reduce further the need of javascript) |
| 102 |
-The insertion of xml via patch now support multiple nodes inside <xml></xml> tags |
| 103 |
-Added exclusive option for AEI which allows AEI to pass a list of .oni-patches to process |
