Ascii Bukkit Menu

Table of Contents

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.

Comments

_ForgeUser7769550
- Join Date: 10/27/2011
- Posts: 9
- Member Details
#111 _ForgeUser7769550

View User Profile

Send Message

Posted Jan 31, 2013
Hello, I first have to say that this menu is really great. it makes the administration much easier and has a great overview about server. There are only two things that i want to ask you for.

1th i always get an error message if i'm restarting the server and it stops after shutting down. i always have to start it by myself a second time to make run again. Sorry i've now realised that this is no error message... but the problem with the restart still exists.

2nd is it possible to make the screen "log" scrollable?? For example if u are using any "help" command of a plugin u will get the complete help list and it often can not show all commands.

Would be great if you could give support at these things.

reagards KardonGER

Last edited by _ForgeUser7769550: Jan 31, 2013

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#110 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 30, 2013
@mormaii2

The annoying message you speak of is probably missing dependencies, see above.. You can always comment out the one you are missing in the functions.sh file. Look for the depcheck function. Or just install what is missing. As for your second issue, the screen config is setup to always focus on the "menu" section of the 3 screens as this is the only interactive part. The other two screens "log" and "server status" are just displaying info. However as TnT suggested screenshots would really be of help here. Cheers

Rollback Post to Revision RollBack
_ForgeUser5803084
- Join Date: 10/12/2010
- Posts: 114
- Member Details
#109 _ForgeUser5803084

View User Profile

Send Message

Posted Jan 26, 2013
@mormaii2

Screenshot both problems please.

Rollback Post to Revision RollBack
_ForgeUser3401813
- Join Date: 10/17/2009
- Posts: 174
- Member Details
#108 _ForgeUser3401813

View User Profile

Send Message

Posted Jan 26, 2013
@user777

Ok I upgraded it. Now I have two problems. The first being that I get greeted with an annoying message and have to press enter everytime I start screen. The other one being that the new screen no longer shows which screen I'm on while I use putty. Any fixes for this please? :/

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#107 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 24, 2013
@mormaii2

What OS are you on? If you are on a RHEL based system. RHEL, CentOS, Oracle Linux. Then these steps should get you going with the correct version of screen. You might want to uninstall the current version on your system in favor of the one below. You will need gcc and some other deps to compile the software. The ./configure will tell you what you are missing.

$ git clone git://git.savannah.gnu.org/screen.git $ cd screen $ ./mktar.pl $ tar zxvf screen-4.1.0.tar.gz $ cd screen-4.1.0 $ ./autogen.sh $ ./configure $ make

Then as root:

# make install

That's it, you should have the correct version of screen.

Cheers
Last edited by _ForgeUser7863716: Jan 24, 2013

Rollback Post to Revision RollBack
_ForgeUser3401813
- Join Date: 10/17/2009
- Posts: 174
- Member Details
#106 _ForgeUser3401813

View User Profile

Send Message

Posted Jan 23, 2013
@TnTBass

How do I do that? :/

Rollback Post to Revision RollBack
_ForgeUser5803084
- Join Date: 10/12/2010
- Posts: 114
- Member Details
#105 _ForgeUser5803084

View User Profile

Send Message

Posted Jan 23, 2013
@mormaii2

You need to enable vertical support for screen.

Rollback Post to Revision RollBack
_ForgeUser3401813
- Join Date: 10/17/2009
- Posts: 174
- Member Details
#104 _ForgeUser3401813

View User Profile

Send Message

Posted Jan 23, 2013
@TnTBass

I choose an option and nothing happens

http://i.imgur.com/4qQcYdL.png

Rollback Post to Revision RollBack
_ForgeUser5803084
- Join Date: 10/12/2010
- Posts: 114
- Member Details
#103 _ForgeUser5803084

View User Profile

Send Message

Posted Jan 23, 2013
@mormaii2

Can you screenshot that problem?

Rollback Post to Revision RollBack
_ForgeUser3401813
- Join Date: 10/17/2009
- Posts: 174
- Member Details
#102 _ForgeUser3401813

View User Profile

Send Message

Posted Jan 23, 2013
@user777

Bukkit works perfectly for me. The problem is that when I try to use Ascii Bukkit Menu. When I start it and it goes to screen and the bottom says bukkit_log and there are several options. I hit for example 1 (1: start) and I don't get any error messages or anything and it won't start :/

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#101 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 23, 2013
@mormaii2

@mormaii2 So you are unable to start and stop bukkit? Are any errors given? Is your bukkit directory properly defined?

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#100 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 23, 2013
@bob7l

Thanks bob.

Yeah a gui would be great, but kind of defeats the purpose. However I have played around remote interface other than ssh. May offer some remote connectivity in the future.

Rollback Post to Revision RollBack
_ForgeUser3401813
- Join Date: 10/17/2009
- Posts: 174
- Member Details
#99 _ForgeUser3401813

View User Profile

Send Message

Posted Jan 22, 2013
I start up ABM but when I choose an option on the interactive menu nothing happens :/

Rollback Post to Revision RollBack
bob7l
- Join Date: 2/7/2012
- Posts: 1,415
- Member Details
#98 bob7l

View User Profile

Send Message

Posted Jan 22, 2013
Great job! You should add a GUI, it's very easy with todays API!

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#97 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 22, 2013
@Kugane

Are you looking for startup scripts to bring it up with say runlevel 3?

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#96 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 22, 2013
@meuced

Yeah MineQuery is now gone as of 0.2.8 deprecated in favor of the built in bukkit query system.

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#95 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 22, 2013
@DjinnWraith

Thanks. So I replied to TnT's reply, wasn't sure if you would get notified.

As for multiple servers, yeah think we can do that pretty easily. I know it's already on TnT's radar so that means it should be added soon :>)

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#94 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 22, 2013
@diagofox

Looks like there may be an issue with your config. I suspect it doesn't know where it's installed to. check the abmdir= variable on the config and scripts. Or better yet maybe just delete your ABM/include/conf/abm.conf and write a new one and pay close attention to the install dir of ABM.

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#93 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 22, 2013
@An___Idiot

Does it take a long time when not using ABM? There has been a lot cleaned up since 0.2.7. Maybe give 0.2.8 a whirl? Let me know if it's still slow. There are many factors involved there. Which is why I test on a couple of development boxes rhel and debian based. We also run it on a production server for real world results. But am always looking for feedback on how it runs on other systems.

Rollback Post to Revision RollBack
_ForgeUser7863716
- Join Date: 11/14/2011
- Posts: 30
- Member Details
#92 _ForgeUser7863716

View User Profile

Send Message

Posted Jan 22, 2013
@TnTBass

Acutally further to TnT's comment. Should work fine if you just change the following line.

Ascii-Bukkit-Menu/include/config/vars # craftbukkit cbfile=craftbukkit*.jar

and change that cbfile= to whatever jar you need.
Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

33842
Created

Nov 14, 2011
Last Released File

Jan 22, 2013
Total Downloads

73,609
License

GNU General Public License ver...

Bukkit

Ascii Bukkit Menu

Bukkit Plugins