advmarkers/README.md

37 lines
2.2 KiB
Markdown
Raw Normal View History

2019-01-07 14:08:42 -08:00
# advmarkers (non-CSM)
2018-12-29 15:09:58 -08:00
2019-01-07 14:08:42 -08:00
A marker/waypoint mod for Minetest.
2019-06-10 17:42:48 -07:00
Unlike the [CSM], this mod is standalone, and conflicts with the marker mod.
2018-12-29 15:09:58 -08:00
## How to use
2018-12-29 20:13:39 -08:00
`advmarkers` introduces the following chatcommands:
2018-12-29 15:09:58 -08:00
2019-01-07 14:08:42 -08:00
- `/mrkr`: Opens a formspec allowing you to display or delete markers. If you give this command a parameter (`h`/`here`, `t`/`there` or co-ordinates), it will set your HUD position to those co-ordinates.
2019-01-07 17:04:18 -08:00
- `/add_mrkr`: Adds markers. You can use `.add_mrkr x,y,z Marker name` to add markers. Adding a marker with (exactly) the same name as another will overwrite the original marker. If you replace `x,y,z` with `here`, the marker will be set to your current position, and replacing it with `there` will set the marker to the last `.coords` position.
2019-01-07 14:17:27 -08:00
- `/mrkr_export`: Exports your markers to an advmarkers string. Remember to not modify the text before copying it. You can use `/mrkr_export old` if you want an export string compatible with older versions of the advmarkers CSM (it should start with `M` instead of `J`). This old format does **not** work with this mod, so only use it if you know what you are doing!
2019-01-07 14:08:42 -08:00
- `/mrkr_import`: Imports your markers from an advmarkers string (`.mrkr_import <advmarkers string>`). Any markers with the same name will not be overwritten, and if they do not have the same co-ordinates, `_` will be appended to the imported one.
- `/mrkrthere`: Alias for `/mrkr there`.
2018-12-29 15:09:58 -08:00
2018-12-29 20:23:49 -08:00
If you die, a marker is automatically added at your death position, and will
update the last `.coords` position.
2018-12-29 15:09:58 -08:00
2018-12-29 20:13:39 -08:00
## Chat channels integration
advmarkers works with the `.coords` command from chat_channels ([GitHub],
[GitLab]), even without chat channels installed. When someone does `.coords`,
advmarkers temporarily stores this position, and you can set a temporary marker
2019-01-07 17:04:18 -08:00
at the `.coords` position with `/mrkrthere`, or add a permanent marker with
`/add_mrkr there Marker name`.
2018-12-29 20:13:39 -08:00
2019-07-13 15:20:04 -07:00
## SSCSM support
With my [SSCSM] mod installed, advmarkers will register a server-sent CSM to
reduce visible lag in the markers GUI.
2019-06-10 17:42:48 -07:00
[CSM]: https://git.minetest.land/luk3yx/advmarkers-csm
2018-12-29 20:13:39 -08:00
[GitHub]: https://github.com/luk3yx/minetest-chat_channels
[GitLab]: https://gitlab.com/luk3yx/minetest-chat_channels
2019-07-13 15:20:04 -07:00
[SSCSM]: https://git.minetest.land/luk3yx/sscsm