Changelog

This v3 document supersedes v2 (2026-04-21). The below is structured as (A) v2 → v3 changes (this update) followed by (B) the v1 → v2 changelog retained for historical context.

#23.0 v2 → v3 Changes (This Update)

Mechanical Refinement

• Mirror Fighter mechanic refined: automatic same-style mirror each match (not pre-pick). Every Mirror matchup is a same-style pentagon matchup by construction. Mirror vs Mirror remains randomly assigned style (unchanged).

Product Rename

• ROKI Mushin product renamed to ROKI Zen. Inner modes keep their names: Strike Mode, Mushin Mode (the blindfold mode — Mushin is authentic for no-mind), Rhythm Chain.

Zen Mechanic Definition

• Added Zen Cut visual mechanic specification: falling drop, katana blade arc, trail reflects timing quality. Perfect cleanly splits the drop; Great off-angle; Good nicks; Miss swings through air.
• Added Mushin Mode audio-first blindfold spec: countdown warning + distinctive incoming sound, drop hidden behind curtain, layered audio on tap (whoosh + slice + split + bell), brief post-tap reveal. Audio IS the score readout for blindfold mode.
• Noted a future fast-velocity slicing variant (finger-drag across multiple flying objects) as a deferred, separate mechanic — not v1 scope.

Dojo Updates

• Dojo ships at /dojo as an additive route alongside the existing /quick-match. Working bot match flow is preserved through validation.
• Added bot opponent style picker before each Dojo session (Boxer / Grappler / Tank / Kicker / Counter Puncher, plus Random).

New Minigames (Four)

• ROKI Stare — press-and-hold no-blink contest with escalating bunny expression. NFT achievement: Iron Gaze (60-second hold).
• ROKI Dodge — top-down opposite-direction swipe to dodge incoming attacks. NFT achievement: Untouchable (90-second survival).
• ROKI Breath — inhale-hold / exhale-release rhythm meditation. NFT achievement: The Mountain (30-day daily streak).
• ROKI Train — IRL exercise daily habit tracker (50 push-ups / 50 squats in 60-second windows; tap or accelerometer). Daily boosts expire at 00:00 UTC. No anti-cheat by design. NFT streak achievements: Disciplined (30), Devoted (100), The Iron Heart (365).

New Side Product

• ROKI AR-Lite Photo Maker at roki.lol/ar. Web-based camera passthrough, bunny overlay with drag/pinch, photo or 5-second video, one-tap social share. Path A (composition-only, no surface tracking) ships in v3; Path B (native ARKit/ARCore) deferred.

New Internal Tool Documented

• ROKI NFT Generator (Part 18.5) — full web-based art generator with 7 layer categories, incompatibility matrix, z-order overrides, count-as-source-of-truth rarity, full-plus-transparent variant output, browse grid, per-NFT regen with sub-seeding, lock-and-reroll, live rarity ledger, staging/commit, manual character creation, Arweave export pipeline (Metaplex Core), AI lore CLI prototype, metadata validator. Stack: Node + TS + Express + sqlite + sharp (API), React + TS + Tailwind + Vite (web), monorepo via npm workspaces. Repackagable as a SaaS launchpad post-mint.

Launch Strategy Update

• Slotted the new products into phases: NFT Generator must be complete before Phase 6 (Mint); Zen/Dojo anchor Phase 7; Stare and Dodge ship between Phase 5 and Phase 6 as virality surfaces; Breath and Train ship around/after Phase 6-7 for retention; AR-Lite ships AT Phase 6 (Mint) as day-one organic marketing.

Halal Philosophy Clarification

• Added Section 22.2.1 clarifying the framework: real haram items (cigars, alcohol, gambling) are out; fictional/cultural depictions of other belief systems (priest, monk, wizard, dracula clothing) are acceptable; the distinction is practice/endorsement vs. representation. Consistent with prior individual cuts (cigars removed; tarot → Cards; paper talismans → Paper Seals).

Document Meta

• Version: 3.0; Supersedes: ROKI Everything v2 (2026-04-21); Date: 2026-04-22

#23.1 (Historical) Major Retirements from v1

• Background-color clan system — RETIRED. Replaced by style-based clans.
• Clan identity driven by color — RETIRED. Now driven by fighting style.

#23.2 (Historical) Major Changes from v1

• Clans now defined by fighting style
• Five clans: Red (Boxer), Blue (Tank), Green (Grappler), Purple (Counter Puncher), Yellow (Kicker)
• Copy Ninjas pink / Mirror Fighters orange, both outside clan system
• Mirror Fighters — mechanic originally clarified in v2 (pre-pick); refined in v3 (auto-mirror)
• Copy Ninja 6th slot for copying one opponent technique used earlier; one-time per match

#23.3 (Historical) New Systems Added in v2

• Player Tier Structure (Free, Paid, Paid+Token-Staker, NFT)
• ROKI Mushin (renamed Zen in v3) as reflex training
• ROKI Dojo with conditioning milestones
• Four-Pillar Cross-Game Reward System
• Still Mind and The Unyielding achievements
• ROKI Verse with AI-generated lore + trait-driven constraint
• Character Archetypes; Three-tier lore production
• Guided Lore Commissions; Holder-submitted Lore Events
• Clan War Narratives; Eras of Dominance
• Multi-leaderboard structure
• Three-bracket tournament system
• Token staking for Challenger Cup; NFT Promotion for top Free/Paid
• NFT Launchpad + Phase 2 SaaS
• AI Image Generator
• Full commercial IP rights for holders
• Launch strategy (9 phases)
• Path 1 → Path 3 metadata migration
• Creator fee structure

#23.4 Mechanical Refinements (Cumulative)

• Legendaries are NFT-exclusive
• Free tier: 300 HP, 3 slots, Commons only
• Paid tier: 400 HP, 5 slots, Commons + Rares
• Zen weekly top-10: +1/+2 damage or damage-taken bonus, weekly reset
• Dojo milestones: 25/75/150/250/500 sessions, +1 HP each, max +5, zone-selectable
• Still Mind: 3 Perfects in single run = +1 permanent damage to chosen zone
• Permanent bonuses additive, capped per pillar
• Mirror Fighter (v3): same-style auto-mirror, no pentagon advantage or disadvantage

#23.5 Rejected Ideas (Cumulative)

• Paid technique re-rolls (breaks NFT scarcity)
• Cosmetic technique skins (animation bottleneck)
• Zen/Dojo bonus conversions via token purchase (undermines skill philosophy)
• Play-to-earn rewards (dump pressure)
• Yield staking (hidden inflation)
• User-chosen NFT nicknames (moderation nightmare)
• Time-based Dojo rewards without caps
• Humiliating loser lore
• Mirror Fighter automatic mid-match style-copying (different from v3's automatic same-style mirror; rejected was a mid-match dynamic swap)

#23.6 Still Under Consideration

• The Reforging — full character re-roll, one-time, preserves Legacy
• Second NFT collection (Beasts/Familiars)
• Tournament entry fees in some halal-compliant form — pending sheikh consultation
• Exact token threshold for Challenger Cup staking ($50-100 range)
• Paid character price point ($20-50 range)
• Exact Guided Lore Commission cost (5,000-10,000 $ROKI)
• Specific airdrop allocation percentages
• Creator fee allocation split (~50/30/20 prize/dev/treasury)
• Fast-velocity Zen slicing variant (deferred, not v1 scope)
• Path B true-AR native app for AR-Lite photo maker (deferred)

#23.7 Retained from Prior Versions

• Simultaneous attack & defend combat mechanic
• Four-zone body system (Head, Body, Arms, Legs)
• HP visibility rules (self exact, opponent color-coded)
• Win conditions (KO or points decision at round 10)
• Match structure (10 rounds max, 12-second timer)
• All 110 techniques with existing handlers
• All 5 style damage profiles and special mechanics
• Style matchup pentagon advantages
• Copy Ninja 50-NFT elite mechanic
• Fighter Legacy concept and career tracking
• ELO system with K=32 and random upset factor
• Dynamic NFT three-phase structure
• Loadout formula
• UI/UX specification and visual design direction
• All VFX and animation timing rules
• AI opponent logic
• Tech stack fundamentals

# Closing Notes

This document represents the full state of ROKI design as of 2026-04-22. It supersedes the ROKI Everything v2 document (2026-04-21), which should be considered archived reference material.

Any design decisions made after this document should be appended as v3.x update notes or rolled into a future v4 document when significant.

Design philosophy takes precedence over specific mechanics. If a future decision seems to conflict with something in this document, the principles in Part 22 are the final arbiter — not the specific numbers or structures. Numbers can be tuned. Principles are fixed.

ROKI is an evolving franchise. The goal is a resilient, long-term ecosystem where games, minigames, lore, NFTs, and infrastructure reinforce one another. No single layer is the entire project. Each layer serves the whole.

— End of Document —