Unity Bot User Guide

Quick Start

1. Invite Unity Bot to your server (Manage Server permission required).
2. On join, your server receives $10,000,000 treasury tokens automatically.
3. Open the Dashboard → sign in with Discord → select your server.
4. Configure General (welcome channel), Rewards (activity rules), and Economy.
5. Run /help in Discord for all commands.

---

Dashboard Overview

Section	Purpose
Overview	Server stats, quick links
General	Welcome/farewell, logs, banners
Treasury	$10M server fund, distributions
Rewards	Automatic activity milestone rewards
Crates	Loot-box style reward crates
Embeds	Visual message designer
Leveling	XP rate, level roles
Economy	Token name, shop items
Verification	NFT/token holder rewards
Moderation	Automod, warnings
AI	Dedicated AI chat channel
Workspace	Team tasks, meetings, time
Commands	Custom prefix commands
Pro	Premium features
Guide	This documentation

Tip: Enable Developer Mode in Discord (Settings → Advanced) to copy Channel/Role IDs (right-click → Copy ID).

---

Admin Commands

Requires Manage Server or appropriate Discord permissions unless noted.

/config

Configure bot behavior per server.

Subcommand	Description	Example
view	Show current settings	/config view
welcome	Set welcome channel & message	/config welcome channel:#welcome message:Welcome {user}!
farewell	Set goodbye channel & message	/config farewell channel:#general message:Bye {user}!
logs	Message edit/delete log channel	/config logs channel:#logs
levelup	Level-up announcement channel	/config levelup channel:#level-ups
autorole	Role for new members	/config autorole role:@Member
xp	XP rate & cooldown	/config xp rate:20 cooldown:45
aichat	AI-only channel	/config aichat channel:#ai-chat

Message variables: {user}, {mention}, {username}, {server}, {membercount}, {level}

/treasury

Manage server treasury (default $10,000,000 on install).

Subcommand	Description
view	Balance & recent transactions
give	Send tokens from treasury to a member
add	Deposit tokens into treasury
initialize	One-time treasury setup (if missing)

/xp

Manage member XP (Admin).

• /xp add user:@Member amount:500
• /xp remove user:@Member amount:100
• /xp reset user:@Member

/levelrole

Grant roles when members reach levels.

• /levelrole set level:5 role:@Active
• /levelrole remove level:5
• /levelrole list

/shop add / /shop remove

Manage economy shop from Discord.

• /shop add name:VIP Pass price:5000 role:@VIP description:Exclusive access stock:-1

/crate

Create crates in Dashboard; manage purchases in Discord.

• /crate list — Available crates
• /crate buy crate_id:<ID>
• /crate open crate_id:<ID>
• /crate inventory

/embed

Send styled embed messages.

• /embed send channel:#announcements title:"Update" description:"**News!** 🎉"
• /embed create channel:#general — Opens builder modal
• /embed templates — List saved templates
• /embed template name:welcome channel:#welcome

/reactionrole

Emoji-based self-assign roles.

• /reactionrole add message_id:123 emoji:✅ role:@Verified
• /reactionrole remove message_id:123 emoji:✅
• /reactionrole list

/customcmd

Prefix commands (default !).

• /customcmd add trigger:rules response:Read #rules channel!
• /customcmd remove trigger:rules
• /customcmd list

/syncverify

Apply verification reward roles after dashboard wallet checks.

Moderation

Command	Usage
/ban	/ban user:@BadActor reason:Spam delete_days:1
/kick	/kick user:@Member reason:Rule break
/timeout	/timeout user:@Member duration:30 unit:minutes reason:Cooldown
/unban	/unban user_id:123456789012345678
/warn add	/warn add user:@Member reason:Language
/warn list	/warn list user:@Member
/warn clear	/warn clear user:@Member
/clear	/clear amount:50 user:@Member

---

Team Commands (Workspace)

Configure profiles in Dashboard → Workspace. Used for internal team coordination.

• Tasks — Kanban board (todo → done)
• Calendar — Schedule meetings
• Time — Clock in/out on tasks

Moderation commands (/warn, /timeout) also apply for team leads with Discord permissions.

---

User Commands

Leveling & Engagement

Command	Description
/rank	Your XP, level, rank card
/rank user:@Friend	Another member's rank
/leaderboard	Top XP members

Economy

Command	Description
/balance	Your token balance
/daily	Claim 100 tokens (24h cooldown)
/give user:@Friend amount:50	Transfer tokens
/gamble amount:100	50% win, 1.8× payout (min 10)
/shop view	Browse shop
/shop buy item_id:<ID>	Purchase item/role
/richest	Token leaderboard

Earning tokens: Messages (+1), daily, verification bonuses, crates, automatic activity rewards, treasury grants.

Verification

Command	Description
/verify	View linked wallets & verification status
Link wallet	Dashboard → Verification → enter ETH/SOL address
/syncverify	(Mod) Apply holder roles

Holder rewards: Configurable role + TREAT bonus per NFT/token rule in Dashboard.

AI

Command	Description
/ai chat prompt:Hello!	Chat with Unity AI
/ai reset	Clear your AI history
/heyunity	Friendly greeting

Or message in the configured AI channel.

Fun

Command	Description
/8ball question:Will we moon?	Magic 8-ball
/coinflip	Heads or tails
/dice sides:6 count:2	Roll dice
/meme	Random meme

Utility

Command	Description
/ping	Bot latency
/userinfo user:@Member	User details
/serverinfo	Server stats
/avatar user:@Member	Avatar URL
/help	Command list by category

---

Automatic Activity Rewards

Before rewards are granted, admins must configure rules in Dashboard → Rewards.

Unity tracks (when enabled):

• Messages sent
• Voice channel time (excludes AFK)
• Reactions given/received
• Engagement score & streaks

Example rules:

• 50 messages today → 500 tokens
• 60 voice minutes → 1000 tokens
• 7-day streak → 2000 tokens

Rewards post to your configured Rewards Channel with a celebration embed. Tokens/XP apply automatically.

---

Crates (Loot Boxes)

Dashboard → Crates:

1. Name your crate (e.g. "Weekly Mystery Box")
2. Set price in tokens
3. Configure rewards with weights (higher = more common)
4. Set stock (-1 = unlimited)

Discord:

1. /crate list — see crate IDs
2. /crate buy crate_id:<ID>
3. /crate open crate_id:<ID> — animated reveal + auto reward

---

Welcome & Leave Banners

Dashboard → General:

• Pick from 5 gradient styles or custom hex color
• Toggle banner on/off
• Customize message with variables

Pro: Upload custom background images (Dashboard → Pro).

---

Verify Assets

Dashboard → Verification:

1. Link your wallet (ETH or Solana)
2. Admin creates rules: contract/mint address, min amount, reward role, TREAT bonus
3. Click Test verification or run checks via API
4. Run /syncverify in Discord for roles

Presets: Label rules "Holder", "Whale", etc. for clarity.

---

Games & Unity Growth

Command	Description
/trivia play / /trivia answer	Trivia for token rewards
/wordle start / /wordle guess	Word guessing game
/battlepass	Season pass progress and tier claims
/growth view	Community Growth tree status
/growth water	Water Growth (alternate with other members)
/growth harvest	Harvest fruit for tokens
/growth almanac	Critter collection
/growth leaderboard	Top waterers or cross-server tallest Growth trees

Configure rewards in Dashboard → Games. Unity Growth uses your server's branded token name (not a global token).

---

Marketplace & extras

Command	Description
/auction	Auction house for roles/items
/market	Member marketplace
/donation	Community donation goals
/cratedrop	Milestone crate drops (admin)
/profile	Member profile, streaks, birthday
/refer	Refer-a-friend rewards
/poll	Poll-to-earn registration
/standup	Workspace standup updates
/linkwallet	Dashboard wallet QR link
/globalboard	Cross-server token leaderboard
/import	Developer XP/token import

---

Best Practices for Engagement

1. Initialize treasury and run weekly /treasury give for top contributors
2. Set 3–5 reward rules — not too many at once
3. Create 2–3 crate tiers (common → legendary)
4. Welcome channel with banner + clear rules embed
5. Level roles at 5, 10, 25 for progression
6. Verification for token/NFT holders with meaningful rewards
7. Daily /daily + message tokens keeps economy flowing

---

Troubleshooting

Issue	Fix
Commands not showing	Run npm run deploy-commands or set DEPLOY_COMMANDS_ON_STARTUP=1
Treasury empty	/treasury initialize or re-invite bot
No auto rewards	Enable tracking + add rules in Dashboard → Rewards
Verification failed	Check RPC env vars, wallet linked, rule contract address
Dashboard access denied	Need Manage Server on Discord + sign in with same account

---

Support

• Dashboard → Guide
• Discord: your support server
• Docs: /docs/USER_GUIDE.md

Unity Bot v2.0 — Powered by Convex + Hugging Face