Skip to content

Commit b93dc41

Browse files
committed
Rename Simopolis vision to Soul City across design docs.
Canonical docs are soul-city.md, soul-city-uplift-roadmap.md, and tomodachi-life-and-soul-city.md; old paths stay as stubs. Keep Marusek's fictional "Simopolis" only as a literary citation.
1 parent 7ea5127 commit b93dc41

39 files changed

Lines changed: 1578 additions & 1564 deletions

apps/micropolis/website/pages/about/hosted-content/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Micropolis extends that arc into [**Soul City**](https://github.com/SimHacker/Wi
2424
|-------|----------------|----------------------|
2525
| Atoms | Objects + dialog templates | Hosted content **CARD.yml** + host mixins |
2626
| Collections | SimFreaks themes / Exchange | Federation repos + curated playsets |
27-
| Nesting | SliceCity, game-in-game | Simopolis bridges, emulators, save linking |
27+
| Nesting | SliceCity, game-in-game | Soul City bridges, emulators, save linking |
2828
| Voice | Family Album stories | Branching hypertext + Repo Show artifacts |
2929

3030
See MOOLLM specs: `hosted-content-cards`, `family-album-cards` (DonHopkins `projects/micropolis-moollm/process/`).

documentation/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Everything under this directory is **project documentation**: manuals for player
2020
- **30-second pitch (link people here):** **`designs/ELEVATOR-PITCH.md`** ← the Micropolis Federation in one page
2121
- **What to build next:** **`TODO.md`** ← start here
2222
- **The top-level framing — characters as hydrogen, Micropolis Federation:** **`designs/characters-as-hydrogen.md`** ← read this first to understand what the Federation actually is
23-
- **The unified Micropolis + Sims vision:** **`designs/simopolis.md`**
23+
- **The unified Micropolis + Sims vision:** **`designs/soul-city.md`**
2424
- **The agent layer (MOOLLM as microworld OS):** **`designs/moollm-microworld-os.md`**
2525
- **The archive recovery pipeline:** **`designs/the-tornado-and-the-archives.md`**
2626
- **Worlds embedded in worlds (the Uplifted Computer):** **`designs/the-computer-as-portal.md`**
@@ -29,7 +29,7 @@ Everything under this directory is **project documentation**: manuals for player
2929
- **Federation peer-game bridge catalogue (CK3 / RimWorld / Stardew / DF / VTTs / …):** **`designs/federation-peer-games.md`**
3030
- **Design discipline (Miyamoto, Twitch-friendly, Wright-vs-EA):** **`designs/designing-inward-miyamoto-principles.md`**
3131
- **OG Cozy Games (Sims-as-cozy-progenitor + Gamergate receipts):** **`designs/og-cozy-games.md`**
32-
- **Phased build plan (Phases 0 → 5, incl. 1C / 1D / 1E / 1F):** **`designs/simopolis-uplift-roadmap.md`**
32+
- **Phased build plan (Phases 0 → 5, incl. 1C / 1D / 1E / 1F):** **`designs/soul-city-uplift-roadmap.md`**
3333
- **Play the game / use the CLI:** root **`README.md`**, **`notes/micropolis-js-tests.md`**, **`notes/city-save-files.md`**
3434
- **Platform eras (NeWS → Wasm):** **`designs/platform-lineage-index.md`**
3535
- **Soul City / Git-as-world:** **`designs/github-as-mmorpg-multiverse.md`**

documentation/TODO.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -36,17 +36,17 @@ the linked documents.
3636
| [VitaMoo — renderer polish](#vitamoo--webgpu-renderer-polish) | GPU pass timing, richer validation UX | Medium |
3737
| [VitaMoo — UI overlays](#vitamoo--ui-overlays) | Pie-menu head, speech bubbles, censorship pass | Low–Medium |
3838
| [VitaMooSpace — Roots & Catalog tabs](#vitamoospace--roots--catalog-tabs) | ~~Roots + Catalog~~ ✅ built — smoke test, then SQLite persistence | Medium |
39-
| [Simopolis — The Uplift](#simopolis--the-uplift) | Phase 0: sims-io L4 ContentIndex bridge + MOOLLM `CHARACTER.yml` emit | **High** |
40-
| [Simopolis — The Uplift](#simopolis--the-uplift) | Phase 0: SPR2 → PNG export + `.iff` save-file download | **High** |
41-
| [Simopolis — The Uplift](#simopolis--the-uplift) | Phase 0: minimal `apps/simopolis/` SvelteKit shell | **High** |
42-
| [Simopolis — The Uplift](#simopolis--the-uplift) | Phase 1: MOOLLM enrichment via MCP + Family Album server | High |
43-
| [Simopolis — The Uplift](#simopolis--the-uplift) | **Phase 1C: Uplifted Computer + custom IFF content (the headline demo)** | **High** |
44-
| [Simopolis — The Uplift](#simopolis--the-uplift) | **Phase 1D: Imagine Loop — Examine → Imagine → Edit → Inject (the LLM-as-narrator alternative to reimplementing the Sims engine)** | **High** |
45-
| [Simopolis — The Uplift](#simopolis--the-uplift) | **Phase 1E: Family Album as StoryMaker — branching/merging graph of scenes; "snippets of DNA"; 35-year SimCity → Bar Karma → MicropolisCore lineage** | **High** |
46-
| [Simopolis — The Uplift](#simopolis--the-uplift) | **Phase 1F: Twitch-friendly streaming features — chat-as-writers'-room, OBS overlays, Twitch Extension, save-file giveaway with provenance** | **High** |
47-
| [Simopolis — The Uplift](#simopolis--the-uplift) | Phase 2: Micropolis residential zone ↔ Sims neighborhood data contract | Medium |
48-
| [Simopolis — The Uplift](#simopolis--the-uplift) | Phase 3: Archive tornado — first source (Sims Exchange via archive.org) | Medium |
49-
| [Simopolis — The Uplift](#simopolis--the-uplift) | Federation peer-game bridges (post-Phase-2): CK3, RimWorld, Stardew Valley, Dwarf Fortress, VTTs (see [federation-peer-games.md](designs/federation-peer-games.md)) | Medium |
39+
| [Soul City — The Uplift](#simopolis--the-uplift) | Phase 0: sims-io L4 ContentIndex bridge + MOOLLM `CHARACTER.yml` emit | **High** |
40+
| [Soul City — The Uplift](#simopolis--the-uplift) | Phase 0: SPR2 → PNG export + `.iff` save-file download | **High** |
41+
| [Soul City — The Uplift](#simopolis--the-uplift) | Phase 0: minimal `apps/simopolis/` SvelteKit shell | **High** |
42+
| [Soul City — The Uplift](#simopolis--the-uplift) | Phase 1: MOOLLM enrichment via MCP + Family Album server | High |
43+
| [Soul City — The Uplift](#simopolis--the-uplift) | **Phase 1C: Uplifted Computer + custom IFF content (the headline demo)** | **High** |
44+
| [Soul City — The Uplift](#simopolis--the-uplift) | **Phase 1D: Imagine Loop — Examine → Imagine → Edit → Inject (the LLM-as-narrator alternative to reimplementing the Sims engine)** | **High** |
45+
| [Soul City — The Uplift](#simopolis--the-uplift) | **Phase 1E: Family Album as StoryMaker — branching/merging graph of scenes; "snippets of DNA"; 35-year SimCity → Bar Karma → MicropolisCore lineage** | **High** |
46+
| [Soul City — The Uplift](#simopolis--the-uplift) | **Phase 1F: Twitch-friendly streaming features — chat-as-writers'-room, OBS overlays, Twitch Extension, save-file giveaway with provenance** | **High** |
47+
| [Soul City — The Uplift](#simopolis--the-uplift) | Phase 2: Micropolis residential zone ↔ Sims neighborhood data contract | Medium |
48+
| [Soul City — The Uplift](#simopolis--the-uplift) | Phase 3: Archive tornado — first source (Sims Exchange via archive.org) | Medium |
49+
| [Soul City — The Uplift](#simopolis--the-uplift) | Federation peer-game bridges (post-Phase-2): CK3, RimWorld, Stardew Valley, Dwarf Fortress, VTTs (see [federation-peer-games.md](designs/federation-peer-games.md)) | Medium |
5050
| [Sims I/O in TypeScript](#sims-io-typescript-package) | ~~Scaffold `packages/sims-io/` L0–L3~~ ✅ done (48 tests) | ~~High~~ |
5151
| [Sims I/O in TypeScript](#sims-io-typescript-package) | Add `parseMSH` to vitamoo (prototype-1998 binary mesh, DDD format) | Medium |
5252
| [GUID collision tooling](#sims-guid-collision-tooling) | Wire collision scanner into VitaMooSpace UI | Medium |
@@ -368,23 +368,23 @@ Currently `files-inventory.ts` holds state **in-process memory** — a server re
368368

369369
---
370370

371-
## Simopolis — The Uplift
371+
## Soul City — The Uplift
372372

373373
**Top-level framing:** [documentation/designs/characters-as-hydrogen.md](designs/characters-as-hydrogen.md) — characters as the *hydrogen* (most-abundant, highest-valence content-atom) of the **Micropolis Federation**, with other atom types (lots, objects, behaviors, appearances, memories, stories, sounds) combining into molecules. *Federation* deliberately (Star Trek vibe), not *franchise* — cooperative association of sovereign open-source projects.
374-
**Strategy:** [documentation/designs/simopolis.md](designs/simopolis.md) — unified Micropolis + Sims vision (introduces the two-product naming: **Micropolis City** + **Micropolis Home**)
374+
**Strategy:** [documentation/designs/soul-city.md](designs/soul-city.md) — unified Micropolis + Sims vision (introduces the two-product naming: **Micropolis City** + **Micropolis Home**)
375375
**Substrate:** [documentation/designs/moollm-microworld-os.md](designs/moollm-microworld-os.md) — MOOLLM as the agent layer
376376
**Recovery pipeline:** [documentation/designs/the-tornado-and-the-archives.md](designs/the-tornado-and-the-archives.md) — sweep the Internet Archive into residential zones
377377
**Computer-as-portal:** [documentation/designs/the-computer-as-portal.md](designs/the-computer-as-portal.md) — Uplifted Computer + custom IFF content for the EA game
378378
**Imagine Loop:** [documentation/designs/the-imagine-loop.md](designs/the-imagine-loop.md) — LLM-as-narrator alternative to reimplementing the Sims engine
379379
**Family Album as StoryMaker:** [documentation/designs/family-album-as-storymaker.md](designs/family-album-as-storymaker.md) — branching / merging community graph of scenes; the 35-year SimCity → DreamScape → Bar Karma → MicropolisCore lineage
380-
**Federation peer-game bridges:** [documentation/designs/federation-peer-games.md](designs/federation-peer-games.md) — catalogue of "in the spirit of Simopolis" + "wildly popular and great technical fit" bridge candidates (CK3, RimWorld, Stardew, Dwarf Fortress, VTTs, plus the anti-target list)
380+
**Federation peer-game bridges:** [documentation/designs/federation-peer-games.md](designs/federation-peer-games.md) — catalogue of "in the spirit of Soul City" + "wildly popular and great technical fit" bridge candidates (CK3, RimWorld, Stardew, Dwarf Fortress, VTTs, plus the anti-target list)
381381
**Design discipline (incl. Twitch-friendly):** [documentation/designs/designing-inward-miyamoto-principles.md](designs/designing-inward-miyamoto-principles.md) — Miyamoto principles + Twitch-friendly streaming features + Wright-vs-EA designer-vs-platform separation
382-
**Build plan:** [documentation/designs/simopolis-uplift-roadmap.md](designs/simopolis-uplift-roadmap.md) — phases 0–5 (incl. 1C / 1D / 1E / 1F), definitions of done, risk register
382+
**Build plan:** [documentation/designs/soul-city-uplift-roadmap.md](designs/soul-city-uplift-roadmap.md) — phases 0–5 (incl. 1C / 1D / 1E / 1F), definitions of done, risk register
383383
**Vision/story (external):** [MOOLLM: THE-UPLIFT.md](https://github.com/SimHacker/moollm/tree/main/designs/sim-obliterator/THE-UPLIFT.md)
384384
**Field mappings (external):** [MOOLLM: BRIDGE.md](https://github.com/SimHacker/moollm/tree/main/designs/sim-obliterator/BRIDGE.md)
385385
**IFF layer stack (external):** [MOOLLM: IFF-LAYERS.md](https://github.com/SimHacker/moollm/tree/main/designs/sim-obliterator/IFF-LAYERS.md)
386386

387-
Bringing Micropolis (the GPL city simulator descended from SimCity) and The Sims under one umbrella in MicropolisCore. Python parsing is replaced by TypeScript in `packages/sims-io`. The Python codebase (SimObliterator Suite) remains a reference implementation; this monorepo is the browser-native rewrite. The full phased plan lives in [simopolis-uplift-roadmap.md](designs/simopolis-uplift-roadmap.md); the headlines below are the immediately-actionable items.
387+
Bringing Micropolis (the GPL city simulator descended from SimCity) and The Sims under one umbrella in MicropolisCore. Python parsing is replaced by TypeScript in `packages/sims-io`. The Python codebase (SimObliterator Suite) remains a reference implementation; this monorepo is the browser-native rewrite. The full phased plan lives in [soul-city-uplift-roadmap.md](designs/soul-city-uplift-roadmap.md); the headlines below are the immediately-actionable items.
388388

389389
### A. sims-io L4 — ContentIndex bridge to VitaMoo (Phase 0)
390390

@@ -410,19 +410,19 @@ Drag-drop a `.iff`, see characters, edit fields, write a new `.iff`. The first t
410410

411411
### F. Micropolis residential zone ↔ Sims neighborhood data contract (Phase 2)
412412

413-
Define the JSON interface: a residential zone position maps to `content/micropolis/cities/<city>/neighborhoods/zone-<row>-<col>.yml` pointing at a parsed `Neighborhood.iff`. The Micropolis engine reads aggregate metrics (budget, population, education, satisfaction) and folds them into tile simulation. Bound neighborhoods read city signals (unemployment, pollution, disasters) back. Small interface, two-way coupling. See [roadmap Phase 2](designs/simopolis-uplift-roadmap.md#phase-2--two-resolution-coupling-micropolis-zone--sims-neighborhood-4-6-weeks).
413+
Define the JSON interface: a residential zone position maps to `content/micropolis/cities/<city>/neighborhoods/zone-<row>-<col>.yml` pointing at a parsed `Neighborhood.iff`. The Micropolis engine reads aggregate metrics (budget, population, education, satisfaction) and folds them into tile simulation. Bound neighborhoods read city signals (unemployment, pollution, disasters) back. Small interface, two-way coupling. See [roadmap Phase 2](designs/soul-city-uplift-roadmap.md#phase-2--two-resolution-coupling-micropolis-zone--sims-neighborhood-4-6-weeks).
414414

415415
### G. Family Album server (Phase 1)
416416

417-
Compatible endpoint for the Steam Sims re-release's upload feature. Receives albums, stores under `content/simopolis/albums/incoming/` with provenance, parses, makes them browsable, makes their characters uplift-able. See [roadmap Phase 1 Track B](designs/simopolis-uplift-roadmap.md#phase-1--moollm-enrichment--family-album-server-3-4-weeks).
417+
Compatible endpoint for the Steam Sims re-release's upload feature. Receives albums, stores under `content/simopolis/albums/incoming/` with provenance, parses, makes them browsable, makes their characters uplift-able. See [roadmap Phase 1 Track B](designs/soul-city-uplift-roadmap.md#phase-1--moollm-enrichment--family-album-server-3-4-weeks).
418418

419419
### G2. Uplifted Computer + custom IFF content (Phase 1C — **the headline demo**)
420420

421421
The first player-visible content artifact: a custom IFF Computer object that "runs" Micropolis (via screen-snapshot SPR2 sprites), plus CD-ROM / Save-Game Disk / Foreign Photo Album / Screen-Snapshot Camera custom objects. Adventure Compiler authors all five from YAML. Player drops them into their `~/Documents/EA Games/The Sims/Downloads/` directory; they appear in the EA-published Sims 1 as ordinary custom content.
422422

423423
**Headline 2-week demo:** Sim plays Micropolis on a custom PC inside the player's EA-published Sims 1. Finishes Will Wright's 1996 Stanford demo.
424424

425-
Full design: [the-computer-as-portal.md](designs/the-computer-as-portal.md). Concrete tasks: [roadmap Phase 1C](designs/simopolis-uplift-roadmap.md#phase-1c--uplifted-computer--custom-iff-content-3-4-weeks-parallelizable-with-2).
425+
Full design: [the-computer-as-portal.md](designs/the-computer-as-portal.md). Concrete tasks: [roadmap Phase 1C](designs/soul-city-uplift-roadmap.md#phase-1c--uplifted-computer--custom-iff-content-3-4-weeks-parallelizable-with-2).
426426

427427
Key sub-items:
428428
- **`moollm://` URL scheme** in `packages/sims-io/src/l4/moollm-url.ts` + resolver
@@ -437,7 +437,7 @@ The architectural alternative to reimplementing the Sims runtime. Examine a pars
437437

438438
**Headline 1–2-week demo:** Five years pass for the Goth household, in one LLM call, ending in a valid `.iff` the player loads into their EA Sims 1 and a pageable album book on the shelf summarizing the five years in 20 languages.
439439

440-
Full design: [the-imagine-loop.md](designs/the-imagine-loop.md). Concrete tasks: [roadmap Phase 1D](designs/simopolis-uplift-roadmap.md#phase-1d--the-imagine-loop-4-6-weeks-parallelizable-with-1b--1c--2).
440+
Full design: [the-imagine-loop.md](designs/the-imagine-loop.md). Concrete tasks: [roadmap Phase 1D](designs/soul-city-uplift-roadmap.md#phase-1d--the-imagine-loop-4-6-weeks-parallelizable-with-1b--1c--2).
441441

442442
Key sub-items:
443443
- `packages/sims-io/src/l5/``examine.ts`, `intent.ts`, `imagine-apply.ts`, `validate.ts`, `compile.ts`, `loop.ts` (valid-or-revise)
@@ -452,7 +452,7 @@ Sims Family Albums become a **branching, merging, geo-tagged graph of scenes**
452452

453453
**Headline 1–2-week demo:** One user with a small album graph, shares one storyline with one friend via a git remote, both compile to a pageable album book IFF and load it into their EA Sims 1. The smallest visible demo of the StoryMaker reborn.
454454

455-
Full design: [family-album-as-storymaker.md](designs/family-album-as-storymaker.md). Concrete tasks: [roadmap Phase 1E](designs/simopolis-uplift-roadmap.md#phase-1e--family-album-as-storymaker-4-6-weeks-parallelizable-with-1b--1c--1d).
455+
Full design: [family-album-as-storymaker.md](designs/family-album-as-storymaker.md). Concrete tasks: [roadmap Phase 1E](designs/soul-city-uplift-roadmap.md#phase-1e--family-album-as-storymaker-4-6-weeks-parallelizable-with-1b--1c--1d).
456456

457457
Key sub-items:
458458
- `packages/family-album/` — schemas, graph builder, local-FS + git-remote federation, CA biome layer
@@ -467,7 +467,7 @@ Key sub-items:
467467

468468
**Headline 1-week demo:** A Sims streamer drops Micropolis Home overlay URLs into OBS, streams with VOD chapter markers, gives viewers the save file at stream end with full stream-derived provenance trail.
469469

470-
Full design: [designing-inward-miyamoto-principles.md → §8a The Twitch corollary](designs/designing-inward-miyamoto-principles.md#8a-the-twitch-corollary-make-streamers-radically-powerful). Concrete tasks: [roadmap Phase 1F](designs/simopolis-uplift-roadmap.md#phase-1f--twitch-friendly-streaming-features-3-5-weeks-parallelizable-with-1b--1c--1d--1e).
470+
Full design: [designing-inward-miyamoto-principles.md → §8a The Twitch corollary](designs/designing-inward-miyamoto-principles.md#8a-the-twitch-corollary-make-streamers-radically-powerful). Concrete tasks: [roadmap Phase 1F](designs/soul-city-uplift-roadmap.md#phase-1f--twitch-friendly-streaming-features-3-5-weeks-parallelizable-with-1b--1c--1d--1e).
471471

472472
Key sub-items:
473473
- `packages/twitch-bridge/` — IRC integration, EventSub wiring, VOD chapter emission

documentation/designs/ELEVATOR-PITCH.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,8 @@ A Star-Trek-style cooperative association of sovereign open-source projects —
3939
| If you want… | Read |
4040
|---|---|
4141
| What the Federation actually is | [characters-as-hydrogen.md](characters-as-hydrogen.md) |
42-
| Micropolis + The Sims under one roof | [simopolis.md](simopolis.md) |
42+
| Micropolis + The Sims under one roof | [soul-city.md](soul-city.md) |
4343
| The agent layer (MOOLLM) | [moollm-microworld-os.md](moollm-microworld-os.md) |
4444
| Which games we'd bridge to, and why | [federation-peer-games.md](federation-peer-games.md) |
45-
| The phased build plan | [simopolis-uplift-roadmap.md](simopolis-uplift-roadmap.md) |
45+
| The phased build plan | [soul-city-uplift-roadmap.md](soul-city-uplift-roadmap.md) |
4646
| Everything | [designs/README.md](README.md) |

0 commit comments

Comments
 (0)