Scripting

Overview

CommandBridge scripts are YAML files that define custom commands and what happens when they're run. All scripts live on the Velocity proxy in plugins/commandbridge/scripts/. From there, you can register and execute commands anywhere in the network.

How scripts work

1. You write a YAML file defining a command, its arguments, and what commands to run
2. On startup (or /cb reload), CommandBridge validates the script and registers the command on the targets listed in register
3. When a player or console runs the command, the dispatch pipeline resolves arguments and placeholders, checks permissions and cooldowns, then forwards the command to each target in execute

flowchart LR
    A[YAML script] --> B[Validation]
    B --> C[Register on targets]
    C --> D[Player runs command]
    D --> E[Resolve args + placeholders]
    E --> F[Permission + cooldown check]
    F --> G[Dispatch to targets]

Script location

Place .yml files in the Velocity proxy's plugin directory:

plugins/commandbridge/scripts/

Files are loaded on startup. Use /cb reload to reload without restarting.

Next steps

• Syntax → full YAML reference for all script fields
• Argument Types → all 21 supported types
• Placeholders → built-in ${arg} placeholders
• PlaceholderAPI → PAPI integration
• Examples: Alert, Lobby, Economy, Punishment