Rawon

rawon

Configuration

Configure Rawon to fit your needs with these settings.

⚡ Essential Settings

These are the minimum settings required to run the bot. Just fill in your Discord token and you're ready to go!

DISCORD_TOKENRequired

Your Discord bot token from the Discord Developer Portal. This is the only REQUIRED setting!

MAIN_PREFIXDefault: !

Main command prefix. Example: ! means you type !play to play music

MAIN_SERVEROptional

Your main server ID for faster slash command registration. Leave empty for global commands (takes up to 1 hour to update)

LOCALEDefault: en-US

Bot language - choose your preferred language for bot responses

en-US, es-ES, fr-FR, id-ID, zh-CN, zh-TW, uk-UA, vi-VN, pt-BR, ru-RU, ja-JP, tr-TR

Spotify APIOptional

For Spotify support, get your credentials from developer.spotify.com/dashboard and set SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET

Example .env

# Essential configuration (only DISCORD_TOKEN is required!)
DISCORD_TOKEN="your-discord-bot-token"
MAIN_PREFIX="!"
MAIN_SERVER=""
LOCALE="en-US"

# Spotify (optional - for Spotify links support)
SPOTIFY_CLIENT_ID=""
SPOTIFY_CLIENT_SECRET=""

🎨 Optional Settings

Customize Rawon's behavior and appearance. All these are optional - the bot works fine without them!

ALT_PREFIXDefault: {mention}

Alternative prefixes (comma-separated). Use {mention} to allow @bot as a prefix. Example: {mention},r! allows both @Rawon play and r!play

ACTIVITIES

Bot status activities shown under the bot name (comma-separated). Available placeholders: {prefix}, {userCount}, {textChannelCount}, {serverCount}, {playingCount}, {username}

ACTIVITY_TYPES

Activity types for each activity above (comma-separated). Must match the number of ACTIVITIES

PLAYING, WATCHING, LISTENING, COMPETING

EMBED_COLORDefault: 22C9FF

Embed color in hex (without #). This color appears on all bot message embeds

EmojisDefault: ✅ / ❌

Customize success (YES_EMOJI) and failure (NO_EMOJI) emojis shown in bot responses

MUSIC_SELECTION_TYPEDefault: message

How search results are displayed. message shows numbered list, selectmenu shows dropdown menu

message, selectmenu

ENABLE_AUDIO_CACHEDefault: no

[EXPERIMENTAL] Cache downloaded audio for faster repeated playback. Uses more disk space but speeds up frequently played songs

REQUEST_CHANNEL_SPLASH

Custom image URL for the request channel player embed

Default: https://cdn.stegripe.org/images/rawon_splash.png

Example optional.env

# Alternative prefixes
ALT_PREFIX="{mention}"

# Bot activities
ACTIVITIES="My default prefix is {prefix}, music with {userCount} users"
ACTIVITY_TYPES="PLAYING, LISTENING"

# Customization
EMBED_COLOR="22C9FF"
YES_EMOJI="✅"
NO_EMOJI="❌"
REQUEST_CHANNEL_SPLASH=""

# Other settings
MUSIC_SELECTION_TYPE="message"
ENABLE_AUDIO_CACHE="no"

🛠️ Developer Settings

Advanced settings for bot developers. Only use if you know what you're doing!

DEVSOptional

Bot developer IDs (comma-separated). Developers can access special commands

ENABLE_PREFIXDefault: yes

Enable/disable prefix commands (like !play). Useful if you only want slash commands

yes, no

ENABLE_SLASH_COMMANDDefault: yes

Enable/disable slash commands (like /play). Useful if you only want prefix commands

yes, no

DEBUG_MODEDefault: no

Enable debug logging for troubleshooting. Shows detailed logs in console

yes, no

Example dev.env

# Developer configuration (for bot developers)
DEVS=""
ENABLE_PREFIX="yes"
ENABLE_SLASH_COMMAND="yes"
NODE_ENV="production"
DEBUG_MODE="no"