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

# config.yml

ManticRods Configuration Files

{% code lineNumbers="true" %}

```yaml

# Put your license key here, if you don't have one, you can get one at https://discord.mantic.dev/
license: XXXX-XXXX-XXXX-XXXX

# The default balance of a player.
starting-shard-balance: 1000.0
# This is the amount of shards you get per fish caught. If you want to disable this, set it to 0.
# Please be aware that a 'shard finder' enchant in 'enchants.json' may affect the amount received by the player.
shards-per-fish: 0.0
# Available types are RAW (172123), COMMA (172,123), and SHORTENED (172.12k)
shard-balance-format: COMMA
# Whether or not the Shard Shop is enabled
enable-shop: true

# (This is for use as the plugins local currency)
# Mantic Options (case-sensitive): ManticHoes, ManticRods, MiningEconomy or ManticSwords
# Other Options (case-sensitive): Vault (or Vault:X (replace X with the economy name)) or EcoBits:X (replace X with the economy name) or SuperMobCoins
# If the plugin cannot be found it will default to the internal economy.
economy-provider: ManticRods
upgrades-economy-provider: ManticRods
shop-economy-provider: ManticRods
# (This is for use as the external 'money' currency
# Options (case-sensitive): Vault (or Vault:X (replace X with the economy name)) or EcoBits:X (replace X with the economy name) or SuperMobCoins
money-provider: Vault

# This means that rod levels will be based on the player, not the rod.
player-based-rod-levels: true

# If false, it will open upgrades directly.
open-main-menu-on-click: true

custom-catch-sound: false
custom-catch-sound-name: FOX_EAT

use-menus-for-leaderboards: true
factions-kore-outpost-sell-booster: false
factions-kore-task-update-every-x-seconds: 10

# Whether or not to automatically send captcha's to players
enable-captcha: true

# This is the chance of a captcha happening catching rods (The higher the number the lower the chance, currently 1/10000)
captcha-chance: 10000
# This is the duration in ticks (20 ticks per seconds) that the player cannot use the tool
captcha-block-ticks: 1200
# This is the max duration a player can take to solve the captcha
captcha-timeout-ticks: 1200
# If false, captcha will be random blocks/items
do-maths-captcha: false
# If true, players will be kicked if they fail the captcha
kick-on-captcha-fail: false

# This is how often the money from rods is sold and deposited to players in Seconds
sell-timer: 15
send-sell-chat-messages: false
send-sell-action-bar-messages: true
payout-summary:
  enabled: true
  send-message: true
  send-action-bar: true
  interval-seconds: 60
# Only these fish will be tracked on the leaderboard, use 'ALL' for all fish to be tracked
# Fish: 'COD', 'SALMON', 'TROPICAL_FISH', 'PUFFERFISH'
fish-to-track-on-leaderboard:
- ALL

default-starting-enchant-level: 1
default-max-enchant-level: 15

should-give-default-exp: true
item-drop-confirmation: true
prevent-item-drop: false
parse-messages-with-placeholder-api: false

# When a player joins for the first time, they will be given a rod with the following settings.
# If you want to disable this, set 'enabled' to false.
# If you want to change the rod type, set 'rod-type' to the name of the rod type. (You can find the sword types in 'rods.yml')
# If you want to change the enchant levels, set 'enchant-levels' to the enchant levels you want.
# If not set or found, it will default a random one.
# Format: 'enchant1:level,enchant2:level,enchant3:level'
# Example: 'tokenfinder:5,spawnerfinder:3,autosell:1'
first-join-rod:
  enabled: true
  rod-type: default
  enchants: ''

# If false, it will be dropped on the ground.
should-drops-be-given-to-player: true

# This is in ticks (20 ticks per second), 15 ticks being the lowest
default-catch-time: 400

# This removes the default drop as a reward for catching a fish.
# This is useful if you want to only use our custom drops.
remove-default-drop: true
# This means that the drop booster will apply to the default drops (if enabled) as well as the custom drops.
apply-drop-booster-to-default-drops: true

# If true, players cannot use anvils to combine items with the tool.
block-anvil-usage: true

# If an enchant has only one level, such as autosell and this is enabled the 'unlocked' message will replace number in the lore for that enchant when it's been upgrade, the opposite goes for 'locked'
single-level-symbol:
  enabled: true
  unlocked: '&a✓'
  locked: '&c✕'

# This is the list of zones where the rod can/cannot be used.
# Corner 1 is the bottom left corner and corner 2 is the top right corner.
# The player must be in the location for it to work.
#  
#   corner-one-x: 0 // X coordinate of the first corner
#   corner-one-y: 0 // Y coordinate of the first corner
#   corner-one-z: 0 // Z coordinate of the first corner
#   corner-two-x: 0 // X coordinate of the second corner
#   corner-two-y: 0 // Y coordinate of the second corner
#   corner-two-z: 0 // Z coordinate of the second corner
#   world-name: world // The name of the world
#   allowed: true // Whether the rod is allowed (or denied) in this zone
#   tool-types: // The tool types this applies to, founds in rods.yml
#   - default
#   - darkzone
usage-zones:
- corner-one-x: 0
  corner-one-y: 0
  corner-one-z: 0
  corner-two-x: 0
  corner-two-y: 0
  corner-two-z: 0
  world-name: world
  allowed: true
  tool-types: []

# Options: RIGHT_CLICK, LEFT_CLICK, SHIFT
# (RIGHT_CLICK by itself won't work as it will stop the player from being able to use the rod)
combinations:
  menu:
  - LEFT_CLICK
  - SHIFT
  autosell-toggle:
  - RIGHT_CLICK
  - SHIFT

# Options: LOWEST, LOW, NORMAL, HIGH, HIGHEST
# If you are looking to use another plugin to handle drops, you may wish to change this option.
catch-event-priority: HIGH

debug: false

```

{% endcode %}