Config.yml Tutorial

# 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"
# 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

# 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: