# TriggerVolumes Plugin<\/p>\n
A powerful Spigot\/Paper plugin for creating 3D trigger volumes with customizable actions that execute when players enter or leave defined areas.<\/p>\n
## Features<\/p>\n
– **Selection System**: Tool-based selection of cubic regions with visual feedback
\n– **Trigger Volumes**: Store and manage named volumes with precise coordinates
\n– **Volume Groups**: Group multiple volumes together for batch operations
\n– **Clone & Copy**: Clone volumes with actions or copy actions between existing volumes
\n– **Enter\/Leave Actions**: Execute different actions when players enter or leave volumes
\n– **Action Types**:
\n – `PLAYER_COMMAND`: Execute commands as the player
\n – `CONSOLE_COMMAND`: Execute commands from console
\n – `MESSAGE`: Send colored messages to players
\n – `TELEPORT`: Teleport players to specific coordinates
\n– **Particle Visualization**: Real-time particle effects showing volume boundaries
\n– **Cooldown System**: Prevent action spam with configurable cooldowns
\n– **Spatial Hashing**: Optimized performance for servers with hundreds of volumes
\n– **Multi-Language**: Support for 7 languages (EN, DE, FR, PL, RU, JA, ES)
\n– **Persistent Storage**: Volumes and actions saved in YAML format
\n– **Reload Command**: Update configurations without server restart<\/p>\n
## Requirements<\/p>\n
– **Server**: Spigot or Paper 1.19+
\n– **Java**: Version 17 or higher
\n– **Permissions Plugin**: Optional (for permission management)<\/p>\n
## Installation<\/p>\n
1. Download `TriggerVolumes-1.0.4.jar`
\n2. Place the file in your server’s `plugins\/` folder
\n3. Start or restart your server
\n4. Configuration files will be generated automatically in `plugins\/TriggerVolumes\/`<\/p>\n
## Configuration<\/p>\n
### Main Configuration (`config.yml`)<\/p>\n
“`yaml
\n# Language Configuration
\nlanguage:
\n default: en # Available: en, de, fr, pl, ru, ja, es<\/p>\n
# Particle Settings
\nparticles:
\n update-interval: 5 # Ticks between particle updates
\n density: 0.5 # Distance between particles (blocks)
\n visualization-duration: 30 # Duration in seconds<\/p>\n
# Cooldown System
\ncooldowns:
\n enabled: true
\n default-cooldown: 3 # Cooldown in seconds<\/p>\n
# Selection Tool
\nselection-tool:
\n material: WOODEN_HOE
\n name: “&6Selection Tool”
\n lore:
\n – “&7Left-click: Set position 1”
\n – “&7Right-click: Set position 2”
\n“`<\/p>\n
### Changing Language<\/p>\n
Edit `config.yml` and change the language setting:
\n“`yaml
\nlanguage:
\n default: de # Change to your preferred language code
\n“`<\/p>\n
Then reload: `\/trigger reload`<\/p>\n
## Commands<\/p>\n
### Basic Commands<\/p>\n
| Command | Description | Permission | ### Action Commands<\/p>\n | Command | Description | Permission | ### Volume Groups Commands<\/p>\n | Command | Description | Permission | ### Visualization Commands<\/p>\n | Command | Description | Permission | ## Action Types<\/p>\n ### PLAYER_COMMAND **Examples:** **Note:** The player must have permission to execute the command!<\/p>\n ### CONSOLE_COMMAND **Examples:** **Placeholders:** ### MESSAGE **Examples:** **Color Codes:** ### TELEPORT **Format:** `x y z [yaw] [pitch]`<\/p>\n **Examples:** **Note:** Teleport coordinates are in the same world as the volume!<\/p>\n ## Usage Workflow<\/p>\n ### 1. Creating a Volume<\/p>\n #### Method A: Using the Selection Tool # Select two corners by clicking blocks # Create the volume #### Method B: Using Coordinates ### 2. Adding Actions<\/p>\n #### Enter Actions (triggered on entering) # Give the player an item # Apply a potion effect #### Leave Actions (triggered on leaving) # Remove potion effects # Teleport player back ### 3. Testing and Visualization<\/p>\n “`bash # Walk into the volume – enter actions will execute # Stop visualization ### 4. Managing Volumes<\/p>\n “`bash # Check volume details # Clear specific actions # Delete volume ## Practical Examples<\/p>\n ### Example 1: Safe Zone “`bash ### Example 2: Shop Entrance “`bash ### Example 3: Danger Zone “`bash ### Example 4: Teleport Hub “`bash ### Example 5: Resource Zone “`bash ### Example 6: Cloning Volumes “`bash # Clone an existing volume to the new selection # Or create a volume without actions # Or clone with auto-generated name ### Example 7: Copying Actions Between Volumes “`bash ### Example 8: Volume Groups “`bash # Add more volumes to the group later # Apply actions to all volumes in the group at once # Remove a volume from the group # Clear actions from all volumes in group # Delete the group (volumes remain intact) ## Permissions<\/p>\n ### Admin Permissions ### User Permissions ### Permission Examples<\/p>\n **Using LuckPerms:** # Give admin permission to a group # Remove trigger permission from guest group **Using PermissionsEx:** # Give to group ## Cooldown System<\/p>\n The cooldown system prevents actions from being triggered too frequently when players repeatedly enter\/exit volumes.<\/p>\n ### How it Works ### Configuration ### Behavior ## Particle Visualization<\/p>\n Volumes can be visualized with colored particle effects to help with positioning and verification.<\/p>\n ### Colors ### Settings ### Usage # Stop showing particles ## Performance Optimization<\/p>\n The plugin uses **spatial hashing** to efficiently handle hundreds or thousands of volumes without performance impact.<\/p>\n ### How It Works ### Performance Comparison ### Benefits ### Best Practices ## File Structure<\/p>\n “` ## Volume Groups<\/p>\n Volume groups allow you to manage multiple volumes as a single unit, making it easy to apply the same actions to multiple areas.<\/p>\n ### Creating Groups ### Using Groups “`bash # Clear actions from all volumes in a group ### Managing Groups # Remove a volume from a group # View which groups a volume belongs to # Delete a group (volumes are not deleted) **Important Notes:** ### Key Features ## Storage Format<\/p>\n Volumes and groups are stored in `triggervolumes.yml`:<\/p>\n “`yaml ## Troubleshooting<\/p>\n ### Actions Not Triggering<\/p>\n **Problem:** Player walks through volume but nothing happens<\/p>\n **Solutions:** ### Selection Tool Not Working<\/p>\n **Problem:** Clicks don’t register positions<\/p>\n **Solutions:** ### Particles Not Showing<\/p>\n **Problem:** `\/trigger visualize` doesn’t show particles<\/p>\n **Solutions:** ### Commands Not Working<\/p>\n **Problem:** Commands return errors or don’t work<\/p>\n **Solutions:** ### Performance Issues<\/p>\n **Problem:** Server lag with many volumes<\/p>\n **Solutions:** ## Advanced Tips<\/p>\n ### Using Placeholders Example: ### Multiple Actions All actions execute in the order they were added.<\/p>\n ### Overlapping Volumes ### World-Specific Volumes ### Volume Groups for Organization # Group all shop areas # Apply consistent actions across related areas ### Dynamic Group Management # Add new shops as they’re built # Remove shops temporarily (e.g., during renovation) # Add them back when ready # If you remove volumes until less than 2 remain, the group auto-deletes ### Clone vs CopyPaste – **CopyPaste**: Copies actions between existing volumes ### Backup and Migration ## API for Developers<\/p>\n ### Maven Dependency ### Getting the Plugin Instance ### Checking if a Location is in a Volume if (!volumes.isEmpty()) { ### Creating a Volume Programmatically \/\/ Add actions ## Support & Contributing<\/p>\n ### Getting Help ### Reporting Bugs ### Feature Requests ## License<\/p>\n This plugin is provided as-is for private and public Minecraft servers.<\/p>\n ## Credits<\/p>\n – **Author**: zfzfg —<\/p>\n **Made by zfzfg**<\/p>\n For updates and more plugins, visit our GitHub Repository.<\/p>\n","protected":false},"excerpt":{"rendered":" A Spigot\/Paper plugin for defining 3D trigger volumes with automated actions on player entry and exit!<\/p>\n","protected":false},"featured_media":159872,"template":"","meta":{"_minecraft_slug":"triggervolumes","_minecraft_project_id":"dPc5IzRs","_minecraft_author":"zfzfg","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":32,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"triggervolumes.zip","_minecraft_size_bytes":118623,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:06:26.455556Z","_minecraft_date_created":"2025-12-19T09:58:49.261589Z","_minecraft_date_modified":"2025-12-07T12:41:47.988438Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/triggervolumes","_minecraft_icon_attachment_id":159872,"_minecraft_imported_at":"2026-06-09T14:36:52+00:00","_minecraft_import_hash":"2f6a2305bbc97532c120d696218f582b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,122,866,127,128,129,869,92],"mod_loader":[130,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-159871","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-magic","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/trigger tool` | Get the selection tool | `triggervolumes.admin` |
\n| `\/trigger create
\n| `\/trigger define
\n| `\/trigger delete
\n| `\/trigger clone [source] [name]` | Clone volume or create from selection | `triggervolumes.admin` |
\n| `\/trigger copypaste
\n| `\/trigger list` | List all volumes | `triggervolumes.admin` |
\n| `\/trigger info
\n| `\/trigger reload` | Reload configurations | `triggervolumes.admin` |
\n| `\/trigger help` | Show help message | `triggervolumes.admin` |<\/p>\n
\n|———|————-|————|
\n| `\/trigger setaction
\n| `\/trigger setaction
\n| `\/trigger clearactions
\n|———|————-|————|
\n| `\/trigger creategroup
\n| `\/trigger deletegroup
\n| `\/trigger groupadd
\n| `\/trigger groupremove
\n| `\/trigger setaction
\n| `\/trigger clearactions
\n|———|————-|————|
\n| `\/trigger visualize
\n| `\/trigger hide
\nExecutes a command as if the player typed it.<\/p>\n
\n“`
\n\/trigger setaction MyVolume enter PLAYER_COMMAND \/heal
\n\/trigger setaction MyVolume enter PLAYER_COMMAND \/spawn
\n\/trigger setaction MyVolume leave PLAYER_COMMAND \/back
\n“`<\/p>\n
\nExecutes a command from the console (with OP privileges).<\/p>\n
\n“`
\n\/trigger setaction MyVolume enter CONSOLE_COMMAND give %player% diamond 1
\n\/trigger setaction MyVolume enter CONSOLE_COMMAND effect give %player% speed 30 1
\n\/trigger setaction MyVolume leave CONSOLE_COMMAND clear %player%
\n“`<\/p>\n
\n– `%player%` – Player’s name
\n– `%uuid%` – Player’s UUID<\/p>\n
\nSends a colored message to the player.<\/p>\n
\n“`
\n\/trigger setaction MyVolume enter MESSAGE &aWelcome to the safe zone!
\n\/trigger setaction MyVolume enter MESSAGE &6You are now in the &cDanger Zone&6!
\n\/trigger setaction MyVolume leave MESSAGE &7You left the protected area.
\n“`<\/p>\n
\n– `&0-9, a-f` – Standard Minecraft colors
\n– `&l` – Bold, `&o` – Italic, `&n` – Underline
\n– `&m` – Strikethrough, `&k` – Obfuscated
\n– `&r` – Reset formatting<\/p>\n
\nTeleports the player to specified coordinates.<\/p>\n
\n“`
\n\/trigger setaction MyVolume enter TELEPORT 100 64 200
\n\/trigger setaction MyVolume enter TELEPORT 0 70 0 90 0
\n\/trigger setaction MyVolume leave TELEPORT -50 65 -50 180 45
\n“`<\/p>\n
\n“`bash
\n# Get the selection tool
\n\/trigger tool<\/p>\n
\n# Left-click for position 1
\n# Right-click for position 2<\/p>\n
\n\/trigger create MyFirstVolume
\n“`<\/p>\n
\n“`bash
\n# Define volume with exact coordinates
\n\/trigger define MyFirstVolume 100 60 100 150 80 150
\n“`<\/p>\n
\n“`bash
\n# Send a welcome message
\n\/trigger setaction MyFirstVolume enter MESSAGE &aWelcome!<\/p>\n
\n\/trigger setaction MyFirstVolume enter CONSOLE_COMMAND give %player% diamond 1<\/p>\n
\n\/trigger setaction MyFirstVolume enter CONSOLE_COMMAND effect give %player% speed 30 1
\n“`<\/p>\n
\n“`bash
\n# Send a goodbye message
\n\/trigger setaction MyFirstVolume leave MESSAGE &cGoodbye!<\/p>\n
\n\/trigger setaction MyFirstVolume leave CONSOLE_COMMAND effect clear %player%<\/p>\n
\n\/trigger setaction MyFirstVolume leave TELEPORT 0 64 0
\n“`<\/p>\n
\n# Visualize the volume with particles
\n\/trigger visualize MyFirstVolume<\/p>\n
\n# Walk out of the volume – leave actions will execute<\/p>\n
\n\/trigger hide MyFirstVolume
\n“`<\/p>\n
\n# View all volumes
\n\/trigger list<\/p>\n
\n\/trigger info MyFirstVolume<\/p>\n
\n\/trigger clearactions MyFirstVolume enter # Clear only enter actions
\n\/trigger clearactions MyFirstVolume leave # Clear only leave actions
\n\/trigger clearactions MyFirstVolume all # Clear all actions<\/p>\n
\n\/trigger delete MyFirstVolume
\n“`<\/p>\n
\nCreate a safe zone that heals players and prevents PvP:<\/p>\n
\n\/trigger create SafeZone
\n\/trigger setaction SafeZone enter MESSAGE &a&lYou entered a safe zone!
\n\/trigger setaction SafeZone enter CONSOLE_COMMAND effect give %player% regeneration 999999 1 true
\n\/trigger setaction SafeZone enter CONSOLE_COMMAND effect give %player% resistance 999999 4 true
\n\/trigger setaction SafeZone leave MESSAGE &cYou left the safe zone!
\n\/trigger setaction SafeZone leave CONSOLE_COMMAND effect clear %player%
\n“`<\/p>\n
\nDisplay information when entering a shop:<\/p>\n
\n\/trigger create ShopEntrance
\n\/trigger setaction ShopEntrance enter MESSAGE &6&l=== SHOP ===
\n\/trigger setaction ShopEntrance enter MESSAGE &eWelcome to the market!
\n\/trigger setaction ShopEntrance enter MESSAGE &7Type \/shop to browse items
\n\/trigger setaction ShopEntrance enter PLAYER_COMMAND \/shop
\n“`<\/p>\n
\nWarn players entering a dangerous area:<\/p>\n
\n\/trigger create DangerZone
\n\/trigger setaction DangerZone enter MESSAGE &c&l\u26a0 WARNING \u26a0
\n\/trigger setaction DangerZone enter MESSAGE &cYou entered a dangerous area!
\n\/trigger setaction DangerZone enter MESSAGE &cProceed with caution!
\n\/trigger setaction DangerZone enter CONSOLE_COMMAND playsound entity.ender_dragon.growl player %player%
\n\/trigger setaction DangerZone leave MESSAGE &aYou are now safe.
\n“`<\/p>\n
\nCreate a portal that teleports players:<\/p>\n
\n\/trigger create TeleportHub
\n\/trigger setaction TeleportHub enter MESSAGE &6Teleporting to spawn…
\n\/trigger setaction TeleportHub enter TELEPORT 0 64 0 0 0
\n“`<\/p>\n
\nGive players items when entering a mining area:<\/p>\n
\n\/trigger create MiningZone
\n\/trigger setaction MiningZone enter MESSAGE &6You received mining equipment!
\n\/trigger setaction MiningZone enter CONSOLE_COMMAND give %player% iron_pickaxe 1
\n\/trigger setaction MiningZone enter CONSOLE_COMMAND give %player% torch 16
\n\/trigger setaction MiningZone leave MESSAGE &7Your mining equipment was removed.
\n\/trigger setaction MiningZone leave CONSOLE_COMMAND clear %player% iron_pickaxe
\n\/trigger setaction MiningZone leave CONSOLE_COMMAND clear %player% torch
\n“`<\/p>\n
\nClone a volume’s actions to a new area:<\/p>\n
\n# Select new area with the tool
\n\/trigger tool
\n# Left-click and right-click to select<\/p>\n
\n\/trigger clone SafeZone MySafeZone2
\n# This creates MySafeZone2 with all actions from SafeZone<\/p>\n
\n\/trigger clone
\n# Creates volume_1, volume_2, etc.<\/p>\n
\n\/trigger clone SafeZone
\n# Creates SafeZone_clone, SafeZone_clone1, etc.
\n“`<\/p>\n
\nCopy actions from one volume to another without selection:<\/p>\n
\n# Copy all actions from DangerZone to AnotherDangerZone
\n\/trigger copypaste DangerZone AnotherDangerZone
\n# Both enter and leave actions are copied
\n“`<\/p>\n
\nManage multiple volumes as a group:<\/p>\n
\n# Create a group of shop volumes
\n\/trigger creategroup AllShops Shop1 Shop2 Shop3<\/p>\n
\n\/trigger groupadd AllShops Shop4
\n\/trigger groupadd AllShops Shop5<\/p>\n
\n\/trigger setaction AllShops enter MESSAGE &6Welcome to the shop!
\n\/trigger setaction AllShops enter CONSOLE_COMMAND effect give %player% glowing 10
\n\/trigger setaction AllShops leave MESSAGE &7Thanks for visiting!<\/p>\n
\n\/trigger groupremove AllShops Shop1<\/p>\n
\n\/trigger clearactions AllShops all<\/p>\n
\n\/trigger deletegroup AllShops
\n# Note: If a group has less than 2 volumes after removal, it’s automatically deleted
\n“`<\/p>\n
\n– `triggervolumes.admin` – Access to all commands (default: OP)
\n – Create, delete, and manage volumes
\n – Set and clear actions
\n – Visualize volumes
\n – Reload configuration<\/p>\n
\n– `triggervolumes.use` – Trigger actions when entering\/leaving volumes (default: all players)<\/p>\n
\n“`bash
\n# Give admin permission to specific player
\n\/lp user PlayerName permission set triggervolumes.admin true<\/p>\n
\n\/lp group admin permission set triggervolumes.admin true<\/p>\n
\n\/lp group guest permission set triggervolumes.use false
\n“`<\/p>\n
\n“`bash
\n# Give admin permission
\n\/pex user PlayerName add triggervolumes.admin<\/p>\n
\n\/pex group admin add triggervolumes.admin
\n“`<\/p>\n
\n– **Separate Cooldowns**: Enter and leave actions have independent cooldowns
\n– **Per-Volume**: Each volume has its own cooldown timer per player
\n– **Configurable**: Default cooldown time can be set in `config.yml`<\/p>\n
\n“`yaml
\ncooldowns:
\n enabled: true # Enable\/disable cooldown system
\n default-cooldown: 3 # Cooldown duration in seconds
\n“`<\/p>\n
\n– When a player triggers an action, they cannot trigger the same action type (enter\/leave) for that volume again until the cooldown expires
\n– Cooldowns are cleared when players leave the server
\n– This prevents spam from players walking back and forth across volume boundaries<\/p>\n
\n– **Green** (VILLAGER_HAPPY): Volumes with actions
\n– **Red** (REDSTONE): Volumes without actions
\n– **Blue** (WATER_SPLASH): Currently being visualized<\/p>\n
\n“`yaml
\nparticles:
\n update-interval: 5 # Ticks between updates (20 ticks = 1 second)
\n density: 0.5 # Block spacing between particles
\n visualization-duration: 30 # Auto-hide after X seconds
\n“`<\/p>\n
\n“`bash
\n# Show particles for 30 seconds
\n\/trigger visualize MyVolume<\/p>\n
\n\/trigger hide MyVolume
\n“`<\/p>\n
\n– The world is divided into 16\u00d716 block chunks (Minecraft’s standard chunk size)
\n– Each volume is registered in all chunks it overlaps
\n– When checking if a player is in a volume, only volumes in the current chunk are checked<\/p>\n
\n| Number of Volumes | Without Optimization | With Spatial Hashing | Speedup |
\n|——————-|———————|———————|———-|
\n| 10 volumes | 10 checks | 2-3 checks | 3-5\u00d7 faster |
\n| 100 volumes | 100 checks | 5-8 checks | 12-20\u00d7 faster |
\n| 1000 volumes | 1000 checks | 5-10 checks | 100-200\u00d7 faster |<\/p>\n
\n– **Scalable**: Handles thousands of volumes without lag
\n– **Efficient**: O(k) instead of O(n) where k = volumes per chunk
\n– **Automatic**: No configuration needed, works out of the box
\n– **Real-time**: Updates instantly when volumes are created\/deleted<\/p>\n
\n– No special configuration required
\n– Works best when volumes don’t span too many chunks
\n– Automatically rebuilds spatial index when needed<\/p>\n
\nplugins\/TriggerVolumes\/
\n\u251c\u2500\u2500 config.yml # Main configuration
\n\u251c\u2500\u2500 triggervolumes.yml # Stored volumes and actions
\n\u2514\u2500\u2500 lang\/ # Language files
\n \u251c\u2500\u2500 en.yml # English (default)
\n \u251c\u2500\u2500 de.yml # German
\n \u251c\u2500\u2500 fr.yml # French
\n \u251c\u2500\u2500 pl.yml # Polish
\n \u251c\u2500\u2500 ru.yml # Russian
\n \u251c\u2500\u2500 ja.yml # Japanese
\n \u2514\u2500\u2500 es.yml # Spanish
\n“`<\/p>\n
\n“`bash
\n# Create a group with at least 2 volumes
\n\/trigger creategroup MyGroup Volume1 Volume2 Volume3
\n“`<\/p>\n
\nGroups can be used wherever you would use a volume name:<\/p>\n
\n# Apply actions to all volumes in a group
\n\/trigger setaction MyGroup enter MESSAGE &aWelcome!
\n\/trigger setaction MyGroup leave MESSAGE &cGoodbye!<\/p>\n
\n\/trigger clearactions MyGroup enter
\n\/trigger clearactions MyGroup all
\n“`<\/p>\n
\n“`bash
\n# Add a volume to an existing group
\n\/trigger groupadd MyGroup NewVolume<\/p>\n
\n\/trigger groupremove MyGroup OldVolume<\/p>\n
\n\/trigger info Volume1
\n# Shows: “Groups: MyGroup, AnotherGroup”<\/p>\n
\n\/trigger deletegroup MyGroup
\n“`<\/p>\n
\n– Groups require a minimum of 2 volumes
\n– When removing a volume leaves less than 2 volumes, the group is automatically deleted
\n– A volume can belong to multiple groups simultaneously
\n– Removing a volume from a group doesn’t delete the volume itself<\/p>\n
\n– **Batch Operations**: Apply actions to multiple volumes simultaneously
\n– **Independent Volumes**: Deleting a group doesn’t delete the volumes
\n– **Multiple Membership**: A volume can belong to multiple groups
\n– **Persistent**: Groups are saved and loaded with the plugin<\/p>\n
\nvolumes:
\n MyVolume:
\n world: world
\n minX: 100.0
\n minY: 60.0
\n minZ: 100.0
\n maxX: 150.0
\n maxY: 80.0
\n maxZ: 150.0
\n enterActions:
\n 0:
\n type: MESSAGE
\n value: “&aWelcome!”
\n 1:
\n type: CONSOLE_COMMAND
\n value: “effect give %player% speed 30 1”
\n leaveActions:
\n 0:
\n type: MESSAGE
\n value: “&cGoodbye!”
\ngroups:
\n MyGroup:
\n name: MyGroup
\n volumes:
\n – Volume1
\n – Volume2
\n – Volume3
\n“`<\/p>\n
\n1. Check permissions: Player needs `triggervolumes.use`
\n2. Verify actions exist: `\/trigger info
\n3. Check cooldown: Actions have a 3-second cooldown by default
\n4. Visualize volume: `\/trigger visualize
\n5. Check console for errors<\/p>\n
\n1. Ensure you have the correct tool (default: Wooden Hoe)
\n2. Check you have `triggervolumes.admin` permission
\n3. Try getting a new tool: `\/trigger tool`
\n4. Verify you’re clicking blocks, not air<\/p>\n
\n1. Check your particle settings in client (Options > Video Settings > Particles)
\n2. Verify the volume exists: `\/trigger info
\n3. Try standing closer to the volume
\n4. Check if another volume is being visualized (only one at a time)<\/p>\n
\n1. Check permission: `triggervolumes.admin` for setup commands
\n2. Verify volume name is correct (case-insensitive)
\n3. Use quotes for values with spaces: `\/trigger setaction MyVolume enter MESSAGE “Hello World”`
\n4. Check console for detailed error messages<\/p>\n
\n1. The plugin uses spatial hashing (v1.0.3+) which handles thousands of volumes efficiently
\n2. Reduce particle density in `config.yml`
\n3. Increase particle update interval
\n4. Disable visualization when not needed
\n5. Increase cooldown times
\n6. Note: Performance issues with volumes are rare due to optimization<\/p>\n
\nAll actions support these placeholders:
\n– `%player%` – Player’s name
\n– `%uuid%` – Player’s UUID<\/p>\n
\n“`bash
\n\/trigger setaction Welcome enter CONSOLE_COMMAND tellraw @a {“text”:”Player %player% entered spawn!”,”color”:”gold”}
\n“`<\/p>\n
\nVolumes support unlimited actions per trigger type:
\n“`bash
\n\/trigger setaction MyVolume enter MESSAGE &aWelcome!
\n\/trigger setaction MyVolume enter MESSAGE &eEnjoy your stay!
\n\/trigger setaction MyVolume enter CONSOLE_COMMAND give %player% diamond 1
\n\/trigger setaction MyVolume enter PLAYER_COMMAND \/heal
\n“`<\/p>\n
\nPlayers can be in multiple volumes simultaneously. Each volume’s actions will trigger independently when the player enters\/leaves.<\/p>\n
\nVolumes are world-specific. A volume in “world” won’t trigger for players in “world_nether”.<\/p>\n
\nUse groups to organize related volumes:
\n“`bash
\n# Group all spawn protection zones
\n\/trigger creategroup SpawnZones SpawnSafe1 SpawnSafe2 SpawnSafe3<\/p>\n
\n\/trigger creategroup Shops MainShop ArmorShop FoodShop<\/p>\n
\n\/trigger setaction SpawnZones enter MESSAGE &aYou are now in spawn!
\n“`<\/p>\n
\nGroups can be modified after creation:
\n“`bash
\n# Create initial group
\n\/trigger creategroup ActiveShops Shop1 Shop2<\/p>\n
\n\/trigger groupadd ActiveShops Shop3
\n\/trigger groupadd ActiveShops Shop4<\/p>\n
\n\/trigger groupremove ActiveShops Shop2<\/p>\n
\n\/trigger groupadd ActiveShops Shop2<\/p>\n
\n\/trigger groupremove ActiveShops Shop1 # Group still exists (3 volumes)
\n\/trigger groupremove ActiveShops Shop3 # Group still exists (2 volumes)
\n\/trigger groupremove ActiveShops Shop4 # Group auto-deleted (would have 1 volume)
\n“`<\/p>\n
\n– **Clone**: Creates a new volume from your selection + copies actions
\n – Requires selection with tool
\n – Creates new volume
\n – Optional: specify source and custom name<\/p>\n
\n – No selection needed
\n – Works with existing volumes only
\n – Faster for duplicating actions<\/p>\n
\nSimply copy the `triggervolumes.yml` file to backup or transfer volumes to another server. Groups are also saved in this file.<\/p>\n
\n“`xml
\n
\n
\n
\n
\n
\n<\/dependency>
\n“`<\/p>\n
\n“`java
\nTriggerVolumesPlugin plugin = (TriggerVolumesPlugin) Bukkit.getPluginManager().getPlugin(“TriggerVolumes”);
\n“`<\/p>\n
\n“`java
\nTriggerVolumeManager manager = plugin.getVolumeManager();
\nList
\n \/\/ Location is in at least one volume
\n}
\n“`<\/p>\n
\n“`java
\nTriggerVolumeManager manager = plugin.getVolumeManager();
\nmanager.createVolume(“MyVolume”, “world”, 0, 60, 0, 100, 80, 100);<\/p>\n
\nTriggerAction action = new TriggerAction(ActionType.MESSAGE, “&aHello!”);
\nmanager.addEnterAction(“MyVolume”, action);
\n“`<\/p>\n
\n– Check this documentation first
\n– Look for errors in console logs
\n– Ask in the Spigot forums
\n– Open an issue on GitHub<\/p>\n
\nWhen reporting bugs, please include:
\n1. Server version (Spigot\/Paper)
\n2. Plugin version
\n3. Full error message from console
\n4. Steps to reproduce the issue
\n5. Relevant configuration files<\/p>\n
\nHave an idea? Open an issue on GitHub with:
\n– Clear description of the feature
\n– Use case \/ why it’s needed
\n– Example of how it would work<\/p>\n
\n– **Version**: 1.0.4
\n– **Built with**: Maven, Spigot API, Java 17<\/p>\n