History

marcin-serwin cbe8583cef Merge branch 'master' into polish-translation		2021-06-02 10:14:25 +00:00
..
locale	Add polish translation of doc	2021-05-28 09:58:01 +02:00
sounds
textures
API.md
init.lua	fix many codestyle issues (functions, strings, modpaths)	2021-05-29 16:12:33 +02:00
mod.conf	Revert color changes to GUI.	2021-04-19 14:44:20 +02:00
README.md	Update doc mod	2020-03-10 18:18:27 +01:00

README.md

Documentation System [`doc`]

This mod provides a simple and highly extensible form in which the user can access help pages about various things and the modder can add those pages. The mod itself does not provide any help texts, just the framework. It is the heart of the Help modpack, on which the other Help mods depend.

Current version: 1.2.1

For players

Accessing the help

To open the help, there are multiple ways:

Use the /helpform chat command. This works always.
If you use one of these mods, there's a help button in the inventory menu:
- Unified Inventory [unified_inventory]
- Simple Fast Inventory Buttons [sfinv_buttons]
- Inventory++ [inventory_plus]

The help itself should be more or less self-explanatory.

This mod is useless on its own, you will only need this mod as a dependency for mods which actually add some help entries.

Hidden entries

Some entries are initially hidden from you. You can't see them until you unlocked them. Mods can decide for themselves how particular entries are revealed. Normally you just have to proceed in the game to unlock more entries. Hidden entries exist to avoid spoilers and give players a small sense of progress.

Players with the help_reveal privilege can use the /help_reveal chat command to reveal all hidden entries instantly.

Maintenance

The information of which player has viewed and revealed which entries is stored in the world directory in the file doc.mt. You can safely reset the viewed/revealed state of all players by deleting this file. Players then need to start over revealing all entries.

For modders and game authors

This mod helps you in creating extensive and flexible help entries for your mods or game. You can write about basically anything in the presentation you prefer.

To get started, read API.md in the directory of this mod.

Note: If you want to add help texts for items and nodes, refer to the API documentation of doc_items, instead of manually adding entries. For custom entities, you may also want to add support for doc_identifier.

License of everything

MIT License

Translation credits

French: Karamel German: Wuzzy Portuguese: BrunoMine