🗡️

Miyoo Extraction RPG

Phase 0: Setup & Foundations (No Docker Edition)

1–2 weeks

This version of Phase 0 uses the union-miyoomini-toolchain directly on your host machine instead of Docker. It is the most common non-Docker approach used by Miyoo homebrew developers.

🎯 Goal

Get a working Rust server and Miyoo SDL2 client that can connect and exchange basic data.

✅ Final Deliverable

A Miyoo binary that connects to your Rust server over WiFi and shows a moving player sprite.

0 Prerequisites

  • • Linux host (Ubuntu 22.04/24.04 recommended; WSL2 on Windows also works well)
  • • Git and Rust (install via rustup.rs)
  • • Miyoo Mini Plus with Onion OS and SD card access
  • • WiFi network reachable by both dev machine and Miyoo
1

Download & Install the union-miyoomini-toolchain

This is the official/recommended toolchain for Onion OS development.

  1. Go to: https://github.com/shauninman/union-miyoomini-toolchain
  2. Download the latest release (usually a .tar.gz or zip)
  3. Extract it to a permanent location, e.g. ~/miyoo-toolchain
  4. Add the bin directory to your PATH permanently (add to ~/.bashrc or ~/.zshrc):
    export PATH="$HOME/miyoo-toolchain/bin:$PATH"
2

Create the Rust Workspace

mkdir miyoo-extraction-rpg
cd miyoo-extraction-rpg
cargo new --bin server
cargo new --lib shared

Edit the root Cargo.toml to make it a workspace with members ["server", "shared"].

3

Set up Shared Crate and Basic Packets

Same as before — add serde, bincode, etc. to shared/Cargo.toml and define basic Packet enum and Class enum.

4

Build the Rust Server Skeleton

Add tokio, bincode, etc. to server/Cargo.toml and create a minimal Tokio TCP+UDP echo server.

5

Create Miyoo SDL2 Client & Compile with Toolchain

In your client folder, create a simple SDL2 project. Use a Makefile that points to the toolchain:

CC = arm-linux-gnueabihf-gcc
# Link against SDL2 libs from Onion (copy libs from your Miyoo SD card if needed)
6

Download Starter Assets & Test Connection

Download 16×16 tilesets and sprites. Compile the client with the toolchain and copy the resulting binary to your SD card as a proper .app folder.

✅ Phase 0 Complete When:

  • ✔️ Toolchain is installed and in PATH
  • ✔️ Rust server runs and accepts connections
  • ✔️ Miyoo client compiles with the toolchain and runs on hardware
  • ✔️ You see a moving sprite over WiFi
Miyoo Extraction RPG • Phase 0 (No Docker) • Updated April 2026