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)
@Elffuhs
maybe use ftp is better
Is there anyway to stop the plugin from printing: [RemoteBukkit] Connection #X from XX.XXX.XXX.XXX:XXXXX was accepted. [RemoteBukkit] Connection #X from XX.XXX.XXX.XXX:XXXXX was successfully established.
I have a problem. My server has stopped (lag) when I try connect to bukkit. I have to close GUI and start it again and after connect to server, he has to be restarted.
Any log, just:
It happens second time and I'm suer it isn't error from ANY of plugins on my server.
CraftBukkit: #2624 rec.
I don't think this is the right place to ask features, so if it isn't, i'm sorry for that. I would like to know, if it would be possible, to add a functionality, to send plugins to the server, via the remote bukkit. That would be awsome. Keep the good job, and thank you very much
@dylqueer
You're putting the wrong .jar in the plugins folder. There are three .jars, two of them are client programs, and the third is a plugin.
Jar does not contain a plugin.yml so bukkit cannot run it
Compile the plugin with Java 6 please? My server doesn't really like Java 7.
@escortkeel
Can't update to Java 7... Well, I can. But whenever I launch my server, it keeps launching with JRE 6. If I get rid of JRE 6 and just leave files for JRE 7, terminal says Java isn't installed.
Specs:
iMac 21.5"
OS X Mountain Lion (10.8.2)
Intel i7 Quad-Core Processor
8GB RAM
@midbifroid
Happening to me too D:
Yesterday I updated java for x32 and x64 both, I shoulnt have java errors
2013-01-30 16:22:40 [SEVERE] Could not load 'plugins\remotebukkitconsole-2.0.0.jar' in folder 'plugins' org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPluginLoader.java:247) at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:132) at org.bukkit.craftbukkit.v1_4_R1.CraftServer.loadPlugins(CraftServer.java:239) at org.bukkit.craftbukkit.v1_4_R1.CraftServer.<init>(CraftServer.java:217) at net.minecraft.server.v1_4_R1.PlayerList.<init>(PlayerList.java:52) at net.minecraft.server.v1_4_R1.DedicatedPlayerList.<init>(SourceFile:11) at net.minecraft.server.v1_4_R1.DedicatedServer.init(DedicatedServer.java:104) at net.minecraft.server.v1_4_R1.MinecraftServer.run(MinecraftServer.java:399) at net.minecraft.server.v1_4_R1.ThreadServerApplication.run(SourceFile:849) Caused by: java.io.FileNotFoundException: Jar does not contain plugin.yml ... 9 more
i would suggest an option to limit log line count sent to console, because sometime it would take too long just to initialize the console client, its like downloading the whole log.
@D1G1T4L3CH0
Long story short, there isn't. :P
If you are executing a single console command using a bash script, consider using the
--exec
switch. It will connect, send the command, and then gracefully exit.If the
--exec
switch doesn't fit your circumstances, get back to me and I will implement a solution.Hey. Thanks for the plugin. It makes life easier. I have a question though. What is the proper way to exit or close the console?
I know CTRL+C works, and if you are in a GUI environment, just clicking the X will do it. But I'm running it in a CLI and starting it with a script. When I do CTRL+C on it, I get an exit code of 130 which is telling me it was exited by CTRL+C.
I would like to check if the exit code is zero or non-zero in order to determine if there was a problem. But with it giving me a 130 every time, the script keeps telling me there was an error. I'm sure I can work around this, but I just thought, there must be a proper way to close the console...
@OMGguy18
Hi OMGguy18! :)
You are running an old (and now obsolete) version of Java. Please update to Java 7.
Thanks for using RemoveBukkit,
Keeley :)
Im running the latest (2.0.0) and the plugin won't load on my 1.4.7-R0.1 beta server...
Heres a log of whats being outputted:
Please help, thanks :)
@Severy
Thanks! :) So all of your issues have been resolved now?
@escortkeel
its weird.
I was trying to login from the same computer the server was running on last night, and that gave me the login problems.
I just tried it from my home pc and that did work.
No problems at all so i think the plugin has difficulty accepting connection from the same computer the server is running on.
Works like a charm now. Very nice plugin :)
@escortkeel
i tried it with various combinations.
Last time i tried it with the default
username password
but that didnt work either
in the server console i can see the attempt to login. The client is conenct succesfully, and then i get the message: wrong login credentials, The next line says connection closed.
@Severy
Hi Severy! :)
Could you me give a username + password combination which I can use to your issue?
Thanks,
Keeley
Doesnt seem to work for me.
Whenever i try to log in with the gui or the console, it tells me access denied.
Doesnt matter what i put in the xml file for the username and password.. i cant login because my username and password are incorrect.
What is going on?