GET /api/overview — Server overview stats
GET /api/stats — Detailed server statistics
GET /api/tps — Current TPS + history
GET /api/heatmap — All heatmap points
GET /api/heatmap/{world} — World-specific heatmap
GET /api/retention — Retention cohorts
GET /api/players — All player profiles
GET /api/player/{uuid} — Player detail
GET /api/sessions — Recent sessions
GET /api/activities — Recent activities
GET /api/churn — Churn risk analysis
GET /api/economy — Economy snapshot
GET /api/health — Health check
GET /api/moderation — Moderation logs
GET /api/acquisition — Player sources
GET /api/funnel — Funnel analytics
GET /api/segments — Player segments
GET /api/ab-tests — A/B test results
GET /api/benchmark — Anonymous benchmarks
GET /api/network — Multi-server sync
GET /api/alerts — Alert history
/CODE

SIZE=5B⚙️ In-Game Commands/B/SIZE
CODE
/analytics status — TPS, online, unique players, avg session
/analytics heatmap — Top 10 hot zones
/analytics retention — Day 1-30 retention cohorts
/analytics churn — Players with HIGH/CRITICAL churn risk
/analytics economy — Economy balance stats
/analytics reload — Reload configuration
/stats — Quick server overview
/playerstats <name> — Player profile, sessions, kills, deaths
/refer generate — Generate referral code
/refer <code> — Use referral code
/abtest create — Create A/B test
/abtest list — List active tests
/abtest results — View test results
/CODE

SIZE=5B Integrations/B/SIZE
LIST
*BVault/B — Economy monitoring, permission hooks
*BPlaceholderAPI/B — 15+ placeholders: %mineanalyticstps%, %mineanalyticsonline%, %mineanalyticschurnrisk%, etc.
*BBungeeCord/Velocity/B — Multi-server network sync (MySQL)
/LIST

SIZE=5B️ Technical Stack/B/SIZE
LIST
*Java 25 + Paper API 26.1.2 (Minecraft 1.21.4+)
*HikariCP connection pool (SQLite / MySQL)
*Javalin embedded web server
*Chart.js + Leaflet.js + Tailwind CSS dashboard
*55 Java classes, 7700+ lines of code
*19 database tables
*Full async processing — zero main thread blocking
/LIST

SIZE=5B Installation/B/SIZE
LIST=1
*Download URL='https://papermc.io/downloads/paper'Paper 1.21.4+/URL server
*Drop BMineAnalytics-1.0.0-SNAPSHOT.jar/B into your B/plugins//B folder
*Start the server — plugin auto-creates config and database
*Open Bhttp://your-server-ip:8080/B for the web dashboard
* Install BVault/B for economy monitoring
* Install BPlaceholderAPI/B for placeholders
* Edit Bplugins/MineAnalytics/config.yml/B to customize
/LIST

SIZE=5B config.yml/B/SIZE
CODE
database:
type: sqlite # sqlite or mysql
host: localhost
port: 3306
name: mineanalytics
username: root
password: ""
pool-size: 10

web:
enabled: true
port: 8080
auth:
enabled: false
username: admin
password: changeme

sampling:
movement-interval: 200 # ticks (10 seconds)
activity-flush: 6000 # ticks (5 minutes)
retention-calculate: 72000 # ticks (6 hours)

hooks:
vault: true
placeholderapi: true

telegram:
enabled: false
token: ""
chat-id: ""

economy:
enabled: true
snapshot-interval: 36000 # ticks (30 minutes)
gini-alert-threshold: 0.8

moderation:
enabled: false
model: glm-4.7-flash
api-key: ""
warn-threshold: 50
mute-threshold: 70
kick-threshold: 85
/CODE

SIZE=5B Permissions/B/SIZE
CODE
mineanalytics.admin — Access to /analytics commands
mineanalytics.stats — Access to /stats command
mineanalytics.stats.others — Access to /playerstats <name>
/CODE

SIZE=5B❓ FAQ/B/SIZE

BQ: Does it work with Spigot?/B
A: Designed for Paper 1.21.4+, but should work on Spigot with reduced functionality.

BQ: Performance impact?/B
A: Minimal. All heavy operations (DB writes, AI analysis) run asynchronously. Main thread only does lightweight event recording.

BQ: Can I use MySQL?/B
A: Yes! Change Idatabase.type/I to Imysql/I in config.yml. Recommended for BungeeCord/Velocity networks.

BQ: Web dashboard over HTTPS?/B
A: Use a reverse proxy (Nginx/Caddy) with SSL termination in front of the web server.

BQ: Free?/B
A: Yes! All features are free and open-source.

SIZE=4B⭐️ If you like this plugin, please leave a review!/B/SIZE
---

### Documentation:


bbcode
SIZE=5B Full Documentation/B/SIZE

SIZE=4BWeb Dashboard Pages/B/SIZE

BOverview (index.html)/B
Shows real-time server metrics: online players, TPS chart, unique players
today/week/month, recent activities feed, top hotspots.

[B]Heatmap (heatmap.html)[/B]
Interactive Leaflet.js map. Select world from dropdown. See heat intensity overlay. View top hotspots table. Requires movement sampling enabled.

[B]Retention (retention.html)[/B]
Cohort table with Day 1/3/7/14/30 retention rates. Line chart showing retention trends. Auto-updates every 6 hours.

[B]Churn (churn.html)[/B]
Player risk table sorted by churn score. Doughnut chart showing risk distribution. Click player for detailed factors and recommendations.

[B]Players (players.html)[/B]
Searchable player list with sorting. View sessions, activities, playtime, kills, deaths for each player.

[SIZE=4][B]PlaceholderAPI Placeholders[/B][/SIZE]
[CODE]
%mineanalytics_online% — Online players count
%mineanalytics_unique_today% — Unique players today
%mineanalytics_unique_week% — Unique players this week
%mineanalytics_unique_month% — Unique players this month
%mineanalytics_new_today% — New players today
%mineanalytics_tps% — Current TPS
%mineanalytics_avg_tps% — Average TPS (5 min)
%mineanalytics_avg_session% — Average session length (minutes)
%mineanalytics_total_players% — Total registered players
%mineanalytics_total_sessions% — Total sessions
%mineanalytics_total_activities% — Total activities recorded
%mineanalytics_retention_1d% — Day 1 retention %
%mineanalytics_retention_7d% — Day 7 retention %
%mineanalytics_retention_30d% — Day 30 retention %
%mineanalytics_churn_risk% — Current player's churn risk
%mineanalytics_playtime% — Current player's total playtime
%mineanalytics_sessions% — Current player's total sessions
%mineanalytics_deaths% — Current player's total deaths
%mineanalytics_kills% — Current player's total kills
 

# Server overview
curl http://localhost:8080/api/overview

# TPS with history
curl http://localhost:8080/api/tps

# Heatmap data
curl http://localhost:8080/api/heatmap
curl http://localhost:8080/api/heatmap/world

# Churn analysis
curl http://localhost:8080/api/churn

# Player detail
curl http://localhost:8080/api/player/<uuid>

# Health check
curl http://localhost:8080/api/health