- Java runtime environment
- Minecraft Server JAR
- Screen v4.x
- c10t (for cartography to work)
- brownan's overviewer script (for overviewer to work)
- Donkey Kong's Biome Extractor (for biomes)
- unzip (for auto updating)
- Install the required programs
Try: sudo apt-get install screen unzip
Or: sudo yum install screen unzip
- Download from udoprog's repo:
https://github.com/udoprog/c10t
- Download from brownan's repo:
http://github.com/brownan/Minecraft-Overviewer
- Download from Donkey Kong's post (was tested as of 0.6a):
http://www.minecraftforum.net/viewtopic.php?f=25&t=80902
- copy the script into your minecraft server folder.
- allow the script to be executed
- check the rights of the script user. Every folder specified in the configuration phase has to be available to him.
- edit the script to configure it (see the configuration section)
- I strongly recommend using crontab to automate some of the process. I prefer to perform logs clean + server restart + sync + then all of my mappers at 4AM every day.
- The 'logs' command should always be used BEFORE a restart, as the restart wipes the previous logs. I'm running hey0's servermod, which allows to have a log history, but that's not the case for everyone.
- I also recommend setting an Internet public folder, for the maps images to be displayed. People on my server love this feature, as they know a new map is generated every day, and they can see the evolution of our world.
- I made an alias to be able to use 'minecraft command' instead of './minecraft.sh command'. It also enables the automatic completion, if you type 'mine' then press tab. Much quicker =) You can do this by editing /home/USER/.bashrc, and adding the line:
(of course, change the path if needed)
This script uses rsync to update an offline folder with the latest world information. As maps become larger, time to completion when running mappers on them increases. Having saving turned off for 15-30 minutes while a new map is being generated isn't good for the users. Saving is now only turned off for the time it takes to sync the folders.
Because of this, your world size is effectively doubled when using this script. Whenever you issue the 'minecraft.sh sync' command, you will be shown the size of the two directories in KB.
If using Brownan's Overviewer to create Google-like maps of your worlds, be sure you are using the --cachedir=/path/to/dir to change the location of the png files as you will start to take up considerable space since it defaults to save the files inside of the world folder. This can grow backups that are only 3mb to 99mb files. If you are not cleaning the logs, this will start to consume a considerable amount of hard drive space.
There are several variables to set before you can run the script for the first time. Open minecraft.sh with a text editor, and edit the following lines, at the beginning of the file :
Main Settings
WORLD_NAME="world"
This is the path to the world folder
OFFLINE_NAME=$WORLD_NAME-offline
This is the name to the offline world folder that sync and all mapper functions use to process the world. This is saved in the same directory as your world folder.
SCREEN_NAME="minecraft"
This is the name of the screen the server will be run on
MEMMAX=1024
This is the maximum size of RAM you want to allow the server to use, if you are not sure, keep this and MEMALOC identical.
MEMALOC=1024
This is the size of RAM you want to allocate to the server
DISPLAY_ON_LAUNCH=1
Do you want the screen to be displayed each time the server starts? 1 if yes, 0 if no.
MC_PATH=/home/minecraft
This is the path to your minecraft folder
SERVER_OPTIONS=""
This is where you would place any desired flags for running your server.
SERVER_OPTIONS="-XX:+UseConcMarkSweepGC -XX:+UseParNewGC -XX:+CMSIncrementalPacing -XX:ParallelGCThreads=2 -XX:+AggressiveOpts"
Modifications
SERVERMOD=0
If you are running hey0's servermod, this needs to be set to 1 (better logging and automatic updating of the mod)
RUNECRAFT=0
If you want your script to update runecraft automatically too, set this to 1
Backups
BKUP_PATH=$MC_PATH/backup
This is the path to the backup folder. Map backups and old log entries will go there.
BKUP_DAYS_INCR=3
How long will incremental map backups be kept? (Only used with the './minecraft.sh backup full' command)
BKUP_DAYS_FULL=3
How long will full map backups be kept? (Only used with the './minecraft.sh backup full' command)
BACKUP_FULL_LINK=${BKUP_PATH}/${WORLD_NAME}_full.tgz
Naming convention for full backups.
BACKUP_INCR_LINK=${BKUP_PATH}/${WORLD_NAME}_incr.tgz
Naming convention for incremental backups.
Logs
LOG_TDIR=/var/www/minecraftLogs
This is the path to the logs folder
LOGS_DAYS=7
How long will the logs be kept? (Only used with the './minecraft.sh logs clean' command)
Mapping
CARTO_PATH=$MC_PATH/carto
This is the path to c10t's cartography script
MAPS_PATH=/var/www/minecraftMaps
This is the path to the world maps folder
CARTO_OPTIONS="-q -s"
This contains all of the options you want when running cartography.
BIOME_PATH=/home/minecraft/BiomeExtractor
This is the path to MinecraftBiomeExtractor.jar
MCOVERVIEWER_PATH=$MC_PATH/Overviewer/
This is the path to Overviewer (gmap.py)
MCOVERVIEWER_MAPS_PATH=/var/www/minecraft/maps/Overview/
This is the location where Overviewer will render
MCOVERVIEWER_CACHE_PATH=/var/www/minecraft/maps/Overview/cache/
This is the path for the cache directory for Overviewer
MCOVERVIEWER_OPTIONS="--lighting"
This contains all of the options you want when running Overviewer.
Without arguments, the script will resume the server screen. (If you want to close the screen without shutting down the server, use CTRL+A then press D to detach the screen)
Tells you if the servers seems to be running, or not.
Starts the server. If you know your server is not running, but the script believe it is, use the force option.
Self explainatory
If the warn option is specified, it will display a warning 30s & 10s before the restart happens.
Parses logs into several files, grouped into a folder named with the date of the logging. If the clean option is specified, it will move the older folders into the backup folder. Again, this command should be issues before a server restart.
Note: If you run this command with Hey0, you will see a message that states something like: "Found a log lock : server_##########" This is not an error and just a notification message. Logs are being generated correctly.
Displays a message to the players if the server is online, stops the writing of chunks, create a dated archive and backs up the world folder. If the full option is specified, it will delete the older incremental and full archives based on the settings.
#####./minecraft.sh say "message" If the server is online, this will send the to all users via the console. If the message is not surrounded by either single or double quotes, only the first word will be sent.
Incorrect: ./minecraft.sh say This is a public message
Correct: ./minecraft.sh say "This is a public message"
If the server is online, this will send a whisper of to . If the message is not surrounded by either single or double quotes, only the first word will be sent.
Incorrect: ./minecraft.sh tell test_user This is a private message
Correct: ./minecraft.sh tell test_user "This is a private message"
This updates the offline folder to have the most recent information from the online folder This needs to be ran before you update any maps via the commands. The size of both folders will be displayed.
Displays a message to the players if the server is online, stops the writing of chunks, initiates c10t's cartography script. I strongly recommend the MAPS_PATH to be an internet public folder.
Displays a message to the players if the server is online, stops the writing of chunks, initiates Brownan's Overviewer script. I strongly recommend the MCOVERVIER_MAPS_PATH to be an internet public folder as well.
Running the extractor will update any biome information from new chunks.
Stops the server if it is online, backs up the old binaries, downloads the last binaries from minecraft.net and restarts the server.
- Bugfixes ?
- Better log parsing, this one is realy primitive
- Anything you could think of.