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 completely forgot that you can just use the console client after you log in with ssh, so it will be encrypted anyway. Thnx for this great tool :)
@MathijsNL
Hi mathijsNL! :D
At the moment, no there is not. However, there is very little call for encryption of server logs. And, unless you are accessing the server through a packet-snooping gateway, there is virtually no need for secure authentication.
I would be happy to implement this feature, but what would it's point really be? I you have a good reason, I'll code it up straight away (probably via SSH).
Thanks,
Keeley :D
How about the security in this plugin? Any encryption? And if so: wich one?
greetz
@Mazgula
GUI v1.2.0 is out! It contains the two features you requested! :D
You can get it here.
~
Keeley :D@HomeDipo
No, you can't use RemoteBukkit if you cannot port forward. :(
@escortkeel
So this plugin is only usable for non-remote servers then, or are there any remote servers that allow you to port forward?
Cheers.
@HomeDipo
Hi 2Beastmode4u! :D
I'm just going to go ahead and answer all of your questions using random statements... ;)
You put the port that you've set in your RemoteBukkit config file. That port must be different to your server's port. The default is 25564, one less than the default Minecraft server port of 25565. You must port forward your RemoteBukkit port as well, just like you do with the server port.
To connect using putty, you must connect via RAW to the remotebukkit port and then:
Then wait for the login message.
If you can't port-forward any ports on your remote host's server, you can't connect. :( I would email them and see what they could do.
Hope I've helped, Keeley :)
I am wondering what port I put in the gui? And if its the default port do I port forward something or can I just use the port the server uses? Also how would I connect using Putty?
Also, is this plugin usable if I am using a server from a provider like Xenon Servers? I can't port forward there so I have no idea how I'd connect to console.
Cheers.
@Mazgula
Yeah, sure! I'l make it so it auto-focusses the input text field only when the window gains focus. That way, I you want to highlight part of the console log, you can still manually click in the console box. ;)
~
Keeley :)@escortkeel
Sounds good... I was thinking a possible issue that might arise from the click-focusing is that I won't be able to copy text from there anymore, that's a feature I like over the dos console so if you could keep that at the same time as well that would be excellent
(: Maz
@Mazgula
Hi Maz! :D
Thanks for the positive feedback! :)
I'd be happy to add those features tomorrow (its like 10pm where I live right now). Check back in a day for GUI v1.6.0. ;)
Thanks,
Keeley :D
escortkeel: Top-notch plugin, very useful for me so I can stop using my VNC wasting bandwith just to access my console. Thank you very much for your excellent hard work. A couple things I can think of, matters of convenience, for the GUI jar, can you add it to repeat last commands with the up arrow? And the other thing is, when i click the GUI jar anywhere to focus to the text input box.
Cheers
Maz
@coolo1
Yes, but you'd have to send the username, and then password, as the first line and second lines, in order to authenticate.
@escortkeel
Can I use this to connect via telnet to my server on say, my iphone?
@coolo1
How do you mean?
Does this support telnet?
could i use this to run the server off someone else's pc??
@lacrosse1991
Hi lacrosse1991! :D
By reload do you mean "/reload" or a full Bukkit server stop and then start? :)
~
Keeley@cxh012
Hi cxh012!
That message means that you've supplied either an invalid username or password to the client.
~
Keeley :)Incorrect Credentials. Server Run: Win 2008 R2 Jre7 How to solve?