Controls

Advanced controls to make your actions smarter.

Controls are added before any action, separated by spaces.

Format

control:value control:value action:value

⏱️ Cooldown

Prevents the action from running again for X seconds.

cooldown:30 message:&aWelcome!
AliasesExample
cooldown: cd:cd:30 message:&aHello!

How it works

Player enters → action runs → blocked for 30s
Player leaves and returns in 10s → blocked
Player returns after 30s → runs again

🎲 Chance

X% chance of running the action.

chance:50 message:&aYou got lucky!
AliasesExample
chance: ch: random:ch:50 message:&aHello!

⏳ Delay

Wait X seconds before running the action.

delay:3 message:&aWaited 3 seconds!
AliasesExample
delay: wait:wait:3 message:&aHello!

🔄 Repetitive

Repeats the action every X seconds while the player stays inside.

repetitive:10 actionbar:&aYou are inside!
AliasesExample
repetitive: repeat: loop:repeat:10 actionbar:&aHello!

Auto-stop

When the player leaves the region, the repetitive action stops automatically.

Also stops when the player disconnects.

🎯 Combining Controls

You can combine multiple controls in one action!

cooldown:5 chance:50 delay:2 repetitive:10 actionbar:&aYou are in the zone!

💡 Real Examples

Smart Portal (with effects)

cooldown:10 delay:2 bossbar:&5&lPORTAL;100;PURPLE;SOLID sound:ENTITY_ENDERMAN_TELEPORT console:tp %player% world_nether 100 64 100

PvP Zone Warning (repeating)

repetitive:5 actionbar:&c&lYou are in a PvP zone!

Lucky Reward (10% chance)

chance:10 give_money:1000 message:&a&lJACKPOT! You got 1000 coins!