MTSatellite is a "realtime" web mapping system for Minetest worlds. With this system you can play your world and you instantly have an online map of it which can be shared on the web.

Go to file

Sascha L. Teichmann 069f4728c5 Revert "remove dead code" This reverts commit `bc65fc56ed`.		2024-01-08 01:34:19 +01:00
cmd	add package description to mtredisalizer	2024-01-07 11:12:42 +01:00
common	Revert "remove dead code"	2024-01-08 01:34:19 +01:00
mods/track_players	add mod.conf to track_players mod	2024-01-07 14:52:54 +01:00
pg	pg listen/notify part	2022-02-28 11:38:16 +01:00
3rdpartylibs.sh	Renamed 3party script to a more proper name.	2018-02-19 11:09:36 +01:00
COMPILE.md	Update compile instructions to Go 1.10.	2018-02-19 11:12:02 +01:00
LICENSE	Added license: MIT	2014-08-03 15:59:56 +02:00
README.md	Update dependencies	2024-01-05 11:41:22 +01:00
SETUP.md	Relax the warnings about the none interleaved backend formats.	2015-12-26 18:14:20 +01:00
TODO	Adjusted TODO	2014-09-24 10:10:02 +02:00
colors.txt	Made a few blocks (water, glass) transparent in colors.txt.	2014-10-19 21:43:17 +02:00
go.mod	compress/zstd is used directly.	2024-01-07 03:58:34 +01:00
go.sum	Add zstd library	2024-01-05 14:41:06 +01:00

README.md

MTSatellite

Attention MTSatellite is currently getting some improvements namely PostgreSQL backend support and and a new Vue-JS based web client.

The new features are in but the documentation is not updated, yet. Hopefully this will change soon.

MTSatellite is a "realtime" web mapping system for Minetest worlds.
With this system you can play your world and you instantly have an online map of it which can be shared on the web.

To get a glimpse what it does watch Realtime Webmapping for Minetest worlds on YouTube.
A live map of an online world can be viewed here.

See COMPILE how to compile MTSatellite. Essentially you need Go 1.20 (or higher) and a GNU/Linux system.

See SETUP how to bring MTSatellite to life.

To use it you have to configure your Minetest server to use the Redis backend data store. Instead of a real Redis server you have to run mtredisalize. The data itself is not stored in a Redis server. It only uses the Redis protocol to communicate with the MT server. The data is stored in an optimized form in a LevelDB or SQLite3 database. Changes made to the world are collected over a configurable amount of time periodically. After a cycle of collection the web server mtwebmapper is triggered to regenerate the map. To not fully regenerate the whole world map but only the differences the map has to be pre-rendered with mtseeder.

mtredisalize is a server which has to be configured as a Redis backend to the Minetest server.
mtwebmapper Web server that serves Leaflet compatible tiles to a web browser. Running in the background this server updates the pre-computed map tiles.
mtdbconverter is converter between Minetest databases. mtredisalize works best if you use a special interleaved LevelDB key schema. To bring your old database (LevelBD or SQLite3) into this format this tool does the job. It can also be used to convert the interleaved database back to a plain LevelDB or SQLite3 one.
mtseeder pre-computes all tiles of the map of the world plus a set of pyramidal overview images. Even playing in a dynamic and fully changeable world most of the data is pretty constant over time. Therefore it makes sense to do only small updates on pre-calculated images instead of generating the map entirely on the fly.
Web-Map-Client Web map application showing the base map of the minetest world and other in the browser.

This is Free Software under the terms of the MIT license. See LICENSE file for details.
(c) 2014 by Sascha L. Teichmann