ВЕРСИИ (61)

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.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.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.

**[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.8.1] - 2024-09-23 **Refactored** - Updated the configuration version to 2 in the default example config for better clarity and alignment with new standards. **Bug Fixes** - Resolved an issue with instance management where commands were not being registered correctly, ensuring smoother operation and command handling in Velocity.

### 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.1] - 2024-08-25 **Refactored** - Introduced a new `UUIDManager` class with methods dedicated to managing UUIDs from messages sent by Bukkit, improving the efficiency and clarity of UUID handling. - Significant package name changes implemented to align with new project structure and enhance code readability. - Updated various file names to reflect new naming conventions and maintain consistency across the codebase. **Fixed** - Resolved a bug related to the reception of multiple messages, which previously caused inconsistencies in message handling. **Updates** - Now compiled using Java 17 instead of Java 21, increasing compatibility with older versions and ensuring broader support.

### 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.7.0] - 2024-08-12 **Fixed** - Fixed an issue where console commands from Bukkit were not executing correctly. - Removed the standard copy option to resolve errors that were occurring. **Improved** - Refactored the `/cb` command to now refer to the help message. - Changed warning messages to informational when a message is received on an unrecognized channel to reduce console spam. - Minor improvements made to logging methods for better clarity. - Adjusted the startup order for improved efficiency. - Updated `config.yml` for better clarity and organization. - Enhanced the message listener with UUIDs to resolve issues with player identification across multiple proxies. - Overhauled command processing and command registrar for better performance. **Added** - Added support for a list of target server IDs instead of a single string. - Implemented script version and config version checks. - Introduced a new option called `args` in the string parser to allow argument parsing for commands. **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.6] - 2024-08-01 #### Fixed - Fixed an issue where version update messages were sent to all players regardless of their permissions. The plugin now correctly checks for the `commandbridge.admin` permission before sending version update notifications. - **Admin-Only Notifications**: Version update messages are now only sent to players with the `commandbridge.admin` permission. - **Non-Admin Players**: Players without the `commandbridge.admin` permission no longer receive version update messages, ensuring appropriate message distribution. #### Improved - Enhanced permission check logic during player join events to ensure only authorized players receive specific notifications. - Updated logging to provide better traceability of permission checks and notification sending, aiding in debugging and monitoring.

## 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.

## Changelog ### [v1.5] - 2024-07-21 #### Fixed - Fixed an issue where plugin messages were received multiple times based on the number of players online (#2). The plugin now correctly handles messages sent by the console, ensuring they are sent through one player if available, and properly logs when no players are online. - **Player-Specific Commands**: Plugin messages are now correctly sent directly to the targeted player. - **Console Commands**: Plugin messages sent by the console are now routed through one online player if available. If no players are online, the situation is logged appropriately. #### Added - Added logic to check for online players and send plugin messages from the first available player when the executor is the console. - Enhanced logging to warn when no players are online to handle console-executed commands.

#### 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).

#### New Features - **None reported for this version.** #### Improvements - Refactored `forceInfo` method in `VerboseLogger.java` for consistency with naming conventions. - Enhanced message handling and command sending logic in `MessageListener` and `MessageSender` classes. - 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.3 RELEASE ## New Features: - **New Commands**: - `velocity help`: Provides help information about Velocity commands. - `velocity version`: Displays the current version of Velocity. - **Automatic Version Check**: Velocity now automatically checks for new versions and notifies the user. This feature also integrates with the `cb` or `commandbridge version` command to ensure users are aware of updates. - **Cross-Platform Command Support**: Introduces support for a new feature in the Bukkit version, allowing commands to be sent from Bukkit to Velocity. ## Bug Fixes: - **Configuration Error Handling**: Added more clauses to handle misconfigurations, reducing the likelihood of errors due to incorrect configurations.

# 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 Bukkit 1.1 RELEASE ## New Features: - **Enhanced Documentation**: Updated and detailed documentation, complete with examples, is now available at [CommandBridge Documentation](https://72-s.github.io/CommandBridge/). ## Bug Fixes: - **Major Issues with Verbose Logger**: Resolved issues related to logging messaging.

# 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.

# Bukkit version 1.0 ## Enhancements: - Enhanced the security of command execution to prevent unauthorized access. - Updated the YML configuration loading to handle file corruptions more gracefully. ## Bug Fixes: - - Corrected an error that caused server-specific commands to fail in rare cases. ## New Features: - Integrated basic verbose logging for troubleshooting and operational monitoring.