Skip to content

Configuration

BrrainzBot stores two local files:

  • config.json for normal settings
  • secrets.json for sensitive values

The setup wizard writes both for you.

What Lives in config.json

  • installation name
  • GitHub repository used for self-update
  • AI endpoint base URL and model
  • per-server IDs
  • per-server active state and spam toggle
  • onboarding text and limits
  • spam cleanup settings

What Lives in secrets.json

  • Discord bot token
  • AI API key

The Settings You Will Touch Most

./brrainzbot setup
./brrainzbot add
./brrainzbot status
./brrainzbot doctor
./brrainzbot print-config

Per-Server Settings

Each server has its own:

  • server ID
  • active on or off state
  • welcome channel ID
  • honeypot channel ID when spam cleanup is on
  • MEMBER role ID
  • owner user ID
  • server topic prompt
  • spam cleanup on or off

Use one real MEMBER role:

  • @everyone is the baseline
  • MEMBER grants normal posting
  • people without MEMBER stay in the welcome path until approval

This is the bot's core model. There is no second newcomer role anymore.

On the first setup pass, MEMBER can be left blank and created right after setup with:

./brrainzbot create-member <serverId>

If your server already uses @everyone for normal posting, use:

./brrainzbot create-member <serverId>
./brrainzbot set-members <serverId>

Then move normal member permissions from @everyone to MEMBER.

Good Prompting for the Onboarding AI

Your server topic prompt should say:

  • who the server is for
  • what legitimate users usually want
  • what obvious wrong-server arrivals look like
  • what obvious spam should be rejected

Keep it short and concrete.

Safe Defaults

  • servers start out off
  • 3 attempts
  • 2 minute cooldown
  • 24 hour stale timeout
  • owner DMs only for uncertain cases and technical failures