What is Player Behavior Engine (PBE)?
Player Behavior Engine (PBE) is a standalone, rule-based moderation and automation engine that reacts to player behavior, not just commands or keywords.
Instead of hard punishments, PBE focuses on soft moderation, retention, and staff automation, making it ideal for SMP servers that want control without over-policing.
PBE is not an anticheat and not a basic chat filter — it is a behavioral engine.
PBE is developed and tested on Minecraft 1.21.
If you want players to join from multiple versions, you’ll need ViaVersion (and optionally ViaBackwards) on your server/proxy.
Recommended:- ViaVersion (multi-version join support)
- ViaBackwards (older versions support)
Core Features
- Rule engine: WHEN → DO (conditions, repeats, cooldowns)
- Behavior scores:
- Toxicity
- Spam
- Newbie harassment
- Struggle
- Helper
- Ragequit detection (death → quit window)
- New player protection logic
- Soft onboarding hints for struggling players
- Smart chat fingerprinting:
- Duplicate detection
- Burst spam detection
- Copy-paste blocks
- Anti-false-positive system:
- Score decay
- Exempt permissions/worlds
- Action rate limits
- Persistent SQLite storage (restart-safe)
Presets & Automation
PBE includes ready-to-use presets:
- Soft – warnings and staff notifications
- Balanced – recommended default
- Strict – stronger automated responses
Presets can be previewed and applied instantly:
/pbe preset list
/pbe preset preview balanced
/pbe preset apply strict
Explainable Moderation & Audit Logs
- /pbe explain <player> – see why a score increased
- /pbe audit <player> – full moderation timeline
- Staff notifications include context, not random triggers
No black-box moderation.
Safety & Control
- Global dry-run mode (simulate actions safely)
- Maintenance mode (pause actions, keep tracking)
- Per-rule cooldowns and safety limits
Public API & Integration
PBE exposes a public API and events:
- PBEScoreChangedEvent
- PBERuleTriggeredEvent
Designed for integration with other plugins and custom systems.
Technical Information
- Server software: Paper / Spigot
- Storage: SQLite
- Standalone (no required dependencies)
- Optional integrations supported
- Fully configurable via settings.yml and rules.yml
Included Files
- player-behavior-engine-1.1.0.jar
- settings.yml
- rules.yml
- Preset files (soft, balanced, strict)
Ideal For
- SMP servers
- Community-focused servers
- Servers wanting smarter moderation
- Staff teams that want transparency and automation
Notes
This plugin is designed to assist staff, not replace them.
All automation is configurable, explainable, and optional.
