Ascii Bukkit Menu
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:
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://[email protected]/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.
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
@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
@mormaii2
Screenshot both problems please.
@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? :/
@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.
Then as root:
That's it, you should have the correct version of screen.
Cheers
@TnTBass
How do I do that? :/
@mormaii2
You need to enable vertical support for screen.
@TnTBass
I choose an option and nothing happens
http://i.imgur.com/4qQcYdL.png
@mormaii2
Can you screenshot that problem?
@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 :/
@mormaii2
@mormaii2 So you are unable to start and stop bukkit? Are any errors given? Is your bukkit directory properly defined?
@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.
I start up ABM but when I choose an option on the interactive menu nothing happens :/
Great job! You should add a GUI, it's very easy with todays API!
@Kugane
Are you looking for startup scripts to bring it up with say runlevel 3?
@meuced
Yeah MineQuery is now gone as of 0.2.8 deprecated in favor of the built in bukkit query system.
@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 :>)
@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.
@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.
@TnTBass
Acutally further to TnT's comment. Should work fine if you just change the following line.
and change that cbfile= to whatever jar you need.