[Epic] Programmable education platform: agents, events, and a modern Python client

[sakebomb]

Vision

Grow RaspberryJuice from a block-drawing bridge into a teaching platform — so people (and kids in STEM classes) can program Minecraft with Python: draw and build, react to events, and drive agents/mobs that walk around and do things.

North star

A per-session programmable Agent (turtle/Logo model): forward, turn, place, dig, move_to. It maps directly onto the intro-CS arc (sequencing → loops → functions → coordinates) and is the most motivating thing to demo.

Principles

• Additive & backward-compatible: keep the simple line-based protocol; new commands are namespaced and feature-detectable so existing mcpi scripts keep working (same discipline that preserved the legacy-id protocol).
• Two tracks, one product: server features and a modern Python client + curriculum. Teachers adopt examples and docs, not raw protocols.
• Classroom-safe: per-student agents, region sandboxing, per-session limits.

Scope (sub-issues)

• Agent: a programmable per-session bot (turtle/Logo model) #12 — Agent: programmable per-session bot (turtle/Logo) ← start here (Agent v1)
• Event hooks: player-move/region, block place/break, death, and more #13 — Event hooks: player-move/region, block place/break, death, …
• Entity/mob control: pathfinding, actions, state #14 — Entity/mob control: pathfinding, actions, state
• Player & world experience control (give/potion/sound/title, time/weather/fill/clone) #15 — Player & world experience control
• Modern Python client library + docs #16 — Modern Python client library + docs
• Curriculum / example-project gallery for STEM classes #17 — Curriculum / example-project gallery
• Classroom multiplayer: per-student agents, region sandboxing, limits #18 — Classroom multiplayer: per-student agents, sandboxing, limits

Suggested phasing

1. Agent v1 (Agent: a programmable per-session bot (turtle/Logo model) #12) + a few core event hooks from Event hooks: player-move/region, block place/break, death, and more #13 (player-move/region, block place/break, death) — smallest slice that unlocks real lessons.
2. Entity control (Entity/mob control: pathfinding, actions, state #14) + player/world control (Player & world experience control (give/potion/sound/title, time/weather/fill/clone) #15) — breadth of "fun".
3. Python client (Modern Python client library + docs #16) + curriculum (Curriculum / example-project gallery for STEM classes #17) — adoption.
4. Classroom safety (Classroom multiplayer: per-student agents, region sandboxing, limits #18) — scale to a class.

Related: distribution is tracked in #11 (Modrinth/Hangar).