Better Fabric Web Console

Better Fabric Console 🌐

A server-side Fabric mod that turns your Minecraft server into its own web-based admin panel.

No external tools. No extra servers. Just install the mod, open your browser, and you’re in.

🚀 How it works

The mod runs silently on your server, captures console output and performance metrics, and serves a modern web interface directly from the same machine — accessible from any browser on your local network.

---

## ✨ What you get

| Feature | Description |
|---|---|
| 📟 **Live Console** | Real-time server log streaming with full Minecraft color code rendering |
| ⚡ **Spark Metrics** | TPS, CPU and memory usage via [spark](https://spark.lucko.me/) — when installed |
| 🔍 **Regex Filters** | Include, exclude or color-highlight log lines with custom rules |
| 🖱️ **Quick Actions** | One-click buttons for common admin commands with confirmation dialogs |
| 🔐 **Secure Access** | SHA-256 password, UUID session tokens and a first-run setup wizard |
| 🔌 **Plugin Toggles** | Enable/disable Spark and console capture on the fly — UI adapts instantly |
| 📦 **Zero Bloat** | Spark is optional and never bundled — install it only if you want metrics |

---

## 🔌 Optional: Spark Integration

If you have [spark](https://modrinth.com/mod/spark) installed on your server, Better Fabric Console will automatically detect it and unlock a live metrics panel with TPS, CPU load and JVM memory stats.

No spark? No problem — the metrics panel simply stays hidden. Everything else works perfectly.

---

## ⚙️ Requirements

- **Minecraft** 26.1.2 (Fabric)
- **Fabric Loader** ≥ 0.16.0
- **Fabric API**
- **Java** 25+
- **Node.js** 20+ *(on the server machine, to run the web service)*

---

## 💬 Which mod should we integrate next?

This mod is built to grow with the community's needs. Right now it supports **spark** for performance metrics — but there's a lot more we could do.

**Got a mod you'd love to see integrated with a dedicated web panel?**

👉 Drop a comment below or open a [GitHub Discussion](https://github.com/MACULINX/better_fabric_console/discussions) — every suggestion is read and considered for the roadmap.

Some ideas already on the radar:
- 🗺️ **BlueMap / Dynmap** — live map status and controls
- 🔑 **LuckPerms** — permission management from the web panel
- 🌍 **Chunky** — pre-generation progress and controls
- 💾 **Backup mods** — backup status and history

If enough people ask for something, it gets built. Simple as that. 🙌

---

## 📜 License

- **Fabric Mod** (`/src`): GPL-3.0 with parent attribution
- **Web Service & UI** (`/service`): MIT with parent attribution

Source code: [github.com/MACULINX/better_fabric_console](https://github.com/MACULINX/Better-Fabric-Console)