factionsuuid-config.yml

# FactionsUUID by drtshock
# Report issues https://github.com/drtshock/Factions/issues?state=open
# Live support http://factions-support.cf
# Website https://www.spigotmc.org/resources/factionsuuid.1035/

# Made with love <3

# Debug
# Turn this on if you are having issues with something and working on resolving them.
# This will spam your console with information that is useful if you know how to read the source.
# It's suggested that you only turn this on at the direction of a developer.
debug: false

# Prevent find factions exploit
# This will help limit how many times a player can be sent a map of factions.
# Set this to the cooldown you want, in milliseconds, for a map to be shown to a player.
# If you want to log when a player violates this (only happens on chunk enter so it shouldn't be too spammy),
#   set log to true and it will be logged to console as "player tried to show a faction map too soon and triggered exploit blocker."
findfactionsexploit:
  cooldown: 2000 # in milliseconds. 2000 = 2 seconds.
  log: false


# Essentials Hook
# Should we delete player homes that they set via Essentials when they leave a Faction if they have homes set in that
# Faction's territory?
delete-ess-homes: true

### Hard Core Settings ###
# Many of the features that are / are to come in this section have been requested by
#   people in relation to HCF servers. All settings are set to the normal Factions
#   behavior by default.

# Default Relation allows you to change the default relation for Factions.
# Example usage would be so people can't leave then make a new Faction while Raiding
#   in order to be able to execute commands if the default relation is neutral.
# This has always been neutral.
default-relation: "neutral"

# Portal Creation
# Do you want to limit portal creation?
portals:
  limit: false # will disable the below check if set to false

  # What should the minimum relation be to create a portal in territory?
  # Goes in the order of: ENEMY, NEUTRAL, ALLY, MEMBER.
  # Minimum relation allows that and all listed to the right to create portals.
  # Example: put ALLY to allow ALLY and MEMBER to be able to create portals.
  minimum-relation: MEMBER # If typed incorrectly, defaults to NEUTRAL.

### Hard Core Settings ###

# Warps
# What should be the max amount of warps that a Faction can set?
max-warps: 5

# This is the cost section for warps.
# It will charge them each time the command would be successful. (won't charge on erroneous /f warp attempts).
# You can use decimal places here.
# If enabled is set to false, it will ignore the values.
warp-cost:
  enabled: false
  setwarp: 5
  delwarp: 5
  warp: 5

# Faction Fly
f-fly:
  # Enable Faction Fly:
  enable: true
  # If a player leaves fly (out of territory or took damage)
  # how long should they not take fall damage for?
  # Set to 0 to have them always take fall damage.
  falldamage-cooldown: 3
  # From how far away a player can disable another's flight by being enemy
  # Set to 0 if wanted disable
  # Note: Will produce lag at higher numbers
  enemy-radius: 7
  # Frequency Check
  # Note: Use 0 to disable
  radius-check: 1
  # Should we disable flight if the player has suffered generic damage
  disable-generic-damage: false
  # Trails show below the players foot when flying, faction.fly.trails
  # Players can enable them with /f trail on/off
  # Players can also set which effect to show /f trail effect <particle> only if they have faction.fly.trails.<particle>
  trails:
    # Speed of the particles
    speed: 0.02
    # Amount spawned
    amount: 20
    # How often should we spawn these particles?
    # 0 disables this completely
    spawn-rate: 0.2

# Faction Near
f-near:
  # Making this radius larger increases lag, do so at your own risk
  # If on a high radius it is advised to add a cooldown to the command
  # Also using {distance} placeholder in the lang would cause more lag on a bigger radius
  radius: 20

# Pistons
# Should we disable pistons in Faction territory? This will prevent people from doing something like:
# http://i.gyazo.com/6a1a31222e58a5d60ff341c13f6a8404.gif
disable-pistons-in-territory: false

# Should we send titles when players enter Factions?
# This is the same as finfo.titles and can be shown in conjunction with scoreboard and chat if necessary.
# If you only want to show titles when entering territory,
# leave this true and set scoreboard.finfo.titles and scoreboard.alsosendchat to false.
enter-titles:
  enabled: true
  fade-in: 10
  stay: 70
  fade-out: 20
  also-show-chat: false

# /f seechunk options
# Get a list of particle effects here:
# https://github.com/DarkBlade12/ParticleEffect/blob/master/src/main/java/com/darkblade12/particleeffect/ParticleEffect.java
see-chunk:
  # If disabled, it will use fake blocks like before (can cause client side lag)
  particles: true
  particle: "REDSTONE"
  # If the above particle is compatible with coloring we will color
  # it based on the current chunk's faction
  relational-color: true
  # How often should we update the particles to the current player's location?
  particle-update-time: 0.75

# ToolTips
# This section is to configure tooltips for things like /f list
tooltips:

  # List
  # This shows up when someone does /f list for the top factions.
  # It will not sure up for factionless of course, just actual factions.
  # You can use color codes here.
  list:
    - "&6Leader: &f{leader}"
    - "&6Claimed: &f{chunks}"
    - "&6Raidable: &f{raidable}"
    - "&6Warps: &f{warps}"
    - "&6Power: &f{power}/{maxPower}"
    - "&6Members: &f{online}/{members}"

  # Show
  # This shows up when someone does /f show.
  # It adds tooltips to each player in the list here, nothing else.
  # {group} will show the players primary group if you have vault installed.
  # {balance} will show their balance if you have vault installed.
  # {lastSeen} will show human readable info on when the player was last seen, or online.
  show:
    - "&6Last Seen: &f{lastSeen}"
    - "&6Power: &f{power}"
    - "&6Rank: &f{group}"
    - "&6Balance: &a${balance}"

# Configuration section for Scoreboards
# This will allow you to completely customize how your scoreboards look.
# Make sure that no lines are duplicates of each other otherwise only the first will display.
# Use &0-9a-f for colors and include messages in "quotes"
scoreboard:

# send faction change message as well when scoreboard is up?
  also-send-chat: true
# How long do we want scoreboards to stay if set temporarily.
  expiration: 7

# FInfo scoreboard is displayed when a player walks into a new Faction's territory.
# Scoreboard disappears after <expiration> seconds.
# Things to be replaced in this:
# {power} - faction's power. {chunks} - total claimed chunks. {members} - total members.
# {online} - online members. {leader} - faction's leader. {open} - shows either true or false if open.
# {raidable} - true if the faction can be claimed over, otherwise false.
# {warps} - the number of warps that a faction has set.
# The title of the scoreboard will be the Faction's tag and colored according to the relation with the player's Faction.
# Commenting this section out will cause the info to appear in chat as the plugin originally did.
  finfo-enabled: true # Default to false to keep original functionality.

  # SUPPORTS PLACEHOLDERS
  finfo:
    - "&6Pow: {power}"
    - "&3Mem: {online}/{members}"
    - "&4Ldr: {leader}"
    - "&bTer: {chunks}"
    - "&bRai: {raidable}"

# Default board that will always show up if a player wants it to.
# This can show any arbitrary text or you can use a lot of variables to replace things.
# Replace {name} - player's name. {faction} - player's faction title, factionless if none.
# {totalOnline} - total players on the server. {balance} - player's balance.
# {maxPower} - player's max power.
# {powerBoost} - player's powerboost.

  default-enabled: true # Default to false to keep original functionality.
  default-title: "Faction" # Can use any of the values from above but this won't update once it's set (so don't set {balance}).
  default-update-interval: 2 # in seconds.

  # This will show faction prefixes colored based on relation on nametags and in the tab.
  #   The scoreboard needs to be enabled for this to work.
  default-prefixes: true

# SUPPORTS PLACEHOLDERS
  default:
    - "&6F {faction}"
    - "&3P {power}"
    - "&aB ${balance}"

  factionless-enabled: true
  factionless:
    - "Make a new Faction"
    - "Use /f create"

# Configration section for warmups.
# Warmup times are in seconds - if a value of 0 is set, there is no warmup.
warmups:
  # Delay for /f home
  f-home: 10
  # Delay for /f warp
  f-warp: 10
  # Delay for /f fly
  f-fly: 2

######################################################
#################### HCF Features ####################
######################################################
# These features were requested as part of Hardcore Factions or something.
# All of them are disabled by default.

# Max Relation Types
# Limits factions to having a max number of each relation.
# Setting to 0 means none allowed. -1 for disabled.
# This will have no effect on default or existing relations, only when relations are changed.
# It is advised that you set the default relation to -1 so they can always go back to that.
# Otherwise Factions could be stuck with not being able to unenemy other Factions.
max-relations:
  enabled: false
  ally: 10
  truce: 10
  neutral: -1
  enemy: 10

# WorldBorder support
# This is for Minecraft's built-in command. To get your current border: /minecraft:worldborder get
# A buffer of 0 means faction claims can go right up to the border of the world.
# The buffer is in chunks, so 1 as a buffer means an entire chunk of buffer between
# the border of the world and what can be claimed to factions
world-border:
  buffer: 2

# Raids
# Allow a faction to be raided if they have more land than power.
# This will make claimed territory lose all protections
#   allowing factions to open chests, break blocks, etc. if they
#   have claimed chunks >= power.
hcf:
  raidable: true

  # DTR (death til raidable) will be in /f show with [raidable] if enabled. Configure the message in the lang.yml
  dtr: true

  # Should we allow Factions to over claim if they are raidable (above has no effect on this)?
  # This has always been true, allowing factions to over claim others.
  allow-overclaim: true

  # Power Freeze
  # After a player dies, how long should the faction not be able to regen power?
  # This resets on each death but does not accumulate.
  # Set to 0 for no freeze. Time is in seconds.
  powerfreeze: 0

  # Buffer Zone
  # Buffer Zone is an chunk area required between claims of different Factions.
  # This is default to 0 and has always been that way. Meaning Factions can have
  #   claims that border each other.
  # If this is set to 3, then Factions need to have 3 chunks between their claim
  #   and another Faction's claim.
  # It's recommended to keep this pretty low as the radius check could be a
  #   heavy operation if set to a large number.
  # If this is set to 0, we won't even bother checking which is how Factions has
  #   always been.
  buffer-zone: 2

  stuck:
    delay: 30
    radius: 10

############################################################
# +------------------------------------------------------+ #
# |                Configurable /f show                  | #
# +------------------------------------------------------+ #
############################################################

# You can use any variable here, including fancy messages. Color codes and or tags work fine.
# Lines that aren't defined wont be sent (home not set, faction not peaceful / permanent, dtr freeze)

# SUPPORTS PLACEHOLDERS
show:
  # First line can be {header} for default header, or any string (we recommend &m for smooth lines ;p)
  - '{header}'
  - '<a>Description: <i>{description}'
  - '<a>Joining: <i>{joining}    {peaceful}'
  - '<a>Land / Power / Maxpower: <i> {chunks}/{power}/{maxPower}'
  - '<a>Raidable: {raidable}'
  - '<a>Founded: <i>{create-date}'
  - '<a>This faction is permanent, remaining even with no members.' # only shows if faction is permanent
  - '<a>Land value: <i>{land-value} {land-refund}'
  - '<a>Balance: <i>{faction-balance}'
  - '<a>Bans: <i>{faction-bancount}'
  - '<a>Kills: <i>{faction-kills}'
  - '<a>Deaths: <i>{faction-deaths}'
  - '<a>Allies(<i>{allies}<a>/<i>{max-allies}<a>): {allies-list} '
  - '<a>Enemies(<i>{enemies}<a>/<i>{max-enemies}<a>): {enemies-list} '
  - '<a>Online: (<i>{online}<a>/<i>{members}<a>): {online-list}'
  - '<a>Offline: (<i>{offline}<a>/<i>{members}<a>): {offline-list}'

# For a /f show that does not display fancy messages that are essentially empty, use minimal-show
minimal-show: false

# Factions that should be exempt from /f show, case sensitive, useful for a
# serverteam faction, since the command shows vanished players otherwise
show-exempt:
  - Put_faction_tag_here


# THIS IS FOR /f map tool tips.

# You can use any variable here, including fancy messages. Color codes and or tags work fine.
# Lines that arent defined wont be sent (home not set, faction not peaceful / permanent, dtr freeze)
map:
  # First line can be {header} for default header, or any string (we recommend &m for smooth lines ;p)
  - '{header}'
  - '<a>Description: <i>{description}'
  - '<a>Joining: <i>{joining}    {peaceful}'
  - '<a>Land / Power / Maxpower: <i> {chunks}/{power}/{maxPower}'
  - '<a>Founded: <i>{create-date}'
  - '<a>This faction is permanent, remaining even with no members.' # only shows if faction is permanent
  - '<a>Land value: <i>{land-value} {land-refund}'
  - '<a>Balance: <i>{balance}'
  - '<a>Allies(<i>{allies}<a>/<i>{max-allies}<a>): {allies-list} '
  - '<a>Online: (<i>{online}<a>/<i>{members}<a>): {online-list}'
  - '<a>Offline: (<i>{offline}<a>/<i>{members}<a>): {offline-list}'

############################################################
# +------------------------------------------------------+ #
# |                Configurable /f list                  | #
# +------------------------------------------------------+ #
############################################################

list:
  # You can only use {pagenumber} and {pagecount} in the header
  header: '&e&m----------&r&e[ &2Faction List &9{pagenumber}&e/&9{pagecount} &e]&m----------'
  # You can use any variables here
  factionless: '<a>Factionless <i>{factionless} online'
  # You can use any variable here
  entry: '<a>{faction-relation-color}{faction} <i>{online} / {members} online, <a>Land / Power / Maxpower: <i>{chunks}/{power}/{maxPower} <a>Raidable: <i>{raidable}'


############################################################
# +------------------------------------------------------+ #
# |                Configurable /f help                  | #
# +------------------------------------------------------+ #
############################################################

# set to true to use legacy factions help
use-old-help: true

help:
  # You can change the page name to whatever you like
  # We use '1' to preserve default functionality of /f help 1
  '1':
    - '&e&m----------------------------------------------'
    - '                  &c&lFactions Help               '
    - '&e&m----------------------------------------------'
    - '&3/f create  &e>>  &7Create your own faction'
    - '&3/f who      &e>>  &7Show factions info'
    - '&3/f tag      &e>>  &7Change faction tag'
    - '&3/f join     &e>>  &7Join faction'
    - '&3/f list      &e>>  &7List all factions'
    - '&e&m--------------&r &2/f help 2 for more &e&m--------------'
  '2':
    - '&e&m------------------&r&c&l Page 2 &e&m--------------------'
    - '&3/f home     &e>>  &7Teleport to faction home'
    - '&3/f sethome &e>>  &7Set your faction home'
    - '&3/f leave    &e>>  &7Leave your faction'
    - '&3/f invite    &e>>  &7Invite a player to your faction'
    - '&3/f deinvite &e>>  &7Revoke invitation to player'
    - '&e&m--------------&r &2/f help 3 for more &e&m--------------'
  '3':
    - '&e&m------------------&r&c&l Page 3 &e&m--------------------'
    - '&3/f claim     &e>>  &7Claim land'
    - '&3/f unclaim  &e>>  &7Unclaim land'
    - '&3/f kick      &e>>  &7Kick player from your faction'
    - '&3/f mod      &e>>  &7Set player role in faction'
    - '&3/f chat     &e>>  &7Switch to faction chat'
    - '&e&m--------------&r &2/f help 4 for more &e&m--------------'
  '4':
    - '&e&m------------------&r&c&l Page 4 &e&m--------------------'
    - '&3/f version &e>>  &7Display version information'
    - '&e&m--------------&r&2 End of /f help &e&m-----------------'

############################################################
# +------------------------------------------------------+ #
# |                   LWC Integration                    | #
# +------------------------------------------------------+ #
############################################################
lwc:
  integration: false
  reset-locks-unclaim: false
  reset-locks-capture: false

############################################################
# +------------------------------------------------------+ #
# |                Big List of variables                 | #
# +------------------------------------------------------+ #
############################################################
# Fancy variables. Can only be used in /f show
#  - {allies-list}  : Lists each faction ally with tooltips
#  - {enemies-list} : Lists each faction enemy with tooltips
#  - {online-list}  : Lists all online members with tooltips
#  - {offline-list} : Lists all offline members with tooltips
# Player variables. Can be used in tooltips.show, scoreboards, or /f show
#  - {group}     : Players group (/f show only)
#  - {name}      : Players name
#  - {lastSeen}  : Last time player was seen (if offline), or just 'Online'
#  - {balance} : Players balance
#  - {player-kills} : # of kills the player has
#  - {player-deaths}: # of deaths the player has
#  - {total-online-visible}: # of players online from the perspective of the current player
# Faction variables. Can be used in tooltips.list, scoreboards, or /f show
#  - {header}    : Default factions header (ex. /f show)
#  - {faction}   : Factions tag (if none, uses lang.yml for factionless name)
#  - {faction-relation-color} : Factions color relative to the viewer
#  - {joining}   : How to join this faction
#  - {power}     : Factions deaths until raidable value
#  - {power-boost}  : DTR Symbol based on current DTR (max, regen, frozen, raidable)
#  - {maxPower}  : Factions max deaths until raidable value
#  - {chunks}    : # of claims faction has (in chunks)
#  - {warps}     : # of warps faction has
#  - {description} : Factions description
#  - {create-date} : Date faction was created
#  - {leader}    : Faction leader
#  - {land-value}  : Value of all claims
#  - {land-refund} : Calculated refund value
#  - {allies}    : # of allies faction has
#  - {enemies}   : # of enemies faction has
#  - {online}    : # of faction members online
#  - {offline}   : # of faction members offline
#  - {members}   : # of faction members (includes offline)
#  - {faction-balance}      : Faction bank balance
#  - {world}, {x}, {y}, {z} : Faction home variables. You don't need to use them all.
#  - {faction-kills} : # of kills the faction has
#  - {faction-deaths}: # of deaths the faction has
#  - {faction-bancount} : # of bans the faction has
# Faction Permissions GUI variables. Can only be used in GUI
# - {relation}            : Shows relation name (Can be used in action and relation)
# - {relation-color}      : Relation color
# - {action}              : Shows action name (Can only be used in action)
# - {action-access}       : Shows the action's access with current relation
# - {action-access-color} : Access color
# General variables. Can be used anywhere.
# - {total-online}  : Total # of players on the server
# - {max-warps}     : Max # of warps a faction can set
# - {max-allies}    : Max # of allies a faction can have
# - {max-enemies}   : Max # of enemies a faction can have
# - {factionless}   : Count of all factionless players online