ColonyWeb

A server-side-only Minecraft mod for 1.20.1 (Forge) and 1.21.1 (NeoForge) that adds a live web dashboard for MineColonies colonies. Open it in any browser to see builder progress, resource needs, citizens, research, defence stats, and warehouse stock — all with live updates via server-sent events.

Players sign in with a pairing code from /colonyweb sync and only see colonies they belong to. The mod does not need to be installed on the client

For support please do not contact the offical minecolonies support. Use the issue option to report issues.

Features

Eight tabs, every one of them live — colony data streams in over SSE, so nothing here needs a manual refresh.

Overview

The colony at a glance. Stat tiles for citizens, happiness, buildings, defence, warehouse and research sit above the builder roster, and every work order sorts by activity — whatever is moving sits at the top. Active research and builder assignments are right there so you always know what's happening.

Map

A pannable, zoomable top-down render of the colony at one pixel per block. Building pins mark every structure and live citizen dots move as they do. Toggle buildings, citizens and labels independently, auto-fit to the colony bounds, or snap straight to the town hall.

Buildings

Every building in the colony as a scannable card grid. Search by name, filter to in-progress builds or decorations, and sort by status, name, progress or level. Click any card to see exactly what resources it still needs — right down to the item count.

Needed

A consolidated view of every resource currently needed across all in-progress builds, aggregated and deduplicated. Instead of clicking through individual buildings, see at a glance what the colony is short on — and exactly how many.

Citizens

The full roster with a job filter and text search. Each citizen opens into a detail panel with their skill breakdown, health and happiness meters, and their inventory and equipment slots. See who is working, who is idle, and what they're carrying.

Research

Every university branch drawn as progress bars with state pills — queued, in-progress or complete — and item-cost icons for whatever each unlock wants. Instantly see what's researching now and what's waiting behind it.

Combat

Guard post staffing at a glance — ok, delivery needed or missing — with individual guard health and a raid banner counting the nights since the last attack. Know whether your defences are ready before the next raid hits.

Warehouse

Aggregated colony stock across every rack and hut block, searchable and sortable by count or alphabetically. Exactly what you'd open the warehouse hut to check, without walking there.

Dependencies

All three are required — install them alongside ColonyWeb.

Installation

1. Drop the ColonyWeb jar and its dependencies into your server's mods/ folder.
2. Start the server — the config file config/colonyweb-common.toml is generated automatically.
3. Open http://your-server-ip:8723 in any browser.
4. Run /colonyweb sync in-game and enter the pairing code on the web page.

Configuration

File: config/colonyweb-common.toml

In-Game Commands

Signing In

1. Run /colonyweb sync in-game. A short code appears in chat (e.g. 3B7X-K2L9).
2. Open your browser to the server's dashboard URL.
3. Type the code into the pairing screen. Codes are case-insensitive.

The code is single-use and expires after 10 minutes by default (loginCodeMinutes). Once accepted, the browser stays signed in for sessionDays — 30 days by default.

Troubleshooting

See the server log (latest.log) for lines prefixed with [ColonyWeb].

License

GNU General Public License v3.0