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.
Anyone know how to make this work with 1.7.2? The main issues is the server logs have moved.
helo, i have a problem, when i start abm, i need every time make the config, i launch the abm.sh, but i need make config :/
Has anyone managed to get this to work on Scientific Linux 6.X?
I made russian localization, enjoy)
http://dev.bukkit.org/bukkit-plugins/ascii-bukkit-menu/tickets/24-russian-localization-i-made/
This is absolutely great. It's been really useful for me
@TnTBass
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
Can you port this to byobu? It's the successor to screen and gives you system stats at the bottom of the screen.
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)
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.
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?
@javieraizpuru
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.
Can i autorestart the server every 3 hours?
@mormaii2
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
@DerroteSturm
What version of screen you running? Must have vertical support for this to work.
Hey guys, wonderful work! Sadly the layout is broken every time i reattach -.- is there a fix?
@TnTBass
A friend of mine helps me manage my server in which I have several people. I use crazylogin with encripted passwords. I am the one who runs the server but he has access to files too so he could check the server.log the players use and log in as them or even me to cause havoc. That's why I've been using a logless server so far and it works wonders but now I want to use this one and I'm having trouble :/
@mormaii2
Not currently. ABM uses the log for detecting a few things. However, it does rotate the logs automatically for you.
What is your concern about logging?
@KardonGER Thanks, I have also seen that issue with the restarts. I'll add it to the bug list.
As for making it scroll-able, it actually already is.
To scroll in the Log do the following:
Great screen cheat sheet here -> http:arundelo.livejournal.com/390.html
@TnTBass
The thing is that the restart was working well as i started using ABM and since a few days it is broken. But i haven't installed any new plugins or something.
@KardonGER
I created a ticket based on your report.
http://dev.bukkit.org/server-mods/ascii-bukkit-menu/tickets/21-hello-i-first-have-to-say-that-this-menu-is-r/
Can I get a bit more information? What ABM version are you using? Do you see any hs_pid files in your directory? What OS are you using?