Docs  /  Minecraft plugin → PHP/HTML live dashboard

Minecraft plugin → PHP/HTML live dashboard

Graph the current Spigot plugin state (players, health, food, hostiles, bridge, worlds, goals, ML summary) in a browser.

Architecture

Spigot plugin (JUPITER)
  WebDashboardService every web.refresh-ticks
    → plugins/AugmentedIntelligenceBridge/web/state.json
    → plugins/AugmentedIntelligenceBridge/web/history.json
    → optional HTTP :8787  /api/state  /api/history

PHP/HTML (minecraft_web_dashboard/)
  index.php  → charts (Chart.js)
  api.php    → reads state.json OR proxies remote HTTP

Plugin setup

config.yml (defaults already added):

web:
  enabled: true
  directory: "web"
  refresh-ticks: 40      # ~2s
  history-points: 120
  http:
    enabled: true
    bind: "0.0.0.0"
    port: 8787
    token: ""            # optional shared secret

Commands:

/ai web status
/ai web export
/ai web http on
/ai web http off

Open directly (no PHP):

http://<minecraft-host>:8787/
http://<minecraft-host>:8787/api/state

PHP dashboard setup

  1. Copy or point a vhost at:
minecraft_web_dashboard/
  config.php
  api.php
  index.php
  1. Edit config.php:

Same machine as Minecraft

$state_file   = 'C:/path/to/server/plugins/AugmentedIntelligenceBridge/web/state.json';
$history_file = 'C:/path/to/server/plugins/AugmentedIntelligenceBridge/web/history.json';
$remote = '';

Remote plugin HTTP

$remote = 'http://10.0.0.153:8787';
$token  = ''; // match web.http.token if set
  1. Serve with PHP:
cd minecraft_web_dashboard
php -S 0.0.0.0:8088

Open http://localhost:8088/.

Graphs

Chart Series
Players / vitals online count, avg health, avg food
Threat / time nearby hostiles, overworld time
Bridge connected 0/1

Player table: name, world, XYZ, HP, food, goal, safety, game mode.

Security

  • Bind HTTP only on trusted LAN, or set web.http.token.
  • Prefer reverse proxy + TLS for public exposure.
  • PHP api.php does not mutate the server; read-only.

Build / deploy plugin

cd minecraft_spigot_plugin
.\gradlew.bat jar
# copy build/libs/AugmentedIntelligenceSpigotBridge-*.jar → server plugins/
Generated from the project markdown docs on 2026-07-24. This is a static, self-contained site.