⚔️ AURVANIA
GAME DOCS

🪶 The Roost — evolving pets. Feed two of the same pet, both raised to Lv3, and they become one creature of the next species: its own name, its own look, its own stat line. Eight chains, three forms each — Dogey → Alpha Dogey → Dogey Ascendant, Shieldy → Bulwark → Cold Aegis, and so on. The two you feed in are gone for good, relics and all, so nothing is duplicated. Base → stage 1 costs 5,000 gems; stage 1 → stage 2 costs 15,000 gems and 5,000 AUR. The newcomer starts at Lv0, and shine passes on only when both parents had it.

🪶 Perches. One pet follows you to begin with. Reaching stage 1 opens a second perch and stage 2 a third, so evolution is what buys the right to field more than one companion — every perched pet contributes, passives stack and each rolls its own proc. Total dodge is capped at 60%, because three pets stacking it would stop being a build and start being an off switch. No egg ever hatches an evolved form; the Roost is the only way they exist.

📖 The Collection tracks every form, not every name. It used to hold one tick per item — so crafting your way to a Radiant or rolling a ✨ shiny left no mark on the one screen built for chasing. Now the unit is a variation: craftable gear has ten forms (five grades × plain and shiny), a consumable or a pet has two. Every card carries a strip of pips, one per form, lit in that grade's own colour, and the card's art glows at the best grade you own — tap it for the full list with counts. The screen is split into sections too: Weapons · Offhand · Armour · Trinkets · Consumables, then pets as Hatchlings · Evolved · Ascended. Counts are variations, so Weapons reads x / 70. Anything you already own is picked up automatically the first time you open it — nothing is lost from before.

🪙 AUR is in the dungeon now. The token turns up as a cache — a gold coin lying on the floor of delves and the Tower, picked up like any other loot. What a cache is worth is settled at the surface, so the delve report is where the number appears, not the pickup.

A cache is a container, not a coin worth 1. It holds what the difficulty you found it at is worth: 1 on Normal and Hard, 2 on Expert and Nightmare, 3 on Abyss, 4 in the Maw, 2 in the Tower. So one cache on an Expert delve pays 2 — the report names the rate so you can check it. Some caches also come up empty as the day's rewards thin out, and the report says how many did.

There is a limit of 1,000 AUR a day per adventurer, so nobody can run away with it. If the day's rewards are already spent, the report says so plainly and caches pay again tomorrow.

🧾 Where your AUR goes. Straight to your wallet — every reward sends itself on-chain the moment you earn it, the same way a relic mints itself. Nothing to claim, no button to find. The AUR figure in the header is your wallet's own balance, so it moves when the transfer lands: a second or two after the delve report, not the same instant. If the chain is busy the reward waits safely in your name and retries by itself — you will see it in the Home Dungeon as on its way, with a Send now button if you would rather not wait. 🧾 Receipts has a AUR tab: what you have earned and spent all time, what has been delivered, and a dated statement of every movement.

💰 One pool pays for everything. Every AUR the game gives away — caches, prizes, bounties, the Daily Delve crown, referrals — comes from a reserved pool of 10,000,000 — 1% of the 1,000,000,000 supply, with the other 99% held in surplus. Each day the pool releases what is left ÷ 1095, three years of days, so it always projects three more years from wherever it stands: it tapers rather than running dry. That is 9,132 AUR a day to start, under a 1,000 a day ceiling per player. Everything you spend in AUR — vendor gear (200–2,000), the Amethyst and Radiant craft fees (2,500 / 10,000), the Roost's stage-2 fee (5,000), the market's 10% tax — flows straight back in, so an active game pays for its own rewards. You can see the pool, today's allowance and your own daily total on the Events screen.

KOIN is no longer a game currency. Prizes, the marketplace, the Loot Room and gem bundles all pay AUR now — one currency to reason about instead of two. KOIN still exists on the chain and still pays the mana every transaction costs, but the game wallet covers that for you on every transfer you sign, so KOIN has been taken out of the header, the wallet and the Send screen entirely. Prizes won before the switch convert across rather than disappearing.

✨ Crafted grades glow. An Emerald, Sapphire, Amethyst or Radiant item now wears its colour everywhere you meet it — the bag, the equip picker, the Forge, the Vendor and the Market, not just at the Weaponsmith that made it. Shinies get a cold white halo of their own. And because a grade multiplies an item's stats by up to 2.2× while forge levels add a few flat points, a grade now outranks a level when the game decides which of your copies fronts a list — or which one you fight with when you have not pinned a specific copy. If you own a Radiant Lv0 and a plain Lv3, you now carry the Radiant.

💎 Loot lies on the floor as itself. The dungeon no longer scatters anonymous crates you walk into to find out what they held. A hoard of gems looks like gems; a sword on the ground is that sword, drawn in its own art, and picking either one up tells you exactly what you got — Picked up 30 gems, Picked up Blood Blade — with the name flashing where you are standing. Loot you have already seen stays drawn on the map after you walk away, so you can go back for it.

🖼️ Every item has its face back. All thirty items now carry the artwork the original game drew for them — recovered from its own icon sheet — and they show up everywhere the game names an item: your bag, the Forge, the Weaponsmith, the Vendor, the Market, the equip slots, the delve report and the Dungeon-o-pedia. Gear lying on the dungeon floor draws itself too, so a helm looks like a helm before you walk over it, with a slow shine ring underneath to catch your eye.

💥 Your gear announces itself. When a proc fires it no longer whispers into the combat log — it lands across the fight in big letters. EMPOWER and CRUSADING DEFENSE in green when something good happens to you; MAJOR WEAKEN ENCHANTMENT, PANIC ENSUES and FREEZE in violet when it happens to them; orange when a monster does it to you. Damage, heals and rupees float in the same hard-edged style and stack rather than piling on top of each other, so a turn that lands a crit, a lifesteal and two procs is still readable at a glance.

🛠️ The Crafting Hall is one bench with four tabs — Weapons · Armour · Trinkets · Pets. Tap what you want to craft and everything that cannot join it goes dim, so the choice is made by looking rather than by reading each card to work out why its button is missing. Pets sit on the same bench because evolving is the same verb: two of a kind, both fully raised, consumed for one better one.

⏫ Two copies make the next grade — four make the one after. The second pair climbs the same ladder and the two results meet, so the bench offers ×2 / ×4 / ×8 and names the grade each one lands on. A ×4 craft is three crafts settled in a single press, and it is billed as three: the tray shows the ladder's whole cost before you commit, never one rung's. Eight climbs three grades. The relics are burned in one signature however many go in.

🛠️ Crafting an equipped item. A copy you are wearing counts. The smith always reaches for spares first — and for your plainest copies before your enchanted or shiny ones — but when the batch has to include the one in your hand, the tray says so before you press Create. Since the result is the same item, the slot usually just falls through to wearing the newly crafted one.

AUR is the game's holder token — a real KCS token on Koinos with a fixed 1,000,000,000 supply minted once at deployment (see On-chain reference). The game is wallet-native: what your account holds on-chain IS your balance.

• Max supply: 1,000,000,000 AUR.
• Earned, never sold: the game does not sell AUR. You earn it — dungeon rewards, NFT market proceeds, Expedition Pass claims, daily holder rewards and referrals — or you buy it from other holders on KoinDX once liquidity is listed.
• What it buys: vendor gear is priced in AUR, and the higher crafting grades ask for it alongside gems.
• Trade tax rewards: the 10% tax on every AUR market sale lands in the treasury and is redistributed daily to all holders pro-rata, as AUR, through the owed queue. The token contract carries its own DEX tax too, so trades on registered pools feed holders the same way. Plain wallet-to-wallet transfers are untaxed.
• Passive rupees: rupees/day per 10,000 AUR held, claimable in the Home Dungeon (blocked while you hold + rupees — a classic anti-hoard rule).
• Wallet-native: there is no in-game token ledger. Earned tokens are delivered on-chain straight to your wallet when you claim them, and holder tiers, drop gates, pity, guarantees and event entry all read the balance your verified wallet holds on-chain.
• Verified by construction: sign-in is a wallet signature, so the wallet counted for tiers, drops and Loot Room shares is cryptographically yours — nobody can borrow a whale's address.
• Owed queue: earned tokens (Expedition claims, market proceeds) wait in the Home Dungeon until you claim them — one on-chain payment to your wallet.
• Deflation: the NFT Market's 10% tax on AUR-priced sales is burned — sent to the issuer account, out of circulation forever.

The Loot Room shares the game's revenue back with its holders — paid in AUR, split by what your account holds:

• 9% of every purchase in the game flows into the day's pot, plus half the 10% tax on every market sale.
• The 10% AUR market-sale tax is a second reward stream: settled daily pro-rata by holdings, paid in AUR via your owed tokens.
• Once per UTC day the pot is split pro-rata by the AUR each verified wallet holds on-chain at snapshot time. No verified holders that day? The pot rolls into the next.
• Claim from the Home Dungeon: your share is priced into AUR at 100 AUR a pot unit and lands in your owed tokens, so it reaches your wallet on your next claim. Minimum payout 10 AUR (dust guard).

Signed in with Pi? The shop prices everything in Pi instead: 10 π / 30 π / 50 π for the gem packs and 100 π for the Expedition Pass. Tap a box and confirm in your Pi wallet — the game verifies every payment with Pi before anything is granted, and an interrupted payment is finished the next time you open the game rather than lost. Every other login uses the card checkout below.

The Shop sells gems and the Expedition Pass for real money — card or PayPal. Tap any product box and its checkout opens; the price is set by the server and verified against PayPal's own response before anything is granted, so no card details ever touch the game. Every purchase is kept under 🧾 My receipts. AUR is not sold here — you earn it in the dungeon.

🎫 Expedition Pass ($9.99) — the game's daily-claim engine:

• Claim once per day in the Home Dungeon after a dungeon run within the last 3 days. Days don't stack — miss a day and it's gone.
• First 20 days: +500 AUR/day recoup (10,000 AUR over the window).
• Every claim: +10 AUR per NFT point (1 point per item owned + 0.5 per enhance level, max 90 points).
• 5% chance per claim of an exclusive item drop.

🏆 Weekend Leaderboard — every week, Friday 14:00 UTC → Sunday 14:00 UTC, and only then: a Hard or Expert win on a Tuesday counts for nothing. Best victorious Hard/Expert score enters (floors × 1000 + rupees), and the window is now the only requirement — the board is open to every adventurer, with no AUR holding needed. A win that lands outside the window says so in the delve report rather than quietly vanishing. The top 25 split 10,000 AUR, claimed to your wallet.

👑 World Boss — the last 3 days of every month. Requires 500+ AUR. There is no victory — deal as much damage as you can before you fall; your best attempt counts and no rupees are earned in the arena. Winners (1,000 AUR each) scale with the community's total damage: 7 ranked + 3 lucky under 30k damage · 10 + 5 at 30k+ · 25 + 5 at 100k+.

⚡ First-Clear races — limited windows where the first 3 adventurers to a feat (e.g. an Expert delve victory) split 6,000 AUR and take a limited item that never drops again. Unlike the Weekend Leaderboard, this race does ask you to hold AUR — the prize is unique and never returns. The card says so, and tells you whether you currently qualify.

📅 The Daily Delve — one seeded run per day: every adventurer fights the same dungeon (identical rooms, monsters and loot), difficulty rotating Normal → Hard → Expert with the date (UTC). One scored attempt — death, flight or victory files your result. Scoring: depth first, then speed, then loot. Yesterday's podium is paid automatically at the day's first visit, and the champion is owed AUR on top. Boards keep two weeks of history.

📜 The Bounty Board — 3 daily and 3 weekly quests, the same set for everyone (drawn from the pools below by the date). Progress is validated server-side from your submitted runs; rewards are claimed on the Daily screen.

🧭 Expeditions — send a benched hero and up to two idle pets on timed trips (). Rewards on return: gems, gear rolls, Tower Crystal chances — +% per pet forge level in the party. % of trips sour and pay half the floor (never a loss). Your active adventurer and active pet stay at your side; three parties at once.

🏟️ Pet Arena — crown one of your pets as champion (a snapshot) and fight other players' champions in a server-simulated best-of-5 dice exchange: pet level, rarity and ✨ shine sharpen every roll. Entry , a win pays , an Elo ladder ranks the kennels, and the gates close after bouts a day. No opponents yet? The Kennel Master's Shade always accepts.

🔥 The Keep Torch — relight it once a day (on the Daily screen) for gems and a growing streak. Milestones: . Past day 30, every 7th day grants another item roll. Miss a day and the flame dies — one ember per month can bridge a single gap.

🌕 Omens — a delve or tower run may carry ONE omen that bends the rules for the whole run (announced at the gate). Rolled from the run's dice, so the seeded Daily Delve shares its omen with every adventurer that day.

⛩️ Shrine boons — shrines now offer a pick-one-of-three draft of run-long blessings that stack with your gear and vanish when the run ends. Choose a build as you crawl:

🛡️ Gearing up is two steps. Adventurers lists who you have; tapping one opens their sheet — portrait and live stats on top, the seven slots below, and tapping a slot opens the picker inline underneath with everything that does not fit that slot dimmed. Before this the slots sat under the roster and quietly belonged to whichever hero was selected, which reads fine on a desk and not at all on a phone, where the two are never on screen together.

✨ Shiny variants — roughly % of dungeon finds (gear drops and pet eggs) roll shiny: a prismatic variant with its own Collection checkmark, + luck while equipped, and a Shiny attribute when minted as an NFT. Shine needs every copy in the batch, not a majority — four shinies forge a shiny two grades up, the deepest chase in the game.

🧩 Gear sets — wear every piece of a set and its bonus activates on top of the items' own stats (shown live on the Adventurers screen):

☠️ Monster Hunts — every kill is tallied per monster, forever (merge-protected like the Collection). Milestones earn a title shown in the Dungeon-o-pedia and a permanent damage bonus against that monster: .

👻 Dice Duel (Knucklebones) — the Gambler Ghost deals the Keep's own table game. Two 3×3 boards; take turns rolling a d6 and placing it in one of your columns. Matching values in a column multiply (two ⚃ score 16, three ⚃ score 36), and placing a value destroys the ghost's matching dice in that column. First full board ends it — higher total takes the pot. Stake gems from the menu (winner takes double; net winnings capped per day, and the ghost only plays settled duels a day), or meet him in the dungeon where he wagers part of your run's haul.

• The game's P2P marketplace: sell your gear drops to other adventurers for AUR — enchant levels, affixes and the item's NFT itself travel with it. Trades are contract-settled: listing escrows the relic into the marketplace contract, and a buy pays the seller (90%), takes the 10% tax and hands over the relic in one atomic on-chain transaction the game server cannot alter. Sellers are paid straight to their account — no claim step. The sale tax feeds the daily holder rewards.
• Sell rupee bundles for AUR (1,000–100,000 per bundle) — a direct way to cash out RUPEE.
• Every sale pays the market's 10% tax, and it is redistributed daily to holders.
• Listings escrow the goods server-side (no duping), max 8 at once. A purchase locks the listing for 10 minutes so cancels and rival buyers can't race the payment.
• AUR proceeds are sent to the seller's wallet automatically, like every other reward.

Any gear or pet — dropped, bought from the vendor, crafted or won — mints automatically as a real NFT in the Adventurer Relics collection on Koinos the moment you own it (consumables excepted). The game pays the mana; you sign nothing.

• Each relic is a unique token (game name CRSDITM#### / CRSDPET####, token id = the code) minted straight to your Koinos address. Metadata — kind, relic, level, grade, shine, affixes — is written on the token itself at mint, so wallets and marketplaces render it out of the box and the collection outlives any server.
• Every copy is its own item. Own three of the same blade? Each copy carries its own enhancement level, grade and affixes — forge, equip, sell or list them individually; each is its own token.
• The chain is the owner registry: sell a relic on any Koinos NFT market (or send it wallet-to-wallet) and the game moves the item to its new holder's account on the next sync. Buy one outside the game and it appears in your satchel.
• 📤 Send anything, in-game: Town → Send transfers AUR or any of your relic NFTs to any Koinos address, straight from your in-game wallet — the game pays the mana, and every transfer links to its transaction on koinosblocks.
• Levels live off-chain: the game stores each relic's mutable level/affix data and mirrors it into the token metadata — forge and enchant as normal, no deposit-back dance, and the level-up shows on every marketplace.
• One approval, once: the first time you trade, the game asks for a single set_approval_for_all signature (free, mana paid by the game, revocable on-chain any time). It lets the game move the matching tokens when YOU list, sell or craft-consume an item — that is what keeps the chain and your satchel in lockstep.
• Trust model, honestly: the game's dev wallet owns the collection (mint authority) and is the market escrow; the contract enforces unique token ids. Full details in the repo's docs/NFT.md.
• 🏺 Held an original Adventurers of Crypto NFT? Town → Legacy Claim connects your BNB Smart Chain wallet, you sign one message to prove it is yours, and the matching relic mints to your Koinos wallet. The signature is free — a message, not a transaction, so there is no gas and no approval, and your old NFT never leaves your wallet. Each old token can be claimed once, by whoever claims it first. The card only appears once the collection is switched on.

• Asynchronous PvP. Everyone plays both roles: as Dungeon Master you configure a dungeon (normal monsters, auxiliaries, a boss) that other players raid; as Adventurer you raid theirs. Matches have a 10-minute limit.
• Dual TrueSkill leaderboards — separate Adventurer and Dungeon Master ratings (Microsoft defaults). 5 games minimum to appear in rankings.
• Seasons run ~3 weeks. Top 10 on each board win 1,000 AUR plus the season-exclusive item (the Champion's Signet); 3 lucky adventurers ranked in both top-50s win the item too.
• Test-raid your own dungeon any time without rating changes.

• Contracts — two audited-lineage AssemblyScript contracts (source in the repo's contracts/koinos/, built on Julian Gonzalez's KCS reference implementations): CrusaderToken (the AUR token, 8 decimals) and CrusaderRelics (the NFT collection). There is no payments contract — KOIN checkout is a plain transfer the server verifies by broadcasting it itself.
• Deployed addresses are announced by the server at /api/chain-info — the game reads them from there, so this page never goes stale.
• Network: Koinos Harbinger testnet during development, Koinos mainnet at launch. No chain-switching dance — your in-game account works as-is.
• Fee-less: Koinos transactions spend mana, a regenerating resource carried by KOIN. The game's dev wallet co-signs every player transaction as mana payer — nobody ever needs funds to play.
• Explore any address, token or transaction at koinosblocks.com (Harbinger: harbinger.koinosblocks.com).
• 1,000,000,000 AUR — the whole supply — minted to the dev wallet at deployment; the mint key goes cold afterwards.