# Dojos โ€” full documentation # Overview Dojos is a shogun-themed incremental Web3 game on Solana. Recruit a champion shogun, keep them in service, duel rivals, summon yokai spirits, and claim your share of the war chest. - ๐Ÿ—ก Adopt your first shogun free, then unlock more looks - ๐Ÿ™ Dine with rations so your dojo stays active - ๐Ÿ›ž Spin the wheel (daily) for Honor - ๐Ÿ’ช Attack & Defense โ€” baseline 10/10; grow via training, yokai bonds, and ascension - โš”๏ธ Duel other players on a cooldown - ๐Ÿ‘พ Summon yokai spirits (Catch'em all) to bond collection rows - ๐Ÿ’Ž Earn and swap Amethyst (player treasure share) - ๐Ÿ“œ Complete Quests for Bushido Points and bonuses - ๐ŸŽ Claim tribute from the SOL war chest ## How it works Your dojo holds a roster of shoguns. Pick an active shogun from Account for duels, quests, and tribute. Each shogun has its own Honor, Attack, Defense, health, and cooldowns. Honor on your active shogun sets your share when you claim tribute. Bottom nav: Quests, Battle, Forge, Barracks, and Account. Forge is the main home screen. Barracks is the training and activities hub. Open Swap from the SOL rewards bar on Forge or Account for Buy DOJO, Amethyst swap/LP, and tribute rewards. ## Quickstart ### Install & connect Open play.dojos.fun. Connect Phantom, Solflare, Backpack, or another Solana wallet. On mobile, use Add to Home Screen or your wallet's in-app browser. - Optional: create a session for fewer wallet prompts while playing - Tap Recruit Shogun on the connect screen โ€” free first adopt (creates dojo + starter shogun) - Walkthrough on Forge covers recruit and basics after your first session ### First session checklist - Forge โ€” Dine your shogun so health is active (ration bar under the forge); Upgrade Shogun to stake $DOJO - Spin the wheel from the floating button or Barracks - Quests โ€” claim daily Bushido Points and other task rewards - Barracks โ€” yokai gacha, loot boxes, shop shortcut, Player's Treasury - Battle โ€” pick champion look, duel rivals when cooldown allows - Account โ€” roster dropdown, paid recruit, and settle fallen when needed - Swap (Forge SOL bar) โ€” buy $DOJO, Amethyst swap/LP, claim war chest tribute ### Referrals Share your referral link from the Invite button on Forge. Friends' in-game $DOJO spends pay you referral rewards instantly. Pass purchases can pay SOL commission to referrers. Redeem a friend's code before your free recruit if you were invited. > **Note:** Dojos is entertainment on Solana, not an investment. $DOJO and in-game currencies can fluctuate. Check local laws before playing. --- # Gameplay Core loop on Solana: recruit, dine, spin the daily wheel, train, duel, yokai summons, and claim tribute โ€” all with dojo theming and on-chain actions. ## ๐Ÿ—ก Recruit your shogun Your first shogun is free. After connecting a wallet, tap Recruit Shogun on the connect screen. That runs recruit_shogun on-chain โ€” one dojo per wallet, starter N shogun, 0 Honor, 10 Attack / 10 Defense, and 3 days of health. Use a friend's ?ref= link before recruiting if you were invited. ### Unlock more shogun looks - Paid recruit โ€” Account: additional shogun roster slots; cosmetic looks also unlock from yokai bonds and collection claims - Yokai Spirit Gacha โ€” summon from Collect 'Em All with $DOJO to bond catalog rows (+ essence at max bond) - Ascension โ€” prestige SSR/UR champions from Barracks for higher duel ATK/DEF - Switch shogun โ€” set which roster character is active (each shogun keeps its own stats and progress) Each shogun has its own Honor, Attack, Defense, and health. Pick your active shogun from Account to play, duel, and quest. Additional roster slots are available via paid recruit from Account. You can also buy shoguns from other players on the Battle marketplace. ## ๐Ÿ™ Rations & health - Health lasts 3 days after each dine โ€” not stackable - Dine shogun: spend 1 ration from inventory - Earn +1 ration every 10 duels you initiate - Passive ration trickle while health is active - No ration? Buy provisions - Health expired โ†’ 7-day seclusion; Rally to return early - Ignore seclusion too long โ†’ Fallen (settle to recover tribute and stake) ## ๐Ÿ›ž Spin the wheel Once per day, spin the wheel for Honor on the free ladder or the premium ladder (stakers and pass holders). Available from the floating button or Barracks. ## ๐Ÿ’ช Training - Training Camp โ€” drill tiers unlocked by PvP wins; +1 ATK or DEF per completed drill - Gacha pull โ€” spend Honor technique tiers for +ATK/DEF rolls - Loot Box (Mystery Scroll) โ€” paid open or free scroll from pass; chance for +ATK/DEF; daily open limit ## ๐Ÿ’ช Attack & Defense - Baseline after recruit: 10 Attack, 10 Defense - Yokai bonds, Training Camp, gacha pull, and loot boxes raise ATK/DEF - Ascension โ€” prestige SSR/UR champions for higher duel ATK/DEF (~6% per star) - Duel win chance: your Attack รท (your Attack + their Defense) Claiming SOL tribute for your active shogun resets that shogun's Honor and combat stats to 10 / 10. Redeeming tribute as $DOJO (Swap โ†’ Rewards) keeps Honor but still clears accrued war-chest accounting. Ration inventory is shared at the dojo level. ## ๐Ÿ‘พ Yokai Spirit Gacha (Catch'em all) Open Barracks โ†’ Collect 'Em All! (or summon from the collection modal) to pull yokai spirits โ€” Dojos' Catch'em-all loop. There are no PvP win gates or Honor thresholds: summon whenever you have $DOJO or your daily free pull. 57 unique shogun looks live in the flat binder catalog. Each slot tracks a bond level from 0 to 5 on your on-chain Spirit Codex. A summon rolls element and rarity, then maps to your wallet's variant slot in that row. ### Summon costs - ร—1 paid โ€” 100 $DOJO - ร—10 paid โ€” 900 $DOJO - Free ร—1 โ€” once per calendar day per active shogun ### Bond levels - First bond (0 โ†’ 1) โ€” unlocks that binder row and wardrobe look in Collect; that spirit becomes your equipped yokai for duel bonuses - Levels 2โ€“5 โ€” strengthen equipped-spirit Attack and Defense in PvP (linear scale up to the rarity cap below) - Level 5+ duplicates โ€” bond stays at 5; you earn +1 essence per dupe (merge / ascension fodder) ### Essence at bond Lv5+ - Each max-bond dupe adds +1 essence on that spirit's codex row โ€” no Bushido or Amethyst payout ### Equipped spirit & duels Your most recently bonded (non-maxed) spirit sets equipped bonuses on your battle account. They add to your shogun's Attack and Defense in duel win chance: your ATK รท (your ATK + their DEF). Switching roster shoguns reloads bonuses from that shogun's codex. - N at Lv5 โ€” up to +1 ATK / +1 DEF - R at Lv5 โ€” up to +2 ATK / +2 DEF - SR at Lv5 โ€” up to +3 ATK / +3 DEF - SSR at Lv5 โ€” up to +4 ATK / +4 DEF - UR at Lv5 โ€” up to +5 ATK / +5 DEF - Global cap โ€” +6 ATK and +6 DEF maximum from equipped spirit ### Spirit Merge Barracks โ†’ Spirit Merge rerolls your active champion's look using stocked essence from max-bonded N/R/SR spirits. Merge is essence-only โ€” no $DOJO cost and no Bushido/Amethyst payout. - Each Lv5+ dupe grants +1 essence on that spirit's codex row - Merge cost by tier โ€” N: 10 essence, R: 5, SR: 3 (any mix of max-bond spirits at that tier) - Quick Add โ€” auto-fills slots and sends the merge when you have enough essence - Result โ€” random new champion look (N/R/SR/SSR/UR roll); equipped spirit ATK/DEF sync to the new look's bond ### Ascension Barracks โ†’ Ascension prestiges your SSR or UR champion. Burn matching-rarity essence dupes from a max-bond codex row plus $DOJO to raise prestige stars and scale duel Attack and Defense. - SSR champions cap at prestige 5; UR champions cap at prestige 6 - Each step scales ATK/DEF by ~6% compound (gentle PvP curve vs lower ranks) - Essence cost per step โ€” 1โ†’2: 1 dupe, 2โ†’3: 2, 3โ†’4: 4, 4โ†’5: 6, 5โ†’6: 8 (from your champion's codex row) - $DOJO cost โ€” SSR: 500 ร— dupe-equivalent step; UR: 1,500 ร— dupe-equivalent step (e.g. first SSR step = 500 $DOJO) - Champion must match the codex row rarity you burn (SSR row for SSR champion, etc.) ## ๐Ÿ’ค Seclusion & Fallen When health expires, your shogun enters seclusion for 7 days. Rally to return early. If seclusion ends without rally, the dojo becomes Fallen โ€” tribute and stake can be settled (or slayed by others for stars on Battle). ## โญ Stars Slaying a Fallen dojo earns a star trophy. Toggle Collect stars on the Battle tab to find fallen dojos. Stars are cosmetic trophies for now. ## ๐ŸŽฒ Dice Shared dice room on Barracks: pay $DOJO to join a round with up to five other players. Join order sets your die face; when the room fills, one winner claims the pot. ## โš™๏ธ Forge (main screen) Forge nav is your home screen: champion on the forge (tap to rename), ration bar with Dine, Collect binder (Honor + Bushido for filled rows), Flash Sale (monthly pass), Invite, Upgrade Shogun (stake $DOJO), and the SOL tribute bar (opens Swap โ†’ Rewards). Top HUD shows Honor and wallet $DOJO balance (shard pill). Barracks is the activities hub. --- # Player vs Player On-chain duels between your active shogun and a specific shogun on another player's dojo. ## How a duel works - Pick your active shogun from Account (roster dropdown) - Attacker must be Active (health not expired) - Choose a defender from the Battle leaderboard โ€” each row is one shogun - Win chance: your Attack รท (your Attack + their Defense) - Wins earn Honor and progress duel-win quests - Every 10 duels you initiate earns +1 ration ## Limits - 30-minute cooldown between initiating duels per shogun (10 min with pass) - Defender immunity window after that shogun was targeted - 32 duel initiations per 24 hours per shogun - Cannot initiate while your active shogun is in seclusion โ€” others can still attack you - Shield shop item blocks honor loss while active ## Honor steal - Premium attacker (stake or pass): higher Honor transfer cap - Free attacker: lower Honor transfer cap - Defender in seclusion: increased loss cap when attacked ## Leaderboard Battle tab Leaderboard ranks shoguns by Honor. Tap a row to duel that shogun โ€” you always attack with your active shogun. --- # Amethyst Amethyst is Dojos' on-chain in-game share of the Player's Treasury โ€” tied to the same Honor and progression loop as duels, the wheel, and spirit bonds. A total of 1,000,000,000 Amethyst will ever exist. Your balance lives on your dojo account (not an SPL token). Amethyst tracks your stake in the growing $DOJO pool that backs the treasure. Buy via Swap or earn LP fees โ€” spirit dupes grant essence only, not Amethyst. ## Earn Amethyst Players can earn Amethyst in two ways: - Swapping $DOJO for it on the Amethyst Swap tab - Duplicate yokai pulls at bond Lv5+ (see Gameplay โ†’ Yokai) ## Player's Treasury Some in-game actions add $DOJO to the Player's Treasury (Amethyst pool vault). Amethyst represents your share of that treasure. Shop, dice, gacha, marketplace, and other $DOJO sinks grow the backing pool over time. View pool stats from Barracks โ†’ Player's Treasury or the Swap screen. ## Amethyst liquidity providers Due to the mechanics of Amethyst you can also liquidity provide (LP) your $DOJO. LPs earn swap fees and Amethyst sold back into the pool. Because the entirety of the Amethyst supply is backed by an ever-growing $DOJO treasury, you are always expected to have more $DOJO value when you stop LPing. Swap fees on $DOJO โ†” Amethyst trades go to LPs. - Provide $DOJO only (single-sided LP) โ€” no Amethyst deposit required - Positions are NFT-backed and transferable (create position, then deposit) - Claim accrued $DOJO fees without removing liquidity ## Swap screen Open Swap from the SOL tribute bar on Forge or from Account. Tabs: - Buy DOJO โ€” Jupiter link (SOL โ†’ $DOJO) - Amethyst Swap โ€” $DOJO โ†” Amethyst - Amethyst LP โ€” deposit $DOJO liquidity, withdraw, claim fees - Rewards โ€” SOL war chest tribute (see $DOJO & Economy) --- # Quests Bushido Points and task cards on the Quest nav โ€” daily and milestone objectives tied to live gameplay. ## Quest board Shows your champion, Bushido Points total, and scrollable task cards. Tasks mirror live gameplay: daily login, spin the wheel, gacha pull, duel wins, spirit bond progress, collection claims, and recruit milestones. ## Rewards - Bushido Points โ€” daily quest, duel milestones, collection claims - Honor (HUD XP) โ€” spirit gacha, spin the wheel, gacha pull, collection binder rows - Amethyst โ€” buy on Swap or earn LP fees (not from spirit dupes) ## Collection milestones Collect 'Em All tracks binder progress across all 57 catalog slots. Fill rows to claim Honor and Bushido from the Collect modal; yokai bonds unlock variant looks the same way. --- # Barracks Barracks is the hub screen โ€” shortcuts to wheel spins, yokai gacha, training, shop, treasury, and dice. ## Barracks cards - Spin the Wheel โ€” daily fortune wheel (same as the floating button) - Gacha Pull โ€” Honor technique tiers for +ATK/DEF - Collect 'Em All! โ€” binder catalog progress + yokai summons (free daily, ร—1, or ร—10) - Spirit Merge โ€” free essence reroll for champion look (N/R/SR tiers) - Ascension โ€” prestige SSR/UR champion with $DOJO + essence for higher ATK/DEF - Training Camp โ€” drill, gacha pull, and mystery scrolls for ATK/DEF - Loot Box โ€” mystery scroll (+ATK/DEF RNG); pass includes free opens - Shop โ€” bonding-curve items - Player's Treasury โ€” Amethyst pool stats and player treasure modal - Dice Game โ€” shared room ($DOJO entry, multiplayer per round) - Marketplace โ€” on Battle tab: list or buy shoguns ## Monthly pass (not Loot Box) The 30-day premium pass is sold from Flash Sale on Forge, not from the Barracks Loot Box card. Pass perks: shorter duel cooldown, bonus Honor on duel wins, premium gacha and spin ladders, and free loot box scroll pulls. --- # Free, Stake & Pass Free play, stake-to-play bonuses, and an optional monthly pass โ€” each tier unlocks different perks. ## Free to play - Full core loop without paying: recruit, dine, duel, spirit gacha, quests - 30-minute duel cooldown between attacks - Lower Honor transfer on duel wins (higher with stake or pass) - Spin the wheel on the free Honor ladder ## Stake to play (S2P) Stake from Forge โ†’ Upgrade Shogun, tied to your active shogun. Each shogun has its own stake vault. Pick a tier (10 / 30 / 100 / 400 / 1000 $DOJO), withdraw unlocked $DOJO later. Each commit extends health by +3 days (adds on remaining time) and unlocks premium perks for 3 days. Only one active stake per shogun โ€” withdraw fully before committing a new tier. - Higher Honor transfer on duel wins - Premium spin-the-wheel ladder - Honor accrues from staked balance while active - Deposits vest linearly over 30 days; withdraw unlocked portions anytime - A new commit after a full withdraw starts a fresh 30-day vest on that deposit - Forge HUD shard pill shows wallet $DOJO only โ€” not staked balance ## Monthly pass Buy the 30-day pass from Flash Sale on Forge. Pass perks stack with stake bonuses while both are active. - 10-minute duel cooldown (instead of 30) - Bonus Honor on duel wins vs free attackers - Premium spin-the-wheel ladder - Free Loot Box (mystery scroll) opens included with each pass --- # $DOJO & Economy $DOJO is the game token on Solana (Pump.fun). Used for staking, shop, dice, marketplace trades, and Amethyst swaps. ## $DOJO sinks - Commit stake per shogun (30-day vest) - Shop โ€” bonding-curve items - Dice room โ€” multiplayer $DOJO entry per round - Yokai summons and ascension - Training โ€” gacha pull and other $DOJO training sinks - Amethyst swap โ€” trade $DOJO for Amethyst - Marketplace โ€” buy listed shoguns from other players Many $DOJO sinks fund the Amethyst player-treasure pool (see Amethyst docs). Referred players' in-game $DOJO spends can pay referral rewards to their inviter. ## War chest & SOL tribute Trading fees on $DOJO (Pump.fun creator rewards) and a share of SOL in-app purchases flow into the player war chest โ€” the on-chain analogue of Fren's ETH rewards pool. Honor on your active shogun (HUD XP) weights your share of that SOL pool when you claim tribute. Claim SOL or redeem as $DOJO from Swap โ†’ Rewards โ€” claiming SOL resets the claiming shogun's Honor and combat stats. Redeeming as $DOJO keeps Honor. Collection binder and quest Honor do not reset until you claim SOL tribute. ## Marketplace Battle tab โ†’ Marketplace: list a roster shogun for $DOJO or buy listed shoguns from other players. You cannot list your only shogun or your currently active shogun. Sales pay the seller in $DOJO. ## Shop Shop scene (Barracks shortcut): buy and sell in-game items on a bonding curve โ€” e.g. Shield and Insurance style buffs. --- # FAQ ## Wallets & access Phantom, Solflare, and Backpack work well. Mobile: wallet in-app browser or home-screen install. First recruit is free โ€” keep a small SOL balance for fees or create a session on connect. ## Care & combat Loop: Recruit โ†’ dine (rations) โ†’ spin the wheel โ†’ gacha pull โ†’ duel โ†’ summon yokai โ†’ claim tribute. Dine refreshes health to 3 days; staking extends health by +3 days on top of remaining time. Unlock looks via yokai bonds, collection claims, or paid additional shogun recruit from Account. Switching looks in Collect is cosmetic. ## Honor, Amethyst & tribute Honor (HUD XP) weights your SOL war chest tribute claim โ€” like Fren points for ETH rewards. Amethyst is your share of the Player's Treasury in $DOJO (see Amethyst doc): buy via swap, LP with $DOJO for fees. Claiming SOL tribute resets Honor and stats on that shogun; redeeming as $DOJO keeps Honor. ## Staking Stake and withdraw from Forge โ†’ Upgrade Shogun โ€” staking is per shogun (switch active shogun to manage each vault). Pick a tier: 10 / 30 / 100 / 400 / 1000 $DOJO. The Forge HUD shard shows wallet $DOJO, not staked balance. Staked $DOJO vests linearly over 30 days; withdraw unlocks as time passes. Withdraw fully before staking again. ## Loot Box vs pass Loot Box on Barracks is the mystery scroll for +ATK/DEF RNG โ€” not the monthly pass. The pass is Flash Sale on Forge and includes free scroll opens. ## Transactions Each on-chain action needs a wallet signature (or an active session). If a tx seems stuck, wait for confirmation then refresh once. Support: Discord with wallet address and transaction signature. ## Disclaimer Dojos is a game, not financial advice. Token prices can change sharply. Playing may be restricted in some regions.