TriggerVolumes

# TriggerVolumes Plugin A powerful Spigot/Paper plugin for creating 3D trigger volumes with customizable actions that execute when players enter or leave defined areas. ## Features - **Selection System**: Tool-based selection of cubic regions with visual feedback - **Trigger Volumes**: Store and manage named volumes with precise coordinates - **Volume Groups**: Group multiple volumes together for batch operations - **Clone & Copy**: Clone volumes with actions or copy actions between existing volumes - **Enter/Leave Actions**: Execute different actions when players enter or leave volumes - **Action Types**: - `PLAYER_COMMAND`: Execute commands as the player - `CONSOLE_COMMAND`: Execute commands from console - `MESSAGE`: Send colored messages to players - `TELEPORT`: Teleport players to specific coordinates - **Particle Visualization**: Real-time particle effects showing volume boundaries - **Cooldown System**: Prevent action spam with configurable cooldowns - **Spatial Hashing**: Optimized performance for servers with hundreds of volumes - **Multi-Language**: Support for 7 languages (EN, DE, FR, PL, RU, JA, ES) - **Persistent Storage**: Volumes and actions saved in YAML format - **Reload Command**: Update configurations without server restart ## Requirements - **Server**: Spigot or Paper 1.19+ - **Java**: Version 17 or higher - **Permissions Plugin**: Optional (for permission management) ## Installation 1. Download `TriggerVolumes-1.0.4.jar` 2. Place the file in your server's `plugins/` folder 3. Start or restart your server 4. Configuration files will be generated automatically in `plugins/TriggerVolumes/` ## Configuration ### Main Configuration (`config.yml`) ```yaml # Language Configuration language: default: en # Available: en, de, fr, pl, ru, ja, es # Particle Settings particles: update-interval: 5 # Ticks between particle updates density: 0.5 # Distance between particles (blocks) visualization-duration: 30 # Duration in seconds # Cooldown System cooldowns: enabled: true default-cooldown: 3 # Cooldown in seconds # Selection Tool selection-tool: material: WOODEN_HOE name: "&6Selection Tool" lore: - "&7Left-click: Set position 1" - "&7Right-click: Set position 2" ``` ### Changing Language Edit `config.yml` and change the language setting: ```yaml language: default: de # Change to your preferred language code ``` Then reload: `/trigger reload` ## Commands ### Basic Commands | Command | Description | Permission | |---------|-------------|------------| | `/trigger tool` | Get the selection tool | `triggervolumes.admin` | | `/trigger create <name>` | Create volume from selection | `triggervolumes.admin` | | `/trigger define <name> <x1> <y1> <z1> <x2> <y2> <z2>` | Create volume with coordinates | `triggervolumes.admin` | | `/trigger delete <name>` | Delete a volume | `triggervolumes.admin` | | `/trigger clone ` | Clone volume or create from selection | `triggervolumes.admin` | | `/trigger copypaste <copy> <paste>` | Copy actions between volumes | `triggervolumes.admin` | | `/trigger list` | List all volumes | `triggervolumes.admin` | | `/trigger info <name>` | Show volume details and groups | `triggervolumes.admin` | | `/trigger reload` | Reload configurations | `triggervolumes.admin` | | `/trigger help` | Show help message | `triggervolumes.admin` | ### Action Commands | Command | Description | Permission | |---------|-------------|------------| | `/trigger setaction <name> enter <type> <value>` | Add enter action | `triggervolumes.admin` | | `/trigger setaction <name> leave <type> <value>` | Add leave action | `triggervolumes.admin` | | `/trigger clearactions <name> ` | Clear actions | `triggervolumes.admin` | ### Volume Groups Commands | Command | Description | Permission | |---------|-------------|------------| | `/trigger creategroup <name> <vol1> <vol2> ` | Create volume group (min 2) | `triggervolumes.admin` | | `/trigger deletegroup <name>` | Delete group (volumes remain) | `triggervolumes.admin` | | `/trigger groupadd <group> <volume>` | Add volume to existing group | `triggervolumes.admin` | | `/trigger groupremove <group> <volume>` | Remove volume from group | `triggervolumes.admin` | | `/trigger setaction <group> <trigger> <type> <value>` | Apply action to all volumes in group | `triggervolumes.admin` | | `/trigger clearactions <group> ` | Clear actions from group | `triggervolumes.admin` | ### Visualization Commands | Command | Description | Permission | |---------|-------------|------------| | `/trigger visualize <name>` | Show volume particles (30s) | `triggervolumes.admin` | | `/trigger hide <name>` | Stop showing particles | `triggervolumes.admin` | ## Action Types ### PLAYER_COMMAND Executes a command as if the player typed it. **Examples:** ``` /trigger setaction MyVolume enter PLAYER_COMMAND /heal /trigger setaction MyVolume enter PLAYER_COMMAND /