Ascii Bukkit Menu
Ascii Bukkit Menu
What is it?
Ascii Bukkit Menu is a Bukkit server manager. Written with bash, designed to be simple and robust. Should work out of the box on most distros. Specificly designed to run on a headless server via a ssh session.
Features:
- Uses screen to keep server session running in background, can reconnect at anytime.
- Start/Stop/Restart commands.
- Send commands directly to bukkit server.
- Automatically update Bukkit server to latest recommended.
- Bukkit server log rotation. Rotates server.log on each start, keeps last 20 compressed.
- If using Ramdisks, will automatically copy worlds between ramdisk and localdisk. Then runs an md5sum to verify consistency of the data.
- Start and Stop server on boot using non-interactive mode.
See:
ScreenShots - Updated for 0.2.8
Download:
Dependencies:
- Java Runtime Enviroment http://java.com/en/download/manual.jsp
- bash http://www.gnu.org/s/bash/
- screen http://www.gnu.org/s/screen/
-Must have vertical support. (This is baked into debian based systems)
-Arch users try this package
-RHEL/CentOS use Git Souce | HowTo
- grep http://www.gnu.org/s/grep/
- wget http://www.gnu.org/s/wget/
- zip / unzip
- logrotate
- md5sum (optional)
- sysstat utilities (optional to see network usage)
- python (optional)
Install:
AutoMagic Method:
This will download and install ABM, then run an interactive script to setup the configuration.
No need to edit config manually.
Simply copy and paste the following to a bash shell.
wget http://dev.bukkit.org/media/files/667/24/install.sh && chmod +x install.sh && ./install.sh
Traditional method - zip:
wget http://dev.bukkit.org/media/files/667/23/abm-0.2.8.zip unzip abm-0.2.8.zip
Experimental Builds - git:
Not for the faint of heart.
git clone https://[email protected]/user77/Ascii-Bukkit-Menu.git
Usage:
To use ABM simply change to the directory you installed it to and run the abm.sh script.
cd Ascii-Bukkit-Menu ./abm.sh
You can also run in non-interactive mode. This can be added to startup scripts. Currently doesn't work if you are using a ramdisk
./abm --start ./abm --stop
Help:
First check to see you have the correct dependencies as listed above.
Make sure your user has +rx permissions to Ascii-Bukkit-Menu directory
chmod -R u+rx Ascii-Bukkit-Menu chown -R you:yourgroup Ascii-Bukkit-Menu
Issues:
Dosen't work on screen without vertical support.
This is very much a work in progress. So if you come across a bug, please open a ticket.
here.
@Bixter1
Please do, we'd be happy to take a look at it.
What a great script! I made some changes to functions.sh to get this to work on my Ubuntu box, run minecraft as a dfiff user, changed to rsync , added silent handling to start to handle ramdisk copying (updated stop too) and added some permissions things. It is earth shattering but I would be happy to send a patch if interested.
@boobert
Thanks boobert. I do have a backup script I wrote to do backups that are world edit compatible, as well as rsync to offsite backup. I will try to include this in the next release. Thanks for the feedback!
I came across this script while looking for something else. I wrote something similar. Just had a suggestion that you should add backup options to the script. I'm guessing backup could just be scripted but having it as part of your script might be nice. I use rsync to backup my world every 5 minutes and archive the world every few hours.
Nice script if I hadn't written my own already I would use it.
@wickersty
@wickersty. First off thanks for the feedback. Glad to see this is helping people. As for the ramdisks. ABM does not currently configure the disks for you. Perhaps in the future that is something that may be added. In the meantime however here is a great write-up on how to get them setup. http://bit.ly/smK9iR
Cheers!
@wickersty
ABM at this time does not setup or configure your ramdisk. However, if you have it setup, it will handle backing up the server upon every shutdown to a location of your choice. Upon start, it will copy those files from that backup location to the ramdisk location. It will also perform a MD5 check on the data to prove data consistency.
Do I need to set up any ramdisks myself before configuring ABM to use ramdisks, or does ABM configure and mount ramdisks for me? Also, does ABM take care of backing up ramdisk worlds upon server start/stop?
Thanks for the best server mangement sript/tool I've found yet :)