flipClub

Multiplayer hacker-pet battles for Flipper Zero. Your dolphin is your fighter.

Two Flippers meet in person → tap NFC to pair → battle over Sub-GHz → winner's dolphin earns real XP (DolphinDeedPluginGameWin, +10).

This is not a Tamagotchi. There is no separate creature to feed. The Pet is a battleable projection of stats your Flipper already tracks for hacking work — dolphin_stats() (level, XP, mood) drives HP / Attack / Defense.

Inspired by walking out of BSides Charm and seeing a Flipper Zero on every other belt, plus nostalgia for the original Digimon V-Pet keychain ritual.

Build

pip install --user ufbt          # one-time
cd flipClub
ufbt                             # produces dist/flipclub.fap
ufbt launch                      # flash + run on a connected Flipper

Builds against Flipper SDK 1.4.3 / API 87.1 (current stock). Should also work on Momentum / Xtreme / RogueMaster — the dolphin and Sub-GHz APIs are inherited.

Architecture

flipclub/
├── application.fam        # FAP manifest
├── flipclub.{c,h}         # entry point, ViewDispatcher + SceneManager wiring
├── pet/
│   ├── pet_snapshot.*     # builds a wire-ready Pet from dolphin_stats() + save
│   ├── pet_save.*         # versioned binary save with CRC32
│   └── battle_engine.*    # pure deterministic resolver — host-testable
├── net/
│   ├── proto.*            # CRC16 + FNV1a + frame defs
│   ├── link_subghz.*      # subghz_tx_rx_worker wrapper, region-checked
│   └── pairing.*          # NFC ISO14443-3A handshake (host emulates a tag)
└── scenes/                # main menu, pet card, pair, battle, trade, etc.

Battle protocol over Sub-GHz (60-byte packet ceiling): HELLO → READY → 4×MOVE → implicit RESULT. Both sides compute the same outcome from a combined RNG seed (XOR of both nonces).

NFC pairing carries {magic=0xFC, session_id[2], frequency_hz[4]} in a 7-byte ISO14443-3A UID. The frequency is picked at handshake time from a 6-channel pool, region-allowed via furi_hal_region_is_frequency_allowed.

Status

v0.1 — multiplayer battle is implemented end-to-end. Trade scene is a stub. Sprite art is text-only for now. Engine determinism verified across 200 seeds on host. Real two-Flipper validation needs hardware.

See docs/superpowers/specs/2026-04-26-flipclub-design.md for the full design.

License

MIT. Built with Claude Code in one auto-mode session — research → design → 4 parallel build agents → bug-hunt review → fix pass.