RemoteBukkit
RemoteBukkit
Plugin v4.0.0 - GUI v2.0.0 - Console v2.0.0
General
RemoteBukkit allows admins to, with the help of a plugin, remotely use the server's console. You do this by running a client on you computer and you provide this client with the hostname and port on which the RemoteBukkit plugin's server is running. Of course you will also need to provide the client with the server's username and password (set up in the plugin config file) for security.
So, provided the server has the RemoteBukkit plugin installed, admins can remotely use the Bukkit Console to control the server and execute Bukkit console commands server side.
RemoteBukkit does support multiple, simultaneous, connected clients.
News
Major Plugin Update v4.0.0
The latest plugin release (v4.0.0) adds support for CB v1.7.2.
Major Plugin Update v3.0.0
The latest plugin release (v3.0.0) adds support for multiple users.
Minor Plugin Update v2.5.0
The latest plugin release (v2.5.0) adds a number of highly requested features as well as a fix for a critical exploit.
Use
Plugin
Simply place the plugin in the standard Bukkit plugin directory and it will automatically generate its configuration the next time the server is run. The config file format is very simple, but offers several flexible options. The defaults are:
port: 25564 verbose: true logsize: 500 users: - user: username pass: password
All avaliable options and their descriptions are listed below.
Option | Default | Description |
---|---|---|
port | 25564 | The port on which the RemoteBukkit server will listen (this MUST be different to the Bukkit server's port number) |
verbose | true | Whether or not RemoteBukkit will produce verbose logging information (in the form "client X dispatched command Y"). |
logsize | 500 | The maximum number of log lines to send to a client upon successful connection. |
users | (list) | A list of the users which are permitted to connect to the RemoteBukkit server. The syntax for defining multiple user entries can be found in the example below. |
A more complex example configuration file can be found below (for demonstration purposes).
port: 6001 verbose: false logsize: 12 users: - user: escortkeel pass: secretpassword - user: bukkitserver pass: thepassword - user: minecraft pass: server
GUI Client
RemoteBukkit offers a very simple and easy to use GUI client which you can use to connect to the plugin. Just double click on the GUI's jarfile to run it. The GUI features a self-explanatory interface where you supply the hostname, port, username and password of the RemoteBukkit server.
Run the GUI with no arguments to open the Login Dialog. Run the GUI with the following arguments and it will attempt to use the supplied parameters to login automatically:
Use: [hostname:port] [user] [pass]
Switches
--help
- Prints this help message.
Console Client
If you prefer to use a console-based application to connect to the RemoteBukkit plugin you can too! The console argument syntax is very simple but the program but will print help information if you supply no/the wrong number of/invalid arguments:
Use: [hostname:port] [user] [pass] <switches>
Switches
--help
- Prints the help message.--nolog
- Instructs the server not to send any log information to the client.--exec <command>
- Sends <command> to the server and then terminates. Useful for scripts. Make sure that you surround commands containing spaces in inverted commas (e.g. "say Hello, World!").
Telnet Client (advanced)
RemoteBukkit also supports telnet connections. Just connect to the normal server port as you would with the console or GUI clients and then supply the server's username and then password on separate lines, followed by a third, blank line.
e.g.
$ telnet [hostname:ip] [user] [pass] [blank line]
Download
The latest plugin build can be downloaded here.
The latest GUI build can be downloaded here.
The latest console build can be downloaded here.
Latest Changes
Plugin v3.0.0
- Added multi-user support!
GUI v2.0.0
- Updated protocol version
Console v2.0.0
- Added
--nolog
switch - Updated protocol version
Planned Features
A standalone GUICompleted!Integration with BukkitGUI - With the help of BertwareCompleted!- Integration with RunBukkit - Another GUI for Bukkit which is not on BukkitDev (yet!)
How Can I Help?
This plugin is developed solely by me in my free time so:
- If you are a developer would like to contribute to this project, or any of my other projects, please PM me or email me at [email protected].
- If you are a not developer but would still like to contribute somehow, please consider donating. Donations are highly valued and much appreciated.
About
Developer: Keeley Hoek (escortkeel)
I like the plugin - used to hate the hassle of ssh connecting to my server. Only problem is, I'd like to see the little '>' thing in the remote console. It just seems like a bug to me. I don't know why. Also, I'd like to see that when i do 'say <message>' It doesn't do it twice. Just a note.
@tdktkd
You need to make sure that you put RemoteBukkitPlugin.jar in the plugins directory and not RemoteBukkitConsole.jar. Run the Console jarfile from the command line remotely.
@kdude63
Sure. That's a brilliant idea!
Really you didn't include the plugin.yml in the plugin...
So I installed the plugin, and it seems to be working fine. However, I can't get the console to run. It would be really nice if you could implement telnet or ssh access so I can use PuTTY instead of just the supplied console jar. :/
Android, but my other admin has an iPhone4, though admittedly he doesn't do alot by phone. Either one already has SSH clients. I have no need to switch.
I guess doing it in plugin form could work, if you somehow could install plugins but not have shell access, such as in a multiple server scenario. I'm not worried about it. I own my server, right down to the hardware level.
@bladedpenguin
The GUI will offer... well... GUI support :P. ATM it's a console app.
iOS or Android?
Oh. Well then. Have fun reinventing technology thats older than I am. :p
I already use encryption and regular expression based log parsing. Do you have a cellphone app? Cause I do most of my administration on the train.
What are you planning to do with your gui? the minecraft console is all text anyway....
@bladedpenguin
Bladedpenguin,
The thing is, the "trivial unix commands" you're talking about aren't known the the majority of users. Furthermore, most Bukkit users run the server on windows.
Plus, RemoteBukkit provides encryption and customizable switches which manipulate log output.
Finally, a standalone GUI is coming very soon (next week) and that simply isn't offered by "trivial unix commands".
Thanks, Keeley (escortkeel)
Ya know its basically trivial to set this up with basic unix commands? Theres plenty of startscripts out there that will do this for you....
@kdude63
@RSCArt
@sharf224
@huntsclan
@RedStoneBoss
@1Rogue
Good to go! Sorry that I've been dead for ages, exams are fun.
RemoteBukkit is now fully operational on the latest Bukkit server version. If you find any issues, report them on GitHub by clicking on the tickets tab!
We're back in business, Keeley (escortkeel)
You should really update this. I need a lightweight plugin that allows my admins to access the server console when I'm not here... :[
@RSCArt
I've had the same issue for a week now...can't get a working build for this plugin.
Is the download link broken? When i open i get 404 GitHub This is not the webpage you are looking for.
@arrongunner
Adminium is a really good iOS app.
Hey there, great plugin, but may i add that getting the RemoteBukkitConsole to run for me from a Command Line in Windows was
It didn't seem to work the way you recommended :/
Also, I keep getting an error when I tried to connect after disconnecting then reconnecting:
This plugin seems really easy to install and use unlike it's competition, however i would love to see and update and a iOS app, I would certainly pay for a easy to install app :)
Update??? This is a great plugin. It would be even better if it was updated.
@dxwarlock
Error occurred while enabling RemoteBukkit v1.1.8 (Is it up to date?)
Recent files: R: Console v1.1.8 for CB 1.1-R1 on 26 Jan 2012
Seem to be getting an error on startup. Running 1.1-Rb4 and Java 1.6.0_24