Config offenses.yml - BeestoXd/UltimateDonutSMP-V2 GitHub Wiki
The preset punishments staff pick from with /offend, and the escalating tiers each one
runs through. Rather than asking staff to judge a duration, they choose the offence and the
plugin applies the right tier based on how many times that player has done it before.
durations is that ladder: the first entry is the first offence, the second the second,
and the last entry repeats for every offence after it. A tier of perm never expires, and
a tier of 0s is issued as a warning instead of a ban.
Treat wipe: true with care. It only fires when the offence actually bans someone, and it
clears that player's stats, balance, homes, ender chest, keys, auctions and orders — the
same thing /playerwipe does. /playerunwipe <player> confirm puts those records back from
plugins/UltimateDonutSmp2/player-wipe-backups/. Punishment history, IP history and placed
spawners are kept.
Comment at the top of the shipped file:
Configuration file for preset offenses and escalating punishment tiers.
Syntax per offense:
<key>:
name: "Display Name"
type: BAN | MUTE | WARN | KICK
wipe: false # optional, defaults to false
durations:
- "30d" # 1st offense
- "60d" # 2nd offense
- "perm" # 3rd offense (and beyond)
wipe only fires when the offense actually bans someone. It clears their stats, balance, homes,
ender chest, crate keys, auctions, orders and the rest of their progress, the same thing
/playerwipe does. That wipe writes a backup under plugins/UltimateDonutSmp2/player-wipe-backups/
first, and /playerunwipe <player> confirm puts those records back. Their punishment history,
IP history and any spawners they placed are kept. A tier of "0s" is issued as a warning rather
than a ban, so it does not wipe, and neither do MUTE, WARN or KICK offenses.
| On disk | plugins/UltimateDonutSmp2/offenses.yml |
| Commands | /offend <player> <reason> [time] [wipe] |
| Player-facing text | Not translated. Edit this file directly. |
| Reload | /ultimatedonutsmp2 reload |
| Section | Type | Contents |
|---|---|---|
offenses |
section | 61 keys |
Each entry under offenses is keyed by a name you choose, and every entry accepts the same options:
| Entry key | name |
type |
durations |
|---|---|---|---|
advertising |
Advertising |
BAN |
30d |
advertising-invite-rewards |
Advertising Invite Rewards |
BAN |
30d |
advertising-irl-trade |
Advertising IRL Trade |
BAN |
3d |
alt-limit |
Alt Limit Violation |
BAN |
perm |
anticheat |
Anticheat Detection |
BAN |
30d |
auto-chat-filter |
Auto Chat Filter Violation |
MUTE |
24h, 3d |
ban-evasion |
Ban Evasion |
BAN |
perm |
baritone |
Baritone / Automation |
BAN |
30d, 60d, 360d |
botting |
Botting |
BAN |
perm |
bug-abuse |
Bug Abuse |
BAN |
14d, perm |
entity-radar |
Entity Radar |
BAN |
3d, 30d |
esp |
ESP Hacks |
BAN |
30d, 60d, 360d |
macros |
Macros |
BAN |
7d, 40d |
major-inappropriate-build |
Major Inappropriate Build |
BAN |
7d, 30d |
major-language |
Major Language Violation |
MUTE |
24h, 7d |
make-a-ticket |
Ticket Abuse / Ban Appeal Required |
BAN |
perm |
chat-capslock |
Chat Caps Lock Spam |
MUTE |
24h, 3d |
chat-death-threats |
Chat Death Threats |
BAN |
24h, 30d, perm |
chat-flooding |
Chat Flooding |
MUTE |
24h, 3d |
chat-harassment |
Chat Harassment |
MUTE |
24h, 3d, 30d, 720d, perm |
chat-hate |
Chat Hate Speech |
MUTE |
0s, 24h, 3d, 30d, perm |
chat-racism |
Chat Racism |
BAN |
30d, perm |
chat-spam |
Chat Spam |
MUTE |
0s, 3d, 30d |
chat-toxicity |
Chat Toxicity |
MUTE |
24h, 3d, 30d, perm |
cheating |
Cheating / Unfair Advantage |
BAN |
14d, 30d, perm |
compromised-account |
Compromised Account |
BAN |
perm |
macros-skripts |
Macros / Skripts |
BAN |
7d, 40d |
autopunish |
Auto Punish Trigger |
BAN |
14d, 30d, perm |
ban-evading |
Ban Evading |
BAN |
30d, perm |
cross-trading |
Cross Trading |
BAN |
30d, perm |
doxing |
Doxing / PII Leak |
BAN |
24h, 30d, perm |
duping |
Item Duping |
BAN |
3d, perm |
external-gambling |
External Gambling |
BAN |
14d |
gambling-ownership |
Gambling Ownership |
BAN |
3d, 30d |
hacking |
Hacking |
BAN |
14d, 30d, perm |
radar-minimap |
Radar / Minimap Hacks |
BAN |
3d, 30d |
ratting |
Ratting / Malware |
BAN |
perm |
soundboard-proximity |
Soundboard Proximity Abuse |
MUTE |
30d |
spamming-chat |
Spamming Chat |
MUTE |
24h, 3d |
streaming-advertising-rat-clients |
Streaming/Advertising Rat Clients |
BAN |
14d, 60d, 180d |
streaming-cheat-client-pvp |
Streaming Cheat Client PVP |
BAN |
7d, 30d |
streaming-just-hack-client-no-advantage |
Streaming Hack Client No Advantage |
BAN |
14d, 60d |
suicide-encouragement-proximity |
Suicide Encouragement Proximity |
BAN |
30d, perm |
toxicity-hate-harassment-in-chat-sign |
Toxicity/Hate/Harassment in Chat/Sign |
MUTE |
24h, 3d, 30d, perm |
xray-esp-baritone |
X-Ray / ESP / Baritone |
BAN |
30d, 60d, 360d |
bot-owner |
Bot Owner |
BAN |
perm |
health-indicators |
Health Indicators Abuse |
BAN |
7d, 30d |
mute-evasion |
Mute Evasion |
MUTE |
7d, 30d |
inappropriate-builds |
Inappropriate Builds |
BAN |
7d, 30d |
inappropriate-language |
Inappropriate Language |
MUTE |
30d |
inappropriate-proximity |
Inappropriate Proximity Chat |
MUTE |
30d |
inappropriate-skin |
Inappropriate Skin |
BAN |
1d, 7d |
invite-rewards |
Invite Rewards Exploitation |
BAN |
14d |
invite-rewards-ownership |
Invite Rewards Ownership Abuse |
BAN |
30d |
racism-in-chat-sign |
Racism in Chat/Sign |
BAN |
30d, perm |
proximity-racism |
Proximity Racism |
BAN |
30d, perm |
proximity-toxicity-hate-harassment |
Proximity Toxicity/Hate/Harassment |
MUTE |
30d, perm |
lying-to-staff |
Lying to Staff |
BAN |
7d, 30d |
irltrade-booster |
IRL Trade / Booster Abuse |
BAN |
3d, 14d, 180d |
irl-trading-ownership |
IRL Trading Ownership |
BAN |
720d, perm |
teaming-with-cheater |
Teaming with Cheater |
BAN |
perm |
| Key | Type | Accepted values | Required? | What it does |
|---|---|---|---|---|
durations |
list |
A list of values | Required | Escalation ladder, one duration per prior offence. Accepts 30d, 24h, perm, and 0s for a warning. The final entry repeats for all later offences. |
name |
string |
Any text | Required | Display name shown to staff in /offend and in punishment messages. |
type |
string |
Any text | Required | Punishment applied: BAN, MUTE, WARN or KICK. |
wipe |
boolean |
true, false
|
Optional | When true, automatically runs a player wipe on BAN and BLACKLIST punishments. Defaults to false. Can be overridden per-use with the 4th argument of /offend <player> <reason> [time] [wipe] (wipe/true or nowipe/false). |
Default offenses block as shipped
offenses:
advertising:
name: "Advertising"
type: BAN
durations:
- "30d"
advertising-invite-rewards:
name: "Advertising Invite Rewards"
type: BAN
durations:
- "30d"
advertising-irl-trade:
name: "Advertising IRL Trade"
type: BAN
durations:
- "3d"
alt-limit:
name: "Alt Limit Violation"
type: BAN
durations:
- "perm"
anticheat:
name: "Anticheat Detection"
type: BAN
durations:
- "30d"
auto-chat-filter:
name: "Auto Chat Filter Violation"
type: MUTE
durations:
- "24h"
- "3d"
ban-evasion:
name: "Ban Evasion"
type: BAN
durations:
- "perm"
baritone:
name: "Baritone / Automation"
type: BAN
durations:
# ... section continues, see the file on disk for the full blockDefaults above match the file shipped in the jar.