CommandBridge

this minor update just fixes some bugs and a arclight conflict latest commit: d6a59a9

this update fixes a placeholder bug that prevented some scheduled tasks from ever resuming, adds a configurable task-expiry timer, and redesigns the admin CLI around resources with consistent rendering across console and in-game chat. so whats new or fixed: scheduled tasks - fixed ${arg} placeholders in execute target IDs not being resolved at queue time, so affected tasks could never match a connected client and never resumed - new tasks.expire-after config option (seconds; default 86400, 0 disables); expired tasks are pruned on load and on the 5-minute save tick - tasks left over with unresolved ${...} placeholders from earlier versions are dropped on load with a warning admin commands - redesigned the /cb tree by resource: - /cb script list | show <name> [group] | enable <name> | disable <name> - /cb task list | clear <id> - /cb client list | ping [id] | players <id> - /cb config show [section] | reload - /cb script show <name> opens a clickable section navigator (permissions, register, defaults, args, commands); pass a group to drill into just that group as a syntax-highlighted yaml card - /cb script enable|disable <name> edits the enabled: line of the matching yaml file in place (comments preserved) and re-pushes registrations to connected clients - /cb config show mirrors the same summary + sections layout; drill into a section via tab-completion or by clicking it in chat - every argument-taking subcommand has live tab-completion now (script names, script groups, task ids, client ids, config keys) rendering - single Report builder drives every command's chat output, so kvs, section headers, bullets, list items, action buttons, and pagination look the same everywhere - DebugPrinter exposes generic printRecord, printRecordOverview, and printList so any record renders as the same yaml card the old /cb scripts view used removed - /cb scripts, /cb tasks, /cb list, /cb ping - replaced by the resource-scoped forms above (no backwards-compat aliases on v3) - /cb task show <id> and /cb client show <id> - their list views already show everything useful, no point duplicating latest commit: 76edfda

This update includes a small fix for an issue where the version was saved incorrectly, causing the launcher to always ask for an update. latest commit: 9563e3c

there are no big changes here: - fix(velocity): deprecation warning was broken on NTFS systems - feature: added support for the latest minecraft versions(26.1, 26.2 and below) latest commit: d7f43a1

this update adds a public developer API for third-party plugins, hardens auth security, and fixes a bunch of stability issues across the board. so whats new: developer API - new api module for third-party plugin integration, available on maven central - typed message channels via CommandBridgeAPI.channel(Class) with send, request, broadcast, and listen - delivery conditions on senders: requirePlayer(UUID) to gate on player presence, whenOnline(UUID) to queue until the player connects - server lifecycle events via onServerConnected and onServerDisconnected (proxy only) - connection state tracking via onConnectionStateChanged (all platforms) - player locator service for resolving which server a player is on (proxy only) - CommandBridgeProvider.get() and CommandBridgeProvider.get(Class) to obtain the API instance - proxy-only methods return Optional<Subscription> instead of raw Subscription, returning Optional.empty() on backends - full JDK-style JavaDocs across all API types security - hardened auth flow with constant-time HMAC comparison to prevent timing attacks - fixed AUTH_OK race condition where messages could be sent before the client processed auth success - added reconnect on failed server proof verification - operator execution no longer grants wildcard permissions, only explicit ones fixes - fixed cooldown being applied before dispatch instead of after - fixed MiniMessage tags in error messages not being escaped - fixed script reload not being thread-safe - fixed player join events firing for already-tracked players - fixed polling not being reset on shutdown - fixed auth check missing on config reload - fixed Log varargs handling for single-argument messages - fixed config name not being passed to ConfigManager in the velocity backend adapter - fixed operator permission resolution being inconsistent across platform executors - left-aligned all chat UI output and removed pixel-width centering - various null guard and stability improvements across dispatch, registration, and player tracking internals - modernized codebase to java 21 idioms - rebuilt test suite from scratch with 136 tests across core, velocity, and backends - added CI test workflow and testing documentation breaking changes: - RunAs and ConnectionState moved to the api package, internal duplicates removed latest commit: d7f43a1

this update is mostly about migration tooling, better player resolution, and support/debug quality of life. also had some internal cleanup and an important fix for velocity running in client mode. so whats new: - added /cb dump for support snapshots (sanitized upload + local file export) - added /cb migrate to migrate script files to the current schema - migration is script-only now. there was a short config migration path but that got reverted again - added player-arg per command for target-required and schedule-online - added remote uuid resolving between connected proxies (RESOLVE_UUID) + local UserCache + Mojang fallback - added OFFLINE_PLAYER argument type with suggestions support - reworked schedule-online / player tracking flow to be more reliable and added clearer warning logs when player resolution fails - fixed double command descriptions in command registration output - fixed velocity client mode startup crash (ClassNotFoundException: org.bukkit.command.CommandSender) breaking changes: - scripts now require version: 4 - older scripts must be migrated first - internal runtime files moved into the data/ subdirectory latest commit: e951a9e

this version brings some nice additions mostly around target-required and player tracking across proxies. the wiki has been fully rewritten for this version so make sure to check that out. so whats new: - target-required per command option. this makes sure the player is actually on the target server before dispatching the command. also works when a proxy is in client mode so it checks across all connected proxies not just the local one - per-command cooldowns, the old pipeline cooldown stage is gone - player presence tracking. backends and client mode proxies now sync their player lists to the proxy. the full list only gets sent once on auth and after that only join/leave deltas get sent so you dont have to worry about huge packets even with like 30k players - added PLAYERS argument type for velocity - scripts now require version 3 breaking changes: - removed Server.timeout from the config - removed some unused config values - script version 3 is now required, older versions wont work anymore latest commit: 37b29f5

well this is a big version jump because it has major rewrites to support a second backend. what do I mean by that? CommandBridge was(or still is) being powered by Websockets. but some users asked for the feature to implement redis. So here it is: - full redis support as transport layer - you can either use websockets or redis depends on what you select in the config so big version because the config has major changes and the plugin architecture

fixed: - example.yml was incorrect - commandapi unregistration on shutdown threw exceptions added: - modrinth api - update checker

Hello guys, I am happy to release this version. This is the first release of the full rewrite of my plugin. Visit the migration guide here: https://cb.objz.dev/docs/migration/

[v2.3.5] - 2025-12-28 - dependency: changed commandapi from 11.0.0 to 11.1.0

[v2.3.4] - 2025-10-11 - fix: fixed command registration issue on paper 1.21.10

[v2.3.3] - 2025-10-10 - feat: now supports minecraft 1.21.9 and 1.21.10

[v2.3.2] - 2025-09-15 - fix: fixed ClassCastException

[v2.3.1] - 2025-09-14 - feat: Inject player placeholders whenever we have a player context, regardless the target executor is set to.

[v2.3.0] - 2025-08-01 - Fixed multithreading issues on folia servers.

[v2.2.9] - 2025-07-22 - Added /cb dump command to dump the current configuration and scripts. You can view the results on the website. It will generate a link for you.

[v2.2.8] - 2025-07-22 - updated to minecraft version 1.21.8

[v2.2.7] - 2025-07-02 - updated to minecraft version 1.21.7 - introduced aliases for scripts. go outside, great weather!

[v2.2.6] - 2025-06-07 - Improved feedback when processing player commands sent from the console

[v2.2.5] - 2025-05-19 - fixed issue [#16](https://github.com/objz/CommandBridge/issues/16) - no longer responds with 'reconnect successfull' when reconnect failed

[v2.2.4] - 2025-05-10 - changed broken links for the new website - internal renamings

[v2.2.3] - 2025-04-29 - Adds support for minecraft version 1.20.5 - fixed #14

[v2.2.2] - 2025-04-30 - Fully rewrote and restructured the wiki for clarity and GitBook compatibility. - Scripts guide now split into clean pages with tables, examples, and diagrams. - Clear separation of Velocity Paper script directions with real-world examples. - Added built-in placeholder overview with platform support table. - Included visual overview diagrams for better understanding. - Added permission hints and common setup tips in examples. - Improved explanation for PlaceholderAPI support on both platforms.

[v2.2.1] - 2025-04-25 - Fixed issues with the Metrics class causing runtime errors. - Resolved an "Internal Server Error" when players lacked permission. - Added full support for Folia, ensuring compatibility and improved performance.

[v2.2.0] - 2025-04-17 - Replaced entire backend with Netty, providing improved performance and enhanced security. - Clients now automatically attempt to reconnect to the server after shutdown, with a configurable timeout. Manual reconnection is possible afterward. - Fixed a bug where the WebSocket server would not shut down properly. This resolves [#11](https://github.com/72-S/CommandBridge/issues/11).

Major version bump due to complete backend reimplementation.

In the next release, a WebUI for managing commands and a /dump command will be introduced.

[v2.1.8] - 2025-03-21 - Improved performance of onLoad and onEnable, reducing usage from 8% to 0.54%. - Added PAPIProxyBridge support for PlaceholderAPI integration on Velocity. - Fixed an issue on Velocity where command arguments were incorrectly required instead of optional.

[v2.1.7] - 2025-03-21 Added - Optional support for PlaceholderAPI on both Bukkit and Velocity platforms. If the PlaceholderAPI plugin is present, external placeholders will be parsed alongside internal ones. - Improved internal placeholder handling to avoid conflicts with PlaceholderAPI syntax, ensuring consistent behavior whether or not PlaceholderAPI is installed. Changed - Updated logging messages to clearly indicate whether PlaceholderAPI was detected and whether internal or external placeholder systems are being used.

[v2.1.6] - 2025-03-06 Changed - Removed dependencies on the Paper API, making the plugin fully compatible with the Bukkit API. This allows support for a wider range of server software, including third-party platforms like Arclight that do not implement the Paper API. - Added a legacy-plugin.yml to ensure compatibility with non-Paper servers while still keeping a paper-plugin.yml to maintain Paper-specific features.

[v2.1.5] - 2025-02-27 Changed - The plugin is now Spigot-mapped and will be remapped by Paper to support older versions starting from 1.20.

[v2.1.4] - 2025-02-23 Added - Added the /cbc reconnect command to allow clients to reconnect to the server. Requires the commandbridge.admin permission on Paper servers. Changed - Updated the /cbc help command description for improved clarity.

[v2.1.3] - 2025-02-10 Changed - Improved the structure and readability of the HelpCommand output. - Grouped commands into general and debug-only sections for better clarity. Fixed - Fixed a bug where CommandBridge starts successfully even if there are errors in the init state

[v2.1.2] - 2025-02-09 Changed - Updated api-version in plugin.yml from 1.21 to 1.20 to ensure compatibility with older Paper versions. Fixed - Resolved startup issues on Paper 1.20 servers caused by unsupported api-version.

[v2.1.1] - 2025-02-05 Changed - Reformatted config.yml for both Velocity and Bukkit, improving readability and structure. - Enhanced script descriptions to provide clearer explanations, similar to the improved config.yml formatting. Fixed - Patched version display errors to ensure correct versioning information is shown.

[v2.1.0] - 2025-01-23 Changed - Updated the certificate generation logic to dynamically include SANs based on the WebSocket server's configured binding address (e.g., 152.248.198.173 or myserver.example.com). Fixed - SSL handshake issues where certificates lacked SANs for the server's public IP, causing clients to fail connection validation. - Fixed a threading bug in Paper where commands executed asynchronously caused errors when dispatching commands. - Fixed a bug with placeholders in Paper, ensuring proper handling in dynamic command execution.

[v2.0.0] - 2024-12-20 Added - WebSocket support to replace plugin messaging for reliable communication. - Single JAR setup for both Velocity and Paper servers. - Placeholder support for dynamic command handling. - Improved logging for better debugging and setup feedback. Changed - Complete rewrite of the codebase for better performance, reliability, and maintainability. Removed - Plugin messaging system due to limitations when no players are online. Compatibility - Requires Java 21. - Fully compatible with Minecraft 1.21.x.

[v1.8.4] - 2024-11-12 Added - Added the hide permission option.

[v1.8.3] - 2024-11-10 Fixed - Fixed the wrong written example.yml.

[v1.8.2] - 2024-11-04 Added - Introduced a small patch to the configuration. - You can now bypass the permission check by enabling the new ignore-permission-check option in the config file. This allows for more flexibility in managing permissions.

Changelog

[v1.8.1] - 2024-09-23 Refactored - Overhauled the project structure to improve clarity and modularity by updating package names. This refactor enhances maintainability and makes future development easier. Added - Updated to support Minecraft version 1.21.1, ensuring compatibility with the newest features and changes. - Built using Java 17 for improved performance and long-term support (LTS). Switched from a Paper instance to a Bukkit instance to provide better long-term support and maintain a stable foundation for plugins.

Changelog

[v1.7.1] - 2024-08-25 Refactored - Significant changes to package names for improved clarity and organization. This refactor aims to enhance maintainability and modularity of the codebase. Added - Now supports Minecraft version 1.21.1, ensuring compatibility with the latest features and updates from Minecraft. - Compiled using Java 17 for better performance and stability. The update also switches from using a Paper instance to a Bukkit instance to offer more long-term support (LTS).

Changelog

[v1.7.0] - 2024-08-12 Improved - Refactored logging logic for better traceability and efficiency. - Updated example scripts to reflect the latest changes and best practices. - Enhanced the logic for sending commands to Velocity using the UUID system for better accuracy and performance. Added - Added support for a list of target server IDs instead of a single string, providing greater flexibility in command routing. - Implemented script version and config version checks to ensure compatibility. - Introduced a new option called args in the string parser to allow for more dynamic command parsing. - Added a new placeholder called %world% for more context-sensitive command execution. - Bukkit to Velocity Command Handling: Refactored the method by which Bukkit sends commands to Velocity to support multiple proxies connected to a single Bukkit server. This change requires the target server to be specified as a list in the Bukkit script, improving compatibility and flexibility in complex server environments. Updates - Config version and script version updated to version 2.

Changelog

[v1.6] - 2024-08-01

#### Added - Release created to synchronize build and release numbers with the Velocity version. No functional changes in this release.

Changelog

[v1.5] - 2024-07-21

#### Fixed - Fixed an issue where plugin messages were processed multiple times based on the number of players online (#2). The plugin now correctly differentiates between player and console executors, ensuring messages are handled appropriately. - Player-Specific Commands: Messages sent by players are now correctly processed once per intended execution. - Console Commands: Messages sent by the console are now handled separately, ensuring they are not duplicated based on player count. #### Added - Added synchronization to the message handling to ensure single execution per message. - Improved logging to provide better traceability of message handling and command execution.

#### New Features - Added version check and command registration on startup. - Introduced a method to copy an example config file if it doesn't exist. #### Improvements - Refactored script loading process for better error handling and logging. - Further refined the script loading process with better error handling and logging. - Improved warning messages for version discrepancies. - Refactored CommandExecutor to handle player online status and timeouts more efficiently. - Added support for system commands in MessageListener and improved logging statements. - Updated CommandBridge plugin version to 1.4-SNAPSHOT in pom.xml files. #### Bug Fixes - None reported for this version. #### Miscellaneous - General improvements in logging and error handling across various components. Please report any bugs or issues on our [GitHub Issues page](https://github.com/72-S/CommandBridge/issues).

Bukkit Version 1.3 RELEASE

New Features:

- Cross-Server Command Sending: - You can now send commands from Bukkit servers to the Velocity server, significantly enhancing cross-server functionality. - Utilizes the same placeholders as on the Velocity side, ensuring consistency and ease of use. - Includes a new configuration section in bukkit-scripts on the Bukkit side for setting up command sending. - Hot Reloading: - Commands can now be hot-reloaded using the cb reload or commandbridge reload command, providing seamless updates without the need for server restarts.

Bug Fixes:

- Configuration and Scripts Folder Handling: - Fixed an issue where the config and scripts folders were not being copied correctly, ensuring proper setup and functionality.

Velocity Version 1.2 RELEASE

New Features:

- bStats: The plugin now sends anonymous statistics. You can disable this in the bStats configuration file

Bug Fixes:

- Unused Code Replaced: Performance issues were resolved by removing unused code snippets.

Velocity Version 1.1 RELEASE

New Features:

- New Configuration Options: Users can now disable checks to see if the executor is a player and if the player is on the target server. - Code Refactoring: The entire codebase has been refactored to enhance readability and performance. - Enhanced Documentation: Updated and detailed documentation, complete with examples, is now available at [CommandBridge Documentation](https://72-s.github.io/CommandBridge/).

Bug Fixes:

- Error Messaging Improvement: Fixed an issue where error messages were repeatedly sent in chat when executing multiple commands and an error such as "you are not on the server" occurred. - Multithreading Stability: Resolved issues related to multithreading errors.

Velocity version 1.0

Enhancements:

- Added timeout functionality for command execution to prevent indefinite waits. Commands will now timeout after 30 seconds if conditions are not met. - Improved command parsing logic to handle complex command structures more efficiently.

Bug Fixes:

- Fixed an issue where commands would not execute under certain conditions when players were switching servers. - Resolved a bug that caused verbose logging settings to not apply until a restart.

New Features:

- Implemented a feature allowing administrators to specify commands that only execute when a player is online on a specific server.