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:

Latest Release 0.2.8

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://user77@github.com/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.

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

• 

  • Reply
  • #127

  Chester007 May 02, 2013 at 23:07 UTC - 0 likes

  This is absolutely great. It's been really useful for me

  Have a nice day!

• 

  • Reply
  • #126

  roxor45 Apr 19, 2013 at 12:40 UTC - 0 likes

  @TnTBass: Go

  hi,

  but how to restart the server in command line with ABM ? what is the command to put inside the cron ?

  I test ./abm - -restart but doesn't work

  Last edited Apr 19, 2013 by roxor45
• 

  • Reply
  • #125

  mattmess1221 Apr 16, 2013 at 19:11 UTC - 0 likes

  Can you port this to byobu? It's the successor to screen and gives you system stats at the bottom of the screen.

• 

  • Reply
  • #124

  mikroskeem Apr 01, 2013 at 12:58 UTC - 0 likes

  i made Bukkit Launcher(silimar to your project) and it was removed...
  Moderator sayd "Ascii-Bukkit-Launcher was here before rule 'You can host here only Texture Packs, Plugins blahblahblah' was made".
  anyway, i prefer yours project to manage my server:).
  BUT i have some suggestions that you would make:
  - Add option how commands are inserted(conflicts with ConsolePlus plugin)
  - check why aren't arrow keys working
  - motd would be colored(console shows me "MOTD: &bMikroPeepCraft&f[&41.5.1&f](&bUus map&f)")
  - if i close abm and i re-open it, it says server is offline(really it isn't, i can insert commands and view output)

  Last edited Apr 01, 2013 by mikroskeem: i found one bug more

  There's no light if you don't make any

• 

  • Reply
  • #123

  jalandoak Mar 29, 2013 at 20:49 UTC - 0 likes

  I had a power outage and when the server reset, it reset with the world that's a week old. Where are the saves supposed to be kept, and how do I restore them? I thought ABM was supposed to keep the ramdisk and local disk in sync.

• 

  • Reply
  • #122

  Anabaric Mar 23, 2013 at 09:29 UTC - 0 likes

  Would it be possible to add a simple option to switch to a Vanilla "test server mode", during the inevitable delay between new bukkit patchs?

• 

  • Reply
  • #121

  TnTBass Feb 20, 2013 at 16:43 UTC - 0 likes

  @javieraizpuru: Go

  A cron job could do this for you, however, I highly suggest you look into finding out why you need to restart every 3 hours.

  BFAK:TnT,595,e6aa1b0d4b6749b31a920a21e29e4963f3e0541c6a639601a1288a6b06ab7407 My Server:
  

• 

  • Reply
  • #120

  javieraizpuru Feb 20, 2013 at 16:18 UTC - 0 likes

  Can i autorestart the server every 3 hours?

• 

  • Reply
  • #119

  user777 Feb 07, 2013 at 18:19 UTC - 0 likes

  @mormaii2: Go

  So you don't want logs? If your server is not running logs ABM will create the server.log if it's missing. But ABM itself doesn't log anything. Feel free to remove the log rotation. You can find that in /include/scripts/functions.sh

• 

  • Reply
  • #118

  user777 Feb 07, 2013 at 18:16 UTC - 0 likes

  @DerroteSturm: Go

  What version of screen you running? Must have vertical support for this to work.