descriptionA simple in-game documentation system (framework only, the actual help topics are added in other mods).
owneralmikes@aol.com
last changeTue, 27 Mar 2018 12:05:33 +0000 (27 14:05 +0200)
content tags
add:
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.1.1

For players

Accessing the help

To open the help, there are multiple ways:

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

shortlog
2018-03-27 WuzzyVersion 1.1.1master
2018-03-25 WuzzySubgame → game
2017-08-18 WuzzyReplace minetest.debug with minetest.log
2017-07-29 WuzzyFix incorrect function parameters in API.md
2017-04-03 WuzzyUpdate version to 1.1.0
2017-03-20 WuzzyAllow to disable reveal notifications
2017-02-03 WuzzyVersion 1.0.1
2016-12-29 WuzzyAdd inventory_plus as optional dependency
2016-12-28 WuzzyVersion 1.0.0
2016-12-28 WuzzyUpdate screenshot
2016-12-28 WuzzyLocalize doc.get_entry
2016-12-28 WuzzyAllow cross-category aliases, change API
2016-12-28 Wuzzynew_entry/new_category → add_entry/add_category
2016-12-28 WuzzyAdd Inventory++ support
2016-12-27 WuzzyClarify shutdown message
2016-12-27 WuzzyFix typos in German translation
...
heads
9 months ago master