🎮 Epicube

A full Minecraft 26.1.2 Fabric ecosystem — server-side mods, a connected web management game, a public website, and a 5-language internationalization layer.

---

Epicube is a complete, production-deployed Minecraft survival ecosystem. The custom content runs server-side (rendered to vanilla clients via Polymer), so players join with a plain client and still see custom blocks, GUIs and mechanics. A web app (idle/management game) is bridged into the world, and everything — game, website and in-game messages — is available in 5 languages.

• 🌐 Website: epicube.ch
• 🕹️ Management app: gestion.epicube.ch
• 🎯 Server address: mc.epicube.ch

✨ What's inside

Component	What it does	Stack
Aegis	Powered claims: protection / force-field / damage blocks + energy grid (generators, batteries, solar) + guilds	Java · Fabric · Polymer
Cargo	Bridge between the web game and Minecraft — places real chests in-game from goods produced in the app	Java · Fabric · Polymer
Revenant	Hardcore death: spectator ghost, grave reopenable for a gold ransom, midnight reset	Java · Fabric
Auction House	Player economy: /ah bidding, instant buys, GUI	Java · Fabric
Gestion (web game)	Server-authoritative idle/tycoon: mining, refining, manufacturing, farms, R&D, city, prestige	React 19 · Vite · Fastify · PostgreSQL
Website	Public site: server info, mods catalog, block wiki, client modpack download	Single-file SPA · Node

🗂️ Repository structure

epicube/
├── mods/                    # Server-side Fabric mods (MC 26.1.2)
│   ├── aegis/               #   Claims & energy
│   ├── cargo/               #   Web ↔ Minecraft bridge (Depot block)
│   ├── revenant/            #   Ghost-hardcore death
│   └── auction-house/       #   /ah player economy
├── web/
│   ├── gestion/             # The management game
│   │   ├── app/             #   React 19 + Vite front-end
│   │   └── app-server/      #   Fastify + PostgreSQL back-end
│   └── site/                # epicube.ch public website
├── server/                  # 🧩 Minecraft server template (sanitized configs + mod manifest, no secrets/world)
├── docs/                    # 📚 Full documentation (see docs/README.md)
├── CHANGELOG.md             # Release history
├── LICENSE                  # MIT
└── README.md

🚀 Quick start

Each component is independent. See docs/getting-started.md for full instructions.

# Clone
git clone https://github.com/Louisdelez/epicube.git && cd epicube

# Build a mod (requires JDK 21+)
cd mods/aegis && ./gradlew build      # → build/libs/aegis-x.y.z.jar

# Run the web game locally
cd web/gestion/app-server && npm i && DATABASE_URL=postgres://… node server.js
cd web/gestion/app && npm i && npm run dev

# Serve the website
cd web/site && node server.mjs

🌍 Internationalization

The whole ecosystem speaks French, English, German, Spanish, Italian:

• Website & game: a home-grown t() layer + data-name mutation (official Minecraft item names).
• Mods: server-side resolution per player locale (clientInformation().language()) — no Text.translatable, because clients are vanilla.

Details: docs/i18n.md.

📦 Versioning

Epicube uses Semantic Versioning with independently-versioned components and a unified release line. See docs/versioning.md and CHANGELOG.md.

📚 Documentation

The complete documentation lives in docs/ — architecture, every mod, the web app (front + back + API reference), deployment, i18n, the client modpack, and more.

📄 License

MIT © 2026 Louis Delez.

Not affiliated with Mojang or Microsoft. "Minecraft" is a trademark of Mojang Synergies AB. Bundled third-party libraries (Fabric API, Polymer, …) remain under their own licenses.