Skip to main content

Documentation 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 Bot includes a Metal Gear Solid-themed achievement system that rewards players for reaching milestones across catching, gifting, and gambling. Every achievement has a stable string key stored in the database so unlocks survive renames and bot updates. Once an achievement is earned it is permanent — it can never be revoked or re-awarded.

Viewing achievements

  • /kojima achievements — shows your own unlocked achievements in the current server.
  • /kojima achievements user:@someone — shows another member’s unlocked achievements.
Achievements are scoped per user per guild. Progress in one server does not affect another.

Achievement catalog

All 21 achievements are listed below. They are stored in the ACHIEVEMENT_CATALOG constant in src/lib/achievements.ts and keyed by the stable key column in the achievement_unlocks table.
KeyTitleDescription
first_catchVirtuous MissionYour first wild catch. Operation starts here.
speed_demonQuick DrawCaught one in under two seconds.
glacierKept Them WaitingCaught one after more than a minute on the board.
collectorMother Base Payroll25 total catches in this server.
hoarderFOB Veteran100 total catches in this server.
diamond_dogs_directorDiamond Dogs Director3,000 total catches—max Mother Base roster, no FOB upgrades required.
mythic_touchRare BreedCaught a Rare spawn.
shiny_hunterS++ Rank RunCaught Broken, Sushi, or Burger.
sus_momentCardboard BoxCaught Disguised.
variety_packNon-Lethal VarietyAt least eight different spawn types on your profile.
generousPhilanthropy, Kind OfSent five gifts.
popularHollywood SuperstarReceived five gifts.
gamble_firstHouse RulesPlaced your first casino bet.
slots_regularOne-Armed FanSpun the slots once.
slots_whaleTriple DiamondHit triple diamonds on the slots.
roulette_firstLa Li Lu Le Let It RideWon a roulette spin.
flip_addictRevolver HobbyistTen coin flips.
high_rollerWar EconomyHeld at least 5,000 chips at once.
stone_brokeMiller’s Retirement FundDropped to zero chips after a loss.
chip_hoarderFOXHOUND Expense Account25,000+ chips. Big Boss would ask where the R&D-line item went.
completionistMission Info UpdatedUnlocked ten different achievements.

How unlocks work

Achievements are checked automatically after each relevant action:
  • After a catchprocessCatchAchievements evaluates catch-count thresholds, catch timing (speed_demon, glacier), rarity-specific checks, and variety count.
  • After a giftprocessGiftAchievements checks the sender’s total gifts sent and the recipient’s total gifts received.
  • After a gambleprocessGambleAchievements checks gamble counts, slot spins, roulette wins, flip counts, and chip balance thresholds.
The tryUnlockAchievement function queries the achievement_unlocks table before inserting to ensure idempotency — if the row already exists the unlock is silently skipped. After every unlock, maybeUnlockCompletionist re-counts total unlocks and awards completionist automatically when the total reaches 10 or more.
Achievement unlock notifications appear inline in the catch, gamble, or gift result embeds — no separate notification is sent.

Build docs developers (and LLMs) love