ODLET
Odlet (odlet.xyz) is a pixel-art reasoning game for Android / Solana Seeker and the browser. Walk an adventure map of voxel monsters you defeat with puzzles, play the three-trial DAILY (Pattern → Shadow → Link), raid weekly bosses, and collect MagicaVoxel-style voxel figures — bought with shards or devnet SOL and minted as Metaplex Core NFTs.
- Client: Unity 6000.6 (Android + WebGL), UI Toolkit, pixelated 3D voxel renderer, offline-first.
- Backend: Supabase (Postgres + RLS + RPCs); the server replays submitted answers instead of trusting "solved" flags.
- Core:
packages/core, a bit-for-bit TypeScript port of the C# domain (puzzles, figures, levels, shop, bosses).
- Website:
web/, Next.js site with the WebGL game, marketplace, leaderboards, friends and devnet SOL purchases.
Status, verification and open items: docs/STATE.md. Architecture and contracts: docs/PLAN_V2.md. Risks: docs/RISKS.md.
Fresh clone
Requirements: Unity 6000.6.5f1 with Android + WebGL modules, Node 24, pnpm 9, Docker Desktop.
pnpm install
pnpm build:core # web consumes @ronriku/core from dist/
# Backend (local)
cd backend
npx supabase start
npx supabase db reset
pnpm publish:content # answer keys, shop shelf, bosses — required after every reset
cd ..
# Website
cp web/.env.example web/.env.local # fill from `npx supabase status -o env` (in backend/)
pnpm --filter web create-mint-authority # server mint authority (needs no SOL) + payment recipient into web/.env.local
Unity (open client/):
- Menu RONRIKU → Setup Fonts (once; creates static pixel-font atlases).
- RONRIKU → Build WebGL (Website) →
web/public/unity/ (git-ignored).
- RONRIKU → Build Android (Release) →
Builds/Android/ODLET.apk. Set RONRIKU_KEYSTORE, RONRIKU_KEYSTORE_PASS, RONRIKU_KEY_ALIAS, RONRIKU_KEY_PASS for a store-signed build; otherwise it is debug-signed.
pnpm --filter web build && pnpm --filter web start # http://localhost:3000, game at /play
On a phone, adb reverse tcp:54321 tcp:54321 lets the APK reach the local backend.
Self-hosting (Docker: Next.js + Caddy + Supabase on one origin, local or a VPS): deploy/README.md.
SOL payments go to NEXT_PUBLIC_PAYMENT_RECIPIENT. Each purchase is one transaction the server prepares and partially signs (payment + memo + Metaplex Core mint); the buyer's wallet signs, pays all fees and rent, and sends it. pnpm --filter web devnet-dry-run exercises this on devnet.
Tests
pnpm test:core # 352 fixture tests vs C# exports
(cd backend && pnpm test && npx supabase test db) # integration + pgTAP
pnpm --filter web test # web unit tests
Unity (editor open, via the Unity CLI): unity command run_tests --mode EditMode; PlayMode categories Uncategorized, Online (needs local backend) and Capture (writes docs/evidence/).
License
Code: MIT (see LICENSE). Fonts: SIL OFL 1.1. Third-party notices: THIRD_PARTY_NOTICES.md.
