API tools faq
paste
Advertisement
shirkit

Output

shirkit
Jul 18th, 2011
135
0
Never
Add comment
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 10.93 KB | None | 0 0
raw download clone embed print report
  1. <span style='font-size:4;'><strong><span style='text-decoration:underline;'>[ANCHOR="The .honmod format"]9. The .honmod Format[/ANCHOR]</span></strong></span><br>
  2. <br>
  3. [SPOILER]Just like an ".s2z" a ".honmod" is a renamed ZIP. It contains the following files:<br>
  4. <ul><br>
  5. <li><span style='color:Red;'>[FONT=Courier New]mod.xml[/FONT]</span>: A valid XML file with describing "how the mod is applied", that is where to add/edit/delete code from the original files. There is a very detailed documentation given below, but you might as well just try looking at other mods to understand how this file works.</li><br>
  6. <li><span style='color:Red;'>[FONT=Courier New]icon.png[/FONT]</span>: A 48x48 icon to be displayed next to the mod's name in the mod manager. Note that partial transparency may not work or look fugly. This file is optional.</li><br>
  7. <li><span style='color:Blue;'>[FONT=Courier New]changelog.txt[/FONT]</span>: Optional file. This file will be displayed in the description of your mod as a possibility for the user to see the changelog. Accepts normal BBCode.</li><br>
  8. <li>Any supportive files, e.g. new files your mod adds. You need to reference these in mod.xml or they will be ignored.</li><br>
  9. </ul><br>
  10. <br>
  11. <span style='font-size:3;'>Elements and Attributes in mod.xml</span><br>
  12. <blockquote><br>
  13. <span style='color:Cyan;'><?xml</span> <span style='color:Red;'>version</span>="1.0" <span style='color:Red;'>encoding</span>="UTF-8"<span style='color:Cyan;'>?></span><br>
  14. <span style='color:Cyan;'><modification</span><br>
  15. <span style='color:Red;'>application</span>="Heroes of Newerth" <span style='color:Lime;'><span style='font-style:italic;'>fixed</span></span><br>
  16. <span style='color:Red;'>appversion</span>="0.3" <span style='color:Lime;'><span style='font-style:italic;'>game version requirement (shown is "anything starting with 0.3")</span></span><br>
  17. <span style='color:Red;'>mmversion</span>="1.3" <span style='color:Lime;'><span style='font-style:italic;'>fixed, the version of the file format</span></span><br>
  18. <span style='color:Red;'>name</span>="The Mod's Name" <span style='color:Lime;'><span style='font-style:italic;'>It is <strong>strongly</strong> recommended to keep this name consistent as it will identify the mod.</span></span><br>
  19. <span style='color:Red;'>version</span>="1.0" <span style='color:Lime;'><span style='font-style:italic;'>The current version of the mod. Should grow with each new release.</span></span><br>
  20. <span style='color:Red;'>description</span>="blahblahblah" <span style='color:Lime;'><span style='font-style:italic;'>Explanatory text about the mod to be shown when selected in the Mod Manager (optional)</span></span><br>
  21. <span style='color:Red;'>author</span>="Your Nickname" <span style='color:Lime;'><span style='font-style:italic;'>Will be shown below the mod's name. (optional)</span></span><br>
  22. <span style='color:Red;'>weblink</span>="http://www.com/" <span style='color:Lime;'><span style='font-style:italic;'>A clickable link to be shown below the description text. (optional)</span></span><br>
  23. <span style='color:Red;'>updatecheckurl</span>="http://.../version.txt"<span style='color:Lime;'><span style='font-style:italic;'>A URL to a text file containing the newest version number. (optional)</span></span><br>
  24. <span style='color:Red;'>updatedownloadurl</span>="http://.../m.honmod"<span style='color:Lime;'><span style='font-style:italic;'>A URL to a .honmod file that will be downloaded and replace this mod file when the text file specified above contains a higher version number than this mod currently has. (optional)</span></span><br>
  25. <span style='color:Cyan;'>></span><br>
  26. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Of the elements being described below each kind may appear any number of times and in any order</span> --></span><br>
  27. <br>
  28. <span style='color:Cyan;'><incompatibility</span> <span style='color:Red;'>name</span>="Other mod" <span style='color:Red;'>version</span>="1.0-1.4" <span style='color:Cyan;'>/></span><br>
  29. <span style='color:Lime;'><!-- <span style='font-style:italic;'>States an incompatibility with certain versions of another mod to be abided by the Mod Manager; this mod cannot be enabled when the other mod is enabled.</span> --></span><br>
  30. <br>
  31. <span style='color:Cyan;'><requirement</span> <span style='color:Red;'>name</span>="Other mod" <span style='color:Red;'>version</span>="2.5.1-*" <span style='color:Cyan;'>/></span><br>
  32. <span style='color:Lime;'><!-- <span style='font-style:italic;'>States a dependence on another mod to be abided by the Mod Manager; this mod cannot be enabled when the other mod is not present and enabled.</span> --></span><br>
  33. <br>
  34. <span style='color:Cyan;'><applyafter</span> <span style='color:Red;'>name</span>="Other mod" <span style='color:Red;'>version</span>="2.5.1-*" <span style='color:Cyan;'>/></span><br>
  35. <span style='color:Cyan;'><applybefore</span> <span style='color:Red;'>name</span>="Other mod" <span style='color:Red;'>version</span>="2.5.1-*" <span style='color:Cyan;'>/></span><br>
  36. <span style='color:Lime;'><!-- <span style='font-style:italic;'>If the specified other mod is enabled, this mod will be applied after/before it.</span> --></span><br>
  37. <br>
  38. <span style='color:Cyan;'><copyfile</span> <span style='color:Red;'>name</span>="path1" <span style='color:Red;'>source</span>="path2" <span style='color:Red;'>overwrite</span>="newer" <span style='color:Red;'>condition</span>="..." <span style='color:Cyan;'>/></span><br>
  39. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Copies a supportive file from the mod archive. If "path2" is not specified the file "path1" is copied, if it is "path2" is copied and renamed to "path1".<br>
  40. overwrite specifies a controlled behaviour in case the target file already exists:<br>
  41. "yes" -> target file is overwritten<br>
  42. "no" -> target file is left as is<br>
  43. "newer" -> target file is overwritten if its last modified date is newer than target file<br>
  44. <br>
  45. If the condition attribute is specified the copying is only performed if the given condition is true. A condition can consist of another mod being enabled or disabled or a boolean expression combining multiple such conditions. Examples of valid condition strings:<br>
  46. 'Tiny UI'<br>
  47. not 'Tiny UI'<br>
  48. 'Tiny UI[v3.0]' and 'Automatic Ability Learner[v1.1-1.5]'<br>
  49. ('BardUI' or ('Improved UI by Barter[v1.08]' and 'Improved UI Addon - Juking Map')) and not 'Tiny UI'</span> --></span><br>
  50. <br>
  51. <span style='color:Cyan;'><editfile</span> <span style='color:Red;'>name</span>="path" <span style='color:Red;'>condition</span>="..."<span style='color:Cyan;'>></span><br>
  52. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Edits a file from resources0.s2z or one that has already been copied</span><br>
  53. If condition is specified this editfile tag is only executed if the given condition is true; uses the same syntax as for copyfile. --><br>
  54. <br>
  55. <!-- <span style='font-style:italic;'>Files are edited by executing a sequence of steps, each being represented by one of the four elements below.<br>
  56. All elements need a string as input, which can either be delivered as inner text node (between the <operation></operation> tags) or read from a file in the mod archive specified by a [COLOR=Red]source</span> attribute.<br>
  57. Every operation interacts with a "cursor" variable which points to a area in the file and starts out at the beginning of the file.</span> -->[/COLOR]<br>
  58. <br>
  59. <span style='color:Cyan;'><find</span> <span style='color:Red;'>position</span>="end" <span style='color:Cyan;'>/></span> <span style='color:Lime;'><!-- <span style='font-style:italic;'>synonyms for "find" are "seek" and "search"</span> --></span><br>
  60. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Moves the "cursor" to the next occurrence of the source string<br>
  61. OR as specified by the [COLOR=Red]position</span> attribute, possible values being:<br>
  62. "start" -> Beginning of the file (synonyms: "begin", "head", "before")<br>
  63. "end" -> End of the file (synonyms: "tail", "after", "eof")<br>
  64. any integer -> Move forward the specified number of characters (negative values allowed)</span> -->[/COLOR]<br>
  65. <span style='color:Cyan;'><findup</span> <span style='color:Cyan;'>/></span> <span style='color:Lime;'><!-- <span style='font-style:italic;'>synonyms for "findup" are "seekup" and "searchup"</span> --></span><br>
  66. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Moves the "cursor" to the next occurrence of the source string, but searching backwards.</span> --></span><br>
  67. <br>
  68. <span style='color:Cyan;'><findall</span> <span style='color:Cyan;'>/></span><br>
  69. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Moves the "cursor" to all occurrences of the source string. Afterwards, the cursor will be reset to the start of the file.</span> --></span><br>
  70. <br>
  71. <span style='color:Cyan;'><insert</span> <span style='color:Red;'>position</span>="after" <span style='color:Cyan;'>/></span> <span style='color:Lime;'><!-- <span style='font-style:italic;'>synonym for "insert" is "add"</span> --></span><br>
  72. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Inserts the source string at the "cursor", either before or after as the [COLOR=Red]position</span> attribute specifies.</span> -->[/COLOR]<br>
  73. <br>
  74. <span style='color:Cyan;'><replace /></span><br>
  75. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Replaces the string pointed to by the "cursor" with the source string.</span> --></span><br>
  76. <br>
  77. <span style='color:Cyan;'><delete /></span><br>
  78. <span style='color:Lime;'><!-- <span style='font-style:italic;'>Deletes the string pointed to by the "cursor". Does not require a source string.</span> --></span><br>
  79. <span style='color:Cyan;'></editfile></span><br>
  80. <span style='color:Cyan;'></modification></span><br>
  81. </blockquote>Remarks:<br>
  82. <ul><br>
  83. <li> Version values may only contain digits and periods. Letters will be ignored!</li><br>
  84. <li> No two mods with the same name can be loaded at once.</li><br>
  85. <li> "Requirements" allow mods of mods; such mods will always be applied <span style='font-style:italic;'>after</span> the mods they marked as required so that they may edit their code; note that <requirement /> automatically implies <applyafter />.</li><br>
  86. </ul><br>
  87. [/SPOILER] [GOTO="Top"]Back To The Top![/GOTO]<br>
  88. <span style='font-size:4;'><span style='color:royalblue;'><strong><span style='text-decoration:underline;'>_____________________</span></strong></span></span><br>
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement
Public Pastes
Advertisement
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy.  OK, I Understand
Not a member of Pastebin yet?
Sign Up, it unlocks many cool features!