AstroBackCooldown
v1.0.01.20+AstroBackCooldown adds a configurable cooldown to the /back command. Different cooldowns for different LuckPerms groups, or use a single global cooldown.
Overview
The /back command, which returns a player to their previous location or death point, is convenient but easy to abuse: in PvP or hardcore-leaning survival it lets a player teleport straight back to a fight or to the exact spot they just died, undercutting the risk that makes those moments matter. AstroBackCooldown adds a cooldown to /back so it can still be used, just not instantly and repeatedly, restoring some weight to dying and disengaging.
The cooldown can be a single global value or, more usefully, vary by rank. Reading groups from LuckPerms, you can give donor or VIP tiers a shorter wait while default players wait longer, and set staff to zero so moderation is never slowed down. This turns a faster /back into a tangible rank perk rather than just a number in a config. When a player tries to use /back too soon, they get a clear, customisable message telling them how long is left.
It is designed to sit on top of the /back you already have rather than replace it. It hooks the command provided by EssentialsX or CMI and simply gates it, so you keep your existing teleport plugin and its behaviour and only add the cooldown layer. Staff can be given a bypass permission to skip the wait entirely.
Who it is for
PvP, survival and hardcore-leaning servers that want /back to carry a cost, networks selling shorter cooldowns as a rank perk, and any server running EssentialsX or CMI that wants to rein in instant return-to-death teleporting.
Features
- Configurable cooldown duration
- Per-group cooldowns via LuckPerms (optional)
- Bypass permission for staff
- Customizable cooldown message
- Works with EssentialsX and CMI
Commands
| Command | Description | Permission |
|---|---|---|
/backcooldown reload | Reload config | astrobackcd.admin |
Permissions
| Node | Description | Default |
|---|---|---|
astrobackcd.bypass | Bypass cooldown | op |
astrobackcd.admin | Use reload | op |
Example Config
# AstroBackCooldown Configuration
default-cooldown-seconds: 30
cooldowns:
vip: 15
mvp: 10
staff: 0
messages:
cooldown: "&cYou must wait %remaining% seconds before using /back again."default-cooldown-seconds is the fallback wait applied when no group-specific value matches. Under cooldowns, list group names with their own durations; the plugin matches a player to a group via LuckPerms, so a 'staff: 0' entry effectively removes the cooldown for staff. The messages.cooldown line is shown when a player is still waiting, with %remaining% replaced by the seconds left.
Installation
Drop AstroBackCooldown.jar into /plugins and restart. It gates the /back command from EssentialsX or CMI, so one of those (or another plugin that provides /back) must be installed for it to do anything. For per-group cooldowns it reads groups from LuckPerms; without LuckPerms it applies the single default cooldown to everyone. A config.yml is generated on first run.
Download
Frequently Asked Questions
Does this plugin add a /back command?
No. AstroBackCooldown does not provide /back; it adds a cooldown to the /back command supplied by another plugin such as EssentialsX or CMI. You need one of those installed for /back to exist, and this plugin gates it. That way you keep your existing teleport behaviour and only layer the cooldown on top.
Can different ranks have different cooldowns?
Yes, and that is the main feature. With LuckPerms installed, you map group names to cooldown durations in the config, so VIP players can wait less than default players and staff can be set to zero. The plugin reads the player's group from LuckPerms to decide which cooldown applies.
What happens if I do not have LuckPerms?
Without LuckPerms the per-group cooldowns cannot be resolved, so the plugin applies the single default-cooldown-seconds value to every player. Basic global cooldown behaviour still works fully; you just lose the ability to vary the wait by rank.
How does a player skip the cooldown?
Grant the astrobackcd.bypass permission to anyone who should not be limited, typically staff. Players with that node can use /back without any wait. By default it is op-only, so assign it through your permissions plugin to the appropriate group.
Does it work with EssentialsX and CMI?
Yes. It is built to hook the /back command provided by either EssentialsX or CMI and apply the cooldown to it, so it fits the two most common teleport setups without you changing your existing plugin.
How do I change the cooldown message?
Edit messages.cooldown in the config; the %remaining% placeholder is replaced with the seconds the player still has to wait. Run /backcooldown reload to apply your changes without restarting the server.