Excalibur | Four-Core Server Engine v1.0.5

Excalibur v1.0.5 — Localization & Language System Update

Localization System Improvements​

• Loads user-translated YAML language files correctly
• Automatically fills missing keys with default English values when upgrading to newer plugin versions
• Does NOT overwrite any existing translated values
• Maintains full compatibility with custom language packs
• Prevents data loss during version migrations

Result​

• Server owners can safely update the plugin without losing translations
• Only newly introduced messages are added automatically
• Existing localized content remains untouched
• Improved long-term maintainability of language files

Excalibur v1.0.4 — Stability, Performance & Crash Fix Update

This release addresses critical crashes occurring on servers with 50+ concurrent players. The issues were caused by thread-safety violations, memory leaks, and inefficient runtime operations. Version v1.0.4 focuses on stability, scalability, and safe concurrency.

v1.0.4 Fixes & Improvements​

Thread-Safety Fixes​

• StaffModeManager.java
  • HashMap → ConcurrentHashMap (line 23)
• VanishManager.java
  • HashSet → ConcurrentHashMap.newKeySet() (line 21)
• StaffParticleManager.java
  • HashMap → ConcurrentHashMap (lines 19–20)
  • stopAll() fix (line 100):
    • new HashMap<>(particleTasks) → new ArrayList<>(particleTasks.keySet())
• FreezeManager.java
  • HashMap → ConcurrentHashMap

Memory Leak Fixes​

• Proper particle task cleanup
• BossBar cleanup enforced in onDisable()
• WeakHashMap usage for cache structures
• Guaranteed cancellation of scheduled tasks

Performance Optimizations​

• Particle spawn interval increased: 2 ticks → 5 ticks (line 38)
• Vanish player caching system implemented
• Database operations moved to async execution
• Optimized player lookup logic

Additional Stability Improvements​

• Added null-safety checks
• Try-catch blocks around critical execution paths
• Graceful degradation for servers with 100+ players
• Centralized resource cleanup in onDisable()

🛠 Modified Files​

• src/main/java/com/staffxplayer/module/staffmode/manager/StaffModeManager.java
• src/main/java/com/staffxplayer/module/vanish/manager/VanishManager.java
• src/main/java/com/staffxplayer/module/staffmode/manager/StaffParticleManager.java
• src/main/java/com/staffxplayer/module/staffmode/manager/FreezeManager.java
• src/main/java/com/staffxplayer/StaffXPlayer.java (onDisable cleanup)

---

Excalibur v1.0.3 — Big Christmas Update​

1. Advanced Staff Analytics & Performance Tracking​

Status: Completed
Module: StaffAnalyticsModule

Description:
A comprehensive staff performance tracking system with real-time metrics, achievements, and detailed analytics to measure and improve moderation efficiency.

Key Features:

• Real-time staff performance tracking
• Session-based metric collection
• Achievement and reward system
• Time-based statistics (Daily / Weekly / Monthly / All-time)
• Leaderboards and individual staff profiles

Implemented Components:

• StaffAnalyticsModule.java
  • Performance tracking engine
  • Real-time metrics collection
  • Achievement system
  • Leaderboard management
• PerformanceTracker.java
  • Metric aggregation (BANS, KICKS, MUTES, WARNS, REPORTS_HANDLED, etc.)
  • Async database flushing (5-minute interval)
  • Thread-safe caching (ConcurrentHashMap)
• StaffAchievementSystem.java
  • 15 achievements (First Ban, Ban Master, Report Handler, etc.)
  • Automatic milestone unlocking
  • Progress tracking and reward integration
• StaffLeaderboardGUI.java
  • Top 10 staff per metric
  • Time period selector
  • Real-time updates
• StaffProfileGUI.java
  • Personal performance statistics
  • Achievement showcase
  • Performance graphs
  • Comparison against server averages
• StaffAchievementsGUI.java
  • Full achievement list
  • Progress bars
  • Unlock dates and reward claiming

Commands:

• /staffanalytics
• /staffanalytics leaderboard [metric]
• /staffanalytics profile [staff]
• /staffanalytics achievements [staff]
• /staffanalytics reset <staff> (admin)

Database Tables:
sxp_staff_analytics (staff_uuid, metric, value, period, last_updated)
sxp_staff_achievements (staff_uuid, achievement_id, unlocked_at, claimed)

Permissions:

• staffxplayer.analytics.view
• staffxplayer.analytics.leaderboard
• staffxplayer.analytics.profile
• staffxplayer.analytics.achievements
• staffxplayer.analytics.admin

──────────────────────────────────────────────

2. Intelligent Auto-Moderation System​

Status: Completed
Module: AutoModerationModule

Description:
An AI-inspired, pattern-based auto-moderation system with progressive punishments, reputation scoring, and advanced false-positive reduction.

Key Features:

• Real-time chat filtering
• Behavior and spam pattern detection
• Progressive punishment system
• Player reputation scoring with decay
• Whitelist and bypass support
• Detailed moderation logs

Implemented Components:

• AutoModerationModule.java
• ChatFilterEngine.java
  • Regex-based, multi-language filtering
  • Context-aware detection
• BehaviorAnalyzer.java
  • Spam, caps-lock, repetition detection
  • Reputation scoring system
• ProgressivePunishmentSystem.java
  • Warn → Mute → Kick → Ban escalation
  • Violation decay and appeal integration
• AutoModCommand.java

Database Tables:
sxp_automod_filters
sxp_automod_violations
sxp_automod_whitelist
sxp_player_reputation

Commands:

• /automod status
• /automod filter add/remove/list
• /automod whitelist add/remove
• /automod test
• /automod stats [player]

Permissions:

• staffxplayer.automod.manage
• staffxplayer.automod.whitelist
• staffxplayer.automod.bypass
• staffxplayer.automod.admin

──────────────────────────────────────────────

3. Enhanced Report System with Advanced Management​

Status: Completed
Module: EnhancedReportModule

Description:
An intelligent report management system with automatic priority calculation, staff assignment, full history tracking, and template-based reporting.

Key Features:

• Automatic priority calculation (LOW → URGENT)
• Load-balanced staff auto-assignment
• Complete report lifecycle history
• False report detection
• Repeat offender tracking
• Report templates for fast submission

Implemented Components:

• EnhancedReportModule.java
• ReportPrioritySystem.java
• ReportAssignmentManager.java
• ReportHistoryTracker.java
• ReportTemplateSystem.java

Database Tables:
sxp_report_assignments
sxp_report_history
sxp_report_templates

Commands:

• /report
• /report assign
• /report history
• /report templates

Permissions:

• staffxplayer.report.priority
• staffxplayer.report.assign
• staffxplayer.report.history
• staffxplayer.report.template
• staffxplayer.report.admin

──────────────────────────────────────────────

4. Real-Time Staff Collaboration Tools​

Status: Completed
Module: CollaborationModule

Description:
Real-time collaboration tools enabling shared investigations, staff notes, and emergency communication between staff members.

Key Features:

• Shared investigation sessions
• Real-time session synchronization
• Player-specific staff notes
• Emergency and direct staff ping system
• Automatic session logging

Implemented Components:

• CollaborationModule.java
• SharedSessionManager.java
• StaffNotesSystem.java
• StaffPingSystem.java

Database Tables:
sxp_staff_sessions
sxp_session_participants
sxp_session_actions
sxp_staff_notes
sxp_staff_pings

Commands:

• /staffsession create/join/leave
• /staffnote add/view/remove
• /staffping <staff>
• /staffping emergency

Permissions:

• staffxplayer.collab.session
• staffxplayer.collab.notes
• staffxplayer.collab.ping
• staffxplayer.collab.admin

══════════════════════════════════════════════

---

Excalibur v1.0.2 – Moderation & Control Expansion​

This release expands staff oversight, player transparency, and AntiCheat control, providing stronger moderation tools and better administrative visibility.

---

New Features​

Staff Activity Logging​

Module: StaffModule

• Full staff action logging stored in the database
• /stafflog command to view recorded actions
• Advanced filters by staff member, action type, and date
• Export staff logs to file for auditing and reviews

---

Player History GUI​

Module: PunishmentModule

• Visual interface for viewing player punishment history
• Clickable entries with detailed punishment information
• Pagination support for large histories
• Filtering by punishment type (ban, mute, warning, etc.)

---

AntiCheat Whitelist System​

Module: AntiCheatModule

• Temporary AntiCheat bypass for selected players
• Per-check whitelist support
• Time-based whitelist expiration
• New management commands:
  • /acwhitelist add
  • /acwhitelist remove
  • /acwhitelist list
  • /acwhitelist check

---

This update significantly improves moderation transparency, staff accountability, and AntiCheat flexibility, making Excalibur more powerful and easier to manage.

---

Excalibur v1.0.1 – Stability & Alert Control Update​

This release focuses on better AntiCheat alert control and improved Discord bot presence reliability.

---

New Features​

Configurable AntiCheat Alerts​

Module: AntiCheatModule

• Per-check alert toggles configurable via config.yml
• Staff can disable specific detection alerts (e.g. Jesus, NoClip, NoFall)
• New config path:
  anticheat.alerts.checks.<check-name>.enabled
• Global AntiCheat alert enable/disable option
• Improved flexibility for noisy detections

---

Discord Bot Online Status​

Module: DiscordBotBridge

• Bot now correctly displays Online status
• Custom activity message support
• Configurable activity types:
  • PLAYING
  • WATCHING
  • LISTENING
  • COMPETING
• Proper gateway connection with presence intent enabled

---

Bug Fixes​

Discord Bot Offline Issue​

• Fixed bot showing as offline despite being connected
• Improved gateway heartbeat handling
• Correct presence intent implementation

---

AntiCheat Alert Spam Reduction​

• Enhanced alert cooldown system
• Per-check alert configuration support
• Reduced duplicate and unnecessary staff notifications

---

This update improves server usability, staff experience, and bot reliability, laying a stronger foundation for future Excalibur releases.