Files
wehub-resource-sync aa1a5d5763
CI / Release hygiene (push) Waiting to run
CI / Python targeted tests (push) Waiting to run
CI / Frontend build (push) Waiting to run
Pages / Build and deploy public pages (push) Waiting to run
chore: import upstream snapshot with attribution
2026-07-13 13:18:17 +08:00
..

📐 GOD Map Package Template

Minimal starter — copy, rename, drop in your assets.

🌏 中文 · 📘 Map Packages Guide


Copy this directory to agentsociety/custom/maps/<your_map_id>/, rename it, and replace map.yaml, visuals/map.json, and the assets.

The v1 contract expects a Tiled JSON map with a tile layer named Collisions. In that layer, 0 means walkable and any non-zero tile means blocked.

🚀 Three-step Start

# 1. Copy this template
cp -r agentsociety/custom/maps/_template agentsociety/custom/maps/my_town

# 2. Edit map.yaml, drop in your Tiled JSON and tilesets

# 3. Validate
cd agentsociety
uv run python scripts/validate_map_package.py custom/maps/my_town

When validation passes, restart GOD and the new map appears in the setup wizard.

See docs/MAP_PACKAGES.md for the full package contract and the_ville/ for a complete working example.