TheDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/noskap/kojima-bot/llms.txt
Use this file to discover all available pages before exploring further.
/kojima command is the main control surface for the spawn game. It provides subcommands for channel setup, spawn management, statistics, gifting, and achievements. Most administrative subcommands require the Manage Channels permission; player-facing subcommands like /kojima last, /kojima leaderboard, /kojima gift, and /kojima achievements are open to everyone.
All subcommands except
/kojima last, /kojima leaderboard, /kojima gift, and /kojima achievements require Manage Channels permission.Subcommands
/kojima setup
Enables random spawns in the current text channel. On first run it inserts a channel record into the database with a default spawn interval of 60–450 seconds. The command is idempotent — running it again on a channel that was previously stopped will re-enable spawns immediately.
Required permission: Manage Channels
/kojima stop
Disables spawns in the current channel by deleting its channel row from the database. The bot will no longer post new spawns here. Any spawn message that was already active will remain in the channel until manually deleted.
Required permission: Manage Channels
/kojima forcespawn
Immediately posts a new spawn, bypassing the normal timer. If a spawn is already active, the bot first marks it as superseded (greying it out) before posting the fresh one. If type is omitted the rarity is rolled randomly using the standard weight table.
Required permission: Manage Channels
The display name of a specific rarity to spawn. Must be one of the 22 rarity names listed in the table below. If omitted, the bot rolls a random rarity using its normal weighted distribution.
| Display name | Display name |
|---|---|
| Stylish | Disguised |
| Sick | Crowbar |
| Matrix | Exercise |
| Super | Valve |
| Drunk | Combat |
| Banana | Mocap |
| Chicken Hat | Broken |
| Rare | Russian |
| Porter | Alien |
| Sushi | Mexican |
| Burger | Weed |
/kojima interval
Sets the random gap between spawns. After each catch the bot waits a random number of seconds drawn from [min_seconds, max_seconds] (plus a small ~4 s tick buffer) before posting the next spawn. Requires /kojima setup to have been run in the channel first.
Required permission: Manage Channels
Minimum seconds to wait after a catch before the next spawn. Must be between 15 and 7200 and must be less than or equal to
max_seconds.Maximum seconds to wait after a catch before the next spawn. Must be between 15 and 7200 and must be greater than or equal to
min_seconds./kojima next
Shows the current spawn schedule for this channel as an ephemeral reply. The response covers three states:
- Active spawn — a spawn message is already live; no new random spawn will be queued until it is caught (or cleared with
/kojima forcespawn). A jump link to the active message is included. - Timer running — the bot is in the idle gap; shows the exact timestamp when the next spawn is due.
- Ready — no active spawn and the timer has cleared; a spawn can appear on the bot’s next ~4 s tick.
/kojima last
Shows the last catch recorded in this channel — the catcher’s username, the rarity they caught, and a relative Discord timestamp for when it happened.
/kojima leaderboard
Shows the top 10 catchers in the current server ranked by total catch count.
/kojima gift
Sends a public gift shout-out to another member of the server. Each gift increments the giver’s catsGifted counter and the recipient’s catGiftsRecieved counter, and may unlock achievements for both parties. You cannot gift yourself or bots.
The server member to receive the gift. Cannot be yourself or a bot account.
An optional personal message to include in the gift embed. Maximum 200 characters.
/kojima achievements
Shows the unlocked achievements for a user, formatted as a list of titles and descriptions, along with an unlocked-out-of-total count. When viewing another user’s achievements the reply is ephemeral.
The member whose achievements to display. Defaults to yourself if omitted.