RegionAction A lightweight and powerful region trigger system for Minecraft
servers.Create custom regions and automatically execute actions when players enter or leave them.
(Perfect for)
Spawn areas, cities/towns, RPG servers, adventure maps, boss areas, and custom background music.
Plugin Functionality :» Custom cuboid region system
» In-game region selection wand
» Left click to set Point A
» Right click to set Point B
» Particle outline preview while selecting a region
» Enter region trigger
» Leave region trigger
» Custom enter and leave titles
» Custom enter and leave subtitles
» Execute commands when entering a region
» Execute commands when leaving a region
» PlaceholderAPI support for commands
» Supports the %player% variable
» Play custom sounds or music when entering a region
» Sound delay support
» Sound loop support
» Automatically stops sounds when leaving the region
» Priority-based region system
» Supports overlapping regions
» If regions have the same priority, the smaller region is selected first
» Fully configurable messages
» Configurable title timing
» Configurable wand item
» Debug mode for troubleshooting
» Auto-save region data
» Human-readable save.yml file with comments
» Tab completion support
» The message.yml file is currently in Chinese; you can change it to your preferred language.
» When you first launch the plugin and complete the settings, a folder named "data" will be automatically created under "plugins". You can find the configuration file in this folder and manually configure it.
»In the future, we may add MMoCore category-level restrictions to the RegionAction add-on to allow "entry" into specific regions. If the category requirements are not met, the selected region will be "blocked".
Server configuration requirements Java 17+
Minecraft 1.21+
spigot/pupur/paper
PlaceholderAPI
Commands :
/rac - Show plugin information
/rac give <player> - Give a player the region selection wand
/rac create <id> - Create a new region from the selected points
/rac delete <id> - Delete an existing region
/rac list - List all created regions
/rac reload - Reload configuration, messages, and region data
/rac debug - Toggle debug mode
Permissions :
regionaction.admin - Allows access to RegionAction admin commands
regionaction.use - Allows players to trigger regions
How to Create a Region? :
Use /rac give <player> to get the selection wand.
Left click a block to set Point A.
Right click a block to set Point B.
A particle outline will preview the selected area.
Use /rac create <id> to create the region.
Edit the plugins/RegionAction/data/save.yml file to customize titles, commands, sounds, priority, and more.
Use /rac reload to apply the changes.
Example Region Config
YAML:
spawn:
world: world
priority: 100
pos1:
x: 100
y: 0
z: 100
pos2:
x: 200
y: 200
z: 200
enter:
title: '&7[&6 Spawn Area &7]'
subtitle: '&aWelcome to the safe zone!'
commands:
- 'say %player% entered the spawn area'
leave:
title: '&7[&6 Spawn Area &7]'
subtitle: '&cYou left the safe zone!'
commands:
- 'say %player% left the spawn area'
sound: 'minecraft:music.sound1'
sound-length: 120
sound-loop: true
sound-delay: 0Region Priority System :
RegionAction supports overlapping regions.
When a player is inside multiple regions, the plugin will select the region with the highest priority value.
If two regions have the same priority, the smaller region will be selected first.
This is very useful for large world regions that contain smaller towns, buildings, boss area, or special event areas.
Sound and Music System :
RegionAction can play custom sounds or music when a player enters a region.
sound - The sound ID to play
sound-length - The length of the music in seconds
sound-loop - Whether the sound should loop
sound-delay - Delay before the sound starts playing
When the player leaves the region, the sound will automatically stop.
PlaceholderAPI Support Commands executed by RegionAction support PlaceholderAPI placeholders.
Example:
YAML:
enter:
commands:
- 'give %player% diamond 1'
- 'say %player_name% entered a special region'
YAML:
# ===================================================#
# RegionAction - V1.0.0 Config File
# by Y2-Dev / XiaoYu5530
# Region Trigger / Title Display / Commands / Music
# ===================================================#
# Enable debug mode
# When enabled, detailed logs will be printed in the console
# Warning: this may spam the console because player movement is checked frequently
debug: false
# Sound settings
# max-volume: Maximum sound volume
# 1.0 = normal volume, 0.5 = half volume
sound:
fade:
max-volume: 1.0
# Command execution settings
# false = execute commands from console
# true = execute commands as the player with temporary OP permission
commands:
as-player: false
# Region selection wand settings
wand:
material: BLAZE_ROD # The material of the selection wand
name: "&6&lRegion Selection Wand"
lore:
- ""
- "&7Left click a block to set &aPoint A"
- "&7Right click a block to set &bPoint B"
# Title display time
# 20 ticks = 1 second
title:
fade-in: 10 # Title fade-in time
stay: 40 # Title stay time
fade-out: 10 # Title fade-out time
# Internal region check settings
region:
check-distance: 2 # 1 = check every block, 2+ = slightly better performance
Use Cases :» Display a title when entering a city
» Play custom background music in towns or cities
» Run commands when players enter a boss area
» Create RPG-style region notifications
» Create adventure map triggers
» Manage multiple overlapping regions with different priorities
Installation :
Download RegionAction.jar
Place it into your server's plugins folder
Install PlaceholderAPI
Restart your server
Configure the plugin files
Preview ![[圖]](https://img.builtbybit.com/zXWm4rVBZz3vjF8_OYCDFMTPtIuSpFGc9yuC1yJQs-w/resize:fill:2000/format:webp/aHR0cHM6Ly9yYXcuZ2l0aHVidXNlcmNvbnRlbnQuY29tL1hpYW9ZdTU1MzBzL1JlZ2lvbkFjdGlvbi9tYWluL2Fzc2V0cy9yZWdpb25hY3Rpb24tcHJldmlldy5naWY "[圖]")
Plug-in SupportIf you need assistance, find bugs, or have suggestions for new features, please feel free to contact the author.
Discord：xiaoyu_5530
