mtcontrib/mtsatellite
1
0
Fork 0
mirror of https://bitbucket.org/s_l_teichmann/mtsatellite synced 2024-12-24 01:00:18 +01:00
Code Issues Projects Releases Wiki Activity

SETUP: prefix it with a "BACKUP FIRST!". Removed some typos.

Browse Source
This commit is contained in:
Sascha L. Teichmann 2014-10-05 12:01:41 +02:00
parent 1838b837d6
commit 786cbee5f7
2 changed files with 14 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@ -2,7 +2,7 @@
MTSatellite is "realtime" web mapping system for [Minetest](http://minetest.net) worlds. MTSatellite is "realtime" web mapping system for [Minetest](http://minetest.net) worlds.
With this system you can play your world and you instantly have an online map of it which With this system you can play your world and you instantly have an online map of it which
can be share on the web. can be shared on the web.
To get a glimpse what it does watch [Realtime Webmapping for Minetest worlds](http://youtu.be/iYEROGPj7RI) To get a glimpse what it does watch [Realtime Webmapping for Minetest worlds](http://youtu.be/iYEROGPj7RI)
on YouTube. on YouTube.

24
SETUP.md
View File

@ -6,20 +6,25 @@ Consult [COMPILE](https://bitbucket.org/s_l_teichmann/mtsatellite/src/default/CO
Setting up MTSatellite takes six steps: Setting up MTSatellite takes six steps:
1. [Convert world database into interleaved format](#markdown-header-convert-world-database-into-interleaved-format) 1. [Backup your world](#markdown-header-backup-your-world)
2. [Configure the Minetest server](#markdown-header-configure-the-minetest-server) 2. [Convert world database into interleaved format](#markdown-header-convert-world-database-into-interleaved-format)
3. [Start `mtredisalize`](#markdown-header-start-mtredisalize) 3. [Start `mtredisalize`](#markdown-header-start-mtredisalize)
4. [Pre-compute the map tiles with `mtseeder`](#markdown-header-pre-compute-the-map-tiles-with-mtseeder) 4. [Pre-compute the map tiles with `mtseeder`](#markdown-header-pre-compute-the-map-tiles-with-mtseeder)
5. [Start the web server `mtwebmapper`](#markdown-header-start-the-web-server-mtwebmapper) 5. [Start the web server `mtwebmapper`](#markdown-header-start-the-web-server-mtwebmapper)
6. [Start the Minetest server](#markdown-header-start-the-minetest-server) 6. [Configure and restart the Minetest server](#markdown-header-configure-and-restart-the-minetest-server)
## Backup your world
MTSatellite is still young. So stop your running Minetest server and make a backup of your world
before you will start crying.
## Convert world database into interleaved format ## Convert world database into interleaved format
MTSatellite operates best if the block data of the world is stored in a LevelDB database with MTSatellite operates best if the block data of the world is stored in a LevelDB database with
a key scheme called interleaved. With this key scheme you can pick up sets of neighbored blocks a a key scheme called interleaved. With this key scheme you can pick up sets of neighbored blocks a
lot quicker than with a plain database. lot quicker than with a plain database.
See [Z-order curve](http://en.wikipedia.org/wiki/Z-order_curve) at Wikipedia for grasping the core ideas. See [Z-order curve](http://en.wikipedia.org/wiki/Z-order_curve) at Wikipedia to grasp the core ideas.
MTSatellite can run on plain LevelDB or SQlite3 world databases but this reduces the performance significantly. MTSatellite can run on plain LevelDB or SQLite3 world databases but this reduces the performance significantly.
This is also not tested very well and will likely break your database. So do not use it! Stay with the This is also not tested very well and will likely break your database. So do not use it! Stay with the
interleaved format! interleaved format!
@ -28,13 +33,10 @@ LevelDB format you have to use `mtdbconverter`:
mtdbconverter -source-backend=sqlite /path/to/your/world/map.sqlite /path/to/your/world/map.db mtdbconverter -source-backend=sqlite /path/to/your/world/map.sqlite /path/to/your/world/map.db
Depending on the size of your world and the speed this conversion will take some time. Depending on the size of your world and the speed of your computer system this conversion will take some time.
Change `-source-backend=sqlite` to `-source-backend=leveldb` if your world is stored as a LevelDB. Change `-source-backend=sqlite` to `-source-backend=leveldb` if your world is stored as a LevelDB.
`mtdbconverter` can also be used to convert your world back to the plain key scheme. `mtdbconverter` can also be used to convert your world back to the plain key scheme.
See `mtdbconverter --help` for all options. Use `mtdbconverter --help` to see all options.
## Configure the Minetest server
**TODO: Write me!**
## Start mtredisalize ## Start mtredisalize
**TODO: Write me!** **TODO: Write me!**
@ -45,5 +47,5 @@ See `mtdbconverter --help` for all options.
## Start the web server mtwebmapper ## Start the web server mtwebmapper
**TODO: Write me!** **TODO: Write me!**
## Start the Minetest server ## Configure and restart the Minetest server
**TODO: Write me!** **TODO: Write me!**