Ascii Bukkit Menu

ABM Logo (NEW)

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.


  • 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.


ScreenShots - Updated for 0.2.8


Latest Release 0.2.8



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 && chmod +x && ./

Traditional method - zip:


Experimental Builds - git:
Not for the faint of heart.

git clone https:[email protected]/user77/Ascii-Bukkit-Menu.git


To use ABM simply change to the directory you installed it to and run the script.

cd Ascii-Bukkit-Menu

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


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


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.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Yamakaky Yamakaky Mar 07, 2012 at 17:20 UTC - 0 likes

    It doesn't work...

  • Avatar of TnTBass TnTBass Mar 06, 2012 at 22:58 UTC - 0 likes


    #Absolute path to your bukkit installation. Example:

    # Java Arguments, change to whaever you like.
    # For a complete list, please see:
    jargs="-server -Xincgc -Xmx1536M"

    # Set Status Refresh rate in seconds.

    #Are you using a ramdisk? if so change to true. See for more info.

    #If True, set world names with space between.
    worlds=(  )

    #NIC To use for SAR

    Last edited Mar 06, 2012 by TnTBass


  • Avatar of Yamakaky Yamakaky Mar 06, 2012 at 22:19 UTC - 0 likes

    Can you give the config file synthax ?

  • Avatar of TnTBass TnTBass Mar 06, 2012 at 14:43 UTC - 0 likes

    @Yamakaky: Go

    I noticed the same. This will be fixed in the next release.

    You can edit the file manually for now after the installation is complete (I agree that its a redundant step that is... redundant)

  • Avatar of Yamakaky Yamakaky Mar 05, 2012 at 07:40 UTC - 0 likes

    Hi I used MapPort to install all type dependencies, the ABM installation command works, ABM is installer and launched but I have still a problem : the config file isn't saved at the end of the config script, so that I can't use the mod, it always says me config file doesn't exist. Can you help me ?

  • Avatar of blakesteel blakesteel Mar 04, 2012 at 04:29 UTC - 0 likes

    You can swap out the performBackup method from my abm-new-v1-1 with something simpler like this:

    backupWorld() {
       echo "Backing up $1"
       as_user "tar -cf - $1 | pv | gzip - > $BACKUP/$1.tgz"

    backupService() {
       echo "Backing up craftbukkit.jar"
       as_user "cp $bukkitdir/craftbukkit.jar $BACKUP/craftbukkit.jar"
       echo "Backup complete"

    performBackup() {
            PATHDATE=`date "+%Y.%m.%d_%H.%M"`
            mkdir $BACKUP
            backupWorld $WORLD
            backupWorld $WORLDNETHER
            backupWorld $WORLDEND

  • Avatar of blakesteel blakesteel Mar 04, 2012 at 03:40 UTC - 0 likes

    I went ahead and modified ascii-bukkit-menu some and added the following features:

    --status - this will print out running or stopped to let you know the state of your server
    --restart - allows you to restart your server
    --backup - performs a backup of your world and bukkit jar

    And, I created a and placed it in the Ascii-Bukkit-Menu path and chmod +x it. This recovers from a crash and brings the server back up if you call it in a cron job. You can set up a cron job by typing: crontab -e

    And then paste the following to give it a 5 minute interval check (this is lightweight since it only does a --status, which will only check the pid if it is still running):

    */5 * * * * /home/USERNAME/Ascii-Bukkit-Menu/

    I'll go ahead and zip it up and make it available for anyone who wants to try out my changes. You can just drop and in the scripts dir and overwite your with mine, and drop in the same dir as Just make sure to edit each and every one of these scripts and change the path to your own.

    Here are my changes...

    It was based on the previous version of ABM, I haven't updated it for 0.2.5 yet.

    Last edited Mar 04, 2012 by blakesteel
  • Avatar of user777 user777 Mar 04, 2012 at 03:19 UTC - 0 likes

    New Version is out 0.2.5.

    Just wanted to say thank you to everyone for you patience. I've been crazy busy as of late. To those of you who have given suggestions both for feature updates and fixes Thank You! I have implemented a lot of bug fixes based on user feedback. I will also be working on some of those feature requests. So as long as they make sense I'll try to get them in here. I currently have some backup scripts I use on my own server that I'm going to include. There are a few new items I have in the works as well.

  • Avatar of user777 user777 Mar 03, 2012 at 20:42 UTC - 0 likes

    @TnTBass: Go

    There should be no issues running this on a mac, provided you have the dependencies. Check here for the deps.

  • Avatar of user777 user777 Mar 03, 2012 at 20:40 UTC - 0 likes

    @megge208: Go

    You mean restart the bukkit server? You could accomplish that with a cron job. I suppose I could add something like that if there is a demand for it.


Date created
Nov 14, 2011
Last update
Jan 22, 2013
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Ascii Bukkit Menu
Recent files


  • Avatar of user777
    • Manager
    • Author

  • Avatar of TnTBass
    • Tester
    • Ticket Manager
    • Documenter
    • Contributor