Version 5.5.0 - "Complete Command Suite"
23 NEW COMMANDS IMPLEMENTED
All stub commands are now fully functional with professional-grade code:

• /checkban <player> - Check if a player is banned with full details
• /checkmute <player> - Check if a player is muted
• /banlist [page] - View active bans with pagination
• /mutelist [page] - View active mutes with pagination
• /unbanip <ip> - Unban an IP address
• /unmuteip <ip> - Unmute an IP address
• /ipmute <player|ip> - Mute by IP address
• /warnings <player> - View all warnings for a player
• /unwarn <player> [id] - Remove a warning
• /alts <player> - Find alternate accounts
• /dupeip <player|ip> - Find players sharing an IP
• /geoip <player> - View geographic location
• /staffhistory <staff> - View punishments by a staff member
• /rollback <staff> [time] - Rollback staff actions
• /reports [page] - View pending reports
• /handlereport <id> <action> - Handle a report
• /appeal <message> - Submit an appeal
• /appeals [page] - View pending appeals
• /handleappeal <id> <action> - Handle an appeal
• /note <player> <note> - Add a staff note
• /notes <player> - View staff notes
• /delnote <id> - Delete a staff note
• /allowplayer <player> - Allow IP ban bypass

⚡ CODE QUALITY

• 100% Configurable Messages - Every single message in messages.yml
• Premium Code Architecture - Async operations, proper error handling
• Smart Tab Completion - Online AND offline players suggested
• Permission-Based - Each command has its own permission

BUG FIXES

• Fixed compilation errors in newly implemented commands
• Corrected API usage for Report, Appeal, and Note models
• Fixed async callback handling for database operations

This update includes 190+ new configurable messages!

Version 5.4.0 - "Code Audit & Stability Update"
NEW FEATURES

• Universal Player Detection - Ban players by UUID even if they've never joined.
• Offline Tab Completion - All punishment commands now suggest BOTH online AND offline players.
• Automatic Update Checker - Plugin checks Spigot for new versions on startup.
• Total Configurability - ALL messages externalized to messages.yml.
• Auto-Updating Config - Automatically detects and adds missing message keys on reload.

CRITICAL FIXES

• Fixed NullPointerException: Database rows with null executor_uuid no longer crash the plugin.
• Fixed Race Condition: Cache operations now properly synchronized from async callbacks.
• Fixed Database Timeout: Login process now uses fail-open strategy with logging instead of blocking players.
• Fixed Thread Interruption: Proper handling of InterruptedException in pre-login checks.
• Fixed IP Ban Build Error: Replaced missing ValidationUtil with existing PlayerUtil methods.

⚡ CODE QUALITY IMPROVEMENTS

• Comprehensive code audit of all 78 Java files
• Added null-safety checks throughout database parsing
• Improved exception handling with specific catch blocks
• Added .exceptionally() handlers to all CompletableFuture chains
• Thread-safe cache modifications from async contexts
• Better debug logging with context information

Full audit report: docs/CODE_AUDIT_v5.4.md

Version 5.3.0 - "Universal Detection Update"
NEW FEATURES

• Universal Player Detection - Ban players by UUID even if they've never joined. No more "Player not found"!
• Offline Tab Completion - All punishment commands now suggest BOTH online AND offline players.
• Automatic Update Checker - Plugin now checks Spigot for new versions on startup and notifies in console.
• Total Configurability - Externalized ALL messages (Main command, HWID, AI, Anti-VPN) to messages.yml.
• Auto-Updating Config - Plugin automatically detects and adds missing message keys on reload.
• HWID Unban - Added /hwid unban <id> command.
• ⌨️ Smart Tab Completion - Added smart tab completion for ALL commands (ban, tempban, ipban, hwid, etc).

CRITICAL FIXES

• Fixed Database Deadlock: Resolved an issue where slow database connections could freeze player logins.
• Fixed H2 Incompatibility: Replaced MySQL-specific queries with standard SQL upserts.
• Fixed Chat Logic: Muted players strictly cannot trigger chat filters anymore (Mute check > Filter check).
• Thread Safety: Improved async handling in player join and HWID operations.
• IP Ban Implementation: /ipban command is now fully functional with duration and reason support.

⚡ IMPROVEMENTS

• Tab completion now shows up to 50 offline players for better usability
• Better UUID handling for pre-banning players who haven't joined yet
• Improved command flag parsing (-s for silent can be placed anywhere)
• PlayerUtil now has centralized getOnlineAndOfflinePlayerNames() helper

Full changelog in docs/CHANGELOG.md

Version 5.2.0 - "Stability & Freedom Update"
NEW FEATURES

• Total Configurability - Externalized ALL messages (Main command, HWID, AI, Anti-VPN) to messages.yml.
• Auto-Updating Config - Plugin now automatically detects and adds missing message keys on reload. No more manual file resets!
• HWID Unban - Added
  Code (Text):

  /hwid unban <id>
  command.
• ⌨️ Tab Completion - Added smart tab completion for main command and subcommands.

CRITICAL FIXES

• Fixed Database Deadlock: Resolved an issue where slow database connections could freeze player logins.
• Fixed H2 Incompatibility: Replaced MySQL-specific queries with standard SQL upserts, fixing crashes on local H2 databases.
• Fixed Chat Logic: Punished (muted) players strictly cannot trigger chat filters anymore (Mute check > Filter check).
• Thread Safety: Improved async handling in player join and HWID operations.

Full changelog in docs/CHANGELOG.md

This update brings INTELLIGENCE to your moderation. Know who's an alt, predict who will be banned, and collect evidence automatically!
️ Social Network Analysis
Revolutionary alt detection and relationship tracking!

• Alt Detection: Automatically finds accounts with same IP/HWID
• Relationship Mapping: Tracks who plays with whom
• Banned Associates: Alerts when friends of banned players join
• Connection Score: Calculate risk based on network
• Commands:
  Code (Text):

  /network alts <player>
  Code (Text):

  /network check <player>

Automatic Case Files
Evidence collection on autopilot!

• Auto-Create: Case file created when you /freeze a player
• Chat History: Saves last 200 messages automatically
• Command Log: Records what commands they used
• Movement Tracking: Logs their position history
• Connection Info: IP, client, ping, everything
• Commands:
  Code (Text):

  /case view <id>
  Code (Text):

  /case evidence <id>

Cross-Server Intelligence
Network-wide punishment sync!

• Real-time Sync: Bans propagate instantly across all servers
• Staff Alerts: All staff see punishments from any server
• Player Tracking: Know when banned players try other servers
• Requires: BungeeCord or Velocity

Predictive Moderation
Know who will be banned BEFORE it happens!

• Risk Scores: 0-100 score based on behavior analysis
• Ban Prediction: % chance of ban in next 7 days
• Pattern Learning: System learns from each ban
• Staff Alerts: Notified when high-risk players join
• Commands:
  Code (Text):

  /risk check <player>
  Code (Text):

  /risk top

We've re-written the rules of punishment plugins. v5.0 introduces Artificial Intelligence and native Role Syncing!
Anti-Gravity AI
Let AI help you moderate! (Requires API Key from OpenRouter/OpenAI/Venice)

• Toxicity Detection: Real-time chat analysis for toxicity/hate speech.
• Smart Appeals: AI analyzes ban appeals for sincerity and suggests verdicts.
• Zero Lag: All processing happens in the cloud, 0% CPU usage on your server.
• Multiple Providers: Support for OpenRouter, Venice, OpenAI, Claude, DeepSeek.

Role Synchronization
Sync your ranks with discord! (Requires LuckPerms + Discord Bot enabled)

• Bidirectional: Sync Discord Roles -> Minecraft Ranks OR Minecraft -> Discord.
• Automatic: Syncs instantly when players join or verify.
• Configurable: Map any Discord Role ID to any LuckPerms Group.
• Commands:
  Code (Text):

  /rolesync sync
  Code (Text):

  /rolesync status

Maintenance Mode
Native maintenance system.

• Scheduled: Enable for a specific duration
  Code (Text):

  /maintenance on 2h Update
• Whitelist: Allow specific players/staff to bypass.
• Protection: Bypasses require permission or whitelist.

Modern Web Panel
A brand new, standalone HTML/React web panel file included!

• Located in
  Code (Text):

  /plugins/LiteBansReborn/web/index.html
• Single-file React application (CSR).
• Connects to the plugin's REST API.
• Modern, dark-themed UI with Dashboard, Graphs, and Player Management.

# Changelog

All notable changes to LiteBansReborn.

## [4.5.0] - 2024-12-28

### Major Release - "Discord Integration"

This release brings complete Discord integration and chat protection!

### Added

#### Native Discord Bot (JDA)
- Full Discord bot running inside the plugin
- Slash commands: `/ban`, `/unban`, `/mute`, `/history`, `/checkban`, `/stats`, `/lookup`
- Real-time punishment notifications to Discord
- Staff role permission system
- No external bot required!

#### Ticket System
- Complete support ticket system
- Categories: Appeal, Report, Support, Bug
- Staff can claim and respond to tickets
- Full message history tracking
- Discord notifications for new tickets
- Auto-close on inactivity
- Commands: `/ticket create`, `/ticket list`, `/ticket respond`, `/ticket close`

#### Discord Verification
- Link Minecraft and Discord accounts
- Generate verification code in-game: `/verify`
- Complete verification in Discord: `/verify CODE`
- Auto-assign verified role
- Staff lookup: `/whois` to see player's Discord
- Optional: require verification to play

#### Chat Filter
- **Anti-Spam**: Block rapid message sending
- **Anti-Flood**: Block repeated messages (80% similarity)
- **Anti-Caps**: Convert CAPS to lowercase (70% threshold)
- **Anti-Advertisement**: Block IPs, domains, Discord invites
- **Blocked Words**: Censor profanity with asterisks
- **Regex Patterns**: Custom pattern blocking
- **Character Spam**: Block repeated characters
- **Domain Whitelist**: Allow YouTube, Imgur, etc.
- **Auto-Mute**: Automatic mute after X violations

### Improved
- Documentation expanded to 20 files (125+ KB)
- Plugin architecture refinements
- Better error handling

### Fixed
- Various minor bugs from v4.0.0

---

## [4.0.0] - 2024-12-28

### Major Release - "Punishment Intelligence"

This release introduces groundbreaking features not found in any other punishment plugin.

### Added

#### Hardware ID Banning
- Ban players by their computer's hardware ID
- Prevents ban evasion with alt accounts
- Player fingerprinting system
- Alt detection with similarity scoring
- Commands: `/hwid check`, `/hwid ban`, `/hwid alts`

#### Evidence System
- Attach proof to any punishment
- Support for screenshots, YouTube, replay links
- Auto-capture player inventory on ban
- Evidence viewer GUI
- Commands: `/evidence add`, `/evidence view`, `/evidence capture`

#### Redemption System
- Banned players can reduce punishment through minigames
- Math captcha challenges (10% reduction)
- Typing test challenges (15% reduction)
- Quiz challenges (20% reduction)
- Configurable reduction percentages
- Commands: `/redemption start`, `/redemption answer`

#### Web Panel
- Full REST API for external management
- Beautiful dark-theme web dashboard
- Real-time server statistics
- Player search
- Staff statistics
- API key authentication
- SSL support

#### ⏱️ Smart Rate Limiting
- Prevent staff abuse with limits
- Max bans per hour
- Max permanent bans per day
- 2FA confirmation for permanent bans
- Report cooldowns for players
- `/lbr confirm` command

#### Ghost Mute (Shadow Mute)
- Muted player thinks they're chatting normally
- Only staff can see their messages
- Perfect for catching rule-breakers
- Command: `/ghostmute`

#### Chat Snapshots
- Automatically save chat context when punishing
- Configurable message count
- Saved as text files for review

#### ⏪ Auto-Rollback
- CoreProtect integration
- Automatically rollback griefer's actions when banned
- Configurable time period
- GUI button option

#### ️ Data Wipe
- Delete player data on permanent ban
- Configurable commands to run
- Delete world data (playerdata, stats, advancements)
- Optional: only on permanent bans

#### Anti-VPN Runtime Controls
- Enable/disable Anti-VPN without restart
- Toggle alerts
- Change action (KICK/WARN/ALLOW)
- Manage whitelist
- Clear cache
- View providers
- Commands: `/lbr antivpn on/off/status/alerts`

### Improved
- UUID support for offline players (pre-ban)
- Ban players who have never joined
- GUI system enhancements
- Alt detection algorithm
- Database performance
- Error handling

### Fixed
- Various bug fixes from v3.0.0
- Memory leak in cache system
- Race condition in freeze
- Tab completion issues

---

## [3.0.0] - 2024-12-15

### Added
- Initial public release
- Complete punishment system (ban, mute, kick, warn, freeze)
- Anti-VPN system with 6 providers
- Discord webhook notifications
- Telegram notifications
- PlaceholderAPI support
- GeoIP lookup
- Alt detection
- Report system
- Appeal system
- Notes system
- Punishment templates
- GUI system
- Multi-database support

---

## [2.0.0] - 2024-11-01

### Added
- Beta testing release
- Core punishment features
- Basic database support

---

## [1.0.0] - 2024-10-01

### Added
- Initial development version
- Proof of concept

---

## Future Plans

### v5.0.0 (Planned)
- [ ] Maintenance Mode
- [ ] Role synchronization (Discord ↔ LuckPerms)
- [ ] AI behavior analysis
- [ ] Full React web panel
- [ ] Advanced analytics

### v6.0.0 (Future)
- [ ] Mobile app (iOS/Android)
- [ ] Voice chat moderation
- [ ] Machine learning cheat detection
- [ ] Cross-server punishment sync

---

## Versioning

LiteBansReborn uses [Semantic Versioning]( https://semver.org/):

- **MAJOR** (X.0.0): Breaking changes
- **MINOR** (0.X.0): New features, backward compatible
- **PATCH** (0.0.X): Bug fixes

---

## Reporting Issues

Found a bug? Please report it:

1. Check [existing issues]( https://github.com/nuvik/litebansreborn/issues)
2. Include:
- Server version
- Plugin version
- Error log
- Steps to reproduce
3. Submit issue

---

## Contributors

Thank you to all contributors!

- **Nuvik** - Lead Developer
- Community testers and reporters

Want to contribute? See our [contributing guide](CONTRIBUTING.md).

We've completely overhauled the plugin to version 3.0! This massive update transforms LiteBansReborn into a complete moderation suite.
️ New In-Game GUI System
No more typing long commands! Manage your server with a beautiful, intuitive interface.

• Punish GUI: Type
  Code (Text):

  /punish <player>
  to open a menu where you can Ban, Mute, Warn, Kick, or check history.
• Duration Selector: Easily pick timeframes (30m, 1h, 1d, 1w, Perm) or customize them.
• Interactive & Fast: Designed to be quick for mods to use in the heat of the moment.

Full Report System
A complete system for players to report hackers or toxicity.

• Command:
  Code (Text):

  /report <player> <reason>
• Staff Notifications: Online staff get instant alerts.
• Database Storage: Reports are saved permanently.
• Management: Staff can view pending reports via GUI or commands.

shield: Security Suite (Anti-VPN & Client Checks)

• Anti-VPN: Block proxies, VPNs, and Tor nodes automatically with rotational API keys.
• Client Detection: See if players are using Fabric, Lunar, Badlion, or known cheat clients.
• Real IP Tracking: Advanced algorithm to find the true IP behind a VPN.

✨ Other Changes

• 1.21 Support: Native support for Minecraft 1.21.
• Smart Config: Configs now auto-update adds new options without resetting your file.
• Optimized Database: Faster HikariCP pooling for MySQL/SQLite.

We've completely overhauled the plugin to version 3.0! This massive update transforms LiteBansReborn into a complete moderation suite.
️ New In-Game GUI System
No more typing long commands! Manage your server with a beautiful, intuitive interface.

• Punish GUI: Type
  Code (Text):

  /punish <player>
  to open a menu where you can Ban, Mute, Warn, Kick, or check history.
• Duration Selector: Easily pick timeframes (30m, 1h, 1d, 1w, Perm) or customize them.
• Interactive & Fast: Designed to be quick for mods to use in the heat of the moment.

Full Report System
A complete system for players to report hackers or toxicity.

• Command:
  Code (Text):

  /report <player> <reason>
• Staff Notifications: Online staff get instant alerts.
• Database Storage: Reports are saved permanently.
• Management: Staff can view pending reports via GUI or commands.

shield: Security Suite (Anti-VPN & Client Checks)

• Anti-VPN: Block proxies, VPNs, and Tor nodes automatically with rotational API keys.
• Client Detection: See if players are using Fabric, Lunar, Badlion, or known cheat clients.
• Real IP Tracking: Advanced algorithm to find the true IP behind a VPN.

✨ Other Changes

• 1.21 Support: Native support for Minecraft 1.21.
• Smart Config: Configs now auto-update adds new options without resetting your file.
• Optimized Database: Faster HikariCP pooling for MySQL/SQLite.

This update brings a massive security overhaul to help you keep your server safe from VPN users, bot attacks, and hackers using cheat clients.
️ Advanced Anti-VPN System
Stop players from bypassing bans or joining with anonymous IPs.

• Rotational API System: Uses multiple providers (ProxyCheck, IP-API, VPNAPI, etc.) and rotates if one fails.
• Smart Caching: Minimizes API calls to keep performance high.
• Real IP Detection: Attempts to "decrypt" and track the likely real IP address behind the VPN.
• Flexible Actions: Choose to KICK the player or just WARN staff silently.
• SQLite Logging: Every detection is logged to a local database for future reference.

Client Brand Detection
Know exactly what clients your players are using to join.

• Detects: Forge, Fabric, Lunar Client, Badlion, LabyMod, Vanilla, and more.
• Suspicious Alerts: Notifies staff if a player joins with a mod-capable client (like Fabric) but without a trusted anti-cheat client.
• Cheat Detection: Warns if known cheat clients (like Wurst, Impact) are detected.

⚙️ Smart Config Auto-Update

• No need to delete your config! New options are automatically added when you run
  Code (Text):

  /lbr reload
  .

v1.0