Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/developer51709/Noxie/llms.txt

Use this file to discover all available pages before exploring further.

All of Noxie’s runtime settings live in a single config.json file at the project root. The file is read once at startup via the load_config() helper. You can override the bot token at any point without touching the file by setting the NOXIE_TOKEN environment variable. Everything else must be configured in config.json before starting the bot.

​
Full example

{
  "bot_token": "YOUR_BOT_TOKEN_HERE",
  "global_prefix": "noxie ",
  "oxapay_merchant_key": "YOUR_OXAPAY_MERCHANT_KEY_HERE",
  "oxapay_base_url": "https://api.oxapay.com",
  "donation_channel_log": null,
  "db_path": "db/noxie.db",
  "hunt_cooldown": 30,
  "default_accent_color": 7930727,
  "rare_accent_color": 16766720,
  "epic_accent_color": 10027263,
  "legendary_accent_color": 16744272,
  "mythic_accent_color": 16711782,
  "economy": {
    "glow_shards_per_hunt": [5, 25],
    "vibe_coins_per_hunt": [1, 5],
    "donation_glow_shards_per_usd": 500,
    "donation_vibe_coins_per_usd": 50
  }
}

​
Field reference

​
Bot & connection

​
bot_token
string
required
Your Discord bot token, obtained from the Discord Developer Portal. This value is used to authenticate the bot process with the Discord gateway.Can be overridden at runtime by setting the NOXIE_TOKEN environment variable — if the env var is present, it takes precedence over this field. If this field is missing or still set to the placeholder value "YOUR_BOT_TOKEN_HERE", the bot will refuse to start.
​
global_prefix
string
default:"noxie "
The permanent global command prefix that is always active across every guild, regardless of any per-guild custom prefixes that server admins configure. The trailing space is intentional — commands are invoked as noxie hunt, not noxiehunt.This prefix cannot be removed or overridden by guild admins. It is always appended to the prefix list returned by prefix_callable.

​
OxaPay (donations)

​
oxapay_merchant_key
string
Your merchant API key from the OxaPay dashboard. This key authenticates crypto invoice creation requests sent by the /donate command. Without a valid key, donation commands will fail at the invoice creation step.
​
oxapay_base_url
string
default:"https://api.oxapay.com"
The base URL for the OxaPay REST API. In normal operation this does not need to change. It can be pointed at a staging or mock endpoint during development and testing.
​
donation_channel_log
string | null
default:"null"
The Discord channel ID (as a string) where completed donation events are logged. Set to null to disable donation logging entirely. When set, Noxie will post a confirmation message to this channel every time a donation is successfully confirmed by OxaPay.

​
Database

​
db_path
string
default:"db/noxie.db"
Path to the SQLite database file, relative to the project root. The directory and file are created automatically on first run — you do not need to create them manually. All five tables (economy, inventory, badges, donations, guild_prefixes) are initialized at startup.

​
Hunt behavior

​
hunt_cooldown
integer
default:"30"
The per-user, per-guild cooldown in seconds between hunts. After a successful /hunt or noxie hunt, a user must wait this many seconds before hunting again in the same guild. The cooldown is tracked and enforced by the bot — exceeding it triggers a cooldown response with a sleepy mood banner.

​
CV2 accent colors

These decimal color values are applied to the CV2 container borders rendered in hunt result messages. Each rarity has its own accent color so players get an immediate visual signal of what they caught.
​
default_accent_color
integer
default:"7930727"
Decimal accent color for Common hunt CV2 containers. The default value 7930727 corresponds to #790367 (a deep purple). Applied to all hunts that do not match a higher rarity.
​
rare_accent_color
integer
default:"16766720"
Decimal accent color for Rare hunt containers. Default: 16766720 → #FFD700 (gold).
​
epic_accent_color
integer
default:"10027263"
Decimal accent color for Epic hunt containers. Default: 10027263 → #9900FF (vivid purple).
​
legendary_accent_color
integer
default:"16744272"
Decimal accent color for Legendary hunt containers. Default: 16744272 → #FF7F50 (coral orange).
​
mythic_accent_color
integer
default:"16711782"
Decimal accent color for Mythic hunt containers. Default: 16711782 → #FF0066 (hot pink). Mythic hunts also trigger the evil mood banner.

​
Economy

​
economy.glow_shards_per_hunt
array [min, max]
default:"[5, 25]"
The base Glow Shard reward range for a Common rarity hunt, expressed as a two-element array [min, max]. The bot picks a random integer in this range and awards it to the hunter’s balance. Rarity multipliers are applied on top of this base range for higher rarities.
​
economy.vibe_coins_per_hunt
array [min, max]
default:"[1, 5]"
The base Vibe Coin reward range for a Common rarity hunt, expressed as a two-element array [min, max]. Vibe Coins are rarer than Glow Shards and serve as the premium currency tier. Rarity multipliers scale this range upward for Uncommon through Mythic hunts.
​
economy.donation_glow_shards_per_usd
integer
default:"500"
The number of Glow Shards awarded per 1USDdonatedviaOxaPay.Thisconversionisappliedoncethedonationinvoiceisconfirmed.A1 USD donated via OxaPay. This conversion is applied once the donation invoice is confirmed. A 5 donation awards 2,500 Glow Shards.
​
economy.donation_vibe_coins_per_usd
integer
default:"50"
The number of Vibe Coins awarded per 1USDdonatedviaOxaPay.AppliedatthesametimeastheGlowShardrewardonconfirmeddonation.A1 USD donated via OxaPay. Applied at the same time as the Glow Shard reward on confirmed donation. A 5 donation awards 250 Vibe Coins.

​
Environment variable

The bot token can be supplied via the NOXIE_TOKEN environment variable instead of storing it in config.json. When the variable is set, it takes precedence over the bot_token field in the config file. 
export NOXIE_TOKEN="your_bot_token_here"
This is the recommended approach for production deployments, CI environments, or any setup where you prefer to keep secrets out of version-controlled files.
The rarity multipliers that scale Glow Shard and Vibe Coin rewards above the Common base range are defined in the hunt system, not in config.json. The values in economy.glow_shards_per_hunt and economy.vibe_coins_per_hunt represent the Common baseline only. See the Economy documentation for the full per-rarity reward table.

Build docs developers (and LLMs) love

Get started for freeTalk to us