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.

config.json is Noxie’s single configuration file, loaded at startup by utils/helpers.py → load_config() and made available to every module that calls it. It covers four areas: Discord bot credentials, OxaPay donation settings, the SQLite database path, and the economy tuning parameters that control hunt rewards and color accents for CV2 containers. All fields have sensible defaults; the only value you must change before running is bot_token.

​
Default Configuration

config.json
{
  "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 & Core

​
bot_token
string
required
Your Discord bot token from the Discord Developer Portal. This value is overridden at runtime if the NOXIE_TOKEN environment variable is set, so you can avoid storing credentials in the file entirely. Never commit a real token to version control.
​
global_prefix
string
default:"noxie "
The always-active global prefix for all prefix-based commands. This prefix is permanent and cannot be removed or overridden by per-guild custom prefixes. The trailing space is intentional — commands are invoked as noxie hunt, not noxiehunt.
​
db_path
string
default:"db/noxie.db"
Path to the SQLite database file, relative to the project root. The directory is created automatically on first run if it does not exist. Four tables (economy, inventory, badges, donations) are initialized at startup via init_db() in utils/economy.py. The fifth table (guild_prefixes) is initialized separately via init_prefix_table() in cogs/prefixes.py.
​
hunt_cooldown
integer
default:30
Seconds a user must wait between hunts, enforced per-user per-guild. The check_hunt_cooldown() function in utils/economy.py reads this value and returns the remaining seconds. Set to 0 to disable the cooldown entirely (useful during local testing).

​
Donation (OxaPay)

​
oxapay_merchant_key
string
Your OxaPay merchant key, obtained from the OxaPay dashboard. Required for the /donate command to function. If this value is missing or left as the placeholder string, donation requests will fail at the API call stage.
​
oxapay_base_url
string
default:"https://api.oxapay.com"
Base URL for the OxaPay REST API. Change this only if OxaPay publishes a new endpoint or you are routing requests through a proxy for testing.
​
donation_channel_log
string | null
default:"null"
Discord channel ID (as a string) where confirmed donations are logged. When set to null, donation logging is disabled and only the user’s DM confirmation is sent. Set to a channel ID string — for example "1234567890123456789" — to enable server-side logging.

​
CV2 Accent Colors

Noxie uses Discord Components V2 containers for all rich message layouts. Each rarity tier has its own accent color applied to the left-edge stripe of the container. Values are decimal integers, not hex strings.
​
default_accent_color
integer
default:7930727
Accent color used for common-rarity hunt containers and any container that does not match a specific rarity. Decimal 7930727 = hex #790367 (a deep violet-purple).
​
rare_accent_color
integer
default:16766720
Accent color for rare-rarity hunt containers. Decimal 16766720 = hex #FFD700 (gold).
​
epic_accent_color
integer
default:10027263
Accent color for epic-rarity hunt containers. Decimal 10027263 = hex #9900FF (vivid purple).
​
legendary_accent_color
integer
default:16744272
Accent color for legendary-rarity hunt containers. Decimal 16744272 = hex #FF7F50 (coral-orange).
​
mythic_accent_color
integer
default:16711782
Accent color for mythic-rarity hunt containers. Decimal 16711782 = hex #FF0066 (hot magenta).

​
Economy

​
economy.glow_shards_per_hunt
integer[]
A two-element array [min, max] defining the base Glow Shard reward range for a common-rarity hunt. All higher rarity tiers multiply from this baseline using the multipliers in roll_rewards(). For example, a mythic drop at default settings yields between 5 × 50 = 250 and 25 × 50 = 1,250 Glow Shards.
​
economy.vibe_coins_per_hunt
integer[]
A two-element array [min, max] defining the base Vibe Coin reward range for a common-rarity hunt. Scales with rarity multipliers identically to glow_shards_per_hunt. Vibe Coins are the rarer premium currency and have lower per-hunt yields than Glow Shards by design.
​
economy.donation_glow_shards_per_usd
integer
default:500
Number of Glow Shards granted per 1USDdonatedviaOxaPay.ThedonationflowmultipliesthisvaluebytheconfirmedUSDamountandcreditstheuser′saccount.Atthedefaultrate,a1 USD donated via OxaPay. The donation flow multiplies this value by the confirmed USD amount and credits the user's account. At the default rate, a 5 donation yields 2,500 Glow Shards.
​
economy.donation_vibe_coins_per_usd
integer
default:50
Number of Vibe Coins granted per 1USDdonated.Appliedalongside‘donationglowshardsperusd‘inthesamedonationconfirmationhandler.A1 USD donated. Applied alongside `donation_glow_shards_per_usd` in the same donation confirmation handler. A 5 donation at the default rate yields 250 Vibe Coins.

​
Environment Variables

The NOXIE_TOKEN environment variable provides an alternative to storing the bot token in config.json, which is useful for containerized deployments or any setup where secrets should not live on disk.
VariableOverridesDescription
NOXIE_TOKENbot_tokenSet the Discord bot token without editing config.json. Takes precedence over the file value at startup.
To use it: 
export NOXIE_TOKEN="your_bot_token_here"
python main.py
Accent color values throughout config.json are stored as decimal integers, not hex strings. To convert: 7930727 decimal = 0x790367 hex. Most color pickers output hex — use int("790367", 16) in a Python shell to get the decimal equivalent before adding it to the config file.

Build docs developers (and LLMs) love

Get started for freeTalk to us