Skip to content

adamwbb/MCStatsPlusWeb

Repository files navigation

MCStatsPlusWeb

Status PHP

The official web dashboard and integration hub for the MCStatsPlus ecosystem.

Why it was created

To provide players with a "Single Pane of Glass" for their server status. MCStatsPlusWeb translates complex SQL data from independent plugins—including core stats, bounties, and RPG levels—into a unified, immersive medieval interface.

What it does

  • First-Run Auto-Setup: The system detects missing configurations and automatically triggers the setup.php wizard upon your first visit.
  • Modular Integration: Native hooks for mcMMO, EliteMobs, and WantedSystemBounties that can be toggled during or after setup.
  • Smart Navigation: header.php dynamically generates menu items like the "Adventurer's Log" or "Bounty Board" based on enabled modules.
  • Security Auditing: Built-in monitoring warns administrators if the /configuration directory permissions are insecure (777).

Requirements

Web Server: PHP 7.4 or higher. Database: Access to the MySQL/MariaDB databases used by your Minecraft plugins. Styling: Internet access for CDN-loaded Bootswatch (Slate) and FontAwesome.

Installation

  1. Upload the repository files to your web root (Apache/Nginx with PHP).
  2. Ensure the /configuration folder is temporarily writable (chmod 0777).
  3. Launch: Simply visit your site URL. The system will automatically redirect you to the Setup Wizard.
  4. Harden: Once finished, set /configuration to 0755 and delete setup.php to engage the security lock.

Demo Configuration

If you prefer to configure the system manually or need to toggle a feature later, your configuration/config.php should follow this structure:

<?php
// Core Connection
$mysql_host = 'localhost';
$mysql_user = 'root';
$mysql_pass = 'password';
$mysql_db   = 'mcstatsplus';
$mysql_encoding = 'utf8mb4';
$prefix = 'mcs_';

// Optional Integrations
$mcmmo_enabled = true;
$mcmmo_host = 'localhost';
$mcmmo_user = 'root';
$mcmmo_pass = 'password';
$mcmmo_db   = 'McMMO';
$mcmmo_prefix = 'mcmmo_';

$em_enabled = true;
$em_host = 'localhost';
$em_user = 'root';
$em_pass = 'password';
$em_db   = 'elitemobs';

$bounty_enabled = true;
$bounty_host = 'localhost';
$bounty_user = 'root';
$bounty_pass = 'password';
$bounty_db   = 'Bounty';

// Site Customization
$site_title = 'MyMinecraftServer';
$banner_subtitle = 'Welcome to the official server statistics portal.';
$server_ip = 'play.example.com';
$home_url = 'https://';

About

A Lightweight Stats UI that tracks multiple aspects of your Minecraft Server.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors