CommandSync 2.8.2

Unofficial update

  1. glavrak
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    • 1.17
    • 1.18
    Source Code:
    https://github.com/SawFowl/CommandSync
    Contributors:
    YoFuzzy3
    Languages Supported:
    ru_RU, en_US
    I just got tired of waiting for the official support of PaperSpigot core and I decided to do it myself.
    After the changes I made, I decided to put it in open access.
    Original plugin ---> Link.

    Please tell me on which versions you have successfully launched this plugin.

    Supported proxy:
    - Velocity(plugin version 2.8+)
    - BungeeCord(max plugin version 2.7 or use Velocity/WaterFall)
    - WaterFall
    - Other BungeeCord forks
    Supported servers:
    - SpongeVanilla/SpongeForge API 7/8
    - Bukkit, Spigot, PaperSpigot etc. Theoretically can work on ForgeBukkit servers(not tested).


    Installation
    1. Read this entire post before installing.
    2. Download the jar file.
    3. Stop your BungeeCord server, if it isn't already.
    4. Put the CommandSync.jar file in your BungeeCord's plugin folder.
    5. Start your BungeeCord server.
    6. Stop your BungeeCord server.
    7. Set the pass in the <BungeeCord>/plugins/CommandSync/config.txt.
    8. Start your BungeeCord server.
    9. Stop your Minecraft servers, if they aren't already.
    10. Put the CommandSync.jar file in your plugin/mods folder on your Minecraft servers. Magically, they don't need to be under the same BungeeCord instance.
    11. Start your Minecraft servers.
    12. Stop your Minecraft servers.
    13. In each <BukkitServer>/plugins/CommandSync/config.txt or <SpongeServer>/config/commandsync/config.txt put a UNIQUE name for identification. Example: survival, creative or whatever. Also put the pass that you set in CommandSyncServer's config.txt.
    14. Start your Minecraft servers.
    15. Woo, you're done!
    Usage
    Here are some example uses.
    1. /sync console all broadcast Hi there people! would make the console on all servers run the command broadcast Hi there people!
    2. /sync console survival broadcast Hey there! would make the console on the server identified as survival run the command broadcast Hey there!
    3. /sync console bungee alert Wassup! would make the console of the BungeeCord server run the command alert Wassup!
    4. /sync player all me Hey would make every online player under the BungeeCord instance the CommandSyncServer is running off run the command /me Hey
    5. /sync player md_5 give YoFuzzy3 cookie 1337 would make the player md_5 run the command /give YoFuzzy3 cookie 1337
    (Of course when you make a player perform a command they must have the permission to use it)

    Commands (Only Minecraft Servers)
    • /sync - view the help menu.
    • /sync console - Send a command to run on all Minecraft servers, a single Minecraft server, or the BungeeCord server.
    • /sync player - Send a command to run for all players, or a single player.
    Permissions
    • sync.use - Access to the command /sync. Default: OP.
    Configuration
    CommandSyncServer:
    ip=localhost
    port=9190
    heartbeat=1000
    pass=UNSET
    debug=false
    removedata=false
    lang=en_US
    • ip - The IP that the CommandSyncServer tries to bind to.
    • port - The port that the CommandSyncServer tries to bind to.
    • heartbeat - In milliseconds, how often should the CommandSyncServer process data.
    • pass - A password that all clients must authorize through. (UNSET means the plugin will not operate.)
    • debug - If true all debug will be saved to a log.txt file.
    • removedata - If true, will delete the file data.txt.
    • lang - Select the language used by the plugin. You can create your own language file based on the available ones.
    CommandSyncClient:
    ip=localhost
    port=9190
    heartbeat=1000
    name=UNSET
    pass=UNSET
    debug=false
    removedata=false
    lang=en_US
    • ip - The IP that the CommandSyncClient tries to connect to.
    • port - The port that the CommandSyncClient tries to connect to.
    • heartbeat - In milliseconds, how often should the CommandSyncClient process data.
    • name - A UNIQUE identifier for the CommandSyncClient, used for the /sync console single command. (UNSET means the plugin will not operate.)
    • pass - A password that the client uses to authorize with the server. (UNSET means the plugin will not operate.)
    • debug - If true all debug will be saved to a log.txt file.
    • removedata - If true, will delete the file data.txt.
    • lang - Select the language used by the plugin. You can create your own language file based on the available ones.
    Awesome Features
    • This plugin now uses Java networking, making it much more reliable than the Plugin Messaging System. This means that silly bugs no longer exist. It also means you can synchronize commands across Minecraft servers under different BungeeCord server instances!
    • If you try sync a command and the CommandSyncServer is down, it will be kept in a queue for when it comes back online!
    • If a Minecraft server is down the CommandSyncServer will wait until it comes back online before it tells it to run a command!
    • If you try sync a command for a player that is offline, the command will not be attempted to run until they come back online!
    • All command queues are saved to a file on shutdown, meaning you can have downtimes across many servers but every command will be stored and run as soon as possible!
    • Authorization for secure cross-network links!
    • Debug file logging!
    Internals
    Here's my very bad diagram of how it works made in Paint, you're welcome to make me a better one. http://imgur.com/llIbkia

    If that diagram made no sense to you here it is in most basic text form.
    • /sync console all /sync -> Single CSC -> CSS -> All CSCs -> MC Console -> Run
    • /sync console <server> /sync -> Single CSC -> CSS -> Defined CSC -> MC Console -> Run
    • /sync console player <player_name> /sync -> Single CSC -> CSS -> Defined CSC -> MC Console -> Run
    • /sync console bungee /sync -> Single CSC -> CSS -> Bungee Console -> Run
    • /sync player all /sync -> Single CSC -> CSS -> All Players -> Run
    • /sync player <name> /sync -> Single CSC -> CSC -> Defined Player -> Run
    The `/proxysync` command with the same arguments is used for the proxy server.
    To execute the command "/sync console player <player_name>" you need the player to be online and the server name in the plugin configuration coincided with the server name in the configuration of the proxy server.
    Because of how it all works data has to be saved. So here's that explained.

    CommandSyncClient (CSC) saves:
    • All the string commands that have been sent. These are never cleared.
    • An int value representing where the CSC is up to in sending commands to the CSS. This is not cleared.
      • This allows the CSC to queue up commands if the CSS goes down.
    CommandSyncServer (CSS) saves:
    • All the string commands that have been received. These are never cleared.
    • An int value for every CSC representing where it is up to in sending commands to that CSC. These are never cleared.
      • This allows the CSS to queue up commands so when a CSC goes down commands will be run when it comes back online, or when a new CSC is added to the setup the stored commands can be run for it.
    • All the commands that have been queued up for offline players. These are cleared after being run.
      • These are run when the player comes online.
    Deleting any piece of data (excluding the queued commands for offline players) will cause the CSS and the CSCs to go out of sync (wow such pun) potentially causing commands to be run duplicate times.

    If the CSS or a CSC crashes and prevents its data from saving then the same effect as described above may occur.

    If you are confident that all commands have been processed successfully and would like to reset the saves then you must:
    1. Shut down the Bungee server running CSS and all MC servers running CSC.
    2. Delete all the data.txt files located at:
      1. Bungee/plugins/CommandSync/data.txt
      2. Bukkit Server/plugins/CommandSync/data.txt
      3. Sponge Server/config/CommandSync/data.txt
    3. Start up all the servers.
    Changelog

    Version 2.8.2 ►
    Fixed message for `sync console player args...` command.
    Fixed saving localization file on SpongeForge.

    Version 2.8.1
    Fix logger messages on SpongeForge.

    Version 2.8
    Velocity support.
    Removed unnecessary code.
    Bug fix with player not executing commands when sending them from a proxy server.

    Version 2.7
    Changed the supported version of SpongeAPI to 8.

    Version 2.6

    Added a filter for sending a command by a player's nickname.
    For the proxy server, the `proxysync` command has been added. The functionality is similar to the `sync` command.

    Version 2.5
    Now one single file!
    The id of the plugin on the Sponge API is changed.
    Fixed incorrect permissions in the Sponge API version.
    Fixed a small localization error on the Bukkit API.
    In language files, the symbol § is replaced by &.
    The SelectLocalization.yml file in the Bukkit API version was deleted. Now the parameter for changing the language in the main config.
    Now localization files are available on the Bungee and Sponge API.

    Version 2.4 + Sponge 0.9 - Creation of commands for the server on Sponge API is completed.

    Version 2.4 + Sponge 0.5.9 - Added config option to remove data.txt. Added localization option for Bukkit version.

    Version Bukkit 2.3-Fix + Sponge 0.5 - Fix errors on PaperSpigot servers. Added support Sponge servers(Not full. I have not yet been able to make the plugin commands on this core.)


    ========== Old ==========

    Version 2.3 - Added support for spaces in the /sync command. Added version to internal checking. Fix null password bug.

    Version 2.2 - Fix config file generation.

    Version 2.1 - The config.txt will be updated on startup with some new options for auth and debug file logging.

    Version 2.0b - Complete rewrite! Now uses Java networking making it a lot more flexible, reliable and secure.

    Version 1.0 - Initial release. Not feature complete.
    McMeme821, Ki3End, GenSecrets and 3 others like this.

Recent Updates

  1. Update 2.8.2
  2. Update 2.8.1
  3. Update 2.8

Recent Reviews

  1. Des_Guard
    Des_Guard
    5/5,
    Version: 2.6.0
    Thanks a lot.
    The plugin works fine on 1.16.5
    But the old plugin didn't work in this version.
    I stumbled upon this post purely by accident.
    And I saw that this plugin has version before 1.18. And this is very good.

    Thanks for your hard work!
    1. glavrak
      Author's Response
      Thank you for your feedback. I also intend to add support for SpongeAPI8 in the near future.
  2. Dumazaurus
    Dumazaurus
    5/5,
    Version: 2.5.3b
    Really nice idea, but I'm having problems on 1.16.5.
    BungeeCord configured, port opened, configs set up according to the instructions and command are not being sent to servers. The below is all I'm getting ..

    [00:31:00 WARN]: Exception in thread "Thread-15" java.lang.NullPointerException: Cannot invoke "String.equals(Object)" because the return value of "java.io.BufferedReader.readLine()" is null
    [00:31:00 WARN]: at Mr_Krab.CommandSyncClient.Bukkit.ClientThread.connect(ClientThread.java:101)
    [00:31:00 WARN]: at Mr_Krab.CommandSyncClient.Bukkit.ClientThread.run(ClientThread.java:78)
    1. glavrak
      Author's Response
      Write me a personal message in which the configs will be attached all plugin. I will try to help you.
  3. alexisl315
    alexisl315
    5/5,
    Version: 2.5.3b
    Hello, your plugin works great from 1.8 to 1.16 but I would like to know when support for 1.17 and 1.18 will come out unless it works but I don't know.
    1. glavrak
      Author's Response
      I have not tested it on versions above 1.16 and have not received test results from anyone. But you can check it yourself, I think it should work, because it depends little on BukkitAPI.
  4. andrewkm
    andrewkm
    5/5,
    Version: 2.5.3b
    Very powerful plugin that gets the job done for what it states it does. Solid stuff. Thank you!
    1. glavrak
      Author's Response
      Thanks for your feedback.
  5. Avi_Muh
    Avi_Muh
    5/5,
    Version: 2.5.3b
    nice plugin for sync my anticheat to ban people from the bungeecord ans for my lobby queue system
    1. glavrak
      Author's Response
      Thanks for your feedback.
  6. ananbabangamer
    ananbabangamer
    5/5,
    Version: 2.5.3b
    Hello. Is it possible to tpa someone from A server when we are in B server? I tried but it didn't work for me.
    1. glavrak
      Author's Response
      Not. This cannot be done. In any case, I do not know of such a method.
  7. Mehmet_27
    Mehmet_27
    5/5,
    Version: 2.5.3b
    i like this plugin. Allows me to send commands between servers. Thanks to this, I can do many things
    1. glavrak
      Author's Response
      Thanks for your feedback.
  8. Stormeyes
    Stormeyes
    5/5,
    Version: 2.5.3b
    Excellent and very useful plugin , works in 1.16 without issues Thank you for the plugin!
    1. glavrak
      Author's Response
      Thanks for your feedback.
  9. JasonHorkles
    JasonHorkles
    5/5,
    Version: 2.5.3b
    Very useful plugin to have, thanks for updating it! I used to use a different fork that didn't have the clear logs option, so this is very nice to have to prevent that weird bug
    1. glavrak
      Author's Response
      Thanks for your feedback.
  10. DevelopmentHigh
    DevelopmentHigh
    5/5,
    Version: 2.5.3b
    Can i use this plugin does this plugin can't execute command when i restart server? like old
    1. glavrak
      Author's Response
      Thanks for your feedback. Repeated execution of commands upon server restart is a random bug. There is an option in the configuration file to delete previously entered commands. Use the option on all servers.