8ball

achievements

action

adopt

Send your active pet on an adventure to earn rewards.

adventure

Battle in PvE arenas to earn coins and loot boxes.

arena

Send your pet on an auto-battle patrol to earn XP passively.

autobattle

balance

Challenge another user's pet to an interactive PvP battle.

battle

Beg for coins from strangers. A small but reliable income.

changelog

View your daily battle checklist objectives.

checklist

Claim your hourly, daily, or weekly Shiro Coins reward.

claim

Configure your notification and reminder preferences.

config

craft

Bet on a rising multiplier — cash out before it crashes to win!

crash

Commit a crime for a potentially large payout — at your own risk.

crime

Deposit Shiro Coins from your wallet into your bank.

deposit

Dig for buried items and treasures. Requires a Shovel.

Divorce your current partner (requires confirmation).

divorce

View the current seasonal event and claim daily rewards.

event

Go fishing for aquatic finds. Requires a Fishing Rod.

fish

Try your luck with various gambling mini-games.

gamble

give

Learn how to use Shiro — economy, pets, battles, and more.

help

Guess if the next card is higher, lower, or the same! Cash out to secure winnings.

highlow

View your economy transaction history with optional filters.

history

Go hunting for animal drops. Requires a Hunting Rifle.

hunt

Use and manage consumable items in your inventory.

item

joke

Pick 1–10 numbers (1–40). 20 are drawn — matches determine your payout!

keno

leaderboard

lootbox

View the daily lottery jackpot and your tickets. Buy tickets via /shop!

lottery

Browse and trade pets on the marketplace.

market

Propose, accept, or view your marriage status.

marry

Uncover safe tiles on a 5×5 grid. Cash out anytime — hit a mine and lose!

mines

missions

View house edge and payout info for every casino game.

odds

ping

Prestige your character for permanent XP bonuses.

prestige

profile

riddle

Spin the roulette wheel! Bet on colours, numbers, ranges, and more.

roulette

Challenge another user to Rock Paper Scissors!

Buy and instantly reveal a scratch card. Match 3 symbols to win!

scratch

Search a location for loose coins and hidden treasures.

search

shop

Manage or view an item showcase on your profile.

showcase

Spin the daily Wheel of Fortune for coins, items, and more! (24h cooldown)

spin

throw

Climb 8 floors — each floor has 3 tiles but 1 trap. Reach the top for 17×!

tower

trade

trivia

vote

Withdraw Shiro Coins from your bank into your wallet.

withdraw

work

View your Zoo Score and species collection diversity.

This project has a complementary web interface that you can use to control or configure your experience

Web Interface

This project has leaderboards highlighting the top players within either the server or globally

Leaderboards

<img src="https://cdn.shirobot.org/action_banners/puppy_training.png" />

### 🐾 Shiro - Pets, Economy & Battles for Your Discord Server

Shiro is a feature-rich Discord bot built around one simple idea: **adopt a pet, care for it, and take on the world.**
Whether you're here to grind coins, challenge your friends to battles, or just hang out - Shiro has something for everyone.

---

### 🐶 Adopt Your Own Pet

Choose from **21 unique species** across 5 rarity tiers - from a free starter Puppy all the way up to a Legendary Tiger or Lion.

Every species has its own **passive ability** that changes how it fights. A Cat can survive a killing blow with 1 HP. A Fox has a chance to set enemies on Burn. An Eagle's first strike is always a critical hit. Your pet, your playstyle.

> 🟢 Common - Puppy, Cat, Bunny, Tortoise, Duck *(free or 500 SC)*
> 🔵 Uncommon - Fox, Otter, Raccoon, Penguin, Meerkat and more *(2,000 SC)*
> 🟣 Rare - Eagle, Owl, Parrot, Panda *(7,500 SC)*
> 🟠 Epic - Bear, Deer, Snow Leopard *(20,000 SC)*
> 🟡 Legendary - Tiger, Lion *(75,000 SC)* · Wolf *(event-only)*

---

## 💛 Care For Your Pet

Your pet needs attention! Feed it, play with it, and let it rest to keep its stats healthy. Neglect your pet and its health will start to drop.

- `/feed` - restore hunger (1h cooldown)
- `/play` - boost happiness (2h cooldown)
- `/rest` - replenish energy (4h cooldown)

Each care action earns your pet **XP** and raises your **Bond Level**. The closer your bond, the more it matters if you ever decide to trade your pet away.

Pets also earn **passive idle XP** every 30 minutes - even while you're offline.

---

### ⚔️ Turn-Based Battles

Challenge other users to **1v1 PvP battles** or take on CPU opponents in the **Arena**.

Each turn you pick a move:

- ⚔️ **Attack** - standard strike
- ✨ **Special** - high-power move using your pet's SPC stat
- 🛡️ **Guard** - reduce incoming damage by 50%
- 😤 **Taunt** - weaken your opponent's defence for 2 turns

Stats (ATK, DEF, SPD, SPC) scale with your pet's level. Higher SPD goes first. Passive abilities fire automatically - no manual activation needed.

**Win rewards:** +50 XP and up to 75 SC. Even losing grants consolation XP.

### 🏟️ 3v3 Team Arena

Pick a squad of three pets and battle through a multi-round CPU challenge. Swap pets mid-fight and use your team's combined strengths to win.

---

### 💰 Economy System

Shiro Coins (SC) are the lifeblood of the server. Earn them through:

- **Timed rewards** - `/hourly`, `/daily`, `/weekly` (with streak bonuses!)
- **Jobs** - apply for a job and `/work` every few hours for a steady income
- **Battles** - win fights, win coins
- **Gambling** - flip coins, roll dice, play slots, plinko, or blackjack

Store your coins safely in the **bank** (safe from theft mechanics) or keep them in your wallet for spending. Bank capacity grows as you level up, and your bank even earns **interest** over time.

> There's a daily gambling loss cap - so you can have fun without losing everything.

---

### 🤝 Trading & Marketplace

Trade pets directly with other users, or list them on the **open marketplace** for anyone to buy.

- Trade offers include an optional SC sweetener
- A **5% marketplace listing fee** keeps the economy balanced
- Pets have a **7-day anti-scam cooldown** after adoption or trade
- When a pet changes hands, it misses its old owner - stats drop based on your bond level and recover gradually through care

---

### 🎉 Fun Extras

- 🤔 `/trivia` - answer a multiple-choice question for bonus SC
- 🧩 `/riddle` - solve a riddle for a reward
- 😂 `/joke` - clean, pun, or programming humour
- 🪨 `/rps` - challenge a friend to Rock Paper Scissors
- 🎱 `/8ball` - consult the Magic 8-Ball
- 🏆 `/leaderboard` - top 10 players by balance, bank, wins, or pet level

---

### 🚀 Getting Started

1. Use `/adopt list` to browse available pets
2. Your **first Common pet is always free** - no coins needed
3. `/feed`, `/play`, and `/rest` to care for your new companion
4. `/work` to start earning coins
5. `/battle @user` to challenge a friend

Type `/help` at any time for a full interactive guide.


Shiro

Adopt pets, battle friends, and build your fortune - Shiro is your all-in-one Discord companion bot.

​​​​​The project that will hold all of the projects made in relation to the Shiro Project

Stemmen voor Shiro

Wil je ons ondersteunen?