Skill

---
name: sim-obliterator
description: "Two-way bridge between The Sims 1 save files and MOOLLM characters"
license: MIT
tier: 2
allowed-tools:
  - read_file
  - write_file
  - run_terminal_cmd
related: [character, mind-mirror, incarnation, needs, adventure]
tags: [sims, bridge, transport, uplift, download, save-file]
---

# SimObliterator — The Sims ↔ MOOLLM Bridge (RETIRED)

> *"What would your Sims say if they could finally talk to you?"*

## ⚠️ Retired — do not invoke this skill

It drives a Python sister repo whose job has been rewritten in TypeScript, and it uses
vocabulary the project has replaced. Go here instead:

| For | Read |
|---|---|
| The protocol, and the words for it | [`skills/soul-city/`](../../../skills/soul-city/) — [SOUL-BRIDGES.md](../../../skills/soul-city/SOUL-BRIDGES.md), [GLOSSARY.md](../../../skills/soul-city/GLOSSARY.md) |
| Field-level Sims ⇄ soul mapping | MicropolisCore [`packages/sims-io/`](https://github.com/SimHacker/MicropolisCore/tree/main/packages/sims-io) |
| Resource layers and IFF | MicropolisCore [`packages/vitamoo/`](https://github.com/SimHacker/MicropolisCore/tree/main/packages/vitamoo) |
| The build, phase by phase | MicropolisCore [roadmap](https://github.com/SimHacker/MicropolisCore/blob/main/documentation/designs/soul-city-uplift-roadmap.md) |

Every retired document is mapped to its current home in
[designs/sim-obliterator/README.md](../designs/README.md).

Everything below is kept for provenance.

## What It Did

Reads and writes The Sims 1 save files via the SimObliterator Suite, a binary format parser that understands IFF files — the container format EA used for everything in The Sims.

Characters beam between a 26-year-old game and an LLM universe. Their personality traits, skills, needs, career, relationships, and family data travel with them. Mind Mirror personality (the MOOLLM extension) waits for them when they return.

## Setup

Run SETUP first. Everything else depends on it.

```bash
python3 skills/sim-obliterator/scripts/setup.py
```

Works on macOS, Linux, and Windows. This will:
1. Clone SimObliterator Suite to `../SimObliterator_Suite/` if not already there
2. Create a Python venv inside it (`.venv/`, gitignored)
3. Install dependencies from `requirements.txt`
4. Verify the IFF parser imports correctly
5. Tell you to add the repo to your Cursor workspace

The venv lives inside SimObliterator's directory, not moollm's. This keeps environments isolated. The `.venv/` directory is gitignored by SimObliterator.

## Methods

### SETUP

Clone, venv, install, verify. Idempotent — safe to run again.

```
> SETUP sim-obliterator
SimObliterator cloned, venv created, IFFFile imports. Ready.
```

### INSPECT

Read-only exploration of a save file. Lists families, characters, objects.

```
> INSPECT ~/Sims/UserData/Neighborhoods/Neighborhood001.iff
Found 8 families, 23 characters:
  Goth Family: Mortimer (neat:9, outgoing:2), Bella (outgoing:9, active:7)
  Pleasant Family: Jeff (playful:8), Diane (neat:7)
  ...
```

### UPLIFT

Reads a character from a save file, maps their PersonData to the MOOLLM `sims:` block, enriches with LLM-generated mind_mirror/description/dialogue, writes CHARACTER.yml.

```
> UPLIFT ~/Sims/Neighborhood001.iff "Bella Goth"
Uplifted Bella Goth → characters/bella-goth/CHARACTER.yml
  Traits: neat:1, outgoing:9, active:7, playful:5, nice:3
  Skills: charisma:8, cooking:3
  Zodiac: aries (computed)
  Career: Politics level 5
  Gold: §23,400
```

The uplift maps PersonData fields to the `sims:` block at 0-10 display scale. The LLM then generates mind_mirror properties, a description, backstory, and dialogue based on the personality. The character is immediately usable in MOOLLM.

### DOWNLOAD

Reads a CHARACTER.yml, maps the `sims:` block back to PersonData, patches the save file.

```
> DOWNLOAD characters/bella-goth/CHARACTER.yml ~/Sims/Neighborhood001.iff
Patched Bella Goth into save file.
  Traits written, skills written, needs written.
  mind_mirror preserved in CHARACTER.yml (Sims doesn't have it).
```

## The Transport Protocol

**BEAM UP** (Sims → MOOLLM):
- SimObliterator reads binary save → PersonData array extracted
- `sims:` block fills from PersonData (traits ÷ 100, needs as-is)
- LLM enriches: mind_mirror, description, dialogue, backstory
- Character is alive in MOOLLM

**BEAM DOWN** (MOOLLM → Sims):
- `sims:` block reads → traits × 100, needs as-is → PersonData
- SimObliterator patches binary save
- `mind_mirror:` stays in CHARACTER.yml — Sims doesn't know about it
- Character walks around in the game

**PARALLEL LIFE**:
- Character exists in both worlds simultaneously
- `sims:` is the sync surface — the fields both systems understand
- `mind_mirror:` is MOOLLM-only — it waits when you beam down
- Changes can be merged like git — no data is lost in either direction

## Field Mapping

| CHARACTER.yml | PersonData Index | Scale |
|---------------|-----------------|-------|
| sims.traits.nice | 2 (kPersNice) | 0-10 → ×100 → 0-1000 |
| sims.traits.active | 3 (kPersActive) | 0-10 → ×100 → 0-1000 |
| sims.traits.generous | 4 (kPersGenerous) | 0-10 → ×100 → 0-1000 |
| sims.traits.playful | 5 (kPersPlayful) | 0-10 → ×100 → 0-1000 |
| sims.traits.outgoing | 6 (kPersOutgoing) | 0-10 → ×100 → 0-1000 |
| sims.traits.neat | 7 (kPersNeat) | 0-10 → ×100 → 0-1000 |
| sims.skills.cooking | 10 (kCookingSkill) | 0-10 → ×100 → 0-1000 |
| sims.needs.hunger | motive system | -100 to 100 (as-is) |
| sims.career.track | 56 (kJobType) | enum 0-9 |
| sims.identity.zodiac | 70 (kZodiacSign) | computed, not stored |

See `skills/mind-mirror/SIMS-STATS.yml` for the complete field reference.
See `skills/mind-mirror/ZODIAC.yml` for the zodiac computation algorithm.

## Sister Repo Pattern

SimObliterator is NOT embedded in moollm. It lives beside it:

```
~/GroundUp/Leela/git/
├── moollm/                     ← skills live here
│   └── skills/sim-obliterator/ ← this skill
└── SimObliterator_Suite/       ← Jeff's repo (sister directory)
    ├── src/                    ← Python API we call
    ├── .venv/                  ← our venv (gitignored)
    └── requirements.txt
```

The skill knows where the sister repo is (default `../SimObliterator_Suite`, configurable). Scripts add `src/` to `sys.path` at runtime. The venv isolates SimObliterator's dependencies (DearPyGUI, Flask, Pillow, etc.) from moollm's environment.

## Dovetails With

- `skills/character/` — The CHARACTER.yml format we read/write
- `skills/mind-mirror/` — Personality layer that enriches uplifted characters
- `skills/incarnation/` — Ethical character creation (uplifted Sims get incarnated)
- `skills/needs/` — The Sims need system mapped 1:1
- `skills/adventure/` — Uplifted characters enter the adventure world