TRY THE GAME

Two random samurai — press DUEL to watch them fight

HOW TO PLAY

Three ways to fight — open queue, private challenge, and tournament

⚔️ Open Duel
  • !join Enter the queue
  • !join Second viewer joins — battle starts automatically
  • Win to earn EXP and level up your samurai

Requires 1 energy per match. Energy recharges each stream.

🎯 Private Challenge
  • !join @username Challenge a specific viewer
  • !accept Target must accept within 30 seconds
  • If the challenge is not accepted — it expires automatically

Both players spend 1 energy. Timeout is adjustable in widget settings.

🏆 Tournament
  • !tournament start 30 Broadcaster starts a 30-day tournament
  • Every duel win during the period counts as a Tournament Win
  • !tournament Anyone can view current standings
  • !tournament reset Broadcaster resets scores and ends the tournament

Tournament wins are tracked separately from total wins. Duration is in days.

🐾 Companion Pets
  • Pets unlock automatically at Lv.10
  • Your companion is determined by your username — always the same pet
  • Pet runs alongside you during the approach, then stands by in combat
  • Pet disappears when its owner is defeated

Accessories (back item / hat) are also assigned per player name. Can be toggled off in widget settings.

🤖 Test Mode
  • !test Fight a bot to practice or try your skills
  • Bot has no EXP or level — useful for testing at any time

Still costs 1 energy. Bot does not earn EXP on win.

📈 Progression
  • Win a duel → +1 EXP
  • Lv.1 → 10 via EXP thresholds (see level table)
  • Each level increases HP and unlocks new skill slots
  • !rank Shows the top-10 leaderboard

SKILL BOOK

Game for Chat

Level up your samurai and unlock powerful skills, pets, and new duel modes — all from Twitch chat.

Skills Slot 1 [Lv.1]
Duelist
DuelistATK

+1 Attack. Your samurai strikes harder.

Stronger
StrongerHP

+1 HP. Your samurai survives longer.

Resolve
ResolveDEF

20% chance to counter-attack after receiving damage.

Bleed
BleedDOT

Applies Bleed to opponent: -0.5 HP every turn.

Weakness
WeaknessHP

Increases your ATK by +0.5. Exploit the enemy's weakness.

Vampire
VampireDEF

20% chance to steal 1 HP from opponent each turn.

Skills Slot 2 [Lv.5]
Critical
CriticalATK

30% chance to deal ×2 damage on your next attack.

Second Life
Second LifeHP

Once per battle: survive a lethal hit with 1 HP remaining.

Blessed
BlessedDEF

30% chance to recover 1 HP per turn automatically.

Predator
PredatorDOT

30% chance to add 1 Poison layer on opponent. Each layer: -1 HP next turn.

Fear
FearHP

30% chance opponent misses their attack this turn.

Silence
SilenceDEF

Disables all 3 of the opponent's skill slots for 1 turn.

Skills Slot 3 [Lv.10]
Hummer
HummerATK

40% chance to Stun opponent — they skip their next turn.

Druid
DruidHP

25% chance to add 1 Recovery layer on yourself. Each layer: +0.5 HP per turn.

Purge
PurgeDEF

40% chance to cleanse your DOT effects and remove opponent's buffs.

Executioner
ExecutionerDOT

30% chance to add 1 Death layer on opponent. At 3 stacks — instant death.

Moon
MoonHP

20% chance: opponent loses -1 Max HP permanently this battle.

Curse
CurseDEF

40% chance to apply a random debuff on opponent OR a random buff on yourself.

STATUS LAYERS

Some skills apply stackable layers — icons shown above characters that affect each turn

Bleed
Bleed — Debuff / DOT

-0.5 HP to owner each turn

Poison
Poison — Debuff / DOT

Each stack: -1 HP next turn. Stackable.

Death
Death — Debuff / DOT

At 3 stacks — instant death. Max 3.

Recovery
Recovery — Buff

+0.5 HP to owner each turn. Stackable.

Stun
Stun — Debuff

Skip 1 turn (no attack). Max 1.

COMPANION PETS NEW v2.0

Unlock a companion at Lv.10 — they follow your samurai into every duel. Your pet is tied to your username, so it's always the same one.

🦊
Fox
Rare. A clever fox spirit that trails its master faithfully.
🐺
Wolf 01 – 05
Five wolf variants — grey, white, brown and more. The most common companions.
🎒
Back Item
Accessory — a small pack worn on the pet's back. Randomly assigned alongside your pet.
🎩
Hat
Accessory — a tiny hat perched on top. A stylish companion deserves a stylish look.

50% chance of no accessory · 25% back item · 25% hat. All determined deterministically from your Twitch username.

CHAT COMMANDS

!joinEnter the open duel queue
!join @userChallenge a specific viewer
!acceptAccept an incoming challenge
!testFight a bot (Player vs Bot)
!rankShow global leaderboard
!rollChange scene decor (mod/broadcaster)
!tournament start <days>Start a tournament (broadcaster)
!tournamentView tournament standings
!tournament resetReset tournament (broadcaster)
!hide gameHide the widget overlay (mod)
!show gameShow the widget overlay (mod)
!sdstatsShow player DB usage (mods/broadcaster)

Energy System

Streamer can configure the number of battles per day. Default is 5 energy that recharges while you're live. Energy can be disabled entirely in widget settings.

DEV LOG

What changed and when

2026 Apr
v2.2 — Expanded Player Database & Smart Auto-Cleanup
  • Player database now split across 8 storage keys — total capacity increased 4× (up to ~32 KB)
  • Legacy single-key saves auto-migrate on first load — no data lost for existing users
  • Auto-pruning when DB approaches limit: removes never-fought players first, then 0-win players inactive 60+ days
  • Players with wins are never pruned — progression is always safe
  • !sdstats command (mods/broadcaster) — shows live DB usage overlay for 8 seconds
2026 Mar
v2.0 — Companions, Challenges & Tournaments
  • Companion pets — unlock at Lv.10, deterministic per username, idle/run animation
  • Pet accessories — back item or hat randomly overlaid on companion sprite
  • Private challenge system — !join @username + !accept with configurable timeout
  • Tournament mode — broadcaster starts multi-day tournament, tracks wins separately
  • Tournament leaderboard shown via !tournament with days remaining
  • New widget settings: petsEnabled, acceptCommand, tournamentCommand, challengeTimeout
  • Obfuscated release build updated with all new features
2026 Feb
v1.0 — Initial Release
  • Turn-based samurai duel game for Twitch chat
  • 18 skills across 3 tiers, unlocking at Lv.1 / Lv.5 / Lv.10
  • Status layer system — Bleed, Poison, Death, Recovery, Stun
  • RPG progression — EXP, levels, HP scaling, ATK bonuses
  • Energy system — configurable daily limit per player
  • Decor system — seasonal terrain, trees, plants, camp/garden/tomb themes
  • Animated samurai sprite (8 color variants, 16 animations)
  • Leaderboard via !rank
  • StreamElements widget with full fieldData configuration

GET THE WIDGET