Tags
Creators
Details
1.3.0
Compatibility
Changes
☠️ BetterPunish v1.3.0 - Moderation Suite Update
Version 1.3.0 is a major update focused on faster staff work, cleaner chat, better investigations, and more consistent punishments.
This release adds progressive offenses, staff notes, player profiles, chat control tools, a freeze system with disconnect protection, database wipe tools, and improved tab completion.
New Features
Progressive Offenses
Added /offend, a new command for rule-based punishment escalation.
- Tracks offenses by category, such as cheating, spam, toxicity, advertising, hate speech, and more.
- Automatically escalates punishments from warning to tempban to permanent ban.
- Supports silent mode with
-s. - Protects exempt players with
tggpunish.offend.exempt. - Resets active category offenses when a player is unbanned or unmuted.
Global Chat Control
Added tools to quickly control server chat during raids, spam waves, or heated situations.
/clearchat [reason]clears chat for regular players while keeping staff history visible./clearchat all [reason]or/clearchat -aclears chat for everyone./mutechat [reason]toggles global chat mute./slowmode <seconds|off>adds or removes a delay between messages.- Staff and players with
betterpunish.chat.bypassare exempt where appropriate.
Player Freeze System
Added /freeze and /unfreeze for live investigations and screen checks.
- Stops frozen players from moving, fighting, interacting, dropping items, using inventory actions, or running blocked commands.
- Shows clear title, subtitle, actionbar, and chat instructions.
- Supports a clickable Discord support link.
- Automatically alerts staff if a frozen player disconnects.
- Can automatically ban freeze-loggers for a configurable duration.
Staff Notes
Added /note so staff can keep internal context on player behavior.
/note add <player> <text...>adds a note./note list <player>shows saved notes./note remove <player> <id>removes one note./note clear <player>removes all notes for a player.- Notes are saved asynchronously in
notes.yml.
Player Profiles
Improved /pinfo and /check into a central player overview.
The profile can show:
- Active bans, mutes, and shadowmutes
- Freeze status
- Staff notes
- Linked alt accounts by IP address
Database Wipe Command
Added /punishcleardb for administrators who need a clean reset.
- Clears local YAML punishment data.
- Clears remote Supabase PostgreSQL tables when configured.
- Requires
betterpunish.cleardb.
Better Tab Completion
Added tab completion support across the main command set, including punishments, notes, chat tools, reports, freeze commands, proof commands, player checks, suspects, and offenses.
Summary
BetterPunish v1.3.0 makes moderation faster, clearer, and more consistent. Staff get stronger tools, players get a cleaner chat experience, and server owners get a more complete moderation setup in one plugin.
Optional dependencies
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:61dNEC9e:OUlksCnK"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:61dNEC9e:OUlksCnK"
}

