# Player Guide

## Overview
This is the comprehensive player guide for Advenexus — a text-based Discord-style chat game where players hunt animals, build battle teams, equip weapons, join guilds, and compete for glory. This guide covers the full gameplay loop from first login to endgame mastery.

---

## Getting Started

### Step 1: Claim Free Rewards
- `.daily` — 300–500 base coins + 1 lootbox + 1 weapon crate (24-hour cooldown)
- `.vote` — 500 coins + 10 gems (every 12 hours)
- Daily rewards scale with your win streak (up to **8× multiplier** at 28+ streak)
- Level bonus adds up to +500 coins at level 25+

### Step 2: Catch Your First Animals
- `.hunt` — catches 1–3 random animals
- **Hunt cost:** Free at levels 1–5 | 1 coin at levels 6–15 | 2 coins at 16+
- Each hunt costs **1 stamina** (100 max, refills +10 every 2 hours)
- 15-second cooldown between hunts
- Check your collection: `.zoo`
- View a specific animal: `.dex <animal>`

### Step 3: Build Your Battle Team
- `.team add <animal>` — add an animal to your team (max 3 animals)
- `.team remove <animal>` — remove an animal
- `.set team <1|2>` — switch between team loadouts
- `.team` — view your current team

### Step 4: Start Battling
- `.battle` — fight a random bot (50% weak, 30% mid, 15% strong, 5% super)
- `.battle ranked` — ranked mode, affects ELO rating (+25 vs players, +20 vs bots)
- `.battle @user` — challenge another player to PvP (loser loses 500 coins)
- Daily cap: 20 rewarded bot battles per day
- 20-second cooldown between battles

### Step 5: Equip Gear
- `.shop` — browse weapons (Mythic 15k–18k, Legendary 45k–50k, Fabled 100k–120k)
- `.buy <weaponID>` — buy a weapon
- `.equip <weaponID> <animal>` — equip to a team animal
- `.crate` — open weapon crates for enchantments, diamonds, or legendary weapons
- `.lootbox` — open lootboxes for Rare–Fabled animals

### Step 6: Join a Guild
- `.guild create <name>` — create a guild (20,000 coins)
- `.guild accept` — accept a guild invitation
- Participate in raids, wars, boss fights, and dungeons

---

## Core Gameplay Loop

```
Hunt → Collect Animals → Build Team → Battle → Earn Coins → Buy Gear → Craft → Evolve → Repeat
```

### Progression Milestones

| Stage | Activities | Goals |
|---|---|---|
| **Beginner** (Lv 1–5) | Hunt (free!), daily, battle bots | Get first Rare+ animals, equip first weapon |
| **Early Game** (Lv 6–15) | Ranked battles, crafting, shop | Build ELO, craft Epic animals, buy Mythic weapons |
| **Mid Game** (Lv 16–25) | Guild raids, events, dungeons | Join a guild, craft Mythic/Legendary animals, enchant your team |
| **Late Game** (Lv 25+) | Marketplace, evolution, wars | Evolve Legendary++, trade on marketplace, push for leaderboard |

---

## Currency Summary

| Currency | How to Get | Used For |
|---|---|---|
| 🪙 Coins | Daily, battles, selling, gambling, dungeons | Buying weapons/items, crafting, marketplace, guild bank |
| 💎 Gems | Sacrificing animals, voting, dismantling weapons | Weapon rerolls (700 gems), huntbot upgrades |
| 💵 Cash | Real money top-up | Premium features: guild upgrades, cosmetics, profile tiers |

---

## ELO Ranks

| ELO | Rank |
|---|---|
| 4,500+ | ⚜️ Legend |
| 3,800 | 👑 Grandmaster |
| 3,000 | 💫 Master |
| 2,300 | 💎 Diamond |
| 1,700 | 🏅 Platinum |
| 1,200 | 🥇 Gold |
| 800 | 🥈 Silver |
| 500 | 🥉 Bronze |
| < 500 | 🔘 Iron |

**ELO changes:**
- Win vs real player: +25 (loser: -20, min 100)
- Win vs ranked bot: +20
- Loss vs ranked bot: -10 (min 100)

---

## Stamina System

Two separate stamina pools, both capped at 100:

| Pool | Used By | Refill Rate |
|---|---|---|
| Hunt Stamina | `.hunt` (1 per hunt) | +10 every 2 hours |
| Battle Stamina | `.battle ranked` (1 per fight) | +10 every 2 hours |

---

## Daily Checklist

| Task | Reward | Cooldown |
|---|---|---|
| `.daily` | 300–500+ coins, 1 lootbox, 1 crate | 24 hours |
| `.vote` | 500 coins, 10 gems | 12 hours |
| `.hunt` (spam it!) | Animals, XP, gems, lootboxes | 15s cooldown, 1 stamina |
| `.battle` (20 wins) | 100–300 coins, XP, crate chance | 20/day reward cap |
| `.battle ranked` | ELO + rewards | 100 stamina/day |
| `.quest` | Coins + Evo Stone Crates (S/A tiers) | 1 per day |
| `.event` | Check for active events | Every 3 hours |

---

## Quest System

Random daily objectives with tiered rewards. Use `.quest` to view yours.

| Tier | Chance | Reward |
|---|---|---|
| **S-Tier** | 5% | 1 Evo Stone Crate + 10,000 coins |
| **A-Tier** | 10% | 2 Evo Stone Crates + 10,000 coins |
| **B-Tier** | 20% | 2 Evo Stone Crates + 7,000 coins |
| **C-Tier** | 30% | 1 Evo Stone Crate + 2 lootboxes |
| **D-Tier** | 35% | 2,000–3,000 coins + 1 lootbox |

- Quests auto-track progress as you play
- One quest per 24 hours — expires if not completed
- **Evo Stone Crates** drop evolution stones (10% Gods, 20% Fabled, 30% Legendary, 40% Mythic)

---

## Animal Rarity Quick Reference

| Rarity | Drop Rate | Sell | Sacrifice | Level Cap |
|---|---|---|---|---|
| Common | ~57% | 1 🪙 | 5 💎 | 5 |
| Uncommon | ~25% | 3 🪙 | 10 💎 | 5 |
| Rare | ~10% | 10 🪙 | 20 💎 | 5 |
| Epic | ~5% | 250 🪙 | 40 💎 | 5 |
| Mythic | ~2% | 5,000 🪙 | 150 💎 | 10 |
| Legendary | ~0.7% | 35,000 🪙 | 500 💎 | 15 |
| Fabled | ~0.01% | 200,000 🪙 | 1,500 💎 | 20 |
| patron | 0 | — | — | 30 |
| Gods | 0 (shop: 5M 🪙) | 2,500,000 🪙 | 2,500 💎 | 30 |
| Boundless | ~0.006% | 5,000,000 🪙 | 5,000 💎 | ∞ |

---

## Gems (Hunt Modifiers)

Gems drop during hunts (5% chance) and boost your hunting power:

| Gem | Effect | Charges |
|---|---|---|
| 🟢🟡🔴 Hunting Gem | **×2 animals** per hunt | 10 / 25 / 50 |
| 💚💛❤️ Lucky Gem | **+1–1.5% fabled** rarity boost | 10 / 15 / 20 |
| 💎 Gemstone | **+3 animals** per hunt | 20 |

- Equip with `.gem equip <ID>` (3 slots max: hunt, lucky, stone)
- Hunting Gem + Gemstone stack: 1 → +3 = 4 → ×2 = **8 animals per hunt**
- ⚠️ **Unequipping a gem destroys it** — commit before equipping

---

## Crafting Quick Reference

| Output | Input | Animals Needed | Cost |
|---|---|---|---|
| Epic | 3 Rare | 3 | 5,000 🪙 |
| Mythic | 5 Epic | 5 | 20,000 🪙 |
| Legendary | 3 Mythic | 3 | 70,000 🪙 |

- **Standard craft:** 80–110% random stats
- **Diamond craft** (`.craft <rarity> diamond`): Costs 1 Sacrificial Diamond, needs 1 fewer animal, guarantees **125% max stats**
- Buy diamonds: `.buy diamond` (50,000 coins) or find in weapon crates (15% drop)

---

## Weapon Rerolling

Spend 700 gems to reroll weapon stats with `.weapon reroll <weaponID>`.

- Each reroll adds a random modifier: **-50% to +50%** to your weapon's bonus
- Bonuses are **cumulative** — keep rolling to push higher
- Caps: **-100% min**, **+200% max** (3× weapon stats at max!)
- All stats (ATK, DEF, CRIT, MANA, LIFESTEAL) scale with the bonus

---

## Enchantments

Special abilities applied to animals. Obtained from weapon crates.

| Tier | Notable Enchantments |
|---|---|
| **Mythic** | Critical (+1.52× damage), Health Point (+25% HP), Reflection (26% reflect), Combat Combo (+8% per stack) |
| **Legendary** | Spirit Guard (-24% damage), Mana Tap (restore mana), Resurrection (revive ally), Taunting (force target) |
| **Fabled** | Negator (nullify enemy enchants), Time Freeze (skip enemy turns), Mana Whip (5× burst), Healer (14% heal) |

- Each enchantment has **50 uses** (per copy) — consumed per battle/raid/dungeon/war
- Apply: `.enchant <animal> <enchID>` | Remove: `.enchant keep <enchID>`
- View all: `.enchants`

---

## Evolution System

Animals Mythic+ can evolve into stronger forms.

**Requirements:**
1. **2 copies** of the same animal at the same stage
2. An **evolution stone** matching the target rarity (from dungeons/quests)

| Rarity | Max Stages | Stat Multiplier |
|---|---|---|
| Mythic | 1 (→ +) | 1.5× |
| Legendary | 2 (→ + → ++) | 1.5× / 2.0× |
| Fabled | 2 (→ + → ++) | 1.5× / 2.0× |
| Gods | 1 (→ +) | 1.5× |

Evolved animals also gain **role bonuses** (Tank +HP, Berserker +ATK, Mage +Mana, etc.)

---

## Dungeon Quick Reference

Dungeons spawn every **3 hours** with a **3-minute join window**.

| Rank | Spawn % | Entry Fee | Min Level | Final-Blow Coin Reward |
|---|---|---|---|---|
| D | 15% | 1,000 🪙 | 2 | 5,000 🪙 |
| C | 35% | 2,000 🪙 | 5 | 10,000 🪙 |
| B | 25% | 3,000 🪙 | 10 | 20,000 🪙 |
| A | 15% | 4,000 🪙 | 20 | 40,000 🪙 |
| S | 10% | 5,000 🪙 | 30 | 100,000 🪙 |

- 3 waves + 1 boss per dungeon, up to 6 players
- **Primary source of evolution stones** (one shared stone roll per dungeon, awarded to one clearer)
- Wave drops are animals; final blow awards the coin prize

---

## Guild Quick Reference

| Action | Requirement |
|---|---|
| Create guild | 20,000 🪙 |
| Default members | 4 (max 8 with upgrades at 250 💵 each) |
| Raid | 60,000 guild bank, 5,000/member entry |
| War | 3+ members per guild, leader accepts |
| Boss | Spawns every 10 hours, despawns after 4h, `.guild boss attack` (10 min cooldown) |
| Banner | Buy from leader's coins (5,000–150,000) |

---

## Event Quick Reference

Events run every **3 hours**. Three types:

| Event | Duration | Mechanic |
|---|---|---|
| 🔥 Hunt Frenzy | 5 min | +2% fabled drop rate for everyone |
| ⚔️ Battle Frenzy | 15 min | First to 10 battle wins wins prize |
| 🃏 Blackjack Frenzy | 15 min | First to 5 blackjack wins wins prize |

Prizes: coins, legendary weapons, legendary animals, fabled profile pictures, fabled animals

---

## Social Commands

| Command | Effect | Cooldown |
|---|---|---|
| `.cookie @user` | Give a friendly cookie | 24 hours |
| `.pray @user` | Donate 50–5,000 coins | 1 hour |
| `.curse @user` | Drain coins (30% backfire) | 30 min |
| `.steal @user` | Steal 200–5,000 coins | 1 min (2h per target) |
| `.give @user <amount>` | Transfer coins directly | 3× per 5 hours |
| `.pat @user` | Pat someone's head | — |
| `.hug @user` | Give someone a hug | — |
| `.kiss @user` | Kiss someone | — |
| `.slap @user` | Slap someone | — |
| `.poke @user` | Poke someone | — |
| `.tickle @user` | Tickle someone | — |
| `.cuddle @user` | Cuddle someone | — |
| `.highfive @user` | High-five someone | — |
| `.wave @user` | Wave at someone | — |
| `.greet @user` | Greet someone | — |
| `.bite @user` | Bite someone | — |
| `.boop @user` | Boop someone's nose | — |
| `.hold @user` | Hold someone | — |
| `.handholding @user` | Hold hands with someone | — |
| `.bully @user` | Bully someone | — |
| `.punch @user` | Punch someone | — |
| `.kill @user` | Kill someone | — |

---

## Marketplace

Trade items with other players in the **#sellers** channel.

1. Switch to seller mode: `.mode seller` (5-min cooldown)
2. List an item: `.player sell <item name> <price>` (2% listing fee)
3. Browse: `.market` or `.market animals/weapons/enchantments/stones`
4. Buy: `.item buy <listingID>`

**Price range:** -20% to +50% of base value. Evolved animals sell for 60–80% more than base forms.

---

## Lootbox & Crate Contents

**Lootbox** (2,000 🪙 or free from daily/hunts):

| Rarity | Chance |
|---|---|
| Rare | 55% |
| Epic | 30% |
| Mythic | 12% |
| Legendary | 2.4% |
| Fabled | 0.3% |

**Weapon Crate** (3,000 🪙 or free from daily/battles):

| Drop | Chance |
|---|---|
| Enchantment | 63% |
| Sacrificial Diamond | 15% |
| Empty | 15% |
| Legendary Weapon | 7% |

---

## Gambling

| Game | Command | Max Bet | Cooldown |
|---|---|---|---|
| Coinflip | `.coinflip <heads\|tails> <bet>` | 100,000 🪙 | 5s |
| Slots | `.slots <bet>` | 100,000 🪙 | 10s |
| Blackjack | `.blackjack <bet>` | 100,000 🪙 | 10s |
| Lottery | `.lottery <bet>` | — | 60s |

- Slots: 🍒🍒🍒 = 2×, 💎💎💎 = 5×, 🎰🎰🎰 = 20× jackpot
- Blackjack: Natural 21 pays 2.5×, dealer hits until 17
- Lottery: Draws at 5+ unique players or 20 tickets, 15% rake

---

## Key Tips

1. **Win streak is king** — daily rewards scale up to 8× at 28+ streak. Don't lose ranked carelessly!
2. **Craft up** — 3 Rare → 1 Epic → 5 Epic → 1 Mythic is the progression backbone
3. **Diamond craft** when you have a Sacrificial Diamond — guaranteed 125% max stats
4. **Gems matter** — equip hunting gems for ×2 animals and lucky gems for bonus fabled chance
5. **Guard dogs** — always have one active (150 coins) to block 90% of steals
6. **Events** — watch for the warning. Hunt Frenzy is free value, Battle/Blackjack Frenzies award huge prizes
7. **Marketplace** — evolved animals sell for 60–80% more than base forms
8. **Enchantments** have 50 uses — they break permanently when depleted. Don't waste them on easy fights
9. **Guild raids** require 60k in the guild bank — deposit regularly
10. **Dungeons** spawn every 3 hours — join within 3 minutes or miss it
11. **Quests** — S-tier quests give Evo Stone Crates, which are the easiest way to get evolution stones outside dungeons
12. **Weapon rerolls** are cumulative — keep pushing toward +200% for 3× weapon stats
13. **Autohunt** — use `.autohunt` to hunt while away; upgrade traits with gems for efficiency

---

## Huntbot (Autohunt)

Hunt animals automatically while you're away.

| Command | What It Does |
|---|---|
| `.autohunt` | Start a huntbot session |
| `.huntresults` | Claim caught animals when session ends |
| `.huntbot` | View huntbot status and build |
| `.huntbot upgrade <trait>` | Upgrade a trait with gems |

**Traits** (max level 50 each): Efficiency (faster hunts), Duration (more animals), Radar (rare chance)

- Max session: **8 hours**
- Cost: animals_per_session × 10 coins
- Upgrade cost: 10 gems × 1.5^(level-1)

---

## Cross-References

For detailed system documentation, see:
- [hunt.md](hunt.md) — Hunting mechanics, autohunt, stamina, gems
- [battle.md](battle.md) — Combat engine, weapons, enchantments, PvP
- [guild.md](guild.md) — Guild management, raids, wars, boss fights
- [dungeon.md](dungeon.md) — Dungeon gates, waves, boss drops, evolution stones
- [economy.md](economy.md) — Currencies, daily/vote, quests, gambling
- [inventory.md](inventory.md) — Animals, evolution, crafting, sacrifice/sell
- [shop.md](shop.md) — Weapon/item shop, gem system, marketplace
- [cosmetics.md](cosmetics.md) — Profiles, banners, achievements, tiers, auras
- [patron.md](patron.md) — Cash currency, premium features, patron animals
- [sticker.md](sticker.md) — Custom sticker upload system
- [events.md](events.md) — Timed event system and prizes
- [commands.md](commands.md) — Full command reference
- [quests.md](quests.md) — Daily quest tiers and Evo Stone Crates