https://github.com/eth-p/bukkit-admin-su
A zero-configuration plugin for toggleable admin permissions.
https://github.com/eth-p/bukkit-admin-su
Last synced: 8 months ago
JSON representation
A zero-configuration plugin for toggleable admin permissions.
- Host: GitHub
- URL: https://github.com/eth-p/bukkit-admin-su
- Owner: eth-p
- Created: 2020-08-29T09:06:53.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-09-30T15:57:18.000Z (over 5 years ago)
- Last Synced: 2025-04-03T08:40:38.388Z (about 1 year ago)
- Language: Java
- Size: 157 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# admin-su
A zero-configuration plugin for toggling admin permissions (like cheats).
This plugin is great for when you want to play on your survival server without cheats.
## Requirements
- Java: 8+
- Bukkit: 1.14+
- LuckPerms is highly recommended.
## Features
The admin-su plugin is intended to be used with the [LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/) permission plugin,
and it provides an extra `su=true` context for when players are in admin mode.
This allows for highly flexible configurations that don't differentiate between admins and players, unless admin cheats are needed for moderation purposes.
If an unsupported permissions plugin is being used (anything that isn't LuckPerms), this plugin will instead toggle the player's `/op` status on and off.
**Other features:**
- PlaceholderAPI support.
- Completely configurable messages.yml file.
## Commands
### /su toggle
**Alias:** `/su`
**Permission:** `adminsu.toggle`
Toggles between admin and player mode.
### /su enable
**Alias:** `/su on`
**Permission:** `adminsu.toggle`
Turns on admin mode.
### /su disable
**Alias:** `/su off`
**Permission:** `adminsu.toggle`
Turns off admin mode.
### /su check
**Permission:** `adminsu.check`
Checks the current admin status of another player.
### /su reload
**Permission:** `adminsu.reload`
Reloads the localization messages.
## Permissions
Permissions need to be explicitly given to players through LuckPerms.
By default, ops will *not* have permission to `/su toggle`.
|Permission|Description|
|:--|:--|
|`adminsu.command.toggle`|Gives access to `/su toggle`, `/su on`, and `/su off`.|
|`adminsu.command.check`|Gives access to `/su check `.|
|`adminsu.command.reload`|Gives access to `/su reload`|
|`adminsu.spy`|Receive a message whenever another player enters admin mode. Type `/su` to get a response back.|
## Placeholders
|Placeholder|Values|Description|
|:--|:--|:--|
|`%adminsu_enabled%`|`true`/`false`|Whether or not the player is in admin mode.|
|`%adminsu_capable%`|`true`/`false`|Whether or not the player has perms for admin mode.|
|`%adminsu_enabled_for%`|`dd:hh:mm:ss`|How long the player has been in admin mode for.|
|`%adminsu_enabled_for_total_seconds%`|`dd:hh:mm:ss`|How long the player has been in admin mode for, in seconds.|