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


MythicSessions is a powerful staff/admin analytics plugin for Paper servers.

It records detailed player session data (join → quit), stores it efficiently,
and presents everything through clean, powerful GUIs and commands.

Designed for staff members, administrators, and server owners
who want insight into player behavior, activity, and progression.


────────────────────────────
✨ Core Features
────────────────────────────

• Automatic session logging (join → quit)
• SQLite storage (no external database required)
• Configurable retention system (auto-deletes old sessions)
• Session List GUI with pagination
• Detailed Session GUI (per-session breakdown)
• Summary GUI (aggregate stats over X days)
• Multiple summary views (metrics / ores)
• Leaderboards GUI (top activity & performance)
• Session comparison (compare two sessions)
• Export sessions to text files (single / all)
• Fully configurable metrics (enable only what you need)

────────────────────────────
Tracked Metrics (configurable)
────────────────────────────

Time / Activity

• Playtime
• Active time / AFK time
• Activity rate (%)

Interaction

• Blocks placed
• Blocks broken

Items

• Items crafted
• Items picked up
• Items dropped

Movement (meters)

• Walked / sprinted
• Swum
• Flown / glided

Combat

• Damage dealt / taken (HP-based)
• Mob kills
• Player kills
• Deaths

Mining

• Ores mined
• Optional deepslate variant grouping

────────────────────────────
Commands
────────────────────────────

/session <player>
Opens the sessions GUI for a player

/session summary <player> <days>
Opens the summary GUI (or prints to chat for console)

/session compare <player> <#num|id> <#num|id>
Compare two sessions side-by-side

/session export <player> <sessionId|#num|all>
Export sessions to text files

/session delete <player> <sessionId|#num>
Delete a stored session

/session top
Opens leaderboard GUI

/session reload
Reload configuration files

────────────────────────────
Permissions
────────────────────────────

• mythicsessions.use – Access GUIs & basic commands
• mythicsessions.export – Export sessions
• mythicsessions.delete – Delete sessions
• mythicsessions.reload – Reload configuration
• mythicsessions.top – Access leaderboards

────────────────────────────
⚙ Configuration Highlights
────────────────────────────

• Session retention by days (auto-cleanup)
• AFK detection threshold
• Enable / disable individual metrics
• Ore variant grouping
• Crafting & pickup counting modes
• Optional suspicion rules (advanced servers)

────────────────────────────
✔ Compatible With
────────────────────────────

• Paper 1.21+
• No external dependencies
• Lightweight runtime impact

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