Import Help 1.1.0: doc, doc_items, doc_identifier
This commit is contained in:
parent
265522435c
commit
2be856f3d1
38 changed files with 4398 additions and 0 deletions
52
mods/HELP/doc/doc/README.md
Normal file
52
mods/HELP/doc/doc/README.md
Normal file
|
@ -0,0 +1,52 @@
|
|||
# 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.0.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 subgame authors
|
||||
This mod helps you in creating extensive and flexible help entries for your
|
||||
mods or subgame. 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
|
Loading…
Add table
Add a link
Reference in a new issue