2014-10-03 13:09:59 +02:00
# MTSatellite
2014-10-05 16:23:14 +02:00
MTSatellite is a "realtime" web mapping system for [Minetest ](http://minetest.net ) worlds.
2014-10-03 13:09:59 +02:00
With this system you can play your world and you instantly have an online map of it which
2014-10-05 12:01:41 +02:00
can be shared on the web.
2014-10-03 13:09:59 +02:00
To get a glimpse what it does watch [Realtime Webmapping for Minetest worlds ](http://youtu.be/iYEROGPj7RI )
2014-12-06 14:32:40 +01:00
on YouTube.
2014-12-06 14:48:06 +01:00
A live map of an online world can be viewed [here ](http://maps.mt.sha-bang.de/ ).
2014-10-03 13:09:59 +02:00
2014-10-03 19:39:27 +02:00
See [COMPILE ](https://bitbucket.org/s_l_teichmann/mtsatellite/src/default/COMPILE.md ) how to compile
2014-10-03 22:10:32 +02:00
MTSatellite. Essentially you need Go 1.3 (or higher) and a GNU/Linux system.
2014-10-03 19:39:27 +02:00
2014-10-04 20:57:47 +02:00
See [SETUP ](https://bitbucket.org/s_l_teichmann/mtsatellite/src/default/SETUP.md ) how to bring
2014-10-04 20:56:01 +02:00
MTSatellite to life.
2014-10-03 13:09:59 +02:00
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** . This server stores the data
in an optimized form and collects changes made to the world 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** .
2014-10-03 22:04:33 +02:00
* [mtredisalize ](https://bitbucket.org/s_l_teichmann/mtsatellite/src/default/cmd/mtredisalize ) is a server which has to be configured as a Redis backend to the
2014-10-03 13:09:59 +02:00
Minetest server. It stores the data in an opitimized form to make updates of the pre-rendered map fast.
It is also used to track the changes made to the world. They are aggregated over
a defined time interval and then send to the mtwebmapper server.
2014-10-03 13:19:59 +02:00
* [mtwebmapper ](https://bitbucket.org/s_l_teichmann/mtsatellite/src/default/cmd/mtwebmapper/ ) Web server that serves [Leaflet ](http://leafletjs.com ) compatible tiles to a
2014-10-03 13:09:59 +02:00
web browser. Running in the background this server updates the pre-computed map tiles.
2014-10-03 13:21:27 +02:00
* [mtdbconverter ](https://bitbucket.org/s_l_teichmann/mtsatellite/src/default/cmd/mtdbconverter ) is converter between Minetest databases. mtredisalize works
2014-10-03 13:09:59 +02:00
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.
2014-10-03 13:19:59 +02:00
* [mtseeder ](https://bitbucket.org/s_l_teichmann/mtsatellite/src/default/cmd/mtseeder ) pre-computes all tiles of the map of the world plus a set of pyramidal overview images.
2014-10-03 13:09:59 +02:00
Even playing in a dynamic and fully changeable world most of the data is pretty constant over time. Therefore
it make 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 ](LICENSE ) file for details.
2014-12-06 14:32:40 +01:00
(c) 2014 by Sascha L. Teichmann
