---

What is StaffModerationPlus?

StaffModerationPlus is the most comprehensive staff moderation plugin for Minecraft Paper servers. With 100+ features including a full moderation toolkit, Discord bot integration, and the CrowzOptimizer performance module, it's everything your server needs.

---

Features

Moderation Tools (70+ commands)

Category	Commands
Punishments	/ban, /tempban, /banip, /kick, /warn, /mute, /tempmute, /freeze, /punish
Staff Utilities	/vanish, /staffmode, /tp, /tphere, /invsee, /enderchest, /socialspy, /staffchat
Player Info	/history, /alts, /geoip, /seen, /ipview, /activity, /session, /audit
Reports	/report, /reports, /evidence, /preport, /reportcategory
Server Control	/maintenance, /lockdown, /clearchat, /lockchat, /slowchat
Watchlist	/watchlist, /joinalert, /iphistory, /blacklist
Appeals	/appeal, /appeals
Templates	/template, /threshold, /kickpreset
Automation	/automod, /cooldown, /decay, /schedule
Teleport	/tpa, /tpahere, /back, /warp, /steleport
Staff Management	/duty, /staffstats, /staffhours, /stafflist, /tag
Nicknames	/nick
Reputation	/rep
Feedback	/feedback
Backups	/backup, /worldbackup
Advanced	/quickban, /psearch, /altshistory, /loctrack, /clearwarnings
Chat	/massmsg, /chatformat, /scformat, /tabprefix, /bq
Staff Actions	/smite, /kickall, /near, /freezeall, /unfreezeall, /staffspy
Server Info	/serverinfo, /serverstats, /serverhealth, /pluginlist

Discord Bot Integration

Full Discord bot powered by JDA:

• Remote Commands: Ban, kick, mute, warn, freeze, teleport, lookup from Discord
• Live Chat Bridge: See Minecraft chat in Discord and vice versa
• Staff Alerts: Real-time notifications for reports, joins, and suspicious activity
• Server Status: Monitor TPS, players, memory from Discord

CrowzOptimizer Performance Module

Built-in performance optimization with 15+ subsystems:

Module	Description
Entity Optimization	Limits excessive mobs/items per chunk, auto-cleanup
Item Cleanup	Automatic dropped-item cleanup with warnings
Combat Optimization	Explosion/projectile/particle optimization, PvP-friendly
Chunk Optimization	Chunk loading limits, view distance capped at 5, safe unloading
Mob Optimization	Per-chunk mob limits, mob stacking, farm prevention
Redstone Optimization	High-frequency redstone detection, throttling
Memory Management	JVM monitoring, leak detection, auto cleanup
Performance Monitor	Live TPS/MSPT, entity/chunk counts, performance score
Lag Detection	Cause identification, admin alerts
Lag Machine Detection	Detects redstone clocks, TNT dupers, item frame spam, and more
Anti-Flood Protection	Water, lava, TNT, item, entity, hopper, piston, falling block flood prevention
View Distance Enforcement	Max view distance of 5 for all players

Anti-Flood Protection

Flood Type	Default Limit	Description
Water Dupe	15 per chunk	Detects water duplicator machines, removes excess source blocks
Lava	8 blocks spread	Prevents lava spreading too far from source
TNT	10 per chunk	Prevents TNT spam/explosion flooding
Items	50 per chunk	Prevents dropped item entity flooding
Entities	100 per chunk	General entity flood protection
Falling Block	30 per chunk	Prevents sand/gravel spam

Lag Machine Detection

Detects and alerts on common lag machines:

• Redstone clocks (200+ updates in 3-block radius)
• TNT duplicators (5+ TNT/tick)
• Item frame spam (20+ per chunk)
• Painting spam (15+ per chunk)
• Hopper chains (30+ connected)
• Mob farms (50+ entities per type)
• Chunk loaders (10+ force-loaded)
• Water/lava pushing (30+ entities)
• Sculk sensor spam (10+ activations/tick)
• Entity cramming (25+ in one spot)

---

Commands

Moderation Commands

Command	Description	Permission
/ban <player> [reason]	Permanently ban a player	staffmod.ban
/tempban <player> <duration> [reason]	Temporarily ban a player	staffmod.tempban
/banip <player> [reason]	Ban a player's IP address	staffmod.banip
/kick <player> [reason]	Kick a player from the server	staffmod.kick
/warn <player> [reason]	Warn a player	staffmod.warn
/mute <player> [reason]	Mute a player from public chat	staffmod.mute
/tempmute <player> <duration> [reason]	Temporarily mute a player	staffmod.tempmute
/freeze <player>	Freeze a player in place	staffmod.freeze
/punish <player> <template|type> [duration] [reason]	Unified punishment command	staffmod.punish

Staff Commands

Command	Description	Permission
/vanish	Toggle vanish mode	staffmod.vanish
/staffmode [on|off]	Toggle staff mode	staffmod.staffmode
/tp <player> [target]	Teleport a player	staffmod.tp
/tphere <player>	Teleport a player to you	staffmod.tphere
/invsee <player>	View a player's inventory	staffmod.invsee
/enderchest [player]	Open a player's ender chest	staffmod.enderchest
/socialspy	Toggle spying on player chat	staffmod.socialspy
/staffchat [message]	Toggle staff chat or send a message	staffmod.staffchat

Info Commands

Command	Description	Permission
/history <player>	View punishment history	staffmod.history
/alts <player>	Check alt accounts	staffmod.alts
/geoip <player>	View geolocation info	staffmod.geoip
/seen <player>	Check last online time	staffmod.seen
/ipview <player>	View IP and connection info	staffmod.ipview
/activity <player> [type]	View activity logs	staffmod.activity
/audit [player]	Full audit of a player	staffmod.audit

Server Commands

Command	Description	Permission
/maintenance [on|off|status]	Toggle maintenance mode	staffmod.maintenance
/lockdown <full|staff_only|maintenance|soft|off> [reason]	Toggle server lockdown	staffmod.lockdown
/clearchat	Clear the chat	staffmod.clearchat
/lockchat	Toggle chat lock	staffmod.lockchat
/slowchat <seconds|off>	Set or disable slow chat	staffmod.slowchat

CrowzOptimizer Commands

Command	Description	Permission
/optimize	Show help	crowzoptimizer.admin
/optimize status	Server performance overview	crowzoptimizer.admin
/optimize entities [world]	Entity cleanup	crowzoptimizer.admin
/optimize chunks [world]	Chunk optimization	crowzoptimizer.admin
/optimize memory	Memory stats & cleanup	crowzoptimizer.admin
/optimize items [world]	Item cleanup	crowzoptimizer.admin
/optimize mobs [world]	Mob stats & limits	crowzoptimizer.admin
/optimize redstone [world]	Redstone stats	crowzoptimizer.admin
/optimize combat	Combat optimization	crowzoptimizer.admin
/optimize report	Full performance report	crowzoptimizer.admin
/optimize lag	Lag detection report	crowzoptimizer.admin
/optimize lagmachines	Lag machine detection	crowzoptimizer.admin
/optimize antiflood	Anti-flood protection status	crowzoptimizer.admin
/optimize reload	Reload configuration	crowzoptimizer.admin

Discord Bot Commands

Command	Description	Permission
/discordbot <start|stop|status|reload>	Manage the Discord bot	staffmod.discordbot

---

Configuration

The plugin comes with a comprehensive config.yml and crowz-optimizer.yml for full customization.

Example CrowzOptimizer Config

settings:
  enabled: true
  debug: false

performance:
  warning-mspt: 40
  critical-mspt: 50
  check-interval: 5

chunks:
  enabled: true
  max-chunks-per-player: 25
  max-view-distance: 5

anti-flood:
  enabled: true
  water-dupe:
    enabled: true
    max-per-chunk: 15
  lava:
    enabled: true
    max-spread: 8
  tnt:
    enabled: true
    max-per-chunk: 10
  items:
    enabled: true
    max-per-chunk: 50
  falling-block:
    enabled: true
    max-per-chunk: 30

lag-machine-detector:
  enabled: true
  thresholds:
    redstone-clock:
      max-updates-in-area: 200
    tnt-duplicator:
      max-tnt-per-tick: 5
    item-frame-spam:
      max-per-chunk: 20

---

Installation

1. Download the latest JAR from Modrinth
2. Place the JAR in your server's plugins/ folder
3. Restart the server
4. Edit plugins/StaffModerationPlus/config.yml and crowz-optimizer.yml as needed
5. Reload with /staffmod reload or restart the server

---

Requirements

• Minecraft 1.21.11+
• Paper (or compatible fork)
• Java 21+
• Simple Voicechat Plugin

---

Permissions

Permission	Description	Default
staffmod.*	All StaffModeration+ permissions	OP
staffmod.ban	Ban players	OP
staffmod.kick	Kick players	OP
staffmod.mute	Mute/unmute players	OP
staffmod.warn	Warn players	OP
staffmod.freeze	Freeze players	OP
staffmod.vanish	Toggle vanish	OP
staffmod.staffmode	Toggle staff mode	OP
staffmod.admin	Admin commands	OP
staffmod.report	Report players	Everyone
staffmod.stafflist	View staff list	Everyone
crowzoptimizer.admin	CrowzOptimizer commands	OP
staffmod.optimizer.alerts	Receive optimization alerts	OP
staffmod.discordbot	Discord bot commands	OP

---

Support

• Discord: Join our Discord
• Issues: GitHub Issues
• Modrinth: Modrinth Page

---

License

This plugin is proprietary software. Unauthorized distribution or modification is prohibited.

---