# FactionsUUID by drtshock
# Report issues
# Live support
# Website
# 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 miliseconds, 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 miliseconds. 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:
#
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:
#
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: false # Default to false to keep original functionality.
# SUPPORTS PLACEHOLDERS
finfo:
- "&6Power"
- "{power}"
- "&3Members"
- "{online}/{members}"
- "&4Leader"
- "{leader}"
- "&bTerritory"
- "{chunks}"
# 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: false # Default to false to keep original functionality.
default-title: "i love drt" # 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:
- "&6Your Faction"
- "{faction}"
- "&3Your Power"
- "{power}"
- "&aBalance"
- "${balance}"
factionless-enabled: false
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: 0
# Delay for /f warp
f-warp: 0
# Delay for /f fly
f-fly: 0
######################################################
#################### 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
# 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: 0
# 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: false
# DTR (death til raidable) will be in /f show with [raidable] if enabled. Configure the message in the lang.yml
dtr: false
# 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: 0
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>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}'
# 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: '<i>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}'
############################################################
# +------------------------------------------------------+ #
# | 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-----------------'
############################################################
# +------------------------------------------------------+ #
# | Faction GUI | #
# +------------------------------------------------------+ #
############################################################
# Global Faction GUI stuff.
# Wiki:
gui:
# These items may be used as 'base' anywhere and all values can be replaced
global:
relation:
material: WOODEN_SWORD
name: '&8[{relation-color}{relation}&8]'
lore:
-
action:
material: TERRACOTTA
name: '&8[{action-access-color}{action}&8]'
# Depending on where it is used, different states are provided
# allow: Action is allowed
# deny: Action is denied
# undefined: Action is undefined
states:
allow:
color: *
material: LIME_TERRACOTTA
deny:
color: RED
material: RED_TERRACOTTA
undefined:
color: CYAN
material: CYAN_TERRACOTTA
lore:
- '&8Access:'
- '&8[{action-access-color}{action-access}&8]'
- ''
- '&8Left click to &a&lAllow'
- '&8Right click to &c&lDeny'
- '&8Middle click to &lUndefine'
warp:
material: RED_STAINED_GLASS
color: RED
name: '&8[&7{warp}&8]'
# exist: If the warp exists
# non_exist: If the warp does not exist
# password: If the warp has a password, will ignore exist
states:
exist:
material: LIME_STAINED_GLASS
color: *
password:
material: BLACK_STAINED_GLASS
color: BLACK
lore:
- '&8Password Protected'
lore:
-
dummies:
glass:
material: BLACK_STAINED_GLASS_PANE
color: BLACK
name: ' '
relation-info:
material: STONE
name: '&8[{relation-color}{relation}&8]'
# Back is a special dummy, which will go to the previous GUI if this able
back:
material: ARROW
name: '&7Back'
############################################################
# +------------------------------------------------------+ #
# | F Permission GUI | #
# +------------------------------------------------------+ #
############################################################
# TODO: Needs documentation
fperm-gui:
relation:
# GUI Name
name: 'Faction Permissions'
# Amount of inventory rows, No larger than 6
rows: 3
# These are the slots where the relations are going to be placed on the first GUI
# Note: Slots start at 0 and end at one less that GUI size
slots:
recruit: 10
normal: 11
moderator: 12
coleader: 13
truce: 14
ally: 15
enemy: 16
neutral: 22
# Material to be displayed
items:
recruit: relation
normal:
base: relation
material: STONE_SWORD
moderator:
base: relation
material: IRON_SWORD
coleader:
base: relation
material: SPONGE
truce:
base: relation
material: IRON_AXE
ally:
base: relation
material: DIAMOND_SWORD
enemy:
base: relation
material: DIAMOND_AXE
neutral:
base: relation
material: STONE
# Dummy items, defined in the global gui section (Can be overwritten)
dummies:
'0': glass
'1': glass
'2': glass
'3': glass
'4': glass
'5': glass
'6': glass
'7': glass
'8': glass
action:
name: 'Faction Permissions'
rows: 4
slots:
build: 9
destroy: 10
frost_walk: 11
pain_build: 12
door: 13
button: 14
lever: 15
container: 16
invite: 17
kick: 18
item: 19
sethome: 20
withdraw: 21
territory: 22
access: 23
promote: 24
setwarp: 25
warp: 26
ban: 27
disband: 28
fly: 29
items:
build: action
destroy: action
frost_walk: action
pain_build: action
door: action
button: action
lever: action
container: action
invite: action
kick: action
item: action
sethome: action
withdraw: action
territory: action
access: action
promote: action
setwarp: action
warp: action
ban: action
disband: action
fly: action
dummies:
'0': glass
'1': glass
'2': glass
'3': glass
'4': glass
'5': glass
'6': glass
'7': glass
'8': glass
'34': back
'35': relation-info
############################################################
# +------------------------------------------------------+ #
# | Faction Warp GUI | #
# +------------------------------------------------------+ #
############################################################
fwarp-gui:
name: "Faction Warps"
rows: 3
password-timeout: 5
slots:
'0': 11
'1': 12
'2': 13
'3': 14
'4': 15
items:
'0': warp
'1': warp
'2': warp
'3': warp
'4': warp
dummies:
'0': glass
'1': glass
'2': glass
'3': glass
'4': glass
'5': glass
'6': glass
'7': glass
'8': glass
############################################################
# +------------------------------------------------------+ #
# | 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
# 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
