> For the complete documentation index, see [llms.txt](https://nidzo-docs.gitbook.io/setupsbot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nidzo-docs.gitbook.io/setupsbot/configuration/config.yml.md).

# config.yml

Configuration File is perfect place to start bot's customisation. In this File you can edit nearly 98% of Bot, starting with embeds, messages to important informations such as Bot Token & Channel/Role IDs. Except this Configuration File there is another one called `commands.yml`, more about that one on next page.

Every Field in Configuration File have comment above them stating what are they used for, some examples & rules so it makes your editing much, much easier and faster.

## File

So, let's see the file!

```
# ________________________________________________
#
#        CHAMPION SETUPS BOT CONFIGURATION FILE
#
# Here you can customise main Bot Configurations
# For Server Templates visit configs/templates/
#
# ________________________________________________

version: "1.0.3"

# ____________________________
#
# GENERAL OPTIONS
# ____________________________

general:
  # Bot Name
  name: "Champion Setups"
  # Bot's Prefix
  prefix: "*"
  # Bot Token obtained from Discord Developer Portal
  token: ""
  # ID of User who is gonna have access to EVAL Command
  # Example:
  #
  # eval:
  #   - "1234"
  #
  # If you don't want any, just change to eval: []
  eval: []
  # Whether Slash Commands are enabled
  slash: true

# ____________________________
#
# SETUP CONFIGURATION
# ____________________________ 

setup:
  # Placeholder for Create Select Menu
  create_placeholder: "Choose option to Create from Drop down"
  # Placeholder for Create Select Menu
  delete_placeholder: "Choose option to Delete from Drop down"
  # Format for Templates List
  # Valid Placeholders <name>, <author>, <channels>, <roles>, <emojis> (Number of them)
  list_format: "> `<name>`\n"

save:
  # Whether to Save Server Icon
  icon: true
  # Whether to Save Server Banner
  banner: true
  # Whether to Save Server Verification Level
  verifyLevel: true

# ____________________________
#
# ROLES CONFIGURATION
# ____________________________

roles:
  # Roles which can bypass specific stuff
  # Format is same as for above roles
  bypass:
    # Roles which can bypass Command Cooldown
    cooldown: []
    # Roles which can bypass Command Permissions
    permission: [] 

# ____________________________
#
# CUSTOM STATUS CONFIGURATION
# ____________________________

status:
  # Can be PLAYING, LISTENING, WATCHING AND COMPETING
  type: "WATCHING"
  # Random Messages in Custom Status, changing every x minutes/hours 
  change_random: true
  # Interval to Change Custom Status (in seconds)
  interval: 180 # 3 minutes, don't go below that
  # Message which is displayed in Custom Status if change_random = false
  message: "Champion Setups Bot"
  # List of Custom Status's if change_random = true
  # Valid Placeholders: <members>, <channels>
  messages:
    - "<members> total members"
    - "<version> | *help"

# ____________________________
#
# EMOJIS CONFIGURATION
# ____________________________
  
emojis:
  # Create All Channels/Roles/Emojis Emoji
  create_all: "💻"
  # Create Channels Emoji
  create_channels: "🏠"
  # Create Roles Emoji
  create_roles: "🎭"
  # Create Emojis Emoji
  create_emojis: "😃"
  # Delete All Channels/Roles/Emojis Emoji
  delete_all: "💻"
  # Delete Channels Emoji
  delete_channels: "🏠"
  # Delete Roles Emoji
  delete_roles: "🎭"
  # Delete Emojis Emoji
  delete_emojis: "😃"
```