|
|
| (8 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| This is the format required by the in-game changelog viewer to display mod changelogs in the browse mods GUI. The changelog.txt file is expected to be located in the root of the mod folder, see [[Tutorial:Mod_structure#Files]]. | | <div class="stub"><p>'''The mod structure have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/auxiliary/changelog-format.html https://lua-api.factorio.com/latest/auxiliary/changelog-format.html] |
|
| |
|
| The online [https://mods.factorio.com/ mod portal] does ''not'' require this changelog format, it will display any changelog.txt file content.
| | </p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div> |
| | |
| TODO
| |
| completely empty lines are ignored?
| |
| | |
| * Parsing errors can be found in the [[log file]] in the [[user data directory]].
| |
| * It may be simpler to copy and modify the [[#Example changelog]] than to start from scratch.
| |
| | |
| <!-- maybe link to vs code extension that has changelog hinting from jarg -->
| |
| | |
| == Important general format ==
| |
| | |
| * Do not use tabs
| |
| ** Indentation is done with two spaces
| |
| * Do not leave whitespace at the end of lines ("trailing spaces")
| |
| | |
| Usually, text editors can enforce this automatically, it is recommended to set this up.
| |
| | |
| == Formatting rules ==
| |
| [[#Important general format]] applies everywhere and will lead to confusing error messages if not followed.
| |
| | |
| TODO One section per version.
| |
| | |
| === Version section start ===
| |
| The line must be exactly <code>---------------------------------------------------------------------------------------------------</code>.
| |
| | |
| The next line must be a [[#Version]] line.
| |
| === Version ===
| |
| The line must start with exactly <code>Version: </code>, note the space after the colon. The remaining part of the line will be parsed as the version the section is about.<br>
| |
| The version itself is expected in the format <code>number.number.number</code> for <code>major.minor.sub</code>, for example <code>0.6.4</code>. Each number can range from 0 to 65535. <code>0.0.0</code> is not considered a valid version.
| |
| | |
| There may not be two version sections with the same version.<br>
| |
| This line is mandatory. | |
| | |
| Example:<br>
| |
| <code>Version: 0.12.35</code>
| |
| === Date ===
| |
| The line must start with exactly <code>Date: </code>, note the space after the colon. The remaining part of the line will be parsed as the date the version was released. There are no restrictions for the format of the date itself.
| |
| | |
| There may not be two date lines within the same version section.<br>
| |
| This line is optional.
| |
| | |
| Example:<br>
| |
| <code>Date: 01. 06. 2016</code>
| |
| === Category ===
| |
| | |
| The line must start with exactly two spaces. The remaining part of the line will be parsed as the category. The line must end with a colon. This colon is removed for the purpose of display.
| |
| | |
| This line and the following entry lines are optional.
| |
| | |
| There are no restrictions for the format of the category itself.
| |
| <div class="toccolours mw-collapsible mw-collapsed" style="width: 60em;">
| |
| However, some categories are recognized by the game and sorted before the "All" tab in the GUI:
| |
| <div class="mw-collapsible-content">
| |
| * Major Features
| |
| * Features
| |
| * Minor Features
| |
| * Graphics
| |
| * Sounds
| |
| * Optimizations
| |
| * Balancing
| |
| * Combat Balancing
| |
| * Circuit Network
| |
| * Changes
| |
| * Bugfixes
| |
| * Modding
| |
| * Scripting
| |
| * Gui
| |
| * Control
| |
| * Translation
| |
| * Debug
| |
| * Ease of use
| |
| * Info
| |
| * Locale
| |
| </div></div>
| |
| | |
| Example:<br>
| |
| <code> Minor Features:</code>
| |
| === Entry ===
| |
| | |
| The line must start with exactly four spaces followed by exactly <code>- </code> (note the space after the dash) for a single line entry. For a multiline entry, lines after the first line must start with exactly six spaces.
| |
| | |
| If an entry is used, a previous line in the version section must be a [[#Category]] line. The entry is then associated with the category, see [[#Example changelog]]. | |
| | |
| Entries in the same version and the same category may not be exact duplicates.
| |
| | |
| Example:<br>
| |
| <code> - Fixed the missing title in character logistics window.</code>
| |
| == Example changelog ==
| |
| It may be simpler to copy and modify this example than to start from scratch.
| |
| <pre>---------------------------------------------------------------------------------------------------
| |
| Version: 1.1.60
| |
| Date: 06. 06. 2022
| |
| Features:
| |
| - This is an entry in the "Features" category.
| |
| - This is another entry in the "Features" category.
| |
| - This general section is the 1.1.60 version section.
| |
| Balancing:
| |
| - This is a multiline entry in the "Balancing" category.
| |
| There is some extra text here because it is needed for the example.
| |
| Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
| |
| Bugfixes:
| |
| - Fixed that canceling syncing mods with a save would exit the GUI.
| |
| - Fixed a desync when fast-replacing burner generators.
| |
| ---------------------------------------------------------------------------------------------------
| |
| Version: 1.1.59
| |
| Date: 06. 05. 2022
| |
| Bugfixes:
| |
| - This general section is the 1.1.59 version section.
| |
| - This is an entry in the "Bugfixes" category.
| |
| - Fixed grenade shadows.
| |
| ---------------------------------------------------------------------------------------------------
| |
| Version: 0.1.0
| |
| Date: 24. 12. 2012
| |
| Major Features:
| |
| - Initial release.
| |
| - This general section is the 0.1.0 version section.
| |
| </pre>
| |
| | |
| == See also ==
| |
| * [https://forums.factorio.com/67140 Forum thread about the changelog format]
| |
| * [[Tutorial:Mod structure]]
| |
The mod structure have moved to a new website with an improved format. This documentation page can now be found here: https://lua-api.factorio.com/latest/auxiliary/changelog-format.html
This wiki page is no longer updated and will be removed at some point in the future, so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback on the forums.