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)
maybe smartphone/tablet support? maybe? =) please =)
i'm using linix mint 15 to connect to my server using the java GUI it does not seem to save the server settings even if i click the box so i have to type the ip each time not a massive problem but is anyway to fix this or run a scrip to automaticlly insert my server ip port, user and pass dont really understand linux very well at the moment
blank console on gui HELP no commands work, its like its not talking to the server
HOOO ... why I have Incorrect credentials. now??
I why I have invalid credentials. please?
thanks
@escortkeel
I have the same problem as joybab3. I'm using putty to access via telnet. Correct username on first line, correct password on second line, but as soon as I hit enter after the password it shows invalid credentials.
Any thoughts?
@joybab3
You are entering the wrong username/password combination! :P
whenever i try to connect it sutomatically says failed to connect becayse invelid credentials...
@Brixishuge
Hi Brixishuge! :)
First, thanks for your interest in the project! :D
So basically, RemoteBukkit is client/server based. You need the plugin running on the server (as a normal Bukkit plugin) and a version on the client on another machine. All versions of client or server software are platform independent (you just need Java install on your machine). The RemoteBukkit plugin runs a "text server" alongside the Minecraft server, so you need to port-forward the port which you choose in the RemoteBukkit config file (default 25564).
After this set-up, it's as easy as just starting the Bukkit server and connecting using one of the client types which are offered.
Of course, you'll want to change the default credentials for security reasons. To do that, just change the words after "user:" to the new username (defaults to "username") and the words after "pass:" to the new password (defaults to "password"). And then you should be good.
RemoteBukkit offers several other options other than those listed above, but these should be enough to get you started. :)
Regards,
Keeley
@escortkeel
Can't understand what it actually does and how it works. Is this working with centOS? Do I need to add any lines to my shell script? How does it access to screen? (I'll use gui from windows, but server is on centOS machine)
Best regards.
@justcool393
Hi justcool393!
I've added the feature you proposed over GitHub in plugin v3.0.0 (as per my reply). Enjoy!
~
Keeley(P.S. It may take several hours for the BukkitDev staff to approve my files and display them on this page.)
@cjoenic
Hi cjoenic!
In RemoteBukkit plugin v3.0.0, that feature has been added! (along with lots of others). Enjoy! :)
~
Keeley(P.S. It may take several hours for the BukkitDev staff to approve my files and display them on this page.)
@rudolf323
No, it isn't.
@OMGguy18
You have to make sure that you don't supply the port number of the minecraft server, but instead the special RemoteBukkit port (by default 25564).
@rudolf323
im sorry, but there are many 1.5.1 updates. How could this be "out of date"??
@OMGguy18
This plugin is out of date...
I connect, and all thats there is a black screen with a bar to type stuff in, but it does nothing.
Host doens't work. What is a host for Other people?
@rudolf323
Got a stacktrace/can you describe the problem further? I'd be happy to help.
Please post all of your issue info here. I'll be notified immediately.
Thanks, Keeley
Not working on 1.5.1 R.2