RedisCommands - Real-Time Cross-Server Network Manager
RedisCommands is a ultra-lightweight, high-performance cross-server utility designed for modern Minecraft networks running Velocity + Paper/Folia (Minecraft 1.21.1 to 1.21.11). Powered by a robust Redis pub/sub architecture, it handles real-time cross-server command execution, lightning-fast player transfers, and synchronized network-wide broadcasts with sub-millisecond latency.Technical Specifications
- Platform Compatibility: Paper, Folia, and Velocity.
- Folia Support: Native. Built using Paper's universal scheduler API, it runs flawlessly on multi-threaded environments (Folia, Leaf, PaperShredded) as well as traditional single-threaded Paper servers.
- Java Requirement: Java 21+
- Dependencies: None required. Heavy dependencies like Jedis and Gson are fully shaded and relocated to prevent version conflicts with other plugins on your server.
- Network Overhead: Highly optimized. Runs on exactly one pooled Redis publisher connection and one auto-reconnecting background subscriber thread.
Project Structure and Modules
The plugin is split into three clean modules:| Module | Generated Artifact | Target Deployment |
| common | Bundled internally | Shaded into both build outputs |
| paper | RedisCommands-Paper-1.0.0.jar | Installed on every backend server (e.g., Lobby, Survival, Plots) |
| velocity | RedisCommands-Velocity-1.0.0.jar | Installed on the Velocity Proxy |
Commands & Permissions
| Command | Permission | Description |
| /koth (Customizable) | rediscommands.transfer.koth | Initiatives transfer and targets post-arrival teleportation commands |
| /rediscommands reload | rediscommands.admin | Reloads configurations and local command setups |
| /rediscommands broadcast <id> | rediscommands.admin | Triggers a configured cross-server JSON broadcast |
| /rediscommands transfer <player> <server> [cmd...] | rediscommands.admin | Remotely forces a player to switch servers |
| /rediscommands run <server|*|PROXY> <cmd...> | rediscommands.admin | Dispatches a console command to remote target servers |
Available Aliases: /rc, /rcmd.
Configuration Guidelines
- Velocity Proxy: Managed via plugins/rediscommands/redis.properties. This handles the core credentials for connecting to your centralized Redis database.
- Paper Backend: Managed via plugins/RedisCommands/config.yml.
