Configuration

Configuration Guide

Configuration Files

The bot uses several configuration files:

myconfig.json

Main configuration file with the following structure:

{
  "required_role": null,
  "chatgpt_required_role": null,
  "tokenuse": false,
  "chat_thread_retention_days": 7,
  "features": {
    "chatgpt": true,
    "fishing": true,
    "games": true,
    "casino": true
  },
  "max_tokens": {
    "feelgood": 50,
    "joke": 75,
    "compliment": 50,
    "advice": 100,
    "inspo": 50,
    "query": 150,
    "image": 50
  },
  "prompts": {
    "feelgood": {
      "generic": "Write a 50-word uplifting message...",
      "targeted": "..."
    }
  }
}

my_fishing_game_config.json

Fishing game configuration:

{
  "member_catch_ratio": 250,
  "cooldown_seconds": 30,
  "fish": [
    {
      "name": "Bass",
      "min_size_cm": 20,
      "max_size_cm": 60,
      "min_weight_kg": 0.5,
      "max_weight_kg": 5
    }
  ]
}

Configuration Options

General Settings

Option	Type	Default	Description
`required_role`	string/null	null	Legacy role gate for bot access
`chatgpt_required_role`	string/null	null	Role required for ChatGPT commands (fallbacks to `required_role`)
`tokenuse`	boolean	false	Show OpenAI token usage after responses
`chat_thread_retention_days`	number	7	Days to keep chat threads
`features`	object	all true	Enable/disable `chatgpt`, `fishing`, `games`, `casino`

Token Limits

Configure max tokens for each command type:

Command	Default	Description
`feelgood`	50	Feel-good messages
`joke`	75	Jokes
`compliment`	50	Compliments
`advice`	100	Advice
`inspo`	50	Inspirational quotes
`query`	150	General queries
`image`	50	Image descriptions

Custom Prompts

You can customize prompts for each command:

"prompts": {
  "joke": {
    "generic": "Tell a family-friendly joke.",
    "targeted": "Tell a family-friendly joke about {topic}."
  }
}

Runtime Configuration

Admin Commands

!reloadconfig - Reload configuration from file
!showconfig - Display current configuration
!setmaxtokens <command> <value> - Adjust token limits
!setprompt <command> <variant> <prompt> - Set custom prompts
!toggletokenusage - Toggle token usage display
!setchatretention <days> - Set thread retention in days (integer)

Feature Toggles

!features / !showfeatures - Show current feature flags
!enable <chatgpt|fishing|games|casino> - Enable a feature
!disable <chatgpt|fishing|games|casino> - Disable a feature

Casino Defaults

Welcome bonus: +2000 chips (one-time on first play)
Daily faucet: +500 chips (once per 24h)

These amounts are fixed in this version. Server‑configurable amounts may be added later.

Fishing Game Settings

!setfishcooldown <time> - Set fishing cooldown
!addfish <name> <min_size> <max_size> <min_weight> <max_weight> - Add fish species

Environment Variables

Required in .env file:

DISCORD_TOKEN=your_bot_token
OPENAI_API_KEY=your_openai_key

Best Practices

Backup configs before making changes
Test changes in a development server first
Monitor token usage to control costs
Set appropriate retention for chat threads
Configure role restrictions for public servers

Generated from repository docs. Last build: 2025-09-12 11:03 UTC