https://github.com/swissalps/postool
Luanti/Minetest mod to show grid of current map-block (also HUD of position in space and time)
https://github.com/swissalps/postool
hud luanti-mod minetest-mod position tool
Last synced: 3 months ago
JSON representation
Luanti/Minetest mod to show grid of current map-block (also HUD of position in space and time)
- Host: GitHub
- URL: https://github.com/swissalps/postool
- Owner: SwissalpS
- License: lgpl-3.0
- Created: 2019-10-29T00:01:17.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-08-25T21:53:44.000Z (10 months ago)
- Last Synced: 2025-08-25T23:33:31.395Z (10 months ago)
- Topics: hud, luanti-mod, minetest-mod, position, tool
- Language: Lua
- Homepage:
- Size: 1.2 MB
- Stars: 4
- Watchers: 4
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://content.minetest.net/packages/SwissalpS/postool/)
[](https://github.com/SwissalpS/postool/actions)
[](LICENSE)
[](https://www.minetest.net)
PosTool mod for Minetest
========================
Adds configurable HUD elements for current: position (node and block) and time.
If advtrains is installed, it can also display railway time.
If mesecons_debug is installed, this info can also be displayed.
Use chat command /postool to invoke formspec to toggle elements and position of HUD.
# Screenshots
Pick a location.
Use the tool.
Invoke formspec with /postool
Example display of HUD
The progress-bar shows the mesecons usage in current block. It changes colour based on penalty.
When not disabled and user is not standing in the middle block of a chunk,
then a smaller, green grid shows in which direction the chunk borders are.
The closer to the orange grid the green one is, the closer a chunk border is in that direction.
# PosTool
Crafting recipe:
```
| | | glass |
| | torch | |
| stick | | |
```
Punch or place with PosTool to show a grid of the map-block at that position.
If PosTool is used on a node, that nodes position will be used otherwise players position.
# Settings
Settings with default values:
```
# HUD offsets in screen percentage
postool.hud.offsetx 0.8
postool.hud.offsety 0.95
# HUD z_index (does not seem to work)
postool.hud.offsetz -111
# how to separate x, y and z values
postool.hud.posseparator ' | '
# titles in HUD and formspec
postool.hud.titletrain 'Railway Time: '
postool.hud.titletime 'Time: '
postool.hud.titlenode 'Node: '
postool.hud.titleblock 'Block: '
postool.hud.titlemesecons 'Mesecons: '
# value shown in HUD when
# advtrains is not enabled
postool.hud.titletrainna 'advtrains not enabled'
# main HUD switch
postool.hud.defaultshowmain false (0/1)
# which items to initially show
postool.hud.defaultshowtrain false (0/1)
postool.hud.defaultshowtime false (0/1)
postool.hud.defaultshownode true (0/1)
postool.hud.defaultshowblock true (0/1)
postool.hud.defaultshowmesecons false (0/1)
postool.hud.defaultshowmeseconsdetails false (0/1)
# wait at least this long
# before updating HUD (seconds)
postool.hud.minupdateinterval 2
# how long to show grid for
# when tool is used
postool.tool.griddisplayduration 12
postool.tool.suppresschunkindicator false (0/1)
postool.tool.usevizlib false (0/1)
```
# Supported Games
Originally created for default Minetest game and should work with most other games.
When [xcompat](https://github.com/mt-mods/xcompat) is installed, crafting recipe
for the wand adapts to any games supported by xcompat.
# Thanks
This mod was strongly inspired by [poshud](https://github.com/orwell96/poshud).
Some techniques I borrowed from [missions](https://github.com/thomasrudin-mt/missions).
I also want to mention [replacer](https://github.com/pandorabox-io/replacer) <- [Coil0's version](https://github.com/coil0/replacer) <- [Sokomine's version](https://github.com/Sokomine/replacer)
and [protector](https://notabug.org/TenPlus1/protector) as I used parts of them too.
[@6r1d for screenshots and support](https://github.com/6r1d)
Thanks also to the users of pandorabox.io for feedback and inspiration to actually
write this mod. @Huhhila for pushing the mapchunk indicator idea. On #minetest IRC/discord
@Warr1024, @hlqkj and @Krock for chiming in the discussion.
Thanks to @BuckarooBanzay for helping debugging postool in node-breakers.
(If you feel I should include you by name, just submit a PR)