# Config.yml Tutorial

```yaml
# In which worlds turrets shouldn't work
blacklisted_worlds:
- minigames
- lobby

# When enabled, players will need the permission complexturrets.use.<turret>
# to place and use a turret.
per_turret_permissions: false

# Max amount of turrets a player can place. You can give the
# complexturrets.limit.<limit> permission to increase the limit.
# Set this option to false if you want players to have no limits.
turret_limit_permissions:
  enabled: true
  default_limit: 1
  
# Minimum distance between each turret in blocks.
min_distance_between_own_turrets: 3
min_distance_between_other_turrets: 20

# Should players receive the turrets (and ammo) when removing it
# from the turret inventory?
receive_turret_on_remove: true

# When enabled, turret blocks will store their properties when 
# they are removed (whitelist, attack options and priority)
save_properties_on_remove: false

# When enabled, players will need to take the ammo from the turret before 
# removing it. If disabled, this could lead to ammo droping in the ground 
# and causing lag.
no_ammo_required_to_remove: true

# Should the turret item (and ammo) be droped when the turret
# is destroyed from external causes?
# I suggest you set the ammo drop to false or it can cause massive
# amounts of lag when the turret has a lot of ammo.
drop_turret_on_destroy: true
drop_ammo_on_destroy: false

# When enabled, turret blocks will store their properties when 
# they are destroyed from external causes.
save_properties_on_destroy: false

# When enabled, if the player is not online, the turret won't shoot.
enable_turrets_only_when_owner_is_online: false

# When this option is enabled, players will only be able to place 
# turrets inside their own regions and lands. OP players bypass this.
# Currently compatible with:
# WORLDGUARD, KINGDOMS, TOWNY, LANDS, FACTIONSUUID, KONQUEST
place_turrets_only_on_own_region: false

# Should hit holograms be enabled? If you are experiencing any lag using
# the plugin you should consider disabling this option.
hit_holograms: true

# Should information holograms above turrets be enabled?
information_holograms: true

# When this option is enabled, information holograms will be visible
# to all players, even when not looking at the turret.
information_holograms_always_visible: false

# After how many ticks will the hit holograms disappear.
# 20 ticks = 1 second
hit_holograms_disappear_time: 15

# When this option is enabled, ComplexTurrets will check for allies
# compatibilities with other plugins, like Factions, Towny, Clans...
ally_protection: true

# Click type (LEFT or RIGHT) to remove whitelisted players from turrets GUI.
remove_player_from_whitelist_click_type: RIGHT

# If enabled, invisible players will not be targeted by turrets
ignore_damage_to_invisible_players: true

# Fixes some issues detecting blocks, allowing to calculate
# collisions more precisely
# This option only works on 1.13+, I suggest you enable it!
walls_better_check: false

# Prevent entities (not players) drops when they are killed by a turret.
block_mob_drop_on_turret_kill: false

# Defines the default ammunition limit for turrets. You must use a multiple 
# of 576 (576, 1152, 1728, etc... Each inventory row will have 576 ammo items).
# You can change this value in each turret upgrade.
default_max_ammo: 2880

# When this option is enabled, arrows will be instantly removed when they 
# hit turrets. I recommend you leave it enabled to fix an important exploit 
# that allow players to destroy turrets with an arrow bug.
remove_arrows_on_turret_damage: true

# When enabled, turret particles will be displayed regardless of the player 
# distance from the turret.
force_particles: false

# This option is useful when you don't want players to protect turrets
# surrounding them with blocks. This value is the minimum distance a
# player can place blocks near the turret.
# WARNING: This could generate lag, if so, set it to 0.
turret_blocks_nearby_min_distance: 1

# Multiple Sounds
# 1.16 Sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
# 1.8 Sounds: https://github.com/Attano/Spigot-1.8/blob/master/org/bukkit/Sound.java
# Use this format: <sound>;<volume>;<pitch>
# If you don't want a sound to be played use: "none"
# You can also use resource pack sounds.
# Sound to play when a turret is destroyed by external sources.
turret_destroy_sound: "BLOCK_ANCIENT_DEBRIS_BREAK;10;0.5"
# Sound to play when upgrading a turret.
turret_upgrade_sound: "ENTITY_PLAYER_LEVELUP;10;1.5"

# This option only works with turrets that have the 'health' attribute.
# This option defines how much damage a turret will take from different
# sources.
# Format: <min_damage>-<max_damage>
# Set it to 0-0 if you don't want a certain source to do damage to turrets.
turret_damage:
  # You can use the /ct setdamage <min_damage> <max_damage> command
  # to set a custom turret damage to a unique bow or crossbow.
  bow: 10-15
  crossbow: 15-20
  
  # Here you can set the amount of damage from different kind of
  # explosions: TNT, CREEPER, WIND_CHARGE, WITHER_SKULL, END_CRYSTAL,
  # FIREBALL, SMALL_FIREBALL, DRAGON_FIREBALL
  # Use OTHERS to set a default damage for all others unspecified explosions.
  entity_explosion:
    TNT: 150-200
    CREEPER: 30-50
    WIND_CHARGE: 5-15
    OTHERS: 0-0
  
# This option defines if turrets will damage player armor and reduce
# its durability.
armor_durability:
  # If this option should be enabled or not.
  enabled: true
  
  # The minimum amount of damage a turret must do to damage
  # player armor.
  # IMPORTANT: This option is ignored for shields, so if the player is
  # blocking with a shield, this item will take damage anyways.
  min_damage_to_reduce_durability: 1  
  
  # When this option is enabled, every hit from the turret will reduce 
  # the durability ONLY from a random armor piece of the player.
  reduce_durability_one_armor_slot_per_hit: false
  
# This option defines the format of the %health_bar% variable you can use
# in turret holograms and the actionBarTurretDamageMessage message.
health_bar_placeholder:
  filled_symbol: "&a|"
  empty_symbol: "&c|"
  amount: 20
  
# This option defines the time (in seconds) to recover turrets health.
health_recovery_time: 7

# The plugin constantly checks if a turret is destroyed by unknown 
# reasons (WorldEdit for example). Here you can define the time
# (in seconds) of this repetitive check task. 
turrets_global_check_time: 5

# This option defines the time (in seconds) to automatically save player data.
data_auto_save_time: 600

# When using WorldGuard, here you can define regions where turrets will
# be able to be placed regarding block protection.
place_turret_whitelisted_worldguard_regions:
  - battlefield1

# Defines if every message/text in the plugin should use the MiniMessage format.
# Only works on Paper 1.19.4+.
use_minimessage: false

# These items can be used in the inventory.yml file
# Item properties are different depending on the item itself.
# You can add custom_model_data: <value> on every item.
items:

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajneb97.gitbook.io/complexturrets/config.yml-tutorial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.