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

# Configuration Files (config.yml)

```
# ==================================================
#          License & Integration Settings         
# ==================================================
# 1. Plugin License Key:
#    Your unique license key from https://discord.mantic.dev.
#    This key is absolutely REQUIRED for the plugin to activate and receive updates.
#    Please replace 'XXXX-XXXX-XXXX-XXXX' with your actual license key.
licenseKey: "XXXX-XXXX-XXXX-XXXX"

# 
# ==================================================
#             Command Configuration              
# ==================================================
# 1. Main Command Label:
#    The primary command used to access Destroy The Core functionality (e.g., /destroythecore).
#    A server RESTART is required for any changes to the command label or aliases to take effect.
mainCommandLabel: "destroythecore"

# 
# 2. Command Aliases:
#    Alternative, shorter command names for convenience.
#    Example: If set to ['destroycore', 'dcore'], players can use /destroycore or /dcore.
commandAliases: 
  - "destroycore"
  - "dcore"
  - "dtc"
  - "ctf"
  - "capturetheflag"

# 
# ==================================================
#           Database Configuration              
# ==================================================
# 1. Storage Type:
#    Defines where gift card data is stored.
#    - JSON: Local file storage (Recommended for small, single-server setups).
#    - SQLITE: Local lightweight database file.
#    - MYSQL: External, high-performance database server (Recommended for large networks).
#    
#    ⚠ CRITICAL WARNING: A server RESTART is required when changing the database type.
# 
databaseType: "JSON"

# MySQL Connection: The full address (IP/hostname) and port. Only relevant if databaseType is set to MYSQL.
mysqlIp: "172.18.0.1:3306"

# MySQL Connection: The username for the MySQL database connection.
mysqlUsername: ""

# MySQL Connection: The password for the MySQL database user.
mysqlPassword: ""

# MySQL Connection: The name of the specific database to be used (it must already exist on your server).
mysqlDatabaseName: ""

# MySQL Connection: Set to 'true' to attempt connection using SSL/TLS encryption. Recommended for production environments.
useSsl: false

# 
# ==================================================
#             Permission Settings                
# ==================================================
# Permission nodes control access to specific Destroy The Core commands. Players require the respective node to use the command.
permissionBasecommand: "mantic.dtc.basecommand"

# Permission required for /destroythecore reload
permissionReload: "mantic.dtc.reload"

# Permission required for /destroythecore leaderboard
permissionLeaderboaard: "mantic.dtc.leaderboaard"

# Permission required for /destroythecore start
permissionStart: "mantic.dtc.start"

# Permission required for /destroythecore stop
permissionStop: "mantic.dtc.stop"

# Permission required for /destroythecore wand & /destroythecore create
permissionSetup: "mantic.dtc.setup"

# Permission required for /destroythecore teleport
permissionTeleport: "mantic.dtc.teleport"

# Permission required for /destroythecore information
permissionInformation: "mantic.dtc.information"

# Permission required for /destroythecore schedule
permissionSchedule: "mantic.dtc.schedule"

# Permission required for /destroythecore list
permissionList: "mantic.dtc.list"

# Permission required for /destroythecore delete
permissionDelete: "mantic.dtc.delete"

# Permission required for /destroythecore reset
permissionReset: "mantic.dtc.reset"

# Permission required for /destroythecore stats
permissionStats: "mantic.dtc.stats"

# 
# ==================================================
#                Sound Settings                   
# ==================================================
# Defines the sound effects played to players when commands are used or specific actions occur.
# Sound names must match the Spigot/Bukkit Sound Enum for your target Minecraft version (e.g., 1.8).
# To disable a sound, simply leave the corresponding value empty ('').
commandSuccessSound: "SUCCESSFUL_HIT"
commandErrorSound: "VILLAGER_NO"
coreBreakSound: "DIG_STONE"
coreWinSound: "LEVEL_UP"

# 
# ==================================================
#                 Schedule Settings                 
# ==================================================
# The timezone used for all scheduled events.
# Valid examples: 'America/New_York', 'Europe/London', 'UTC'.
# 
# Note: If an invalid ID is provided, it will fallback
# to the system default timezone.
timezone: "Europe/London"

#
# ==================================================
#           Progress Bar Configuration           
# ==================================================
# These settings control the look of the %dtc_progress_bar_<core>% placeholder.
# You can change the symbol used, the colors, and the total length of the bar.
progressBarSymbol: "■"
progressBarCompletedColor: "&a"
progressBarUncompletedColor: "&c"
progressBarLength: 10

# 
# ==================================================
#           Placeholder Configuration            
# ==================================================
# These values are displayed when a placeholder has no data to return.
# For example: if there is no next event, or nobody is on the leaderboard.
placeholderLeaderboardEmptyName: "Nobody"
placeholderLeaderboardEmptyWins: "0"
placeholderNextEventEmptyName: "None"
placeholderNextEventEmptyTime: "N/A"

# 
# ==================================================
#            General Messages                    
# ==================================================
# Customize messages displayed to players in-game. Supports Minecraft color codes (e.g., &a).
msgPlayerOnly: "&3&lDTC &8➸ &cYou can only use this command as a player!"
msgInvalidNumber: "&3&lDTC &8➸ &cYou have entered an invalid number!"
msgInvalidDtc: "&3&lDTC &8➸ &cYou have entered an invalid destroy the core name!"
msgAlreadyDtc: "&3&lDTC &8➸ &cYou have entered an already created destroy the core name!"
msgDtcUsageStart: "&3&lDTC &8➸ &7Usage: &e/destroythecore start [name]"
msgDtcUsageStop: "&3&lDTC &8➸ &7Usage: &e/destroythecore stop [name]"
msgDtcUsageCreate: "&3&lDTC &8➸ &7Usage: &e/destroythecore create [name] [breaks]"
msgDtcUsageTeleport: "&3&lDTC &8➸ &7Usage: &e/destroythecore teleport [name]"
msgDtcUsageInformation: "&3&lDTC &8➸ &7Usage: &e/destroythecore info [name]"
msgDtcUsageDelete: "&3&lDTC &8➸ &7Usage: &e/destroythecore delete [name]"
msgDtcUsageReset: "&3&lDTC &8➸ &7Usage: &e/destroythecore reset [player]"
msgReloaded: "&3&lDTC &8➸ &aSuccessfully reloaded mantic destroy the core!"
msgUseWand: "&3&lDTC &8➸ &7Use &3/dtc wand&7 and click the block to register location."
msgAdminSetup: "&3&lDTC &8➸ &cConfiguration incomplete for &f{display}&c. Please set the location and material."
msgDtcAlreadyActive: "&3&lDTC &8➸ &3{display}&7 DTC is already &aactive&7!"
msgDtcNotActive: "&3&lDTC &8➸ &3{display}&7 DTC is not currently &aactive&7 to be able to stop!"
msgDtcScheduleEmpty: " &cNo upcoming scheduled events."
msgDtcScheduleFormat: " &3{display} &8➸ &f{time} &7({countdown})"
msgDtcDeleted: "&3&lDTC &8➸ &7Successfully deleted and wiped the core &c{display}&7."
msgDtcReset: "&3&lDTC &8➸ &7Successfully wiped DTC data for &e{player}&7."
msgDtcStarted: 
  - "&7"
  - "{display} &3&lDTC has begun!"
  - "&7Location: &3{x}, {y}, {z}, {world}"
  - "&7"
msgDtcEnded: 
  - "&3&lDTC &8➸ {display} &7has been forced ended by &c{player}&7!"
msgDtcInformation: 
  - "&7&m------[&3&l{name}'s DTC Info &7&m]------"
  - " &3Location: &f{x}, {y}, {z}, {world}"
  - " &3Health: &f{health}/{max}"
  - "&7"
  - " &3Material: &f{material}"
  - "&7"
msgDtcSchedule: 
  - "&7&m------[&3&l Scheduled DTCs &7&m]------"
  - "{schedules}"
  - "&7"
msgDtcListHeader: 
  - "&7&m------[&3&l Registered Cores &7&m]------"
msgDtcListFormat: " &8➸ &3{name} &7| Active: {active} &7| Loc: &f{location}"
msgDtcStats: 
  - "&7&m------[&3&l {player}'s Stats &7&m]------"
  - " &3Total Wins: &f{wins}"
  - "&7"
msgDTCCreated: "&3&lDTC &8➸ &7You have &asuccessfully &7created a dtc named &3{display}&7!"
msgLocationSelected: "&3&lDTC &8➸ &7You have &asuccessfully &7selected location!"
msgCoreBroke: "&3&lDTC &8➸ &f{breaks}/{max} - {display}"
msgCoreEndedWin: 
  - "&3&lDTC &8➸ &a&l{player}&7 has won the &b{display} DTC&7!"
```
