Page 1 of 2

[Mod] Minetest Game item help [0.11.0] [doc_minetest_game]

PostPosted: Sun Jul 24, 2016 23:25
by Wuzzy
Adds help texts for the Help modpack with information about Minetest Game.

This mod depends on some of the mods in the Help modpack to improve the item help entries for Minetest Game, namely:
  • General hand-written item descriptions
  • Item usage help
  • Group definitions
  • Factoids (little automatically generated pieces of information) like flammability, Flora spread, etc.

The current mod releases support Minetest Game 0.4.14, 0.4.15, and 0.4.16 (see below).

Example entry:

Current status: The help texts are complete in 0.11.0 and this mod is fairly stable. This mod needs to undergo testing now.

I want to hear feedback on how well I wrote the help entries. In this thread, please focus on the fields “Description” and “Usage help” of each entry, as those are the main texts which are provided by this mod.

Important! Always download the version which fits your Minetest Game version, otherwise the help texts will be incorrect.

If you want the latest and greatest version for Minetest Game 0.5.0-dev, you may try out the Bleeding Edge version: Zip archive. Warning: This is not a real version, just the latest stage of development. No guarantee of completion or bug-freeness given! Use at your own risk! If it doesn't work, fall back to latest stable mod version.

Other information
  • Git project page:
  • Mandatory dependencies:
    • Minetest Game (remember to download the correct mod version)
    • doc_items (Version 0.11.0 or later) (part of the Help modpack)
  • Optional dependencies:
    • doc_identifier (part of Help)
    • doc_basics (part of Help)
    • intllib
  • License of everything: MIT License

Version 0.2.0

PostPosted: Mon Aug 01, 2016 22:31
by Wuzzy
Version 0.2.0 released!

This version comes with a huge number of string updates, simply too much to list fully. Biggest changes:
- Blocks with special drops (e.g. Gravel) now show what they drop, including probabilities (example: “This block drops one of the following: Flint (ca. 6%), Gravel (ca. 94%).”)
- Tool damage and digging properties are now displayed more systematically
- Blocks display their digging group and level more systematically as well
- Group memberships displayed in a more readable form
- Selected additional groups are listed for all items
- Better explanation of light behaviour for blocks
- New or updated descriptions for many items
- New minimal descriptions for all craft-only items
- Various other small and big text changes

Other addition, just for fun:
- An experimental achievement for the Achievements [awards] mod by rubenwardy has been added. Read all block entries to win it. This achievement is likely to change later to something more practical.

I guess the next big step for this mod will be to split this mod into two mod: One part to handle the items in a neutral manner, and one part specific to Minetest Game only.

Version 0.3.0

PostPosted: Fri Aug 05, 2016 04:48
by Wuzzy
Version 0.3.0 released!

This is an important release since major structural changes have been made. I have forked this mod to create a generic API for adding item help without adding any Minetest Game-specific cruft; this mod can now be found under Item Documentation [doc_items].
All generic functionality in this mod is not part of the aforementioned mod and has been removed in this mod. What remains are only a couple of help texts for Minetest Game and some automatically generated texts and other minor things.
This step was important to make it much more easy for modders to add their own item help.
These changes mean that the dependencies of this mod have changed! Read the first post.

Apart from that, I have again updated the help texts of many items and I think the help texts are now pretty much complete. If you want to give feedback, please do by telling me how well you understand the item entries, especially the description and usage help of each entry.

Version 0.4.0

PostPosted: Sat Aug 13, 2016 21:44
by Wuzzy
Updates for version 0.4.0 of this mod:

- Allow Lookup Tool to correctly identify placed boats
- Make Lookup work properly on a variety of blocks where it didn't work previously: Doors, glass panes, iron bars, burning furnace, ignited TNT
- Update screwdriver text
- Update TNT texts
- Fix incorrect information regarding obsidian and how it is created
- More detailed bucket texts
- Move door entries to Blocks section
- Other text changes

Re: [Mod] Minetest Game item help [0.4.0] [doc_minetest_game

PostPosted: Sun Aug 14, 2016 08:21
by azekill_DIABLO
+1 this is awesome! is it aded to tutorial?

Re: [Mod] Minetest Game item help [0.4.0] [doc_minetest_game

PostPosted: Sun Aug 14, 2016 09:12
by Wuzzy
No, certainly not. This is the Minetest Game item help and the tutorial has not much to do with Minetest Game, apart from using some of its textures and a very few nodes as examples.

I would have to add custom help texts for tutorial. Maybe I'll even do it (and also add doc and doc_identifier) but first the tutorial has some bigger issues which need to be solved (like, finally making major version 2 official because I have problems with item spawning again).

Version 0.5.0

PostPosted: Wed Aug 31, 2016 21:44
by Wuzzy
Version 0.5.0 released!

- Compability with doc_items 0.5.0
- Expose tnt_radius setting into TNT description (explosion range of TNT)
- Ore descriptions now include the height in which they can be found
- Add hoe usage count
- Turn leaf decay into an automatically generated text, rather than putting it into the long description
- Customize descriptions for leaves and trees (more infos about the trees themselves)
- Add entry for unused dirt with grass and footsteps node
- Fix incorrect item images for doors
- Fix incorrect description of Flora behaviour
- Fix dropped doors being unidentifiable
- Fix mostly incorrect xpanes factoids (glass pane, iron bar)
- Add alias for burning gunpowder and active furnace so they can be properly identified by doc_identifier
- Compability with doc_items 0.5.0
- Two blocks are now marked as “hidden” (these are unused blocks and unimportant for gameplay, but the entries are still there in case they end up in a world for some reason)
- Many other smaller text changes
- Many minor spelling, grammar and factual fixes

Version 0.6.0 and version 0.6.1

PostPosted: Sat Oct 22, 2016 15:21
by Wuzzy
Version 0.6.0 released!

- Mention the height at which lava appears
- Bugfix: Fire burning speed was mentioned but Minetest Game only supports one burning speed
- Rename the screwdriver description/tooltip to “Screwdriver” (indead of “Screwdriver (Left click (…))”)
- Declare dirt with grass and footsteps, and dirt with snow as soil for hoe
- Remove the experimental achievement for reading all entries. It might be added later in a slightly different manner, when everything works out fine

Version 0.6.1 released!
- Remove optional dependency on awards mod

Version 0.7.0 released!

PostPosted: Thu Nov 17, 2016 22:33
by Wuzzy
Version 0.7.0 released!
If you updated the Documentation System recently to version 0.7.0, you also need to update this mod, otherwise, it won't work.


- Compatiblity with version 0.7.0 of doc_items (now part of the Documentation System modpack)
- Add some compability with development version of Minetest Game (but incomplete compability, the main documentation goal is still Minetest Game version 0.4.14)
- Add support for a few more group names
- Add intllib support (but no translation yet)
- Some spell-checking
- Screenshot changed

Version 0.7.1 released!
Fix mod crash with both intllib and mod security enabled.

Version 0.8.0 released!

PostPosted: Mon Dec 19, 2016 22:34
by Wuzzy
Version 0.8.0 released! With lots of new help texts for the coming next version of Minetest Game. Perfect if you want to understand how the new items work.

  • Add support and help texts for new items in the next Minetest Game version:
    • Cart
    • Powered rail, brake rai
    • Key and skeleton key
    • Orange coral, brown coral
    • Coral skeleton
    • Bush leaves, bush stem, acacia bush leaves, acacia bush stem
    • Silver sand
  • Add a short note to blocks which support the new keys (e.g. locked chest, steel door, steel trapdoor)
  • Add support for upcoming new torch
  • More copy-editing
  • Specify the number of uses for hoes differently
  • Add support for the upcoming cools_lava group (mentions all blocks which turn lava into obsidian nearby)
  • Add bonus recipe for the encyclopedia from doc_encyclopedia: 3 books vertically.
  • Some other refactoring

Note: Minetest Game 0.4.14 is still supported and the primary target of this mod. Some help texts of this mod might be slightly outdated for the current developer version.

Version 0.9.1

PostPosted: Tue Dec 27, 2016 20:35
by Wuzzy
Version 0.9.1 released!
This version is the second update for the new Minetest Game version 0.4.15. This update contains help text updates for the more subtle gameplay changes. The help texts have been updated for the following items:
Mossy cobblestone, mossy cobblestone stair, mossy cobblestone slab, mossy cobblestone wall, dirt, dirt with grass, dirt with dry grass, dirt with snow, snow block, snow, mese crystal fragment, basic flame, permanent flame, coal block, flint and steel, TNT, gun powder, torch.

From now on, this mod will only work with Minetest Game 0.4.15. I will continue to offer version 0.8.0 for Minetest Game 0.4.14, at least for a while.

Full changelog:
  • Glass pane, iron bar (and other panes): Fix broken lookup tool support
  • Mossy cobblestone, mossy cobblestone stair, mossy cobblestone slab, mossy cobblestone wall: Update help regarding mossy blocks with explanation how to generate these
  • Dirt with grass, dirt with dry grass, dirt with snow: Dirt cover spreading is now presented differently in help pages
  • Mese crystal fragment: Now considered a normal craftitem
  • Explain that flammable items get destroyed by igniter blocks such as fire and lava
  • Update many fire and ignition-related texts (especially that flint and steel can be used to ignite things like TNT)
  • Coal block: Explain that it creates a permanent flame when a flint and steel is used on it
  • Mention other ways to create dirt with snow
  • Fix incorrect fire entry if fire is disabled (setting “disable_fire” changed name to “enable_fire”)
  • Removed the encyclopedia recipe with 3 books (it will be moved to doc_encyclopedia)
  • Fix outdated mod dependencies for Minetest Game 0.4.15
  • Minor copy-editing (as usual)

Note: The mod has one major remaining bug which definitely needs fixing: You can't use the lookup tool on doors, it will make Minetest crash.

Note: Version 0.9.0 was released in error, so I quickly went to version 0.9.1.

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Thu Dec 29, 2016 00:33
by echosa
Edit: oops - wrong forum post

Version 0.10.0

PostPosted: Thu Dec 29, 2016 02:13
by Wuzzy
Version 0.10.0 released!


- Compability with Help modpack 1.0.0 (IMPORTANT)
- Update help entries: pine sapling, powered rail
- Almost complete rewrite of cart entry, now mentions how to turn the cart around
- TNT entry now optionally mentions mesecons support
- Automatically generate help texts for farming soil
- Replace deprecated function call
- Door entries now finally work with the lookup tool

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Thu Dec 29, 2016 07:52
by ManElevation
nice I like this mod

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Mon Jan 02, 2017 19:42
by DS-minetest
Will you add optional information for doors if mesecons_doors is enabled?

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Mon Jan 02, 2017 20:22
by Wuzzy
I'd rather not. The responsibility for this lies in Mesecons.
My rule of thumb is this: The responsibility for adding help texts for a feature lies in the mod which adds the feature, unless it is a basic Minetest feature (like stack size of an item).

Theoretically. If I'd add support for any external mod which modifies a Minetest Game item, the amount of help texts in this mod would explode and they would also become outdated for sure. Maintaining Minetest Game help texts is enough.

But the real problem is, doors are very messy in Minetest Game and I used really bad trickery to add somewhat useful door help pages, which makes it hard to modify them. I really gotta clean up the code. But it won't be easy. I also might consider an exception for Mesecons because doors are so messy. But this has the downside that I now have to watch another mod for updates.

Frankly, this entire mod is a giant hack because it overwrites the item definitions of basically everything in Minetest Game. It works (more or less), but it's still a hack.

If I would apply my rule of thumb consequently, this mod should not even exist.
Because according to my rule, the responsibility for Minetest Game help texts should lie in Minetest Game itself. This would be the easiest solution, because that's what the Help is designed for. But this would also mean the Help modpack must become a native part of Minetest Game. It would not be bad, I just fear the Help modpack just doesn't have good chances into getting into Minetest Game because it would improve usability. xD (Yes, I'm cynical.)
That's why I created this mod in the first place, also because Minetest Game is still so dominant.

But well, I might one day try to convince Minetest Game devs to adopt the Help modpack, when it has more features. But not now.

That having said, I hope the help is still useful for you. :-)

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Mon Apr 10, 2017 20:19
by bell07
Today I noticed the doc_minetest_game does not load on stable 0.4.15 because of
Code: Select all
mod "doc_minetest_game" has unsatisfied dependencies:  "pbj_pup"

Can you pls. change the dependencies to optional if not really required? In stable the mod pbj_pup does not exists currently. Some people does not use the full minetest_game.

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Tue Apr 11, 2017 09:10
by azekill_DIABLO
correction: some people does not use MTG

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Tue Apr 11, 2017 12:17
by Wuzzy
bell07: This is your own fault, because you chose to live on the bleeding edge. :D
The developer version is never officially supported, so bugs are expected.

Just use version 0.10.0, and you will be fine.
Version 0.10.0 has everything you need for Minetest Game 0.4.15.

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Tue Apr 11, 2017 19:16
by bell07
If I use the 0.10.0 I will miss the documentation for the new sand that I cherry-picked on top of minetest_game-0.4.15. :D
I cannot cherry-pick pbj_pup, my childs does not allow experiments with the Nyancats :D

I think I am not alone with modified minetest_game version that does not have all upstream mods installed (The MTG is just a base-modpack for me).
Do you see any issues with some additional "?" in the depends.txt? I see in the code you check always for minetest.registered_items[] before overriding.

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Wed Apr 12, 2017 03:03
by Wuzzy
Alright, alright. Doing a more modular approach seems to make sense.
I may look into this when I prepare the next update of this mod. But I am currently not in my Minetest phase.
Maybe somewhen in May 2017.

Re: [Mod] Minetest Game item help [0.10.0] [doc_minetest_gam

PostPosted: Sun Apr 23, 2017 12:27
by azekill_DIABLO
I think that if we continue calling "Minetest Game" "minetest_game", wuzzy will have an attack.


PostPosted: Sun May 28, 2017 03:41
by Wuzzy
Version 0.11.0-preview released!
I have updated the help texts for the few new blocks and items which will soon be added in Minetest Game 0.4.16.

Download 0.11.0-preview (for Minetest Game 0.4.15-dev (May 28, 2017)): ...

I will continue to offer the downloads for Minetest Game 0.4.15 and 0.4.14 (see 1st post).

New help texts are added for: Both bush saplings, mese post light, tin stuff, dirt with rainforest litter, desert sandstone, silver sandstone (+all variants), ice stair/slab, snow block stair/slab.
In Minetest Game, the placement rules of slabs have been changed, so the slab help has been updated accordingly.

Please tell me of any gameplay changes I may have overlooked which may cause one or more of the existing help texts to be incorrect. Or if you find any typos and whatnot. No detail is too small! :D


PostPosted: Mon May 29, 2017 00:45
by Wuzzy
Version 0.11.0-test released!

Download 0.11.0-test (for Minetest Game 0.4.15-dev (May 29, 2017)): ...

Updated pages:
- Slabs
- Swords
- Flint and Steel
- Bush Leaves, Acacia Bush Leaves
- Dirt with Snow
- Pine Sapling
- Papyrus
- Cactus
- Key
- Possibly more?

Updated factoids:
- Flora spread and dry shrub creation

- Remove pointless entries for open chests

Remember, if you use Minetest Game 0.4.15, you still have to download version 0.10.0 of this mod!

Re: [Mod] Minetest Game help [0.11.0-test] [doc_minetest_gam

PostPosted: Mon May 29, 2017 01:06
by Wuzzy
bell07 wrote:If I use the 0.10.0 I will miss the documentation for the new sand that I cherry-picked on top of minetest_game-0.4.15. :D
I cannot cherry-pick pbj_pup, my childs does not allow experiments with the Nyancats :D

Sorry, I can not support every possible modified (!) Minetest Game version (which is basically what you used). That would be impossible, as there is an infinite amount of ways you can possibly change Minetest Game. :D

I think it is more than enough if I support latest stable, the stable before that one, and maaaaaybe current dev (which I just made a release for). I have rewritten my first post to make the downloads less confusing now.

FYI: The new sandstone nodes are nothing special. They are just recolored versions of the existing sandstone nodes. Also note: Basic help entries are always already present for all nodes (no matter which mods) with automatically-gathered info such as mining speed, even without this mod. The main task of this mod is to add hand-written descriptions as well, at least for Minetest Game.

Well, it would be better for all if Minetest Game just included the help texts itself (so this mod wouldn't be neccessary) but I am probably asking for too much. :-(