mtcontrib/mtsatellite
1
0
Fork 0
mirror of https://bitbucket.org/s_l_teichmann/mtsatellite synced 2024-11-08 03:00:26 +01:00
Code Issues Projects Releases Wiki Activity
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.
239 Commits 4 Branches 0 Tags 3.7 MiB
Go 92.1%
JavaScript 3.5%
Vue 3.2%
HTML 0.4%
Lua 0.4%
Other 0.4%
3e0e909a69
Go to file
Sascha L. Teichmann 3e0e909a69 Added 'websocket' branch. Added mechanism to forward the coords of the updated base tiles.
2015-03-02 13:10:30 +01:00
cmd Added 'websocket' branch. Added mechanism to forward the coords of the updated base tiles. 2015-03-02 13:10:30 +01:00
common Fixed hill shading for transparent structures a bit. Still not optimal. 2014-10-28 11:53:18 +01:00
colors.txt Made a few blocks (water, glass) transparent in colors.txt. 2014-10-19 21:43:17 +02:00
COMPILE.md Refer to Go 1.4.1 binary when compiling mtsatellite. 2015-02-15 19:55:22 +01:00
LICENSE Added license: MIT 2014-08-03 15:59:56 +02:00
README.md README.md edited online with Bitbucket 2015-03-01 15:53:32 +00:00
SETUP.md Mentioned transparency in SETUP. 2014-11-16 13:13:03 +01:00
TODO Adjusted TODO 2014-09-24 10:10:02 +02:00

README.md

MTSatellite

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.3 (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.

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