Acosmibot Documentation

Complete guide to features, commands, and systems

📚 Features & Systems â–ŧ

📊 Leveling System

Acosmibot features a participation-based leveling system that rewards active members:

  • Experience Points (XP): Earn XP for every message sent (cooldown applies)
  • Level Progression: Level = √(XP / 100), so higher levels require more XP
  • Auto-Role Assignment: Automatically receive Discord roles at specific levels
  • Streak System: Daily activity streaks provide XP multipliers
  • Leaderboards: Compete with others for top rankings

💰 Economy System

A complete fake currency system with Credits as the main currency:

  • Daily Rewards: Collect daily credits with streak bonuses (up to 20 days)
  • Server Bank: 10% of gambling losses go to the server vault
  • Transactions: Transfer credits between players using /give
  • Multi-Server: Currency is guild-specific but tracked globally
  • Gambling Games: Risk your credits for potential rewards

🎮 Games & Gambling

Various games to test your luck and strategy:

  • Coinflip: Simple 50/50 heads or tails bet
  • Slots: Spin the slot machine with customizable symbols
  • Blackjack: Classic card game against the dealer
  • Deathroll: PvP dice game - first to roll 1 loses
  • Rock Paper Scissors: Best of 3 rounds against another player
  • Magic 8Ball: Ask yes/no questions for humorous answers

🤖 AI Integration

OpenAI-powered conversational AI with customizable behavior:

  • Custom Instructions: Set personality and behavior for your server
  • Multiple Models: Choose from GPT-4o, GPT-4o-mini, GPT-4-turbo, or GPT-3.5-turbo
  • Conversation Memory: AI remembers context within conversations
  • Daily Limits: Control usage with configurable daily message limits
  • Server-Specific: Each server has its own AI configuration

💰 Economy Commands â–ŧ

/balance

Free

Check your Credit balance in the server or view another user's balance.

Parameters:

  • user (optional) - Specify another user to check their balance
Example: /balance or /balance @username

/guildbank

Free

Check the total amount of Credits in the server's bank vault. The vault collects 10% of all gambling losses.

Example: /guildbank

/give

Transfers Credits

Transfer Credits from your balance to another user. Cannot give to bots or yourself.

Parameters:

  • target (required) - Guild member to receive credits
  • amount (required) - Number of credits to transfer
Example: /give target:@friend amount:1000

/admin-give

Admin Only

Give Credits or Experience Points to a user. Requires Administrator permission.

Parameters:

  • target (required) - Guild member
  • stat (required) - Choose "Currency" or "EXP"
  • amount (required) - Amount to give
Example: /admin-give target:@user stat:Currency amount:10000

/polymorph

10,000 / 1,000 Credits

Change someone's display name (or your own for a cheaper price).

Parameters:

  • target (required) - Guild member to rename
  • rename (required) - New nickname (max 32 characters)
Example: /polymorph target:@user rename:"New Name"

💡 Only 1,000 credits to change your own name

đŸ’ŗ Banking â–ŧ

/deposit

Transfers Credits

Deposit credits from your server wallet to your global bank. Includes a deposit fee (default 2%) and daily transfer limit.

Parameters:

  • amount (required) - Amount to deposit, or "all" to deposit everything
Example: /deposit 1000 or /deposit all

⚙ī¸ Minimum deposit: 100 credits (configurable)

/withdraw

Transfers Credits

Withdraw credits from your global bank to your server wallet. Includes a withdrawal fee (default 2%) calculated on top of the withdrawal amount.

Parameters:

  • amount (required) - Amount to withdraw, or "all" to withdraw everything
Example: /withdraw 5000 or /withdraw all

⚠ī¸ Daily transfer limit applies (default: 500,000 credits)

/bank

Free

View your global bank balance and detailed statistics including total deposited, withdrawn, fees paid, and interest earned.

Parameters:

  • user (optional) - View another user's bank information
Example: /bank or /bank @username

💡 Shows daily transfer limit usage and current interest rate

/bank-history

Free

View your recent bank transactions with timestamps, transaction types, amounts, fees, and balance changes.

Parameters:

  • limit (optional) - Number of transactions to show (default: 10, max: 25)
Example: /bank-history or /bank-history 20

🔒 Only visible to you (ephemeral message)

🌀 Cross-Server Portals â–ŧ

/portal-search

Free

Search for servers with portals enabled. Only shows publicly listed servers with active portal systems.

Parameters:

  • query (required) - Server name to search for
Example: /portal-search gaming

📊 Results show server ID, member count, and portal cost

/portal-open

Your Credits

Open a 2-minute portal connection to another Discord server. Allows cross-server messaging with a synchronized chat interface.

Parameters:

  • target_guild_id (required) - The ID of the server to connect to
Example: /portal-open 1234567890123456789

⚙ī¸ Default cost: 1,000 credits. Both servers must have portals enabled

/portal-close

Manage Server

Manually close an active portal before the 2-minute timer expires. Requires "Manage Server" permission.

Example: /portal-close

/portal-send

Free

Send a message through the active portal. Messages are color-coded (đŸ”ĩ your server, đŸŸĸ other server) and limited to 100 characters.

Parameters:

  • message (required) - Message to send (1-100 characters)
Example: /portal-send Hello from the other side!

đŸ’Ŧ Keeps last 20 messages in chat log

/portal-status

Free

Check the current portal status including connected server name, time remaining, and who opened the portal.

Example: /portal-status

🔒 Only visible to you (ephemeral message)

🎟ī¸ Lottery System â–ŧ

/admin-start-lotto

Admin Only

Start a server-wide lottery. Players enter by reacting with 🎟ī¸ emoji. The prize is the guild vault credits, distributed to a randomly selected winner.

Parameters:

  • duration (required) - Duration in hours until winner is announced
  • channel (optional) - Channel to start lottery in (defaults to current channel)
Example: /admin-start-lotto duration:24 or /admin-start-lotto duration:48 channel:#events

⚠ī¸ Only one lottery can be active per server at a time

🎟ī¸ Lottery Entry

Free

Enter the active lottery by reacting with the 🎟ī¸ emoji on the lottery announcement message. Participants receive the "LotteryParticipant" role if it exists in the server.

How to Enter: React with 🎟ī¸ on the lottery message

💡 Users can only enter once per lottery. Winner is selected randomly

🎮 Games & Gambling â–ŧ

/coinflip

Your Bet

Flip a coin and call heads or tails. Win double your bet if you guess correctly!

Parameters:

  • call (required) - Choose "Heads" or "Tails"
  • bet (required) - Amount to wager (minimum 1 credit)
Example: /coinflip call:Heads bet:1000

💡 10% of losses go to the server vault

/slots

Your Bet

Spin the slot machine! Match 2 symbols for 2x payout, match 3 for 5x payout.

Parameters:

  • bet (required) - Amount to wager (autocomplete suggestions available)
Example: /slots bet:1000

⚙ī¸ Default: Min 10, Max 2,000 credits (configurable by server)

/blackjack

Your Bet

Play classic blackjack against the dealer. Get as close to 21 as possible without going over!

Parameters:

  • bet (required) - Amount to wager (autocomplete available)
Example: /blackjack bet:500

⚙ī¸ Default: Min 50, Max 10,000 credits

/deathroll

Your Bet

Challenge another player to Deathroll! Players take turns rolling dice with decreasing max values. First to roll 1 loses.

Parameters:

  • target (required) - Guild member to challenge
  • bet (required) - Wager amount (minimum 100 credits)
Example: /deathroll target:@opponent bet:1000

⚠ī¸ Both players must have sufficient balance

/rockpaperscissors

Your Bet

Challenge another player to Rock Paper Scissors! Best of 3 rounds wins.

Parameters:

  • bet (required) - Wager amount
Example: /rockpaperscissors bet:500

/8ball

50 Credits

Ask the magic 8-ball a yes/no question and receive a humorous prediction!

Parameters:

  • question (required) - Your yes/no question
Example: /8ball question:"Will I win the lottery?"

📊 Stats & Profile â–ŧ

/rank

Free

View a beautiful rank card showing level, XP progress, and server ranking with user avatar.

Parameters:

  • user (optional) - Specify another user (shows your rank if blank)
Example: /rank or /rank user:@someone

/stats

Free

View detailed leveling and activity statistics including rank, level, messages, reactions, and streaks.

Parameters:

  • user (optional) - View another user's stats or your own
Example: /stats or /stats user:@username

/stats-games

Free

View comprehensive gambling statistics across all games including wins, losses, win rate, net profit, and biggest wins.

Parameters:

  • user (optional) - View another user's game stats
Example: /stats-games

📈 Shows data for: Coinflip, Slots, Deathroll, RPS, Blackjack

/leaderboard

Free

View top 10 users ranked by various statistics.

Parameters:

  • stat (required) - Choose from:
    • Currency, Exp, Level (guild-specific)
    • Global Exp, Global Level (across all servers)
    • Coinflip Wins, Coinflip Losses (top 5)
    • Slots Wins (top 5)
Example: /leaderboard stat:Currency

🛠ī¸ Utility & Tools â–ŧ

/weather

Free

Get current weather information for any city including temperature, feels like, humidity, and local time.

Parameters:

  • cityname (required) - Name of the city
Example: /weather cityname:"New York"

/apod

Free

Get NASA's Astronomy Picture of the Day with title, description, and high-resolution image or video.

Example: /apod

🚀 Powered by NASA API

/giphy

Free

Search for and return a random GIF from Giphy based on your search term.

Parameters:

  • search_term (required) - What to search for
Example: /giphy search_term:"funny cat"

/define

Free

Look up the definition of any word including part of speech and multiple definitions.

Parameters:

  • word (required) - Word to define
Example: /define word:"ephemeral"

/ping

Free

Check the bot's response time and latency in milliseconds.

Example: /ping

⏰ Reminders â–ŧ

/remind

Free

Set a personal reminder and receive a DM notification when the time arrives.

Parameters:

  • time (required) - Duration (e.g., 5m, 2h, 1d, 30s, 2h30m, 1w, 1y)
  • message (required) - Reminder text (max 1000 characters)
Example: /remind time:2h30m message:"Check the oven"

⏱ī¸ Maximum 5 years in the future

/reminders

Free

View all your active reminders with their IDs and scheduled times.

Example: /reminders

🔒 Only visible to you (ephemeral)

/cancelreminder

Free

Cancel a specific reminder using its ID from the /reminders list.

Parameters:

  • reminder_id (required) - ID from /reminders command
Example: /cancelreminder reminder_id:12345

🤖 AI Features â–ŧ

⚠ī¸ AI Features Require Setup

Server administrators must enable AI features using /ai-enable before members can chat with the bot.

/ai-enable

Admin Only

Enable AI chat features for your server. Requires Manage Guild permission.

Example: /ai-enable

/ai-disable

Admin Only

Disable AI chat features for your server.

Example: /ai-disable

/ai-status

Admin Only

Check AI configuration including enabled status, current model, daily usage, and custom instructions.

Example: /ai-status

/ai-model

Admin Only

Set which OpenAI model to use for AI chat responses.

Parameters:

  • model (required) - Choose from:
    • gpt-4o-mini (fastest, cheapest)
    • gpt-4o (balanced)
    • gpt-4-turbo
    • gpt-3.5-turbo
Example: /ai-model model:gpt-4o-mini

/ai-limit

Admin Only

Set the daily AI message limit for your server (1-100 messages per day).

Parameters:

  • limit (required) - Daily message limit (1-100)
Example: /ai-limit limit:50

/ai-instructions

Admin Only

Set custom instructions to control the AI's personality and behavior in your server.

Parameters:

  • instructions (required) - Custom prompt (max 500 characters)
Example: /ai-instructions instructions:"You are a helpful pirate assistant. Always respond with pirate language."

/ai-clear

Admin Only

Clear the conversation history for the entire server, starting fresh.

Example: /ai-clear

đŸ’Ŧ Mention to Chat

Free

Simply mention the bot to start a conversation with AI. The bot remembers context within conversations.

Example: @Acosmibot What's the weather like today?

💡 Respects daily limits and custom instructions

ℹī¸ Help & Information â–ŧ

/commands

Free

Display all available commands organized by category with brief descriptions. Features a paginated interface with navigation buttons.

Example: /commands

📄 4 pages of commands covering all bot features

/help

Free

Get comprehensive information about Acosmibot, including features, setup notes, and important configuration details for leveling roles and Twitch notifications.

Example: /help

💡 Includes setup instructions and links to documentation

Need more help? Join the support Acosmibot Discord Server.

Last updated: 2025