Bukkit

====ConvoSync====

Version: 1.0.2

From 1.0.1 on, the CS plugin and server are in the same jar: Just copy the jar and use one copy as the server and the other as the plugin.

ConvoSync is comprised of two main parts, the ConvoSync plugin and the ConvoSync server. The plugin will connect to the server, and allow the Minecraft server it's on to communicate with all other Minecraft servers that are connected to that ConvoSync server.

Setting up the ConvoSync server:

This should be done first. I recommend running it from a batch file (or your OS's equivalent) like this:

java -jar "ConvoSyncBundle.jar" Port:25000 Name:Blir PluginPassword:asdf ApplicationPassword:1234 server
pause

Replace "25000" with the port you want to host the ConvoSync server on. Replace "Blir" with your name (or exclude the argument entirely and it will use a default name of "ConvoSyncServer"(this is used to identify the server in chat)). Replace "asdf" with the password that ConvoSync plugins will use to connect to your ConvoSync server. Replace "1234" with the password that ConvoSync GUI clients will use to connect to your ConvoSync server. The "server" just indicates that you wish to launch the ConvoSyncServer as opposed to the GUI client. If you do not include the port or passwords, the program will ask for them on start-up. If you include sufficient arguments, it will get up and running immediately without prompting you for anything.

You may also view all of the server commands here.

Setting up the ConvoSync plugin:

ConvoSync grabs all its information from its config.yml file: The IP and port to connect to, and the password to use to authenticate its connection. There's also a lot of configurable options, like cross-server AFK notifications and death messages, and automatic reconnection. Here's the format of the file:

port: 25000
ip: X
password: X
#If this many players are on the server, it will not sync chat with the other servers.
max-players: 25
#If true, players from other servers can execute commands on this server
#via /ccmd, if they have permission to.
#Careful! If you allow cross-server commands, a player that has the permission
#to use this command on another server can execute any command on this server,
#as the plugin must assume that the sender is OP.
allow-cross-server-commands: false
notif:
  #If true, player death messages will be displayed cross-server.
  player-death: false
  #If true, AFK notifications will be displayed cross-server.
  #This is experimental;
  #sometimes AFK notifications may be displayed when they shouldn't.
  afk: false
auto-reconnect:
  after-socket-close: false
  after-socket-error: true
  after-connect-fail: true
  #This is in milliseconds, so 30000 ms is 30 seconds.
  time-delay-ms: 30000

The ConvoSync plugin will automatically attempt to connect to a server on start-up. Once connected and authenticated with the plugin password, it will be able to chat with other Minecraft servers connected to that ConvoSync server.

Here are all of the plugin commands.

To set the server name for cross-server chat, add this line to your server.properties file:

server-name=Blir's Server

Except with the name of your server in place of "Blir's Server", of course.

Using the GUI client:

The GUI client may be used to chat with players on a server connected to a ConvoSync server. You must know the application password set by the server to do so. You can run it from a batch file (or your OS's equivalent) like this:

java -jar "ConvoSyncBundle.jar" IP:127.0.0.1 Port:25000 Password:oops Name:Blir application 
pause

Replace "127.0.0.1" with the IP of the ConvoSync server you wish to connect to, and "25000" with the port that the ConvoSync server is hosted on. Replace "oops" with the application password to connect to that server, and "Blir" with your name. The "application" argument just specifies that you wish to run the GUI client rather than the ConvoSync server.

Or, you can just run the jar directly with Java. A window will ask you whether you want to run the ConvoSync server or GUI client. Click GUI client, and it will then ask for the information it needs to connect: The IP, port, application password, and your name.

Notes:

• Make sure to always use a plugin and server of the same version. Different versions may not be compatible.