Overview
Versus Invites combines two systems into one bot: a competitive King of the Hill invite battle game and a global server partnership listings hub. Servers compete to hold the throne by out-inviting each other, guessing secret numbers, and spending coins on perks — while the partnership system lets servers list themselves across 4 categories for cross-server discovery and collaboration.
👑 King of the Hill — Invite Battles
Servers compete to hold the top position by earning more invites than the current holder. The holder picks a secret number — challengers guess it to dethrone them. Earn coins for correct guesses, spend them on perks, and climb the leaderboard.
🤝 Global Partnership Listings
Servers submit themselves to 4 global categories (Partnership, Staff, Work, Boosts). Applications go through admin approval, then appear in a live-updating embed in your server's partner channel. Any Discord server can browse all listings.
Secret Number Game
Holder sets a number 1–100. Challengers guess — hot/cold hints given. Correct guess = dethroned
Coin Economy
Earn coins for correct guesses and tips from other users. Spend on role perks
Perk Roles
Admins assign roles as perks — users buy them with coins earned from battles
Persistent Leaderboard
Paginated leaderboard tracking all-time invite counts, wins, and coin balances
4-Category Listings
Servers list themselves across Partnership, Staff, Work, and Boost categories
Admin Approval Queue
All partnership applications are reviewed by admins before going live
Partnership Categories
Servers can submit listings to any of these 4 global categories:
🤝 Partnership
General server partnerships — mutual promotions, co-events, and cross-community collaboration
👨💻 Looking for Staff
Servers actively recruiting moderators, admins, or other staff positions
💼 Looking for Work
Individuals or servers offering Discord services — moderation, design, bot development, etc.
🔥 Looking for Boosts
Servers seeking Nitro boosts — can offer perks, roles, or other incentives in exchange
Commands — Invite Battles (KOTH)
Setup Admin Only
| Command | Description |
|---|---|
| /setup | Initialize Invite Battles for this server — creates database entries and shows config instructions |
| /config channel add #channel | Set the channel where game activity is posted |
| /config approval #channel | Set the channel where new invite submissions are reviewed |
| /config perks add | Assign a Discord role as a purchasable perk (users spend coins to buy) |
| /config coins <amount> | Set how many coins a user earns per correct secret number guess |
| /config guesses <limit> | Set the daily guess limit per user (default: 5) |
| /config cooldown <hours> | Set the cooldown period after activation (default: 3 hours) |
| /reset | Reset the current game — clears the active holder and secret number |
| /forcepick <invite> | Admin: force-set a specific server invite as the current target |
Game Commands Everyone
| Command | Description |
|---|---|
| /pick | Submit your server's invite to challenge the current holder — starts the guessing phase |
| /tip <user> <amount> | Send coins from your balance to another user |
| /leaderboard | View the paginated all-time leaderboard — invite counts, wins, and coin balances |
| /guide [#channel] | Post an interactive guide explaining how the game works. Optionally specify a target channel |
Commands — Partnership System
Partnership Setup Admin Only
| Command | Description |
|---|---|
| /partner set-channel #channel | Set the channel where partnership embeds are posted. Auto-enables all 4 category embeds |
| /partner set-admin-channel #channel | Set the channel where incoming partnership applications appear for admin review |
| /partner enable <category> | Enable a category embed (Partnership, Staff, Work, or Boost) |
| /partner disable <category> | Disable a category embed — removes it from the partner channel |
| /partner set-bump-cooldown <hours> | Set how often listed servers can bump their listing (default: 24 hours) |
| /partner monitor-add #channel | Add a channel to track for user activity |
| /partner monitor-remove #channel | Remove a channel from activity monitoring |
| /partner monitor-list | List all currently monitored channels |
| /partner pending | View and approve/deny pending partnership applications (up to 5 at a time) |
| /partner status | Show full partnership configuration — channels, enabled categories, listing counts, bump cooldown |
| /partner refresh | Manually refresh all partnership embeds in the partner channel |
Setup Guide
Step 1 — Create a Discord Application
Go to the Discord Developer Portal, create a new application named "Versus Invites", go to the Bot tab, copy the token. Under OAuth2 → URL Generator, select scopes: bot, applications.commands. Invite the bot to your server.
Step 2 — Configure .env
Step 3 — Install and Deploy Slash Commands
Step 4 — Configure in Discord
Required Bot Permissions
- Manage Roles (for perk role assignment)
- Send Messages
- Read Message History
- Embed Links
- Use External Emojis
- Manage Messages (for updating embeds)
- Create Public Threads
Command Summary
Total Commands: 20
KOTH Admin Commands: 9 — setup, config (×6), reset, forcepick
KOTH User Commands: 4 — pick, tip, leaderboard, guide
Partnership Admin Commands: 11 — partner subcommands (set-channel, set-admin-channel, enable, disable, set-bump-cooldown, monitor-add, monitor-remove, monitor-list, pending, status, refresh)
Technology: Node.js • Discord.js • SQLite (sql.js) • Slash Commands