Skip to content
This repository has been archived by the owner on Mar 22, 2019. It is now read-only.

user77/Ascii-Bukkit-Menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

     _             _ _   ____        _    _    _ _     __  __                  
    / \   ___  ___(_|_) | __ ) _   _| | _| | _(_) |_  |  \/  | ___ _ __  _   _ 
   / _ \ / __|/ __| | | |  _ \| | | | |/ / |/ / | __| | |\/| |/ _ \ '_ \| | | |
  / ___ \\__ \ (__| | | | |_) | |_| |   <|   <| | |_  | |  | |  __/ | | | |_| |
 /_/   \_\___/\___|_|_| |____/ \__,_|_|\_\_|\_\_|\__| |_|  |_|\___|_| |_|\__,_|

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:

ScreenShot

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
grep http://www.gnu.org/s/grep/
wget http://www.gnu.org/s/wget/
zip / unzip
logrotate
md5sum
sysstat utilities (optional to see network usage)
python 2.x (option to see player list)
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/666/822/install.sh && chmod +x install.sh && ./install.sh
Traditional method - zip:

wget http://dev.bukkit.org/media/files/666/820/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

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

cd /opt/craftbukkit/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.

    Copyright (C) 2013 

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.


Releases

No releases published

Packages

No packages published