In game documentation for tools

[S-S-X]

Add standardized formspecs containing documentation for tools.

In game docs should contain:

• List of supported nodes.
• Info if tool can be used on any node and description what wildcard node def is supposed to do.
• What functions are implemented and usable for tool and nodes: copy, paste, info.
• How to execute those functions: use, special+use, sneak+use.
• Registered chat commands that work with said tool.
• Something else?

How to display that formspec in game?
Possibly some chat command /metatool help and display documentation for tool that player is holding, allow also saying for example /metatool help tubetool to display tubetool docs no matter what tool player holds in hand.
If not holding anything and not adding tool name then maybe chat reply listing all possible help commands something like:

Run one of following commands to display documentation for tool:
/metatool help tubetool
/metatool help sharetool
/metatool help luatool

Another option would be just /metatool help that would display form that lists tools and when selected displays documentation for that tool. Form could then also contain simple description of common metatool API things.

[6r1d]

How to display that formspec in game?

Command is cool, but I was thinking about a tool one can carry without looking at help, because people won't look for a command generally.
It can contain a hint about the command so people learn it, but by default I expect new players to avoid the in-game command. :/

Something else?

Digiline blocks need examples most of the time. Loading these examples should depend on node existing, maybe there should be more examples, because conflicting mods probably do exist.

[S-S-X]

but I was thinking about a tool one can carry without looking at help

#85

Seems I now have 2 separate in game documentation things here 😄