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 Xenocide122 Xenocide122 Apr 01, 2014 at 04:10 UTC - 0 likes

    @TnTBass: Go

    I followed your instructions but I guess I am doing something wrong, when I start ABM i get an error stating -Dlog4j.configurationFile=/location/of/my/server/log4j2.xml The file or directory does not exist.

  • Avatar of TnTBass TnTBass Jan 25, 2014 at 04:28 UTC - 0 likes

    @TheRedHun1: Go

    Please see this comment:

    That will solve your log problems.


  • Avatar of TheRedHun1 TheRedHun1 Jan 24, 2014 at 06:29 UTC - 0 likes

    I tried this out, hoping for a working restart script, and it works. I thank you so very much for it. There is one small issue though with the server log. It fails to load the server log every time and says there is no server log in the directory. Other then that issue, it works perfect. Could you also add the ability to schedule saving on lie a 10 minute interval?

  • Avatar of TheTallest TheTallest Jan 18, 2014 at 05:30 UTC - 0 likes

    @TnTBass: Go

    I will try to run it there. The last time I Put it there the server gave me the middle finger. Maybe I fat fingered it some how.....

    EDIT: I guess I did fat finger it. All is working now except I cannot see anything being presented in the players line it says players [/] << does not display how many players are online. That could be my issue because no matter what I put in for the NIC it does not accept it sar=I have tried ETH0 eth0 and so on.

    Last edited Jan 18, 2014 by TheTallest
  • Avatar of TnTBass TnTBass Jan 17, 2014 at 15:38 UTC - 0 likes

    @TheTallest: Go

    This is how I have it on one of my servers and it works like a charm:

    # Java Arguments, change to whaever you like.
    # For a complete list, please see:
    jargs="-server -Xmx1536M -Dlog4j.configurationFile=/opt/blackdamp/log4j2.xml"
  • Avatar of TheTallest TheTallest Jan 17, 2014 at 07:01 UTC - 0 likes

    @TnTBass: Go

    Yeah but Where in the abm.conf file do you place that line. I do not see any where you can post that line to make it work ? Please point out where we should place this line.

    If you saying place it here

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

    I tried placing it there and it freaked out my server on start up. Could please point where this should go.

  • Avatar of TnTBass TnTBass Jan 12, 2014 at 17:36 UTC - 1 like

    @TheTallest: Go @Sygaro: Go

    Actually, that's a sub optimal way of doing it as there is already a config file you can use. I'm reposting my instructions with a bit of clarification (because I want this front and center for people using ABM).

    Since Ascii Bukkit Menu already rotates logs, the new logging changes introduced in Minecraft 1.7 were causing problems with the intended functionality. Hence, here's how you can get ABM working for you again with minimal effort.

    • Create a file in your server directory. Name the file log4j2.xml
    • Add this to your start line for your server (you can change this in the abm.conf file located in ABM/include/config/abm.conf):
    -Dlog4j.configurationFile=<path to server directory>log4j2.xml
    (Example: -Dlog4j.configurationFile=/opt/blackdamp/log4j2.xml )
    • Launch Ascii Bukkit Menu. server.log is now returned to the root of your server folder and Ascii Bukkit Menu functions as it used to.
    Last edited Jan 12, 2014 by TnTBass
  • Avatar of Sygaro Sygaro Jan 12, 2014 at 14:17 UTC - 0 likes

    Thank you, it's working now :D

  • Avatar of TheTallest TheTallest Jan 12, 2014 at 12:32 UTC - 1 like

    @Sygaro: Go

    It is in your functions file. It took me a few minutes to find it myself but in that file look for the following line # Find PID of Bukkit Server right below you will see see this bukkitPID=`ps -ef |grep "java $jargs -jar $bukkitdir/craftbukkit" | grep -v grep | awk '{ print $2 }'` Put your start up parameter after craftbukkit but inside the quotes other it will get ignored. I Hope this helps.

  • Avatar of Sygaro Sygaro Jan 12, 2014 at 11:06 UTC - 0 likes

    Hi, I’m struggling to find where I should place the startup parameter. Which file should it be in and where in that file? I have tried to search for it in ../include/scripts/ but can’t find where the startup parameter should be. Please advise.


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