EpicBans Update 2.1.0
What's New
The
EpicBans 2.1.0 update introduces major improvements, bug fixes, and new features designed to enhance both server performance and administrator experience.
✅ New Features
- Developer API
- A complete, developer-friendly API to interact with EpicBans programmatically;
- Retrieve punishment lists, apply/remove punishments, and integrate with other plugins;
- Manage bans, mutes, warns, and more via code;
- See the EpicBans API Documentation for detailed usage examples.
- Templates
- Predefined punishment templates for faster and consistent moderation;
- Configurable in templates.yml;
- Full guide available here: Punishment Templates Wiki
- Example:
Code (YAML):
templates
:
# Template for severe cheating violations
Cheating
:
# Example: /ban Player @Cheating
type
: BAN
# Permanent ban
reason
:
"Unfair Advantage (Cheating)"
time
: 0
# Permanent ban (time is ignored for PERMANENT type)
unit
: seconds
# Unit (ignored for permanent punishments)
permission
:
"epicbans.template.cheating"
# Required permission to use this template
server
:
"*"
# Applies to all servers
isSilent
: false
# Broadcast the punishment
# Template for temporary ban for toxicity
Toxicity
:
# Example: /tempban Player @Toxicity
type
: TEMPBAN
# Temporary ban
reason
:
"Toxic Behavior (Harassment/Hate Speech)"
time
: 7
# Duration of punishment
unit
: days
# Time unit
permission
:
"epicbans.template.toxicity"
# Required permission
server
:
"*"
# Applies to all servers
isSilent
: false
# Broadcast the punishment
# Template for spamming in chat
Spam
:
# Example: /warn Player @Spam
type
: WARN
# Temporary mute
reason
:
"Chat Spam/Flood"
time
: 0
# Duration of punishment
unit
: seconds
permission
:
"epicbans.template.spam"
# Required permission
server
:
"*"
# Applies to all servers
isSilent
: true
# Silent punishment (staff only)
# Template for advertising violations
Advertising
:
# Example: /tempban Player @Advertising
type
: TEMPBAN
# Temporary ban
reason
:
"Unauthorized Server Advertising"
time
: 30
# Duration of punishment
unit
: days
# Time unit
permission
:
"epicbans.template.advertising"
# Required permission
server
:
"*"
# Applies to all servers
isSilent
: false
# Broadcast the punishment
- Templates provide staff with quick access to predefined punishments (reason, duration, type).
- New Time Unit: Year
- Silent Punishments Permission
- Added the new permission:
epicbans.silent
- Required for staff to execute punishments silently (using the -s flag).
- Without this permission, staff attempting to use silent punishments will receive the NoPerms message.
- Automatic MiniMessage → Legacy Color Fallback
- Messages now automatically detect and convert color codes when mixing MiniMessage and Legacy formatting;
- Prevents display issues when both systems are used in the same message.
Bug Fixes
- Fixed a rare issue where server=... could incorrectly appear in the punishment reason when applying server-specific punishments.
⬆️ Upgrade to 2.1.0
Upgrade now to take advantage of:
- The new Developer API,
- Punishment Templates,
- Better time unit handling,
- The silent punishment permission system,
- And improved message compatibility.