Versioned JSON · public read only
Build around server-verified public records. The website API reads the same signed snapshots shown on Network profiles and pages; it cannot change game state.
Open API index01 / Version 1
Stable public resources
| Resource | What it returns |
|---|---|
/api/v1/status | Snapshot freshness, server identifier, population, and territory sync status. |
/api/v1/players | Public player directory. Add ?online=1, ?q=name, or a bounded ?limit=. |
/api/v1/player?name=PlayerName | One public profile with privacy-filtered statistics, public deaths, memorial stories, and achievements. |
/api/v1/leaderboards?metric=blocks_mined | Public rankings for streak, playtime, currencies, survival, and lifetime history totals. |
/api/v1/market | Marks prices, market supply, and published 24-hour price movement. |
/api/v1/clans and /api/v1/clan-relations | Public clan records and public alliances or rivalries. |
/api/v1/territory?world=minecraft:overworld | Public clan-assigned chunks. Without a world parameter, returns worlds with public territory. |
/api/v1/deaths and /api/v1/memorials | Public death stories and Soul-funded memorial records, with coordinates omitted. |
/api/v1/events and /api/v1/activity | Published world events and privacy-filtered Network activity. |
/api/v1/goals, /api/v1/contracts, /api/v1/shops | Public community progress, player delivery contracts, and read-only item listings. |
Send GET requests. Responses are JSON, cached for 30 seconds, and include an ETag for conditional requests. List endpoints accept a limit up to 250.
curl https://hardcoreminecraft.net/api/v1/status
curl "https://hardcoreminecraft.net/api/v1/leaderboards?metric=longest_survival_seconds&limit=25"Profiles follow player visibility settings. Private statistics are omitted. The API excludes exact death coordinates, private homes, personal claim coordinates, player UUIDs, account data, and moderation records. Territory is limited to claims assigned to public clans.
The API reads the latest signed plugin snapshot. It cannot grant currency, lives, items, permissions, or progress; public data may lag behind the live server by one sync interval.