source: s10k/XmlTools/README.txt @ 1113

Last change on this file since 1113 was 1113, checked in by s10k, 13 months ago

Updated readme for 2.0f

File size: 4.6 KB
Line 
1Readme.txt
2~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3XmlTools v2.0f
4~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
5
6----------------------------------
7Description:
8----------------------------------
9
10XmlTools is a command-line modding tool that operates on XML files.
11
12It supports many operations in XML files and even non implemented operations using custom javascript code.
13
14It is developed in C++ and works in both Mac OS and Windows.
15
16An additional guide with examples can be read here: http://wiki.oni2.net/XmlTools
17
18----------------------------------
19Full 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----------------------------------
43Installation (standalone version):
44----------------------------------
45
46Extract XmlTools folder to any place in your computer. Open it with command line on windows or terminal in Mac OS.
47
48----------------------------------
49Contacts:
50----------------------------------
51
52s10k, "faob2@hotmail.com"
53
54Oni Central Forum:
55http://oni.bungie.org
56->Select forum
57
58Oni Wiki:
59http://wiki.oni2.net
60
61----------------------------------
62Change Log:
63----------------------------------
642.0f, 08-09-2019
65-Fixed a deadlock in custom js code
66----------------------------------
672.0e, 16-02-2019
68-Fixed bug in the processing of patch files when the target XML contained an apostrophe (') in the path
69----------------------------------
702.0d, 05-10-2017
71-Fixed bug in the processing of javascript files for XML custom processing (some files were not being processed)
72-Some code refactoring to make the code more modular and easier to build (now uses s10k's "shared" libraries for
73qtcreator projects)
74----------------------------------
752.0c, 30-10-2016
76-Fixed bug in --update-elements operation
77-Added some exception handling
78-Started migrating some of the source code to C++14
79-Upgraded pugixml to latest 1.7 version
80-Dropped openmp since apple clang doesn't support it, using Qt threads mechanisms now
81----------------------------------
822.0b, 13-06-2014
83-Minor code fixes (use of singleton pattern)
84-Fixed segmentation fault when providing a non-existing element name in patch files operations
85----------------------------------
862.0a, 02-03-2014
87-Added multithreading support for @CUSTOM_CODE (performance may increase over 3 times in a quadcore)
88-Now a warning is given if a user javascript code (@CUSTOM_CODE) takes too much time to finish
89-Fixed small bug when applying patches with @COMMAND + --no-verbose where some std output should not be displayed
90-Added double single quotes in @COMMAND to allow single quotes in XPath expressions
91----------------------------------
922.0, 08-02-2014
93-Rewrite XmlTools fom the scratch from C# to C++ in order to increase (much!) the performance of the program
94-The program now uses the following libraries: Qt5, pugixml and jsxml js library
95-The commands were simplified (they now use unix like syntax)
96-Update node operation (old updatechainvalues) it now receives the DIFFERENCE between the old value
97and the new value instead of the new value
98-Update node operation (old updatechainvalues) relation parameter was removed
99-The program now only edits files with .xml extension
100-The program now only reads patches files with .patch or .oni-patch extensions
101-The patch files now have a XmlTools minimum version
102-Some patch files operations were renamed and some extra arguments added
103-Added option to select xml elements by attribute name and value
104-Added option to select xml elements by XPath 1.0 (should reduce further the need of javascript)
105-The insertion of xml via patch now support multiple nodes inside <xml></xml> tags
106-Added exclusive option for AEI which allows AEI to pass a list of .oni-patches to process
Note: See TracBrowser for help on using the repository browser.