# Burrow Pack — Computer / Programming Stack

**Status**: locked in. These are the programming/automation backbone mods.

## Core (mandatory)

| Mod | Slug | Role |
|---|---|---|
| **CC: Tweaked** | `cc-tweaked` | Lua-programmable computers, turtles, monitors, modems. Turing-complete. |
| **Advanced Peripherals** | `advanced-peripherals` | CC:T addon — Geo Scanner, ME Bridge (AE2), Player Detector, Block Reader, Energy Detector, Inventory Manager, AR Goggles, Redstone Integrator, Chunk Controller. |
| **Applied Energistics 2** | `ae2` | Digital storage + autocrafting. ME network as base "RAM". Pairs with AdvPer ME Bridge for CC programs. |
| **PneumaticCraft: Repressurized** | `pneumaticcraft-repressurized` | Visual drag-and-drop programming for drones (parallel paradigm to CC:T). |
| **KubeJS** | `kubejs` | Server-side JavaScript scripting. Used for the Wing Curse mechanic. |

## Already in pack via dependencies

- **Mekanism** — came as `ponderjs` dependency. Digital Miner, factories, jetpacks. Not "programmable" but heavy automation.

## Optional adds (not yet committed)

- **Modular Routers** — slot-based item routing (lightweight CC:T alternative)
- **Integrated Dynamics + Tunnels** — visual logic networks (Excel-formulas-for-Minecraft)

## Skipped intentionally

- **OpenComputers** — redundant with CC:T, smaller ecosystem, more complexity for no gain.
- **Refined Storage** — conflicts philosophically with AE2. AE2 wins.

## External tooling (not mods, but recommended workflow)

- **VS Code** + `lemmmy.computercraft-extension-pack` + `sumneko.lua` + `lua-ls-cc-tweaked` addon — full IDE for Lua with CC:T autocomplete.
- **CraftOS-PC** — offline emulator. Develop programs without booting MC.
- **Git** — version-control program registry.
- **CC:T `wget run <url>`** — minimal viable "API": host Lua files at any URL, computers fetch and execute.

## Future (BurrowOS)

Custom Node.js or Python backend hosting program registry, telemetry, web dashboard. Scope: ~3–5 days of dedicated work. Build only after pack ships.

- HTTP/WS endpoints for program fetch + telemetry
- Git-backed program storage
- Web dashboard for fleet monitoring
- Optional Claude API integration for AI-driven task planning

## Architecture

```
Claude Code / VS Code  ←  write Lua programs
       │
       ▼ git push
BurrowOS (future)      ←  Node.js backend, HTTP+WS
       │
       ▼ http.get / websocket
CC:T fleet in-game    ←  bootloader polls server, executes tasks, reports telemetry
       │
       ▼ Advanced Peripherals
AE2 / Create / Mekanism  ←  the systems being orchestrated
```

## Player onboarding tiers

- **Tier 0 (friend)**: ignore everything in this file. Play Create + Mekanism + AE2 GUI normally. Pack works.
- **Tier 1 (curious friend)**: place a Computer block, run `wget run <pastebin>`, watch turtle dig.
- **Tier 2 (programming friend)**: edit Lua in-game with the built-in editor.
- **Tier 3 (you)**: VS Code workflow, BurrowOS backend, Claude orchestration.

The mods are dormant for tiers 0–1 unless engaged. No friction.