2018-05-15 23:30:20 +00:00
version :
2018-10-13 15:56:20 +00:00
# This is the current version of Towny. Please do not edit.
2019-12-05 23:46:47 +00:00
version : 0.95 .2 .0
2018-10-13 15:56:20 +00:00
# This is for showing the changelog on updates. Please do not edit.
2019-12-05 23:46:47 +00:00
last_run_version : 0.95 .2 .0
2018-10-13 15:56:20 +00:00
# The language file you wish to use
2018-05-15 23:30:20 +00:00
language : english.yml
2018-10-13 15:56:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Permission nodes | #
# +------------------------------------------------------+ #
############################################################
2018-05-15 23:30:20 +00:00
2018-10-13 15:56:20 +00:00
# Possible permission nodes
#
# for a full list of permission nodes visit:
2019-12-05 23:46:47 +00:00
# https://github.com/TownyAdvanced/Towny/wiki/Towny-Permission-Nodes
2018-05-15 23:30:20 +00:00
permissions : ''
2018-10-13 15:56:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Town and Nation levels | #
# +------------------------------------------------------+ #
############################################################
2018-05-15 23:30:20 +00:00
levels :
# default Town levels.
town_level :
- numResidents : 0
namePostfix : ' Ruins'
mayorPrefix : 'Spirit '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
townBlockLimit : 4
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.1
2018-10-13 15:56:20 +00:00
townOutpostLimit : 0
2018-05-15 23:30:20 +00:00
- numResidents : 1
namePostfix : ' (Settlement)'
mayorPrefix : 'Hermit '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
townBlockLimit : 64
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.1
2018-10-13 15:56:20 +00:00
townOutpostLimit : 0
2018-05-15 23:30:20 +00:00
- numResidents : 2
namePostfix : ' (Hamlet)'
mayorPrefix : 'Chief '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
2018-10-13 15:56:20 +00:00
townBlockLimit : 128
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.1
2018-10-13 15:56:20 +00:00
townOutpostLimit : 1
2018-05-15 23:30:20 +00:00
- numResidents : 6
namePostfix : ' (Village)'
mayorPrefix : 'Baron Von '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
townBlockLimit : 384
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.2
2018-10-13 15:56:20 +00:00
townOutpostLimit : 1
2018-05-15 23:30:20 +00:00
- numResidents : 10
namePostfix : ' (Town)'
mayorPrefix : 'Viscount '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
townBlockLimit : 640
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.3
2018-10-13 15:56:20 +00:00
townOutpostLimit : 2
2018-05-15 23:30:20 +00:00
- numResidents : 14
namePostfix : ' (Large Town)'
mayorPrefix : 'Count Von '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
townBlockLimit : 896
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.4
2018-10-13 15:56:20 +00:00
townOutpostLimit : 2
2018-05-15 23:30:20 +00:00
- numResidents : 20
namePostfix : ' (City)'
mayorPrefix : 'Earl '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
townBlockLimit : 4280
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.5
2018-10-13 15:56:20 +00:00
townOutpostLimit : 3
2018-05-15 23:30:20 +00:00
- numResidents : 24
namePostfix : ' (Large City)'
mayorPrefix : 'Duke '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
townBlockLimit : 4536
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.6
2018-10-13 15:56:20 +00:00
townOutpostLimit : 3
2018-05-15 23:30:20 +00:00
- numResidents : 28
namePostfix : ' (Metropolis)'
mayorPrefix : 'Lord '
2019-12-05 23:46:47 +00:00
townBlockBuyBonusLimit : 0
2018-05-15 23:30:20 +00:00
namePrefix : ''
mayorPostfix : ''
townBlockLimit : 4792
2018-08-27 03:20:05 +00:00
upkeepModifier : 0.7
2018-10-13 15:56:20 +00:00
townOutpostLimit : 4
2018-05-15 23:30:20 +00:00
# default Nation levels.
nation_level :
- kingPostfix : ''
capitalPostfix : ''
upkeepModifier : 1.0
kingPrefix : 'Leader '
capitalPrefix : ''
2018-10-13 15:56:20 +00:00
numResidents : 0
nationBonusOutpostLimit : 0
namePostfix : ' (Nation)'
townBlockLimitBonus : 40
namePrefix : 'Land of '
nationZonesSize : 1
2018-05-15 23:30:20 +00:00
nationTownUpkeepModifier : 1.0
- kingPostfix : ''
capitalPostfix : ''
2018-08-22 20:43:26 +00:00
upkeepModifier : 1.1
2018-05-15 23:30:20 +00:00
kingPrefix : 'Count '
capitalPrefix : ''
2018-10-13 15:56:20 +00:00
numResidents : 10
nationBonusOutpostLimit : 1
namePostfix : ' (Nation)'
townBlockLimitBonus : 80
namePrefix : 'Federation of '
nationZonesSize : 1
2018-08-22 20:43:26 +00:00
nationTownUpkeepModifier : 1.1
2018-05-15 23:30:20 +00:00
- kingPostfix : ''
capitalPostfix : ''
2018-08-22 20:43:26 +00:00
upkeepModifier : 1.2
2018-05-15 23:30:20 +00:00
kingPrefix : 'Duke '
capitalPrefix : ''
2018-10-13 15:56:20 +00:00
numResidents : 20
nationBonusOutpostLimit : 2
namePostfix : ' (Nation)'
townBlockLimitBonus : 160
namePrefix : 'Dominion of '
nationZonesSize : 1
2018-08-22 20:43:26 +00:00
nationTownUpkeepModifier : 1.2
2018-05-15 23:30:20 +00:00
- kingPostfix : ''
capitalPostfix : ''
2018-08-22 20:43:26 +00:00
upkeepModifier : 1.3
2018-05-15 23:30:20 +00:00
kingPrefix : 'King '
capitalPrefix : ''
2018-10-13 15:56:20 +00:00
numResidents : 30
nationBonusOutpostLimit : 3
namePostfix : ' (Nation)'
townBlockLimitBonus : 240
namePrefix : 'Kingdom of '
nationZonesSize : 2
2018-08-22 20:43:26 +00:00
nationTownUpkeepModifier : 1.3
2018-05-15 23:30:20 +00:00
- kingPostfix : ''
capitalPostfix : ''
2018-08-22 20:43:26 +00:00
upkeepModifier : 1.4
2018-05-15 23:30:20 +00:00
kingPrefix : 'Emperor '
capitalPrefix : ''
2018-10-13 15:56:20 +00:00
numResidents : 40
nationBonusOutpostLimit : 4
namePostfix : ' Empire'
townBlockLimitBonus : 400
namePrefix : 'The '
nationZonesSize : 2
2018-08-22 20:43:26 +00:00
nationTownUpkeepModifier : 1.4
2018-05-15 23:30:20 +00:00
- kingPostfix : ''
capitalPostfix : ''
2018-08-22 20:43:26 +00:00
upkeepModifier : 1.5
2018-05-15 23:30:20 +00:00
kingPrefix : 'God Emperor '
capitalPrefix : ''
2018-10-13 15:56:20 +00:00
numResidents : 60
nationBonusOutpostLimit : 5
namePostfix : ' Realm'
townBlockLimitBonus : 560
namePrefix : 'The '
nationZonesSize : 3
2018-08-22 20:43:26 +00:00
nationTownUpkeepModifier : 1.5
2018-05-15 23:30:20 +00:00
2018-10-13 15:56:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Town Claim/new defaults | #
# +------------------------------------------------------+ #
############################################################
2018-05-15 23:30:20 +00:00
town :
# Default public status of the town (used for /town spawn)
default_public : 'true'
# Default Open status of the town (are new towns open and joinable by anyone at creation?)
default_open : 'false'
# Default tax settings for new towns.
default_taxes :
# Default amount of tax of a new town. This must be lower than the economy.daily_taxes.max_tax_percent setting.
tax : '0.0'
# Default amount of shop tax of a new town.
shop_tax : '0.0'
# Default amount of embassy tax of a new town.
embassy_tax : '0.0'
2018-05-26 10:45:39 +00:00
# Default amount for town's plottax costs.
plot_tax : '0.0'
2018-05-15 23:30:20 +00:00
# Default status of new town's taxpercentage. True means that the default_tax is treated as a percentage instead of a fixed amount.
taxpercentage : 'false'
2018-05-26 10:45:39 +00:00
# A required minimum tax amount for the default_tax, will not change any towns which already have a tax set.
# Do not forget to set the default_tax to more than 0 or new towns will still begin with a tax of zero.
minimumtax : '0.0'
2018-05-15 23:30:20 +00:00
# Limits the maximum amount of bonus blocks a town can buy.
2019-12-05 23:46:47 +00:00
# This setting does nothing when town.max_purchased_blocks_uses_town_levels is set to true.
2018-05-30 13:23:37 +00:00
max_purchased_blocks : '2147483647'
2019-12-05 23:46:47 +00:00
# When set to true, the town_level section of the config determines the maximum number of bonus blocks a town can purchase.
max_purchased_blocks_uses_town_levels : 'true'
2018-05-15 23:30:20 +00:00
# maximum number of plots any single resident can own
max_plots_per_resident : '400'
2018-05-26 10:45:39 +00:00
# maximum number used in /town claim/unclaim # commands.
# set to 0 to disable limiting of claim radius value check.
# keep in mind that the default value of 4 is a radius,
# and it will allow claiming 9x9 (80 plots) at once.
max_claim_radius_value : '16'
2018-05-15 23:30:20 +00:00
# Maximum number of towns allowed on the server.
town_limit : '3000'
# Minimum number of plots any towns plot must be from the next town's own plots.
# This will prevent town encasement to a certain degree.
min_plot_distance_from_town_plot : '4'
# Minimum number of plots any towns home plot must be from the next town.
# This will prevent someone founding a town right on your doorstep
min_distance_from_town_homeblock : '20'
2018-10-13 15:56:20 +00:00
# Minimum number of plots an outpost must be from any other town's plots.
# Useful when min_plot_distance_from_town_plot is set to near-zero to allow towns to have claims
# near to each other, but want to keep outposts away from towns.
min_distance_for_outpost_from_plot : '5'
# Maximum distance between homeblocks.
2018-05-15 23:30:20 +00:00
# This will force players to build close together.
max_distance_between_homeblocks : '0'
# The maximum townblocks available to a town is (numResidents * ratio).
# Setting this value to 0 will instead use the level based jump values determined in the town level config.
2018-05-29 05:19:14 +00:00
town_block_ratio : '48'
2018-05-15 23:30:20 +00:00
# The size of the square grid cell. Changing this value is suggested only when you first install Towny.
# Doing so after entering data will shift things unwantedly. Using smaller value will allow higher precision,
# at the cost of more work setting up. Also, extremely small values will render the caching done useless.
# Each cell is (town_block_size * town_block_size * 128) in size, with 128 being from bedrock to clouds.
town_block_size : '8'
############################################################
# +------------------------------------------------------+ #
# | Default new world settings | #
# +------------------------------------------------------+ #
############################################################
# These flags are only used at the initial setup of a new world.
# Once Towny is running each world can be altered from within game
# using '/townyworld toggle'
new_world_settings :
# Default for new worlds to have towny enabled.
2018-06-18 17:33:32 +00:00
using_towny : 'false'
2018-05-15 23:30:20 +00:00
pvp :
# Set if PVP is enabled in this world
world_pvp : 'true'
# force_pvp_on is a global flag and overrides any towns flag setting
force_pvp_on : 'false'
2019-12-05 23:46:47 +00:00
# If set to false the world will not be included in war events.
war_allowed : 'true'
2018-05-15 23:30:20 +00:00
mobs :
# world_monsters_on is a global flag setting per world.
world_monsters_on : 'true'
# force_town_monsters_on is a global flag and overrides any towns flag setting
force_town_monsters_on : 'false'
explosions :
# Allow explosions in this world
world_explosions_enabled : 'true'
# force_explosions_on is a global flag and overrides any towns flag setting
force_explosions_on : 'false'
fire :
# Allow fire to be lit and spread in this world.
world_firespread_enabled : 'true'
# force_fire_on is a global flag and overrides any towns flag setting
force_fire_on : 'false'
# Prevent Endermen from picking up and placing blocks.
enderman_protect : 'true'
# Disable players trampling crops
disable_player_crop_trampling : 'true'
# Disable creatures trampling crops
disable_creature_crop_trampling : 'true'
# World management settings to deal with un/claiming plots
plot_management :
block_delete :
enabled : 'false'
# These items will be deleted upon a plot being unclaimed
2019-11-08 01:31:44 +00:00
unclaim_delete : BED_BLOCK,TORCH,REDSTONE_WIRE,ACACIA_SIGN,BIRCH_SIGN,DARK_OAK_SIGN,JUNGLE_SIGN,OAK_SIGN,SPRUCE_SIGN,WOODEN_DOOR,ACACIA_WALL_SIGN,BIRCH_WALL_SIGN,DARK_OAK_WALL_SIGN,JUNGLE_WALL_SIGN,OAK_WALL_SIGN,SPRUCE_WALL_SIGN,STONE_PLATE,IRON_DOOR_BLOCK,WOOD_PLATE,REDSTONE_TORCH_OFF,REDSTONE_TORCH_ON,DIODE_BLOCK_OFF,DIODE_BLOCK_ON
2018-05-15 23:30:20 +00:00
mayor_plotblock_delete :
enabled : 'true'
# These items will be deleted upon a mayor using /plot clear
# To disable deleting replace the current entries with NONE.
2019-11-08 01:31:44 +00:00
mayor_plot_delete : ACACIA_WALL_SIGN,BIRCH_WALL_SIGN,DARK_OAK_WALL_SIGN,JUNGLE_WALL_SIGN,OAK_WALL_SIGN,SPRUCE_WALL_SIGN,ACACIA_SIGN,BIRCH_SIGN,DARK_OAK_SIGN,JUNGLE_SIGN,OAK_SIGN,SPRUCE_SIGN
2018-05-15 23:30:20 +00:00
revert_on_unclaim :
# *** WARNING***
# If this is enabled any town plots which become unclaimed will
# slowly be reverted to a snapshot taken before the plot was claimed.
#
# Regeneration will only work if the plot was
# claimed under version 0.76.2, or
# later with this feature enabled
2018-05-26 10:45:39 +00:00
# Unlike the rest of this config section, the speed setting is not
# set per-world. What you set for speed will be used in all worlds.
2018-05-15 23:30:20 +00:00
#
# If you allow players to break/build in the wild the snapshot will
# include any changes made before the plot was claimed.
enabled : 'false'
speed : 1s
# These block types will NOT be regenerated
2019-11-08 01:31:44 +00:00
block_ignore : GOLD_ORE,LAPIS_ORE,LAPIS_BLOCK,GOLD_BLOCK,IRON_ORE,IRON_BLOCK,MOSSY_COBBLESTONE,TORCH,SPAWNER,DIAMOND_ORE,DIAMOND_BLOCK,ACACIA_SIGN,BIRCH_SIGN,DARK_OAK_SIGN,JUNGLE_SIGN,OAK_SIGN,SPRUCE_SIGN,ACACIA_WALL_SIGN,BIRCH_WALL_SIGN,DARK_OAK_WALL_SIGN,JUNGLE_WALL_SIGN,OAK_WALL_SIGN,SPRUCE_WALL_SIGN,GLOWSTONE,EMERALD_ORE,EMERALD_BLOCK
2018-05-15 23:30:20 +00:00
wild_revert_on_mob_explosion :
# Enabling this will slowly regenerate holes created in the
# wilderness by monsters exploding.
enabled : 'true'
entities : Creeper,EnderCrystal,EnderDragon,Fireball,SmallFireball,LargeFireball,TNTPrimed,ExplosiveMinecart
delay : 20s
############################################################
# +------------------------------------------------------+ #
# | Global town settings | #
# +------------------------------------------------------+ #
############################################################
global_town_settings :
# can residents/Allies harm other residents when in an area with pvp enabled? Other than an Arena plot.
friendly_fire : 'true'
# Players within their town or allied towns will regenerate half a heart after every health_regen_speed seconds.
health_regen :
speed : 3s
enable : 'true'
# Allow towns to claim outposts (a townblock not connected to town).
2019-09-30 07:13:25 +00:00
allow_outposts : 'false'
2018-10-13 15:56:20 +00:00
# When set to true outposts can be limited by the townOutpostLimit value of the Town Levels and
# the nationBonusOutpostLimit value in the Nation Levels. In this way nations can be made to be
# the only way of receiving outposts, or as an incentive to receive more outposts. Towns which are
# larger can have more outposts.
# When activated, this setting will not cause towns who already have higher than their limit
# to lose outposts. They will not be able to start new outposts until they have unclaimed outposts
# to become under their limit. Likewise, towns that join a nation and receive bonus outposts will
# be over their limit if they leave the nation.
limit_outposts_using_town_and_nation_levels : 'false'
# When limit_outposts_using_town_and_nation_levels is also true, towns which are over their outpost
# limit will not be able to use their /town outpost teleports for the outpost #'s higher than their limit,
# until they have dropped below their limit.
# eg: If their limit is 3 then they cannot use /t outpost 4
over_outpost_limits_stops_teleports : 'false'
2018-05-15 23:30:20 +00:00
# Allow the use of /town spawn
2018-10-13 15:56:20 +00:00
# Valid values are: true, false, war, peace
# When war or peace is set, it is only possible to teleport to the town,
# when there is a war or peace.
2018-05-15 23:30:20 +00:00
allow_town_spawn : 'true'
# Allow regular residents to use /town spawn [town] (TP to other towns if they are public).
2018-10-13 15:56:20 +00:00
# Valid values are: true, false, war, peace
# When war or peace is set, it is only possible to teleport to the town,
# when there is a war or peace.
2018-05-15 23:30:20 +00:00
allow_town_spawn_travel : 'true'
# Allow regular residents to use /town spawn [town] to other towns in your nation.
2018-10-13 15:56:20 +00:00
# Valid values are: true, false, war, peace
# When war or peace is set, it is only possible to teleport to the town,
# when there is a war or peace.
2018-05-15 23:30:20 +00:00
allow_town_spawn_travel_nation : 'true'
# Allow regular residents to use /town spawn [town] to other towns in a nation allied with your nation.
2018-10-13 15:56:20 +00:00
# Valid values are: true, false, war, peace
# When war or peace is set, it is only possible to teleport to the town,
# when there is a war or peace.
2018-05-15 23:30:20 +00:00
allow_town_spawn_travel_ally : 'true'
2018-10-13 15:56:20 +00:00
# When set to true both nation and ally spawn travel will also require the target town to have their status set to public.
2018-11-24 18:07:35 +00:00
is_nation_ally_spawning_requiring_public_status : 'true'
2018-05-15 23:30:20 +00:00
# If non zero it delays any spawn request by x seconds.
2018-11-24 18:07:35 +00:00
teleport_warmup_time : '60'
2019-12-05 23:46:47 +00:00
# Number of seconds that must pass before a player can use /t spawn or /res spawn.
spawn_cooldown_time : '30'
# Number of seconds that must pass before pvp can be toggled by a town.
# Applies to residents of the town using /res toggle pvp, as well as
# plots having their PVP toggled using /plot toggle pvp.
pvp_cooldown_time : '30'
2018-05-15 23:30:20 +00:00
# Respawn the player at his town spawn point when he/she dies
2018-11-24 22:48:49 +00:00
town_respawn : 'false'
2018-05-15 23:30:20 +00:00
# Town respawn only happens when the player dies in the same world as the town's spawn point.
2018-11-24 18:07:35 +00:00
town_respawn_same_world_only : 'true'
2018-05-15 23:30:20 +00:00
# Prevent players from using /town spawn while within unclaimed areas and/or enemy/neutral towns.
# Allowed options: unclaimed,enemy,neutral
prevent_town_spawn_in : enemy
# Enables the [~Home] message.
# If false it will make it harder for enemies to find the home block during a war
show_town_notifications : 'true'
2018-05-26 10:45:39 +00:00
# The required number of residents in a town to join a nation
# If the number is 0, towns will not require a certain amount of residents to join a nation
required_number_residents_join_nation : '0'
# The required number of residents in a town to create a nation
# If the number is 0, towns will not require a certain amount of residents to create a nation
required_number_residents_create_nation : '0'
# If set to true, if a nation is disbanded due to a lack of residents, the capital will be refunded the cost of nation creation.
refund_disband_low_residents : 'true'
# The maximum number of townblocks a town can be away from a nation capital,
# Automatically precludes towns from one world joining a nation in another world.
# If the number is 0, towns will not a proximity to a nation.
nation_requires_proximity : '0.0'
# List of blocks which can be modified on farm plots, as long as player is also allowed in the plot's '/plot perm' line.
2019-08-19 00:12:51 +00:00
# Not included by default but some servers add GRASS_BLOCK,FARMLAND,DIRT to their list.
farm_plot_allow_blocks : BAMBOO,BAMBOO_SAPLING,JUNGLE_LOG,JUNGLE_SAPLING,JUNGLE_LEAVES,OAK_LOG,OAK_SAPLING,OAK_LEAVES,BIRCH_LOG,BIRCH_SAPLING,BIRCH_LEAVES,ACACIA_LOG,ACACIA_SAPLING,ACACIA_LEAVES,DARK_OAK_LOG,DARK_OAK_SAPLING,DARK_OAK_LEAVES,SPRUCE_LOG,SPRUCE_SAPLING,SPRUCE_LEAVES,BEETROOTS,COCOA,CHORUS_PLANT,CHORUS_FLOWER,SWEET_BERRY_BUSH,KELP,SEAGRASS,TALL_SEAGRASS,GRASS,TALL_GRASS,FERN,LARGE_FERN,CARROTS,WHEAT,POTATOES,PUMPKIN,PUMPKIN_STEM,ATTACHED_PUMPKIN_STEM,NETHER_WART,COCOA,VINE,MELON,MELON_STEM,ATTACHED_MELON_STEM,SUGAR_CANE,CACTUS,ALLIUM,AZURE_BLUET,BLUE_ORCHID,CORNFLOWER,DANDELION,LILAC,LILY_OF_THE_VALLEY,ORANGE_TULIP,OXEYE_DAISY,PEONY,PINK_TULIP,POPPY,RED_TULIP,ROSE_BUSH,SUNFLOWER,WHITE_TULIP,WITHER_ROSE
2019-12-05 23:46:47 +00:00
# List of animals which can be killed on farm plots by town residents.
2018-05-26 10:45:39 +00:00
farm_animals : PIG,COW,CHICKEN,SHEEP,MOOSHROOM
# The maximum number of residents that can be joined to a town. Setting to 0 disables this feature.
max_residents_per_town : '0'
# If Towny should show players the townboard when they login
display_board_onlogin : 'true'
# If set to true, Towny will prevent a town from toggling PVP while an outsider is within the town's boundaries.
# When active this feature can cause a bit of lag when the /t toggle pvp command is used, depending on how many players are online.
outsiders_prevent_pvp_toggle : 'false'
2018-10-13 15:56:20 +00:00
# If set to true, when a world has forcepvp set to true, homeblocks of towns will not be affected and have PVP set to off.
homeblocks_prevent_forcepvp : 'false'
2018-05-26 10:45:39 +00:00
# The amount of residents a town needs to claim an outpost,
# Setting this value to 0, means a town can claim outposts no matter how many residents
minimum_amount_of_residents_in_town_for_outpost : '0'
2019-08-19 00:12:51 +00:00
# If People should keep their inventories on death in a town
# Is not guaranteed to work with other keep inventory plugins!
keep_inventory_on_death_in_town : 'false'
2018-10-13 15:56:20 +00:00
# If People should keep their experience on death in a town
# Is not guaranteed to work with other keep experience plugins!
2019-08-19 00:12:51 +00:00
keep_experience_on_death_in_town : 'false'
2018-10-13 15:56:20 +00:00
# Maximum amount that a town can set their plot, embassy, shop, etc plots' prices to.
# Setting this higher can be dangerous if you use Towny in a mysql database. Large numbers can become shortened to scientific notation.
maximum_plot_price_cost : '1000000.0'
2019-12-05 23:46:47 +00:00
# If set to true, the /town screen will display the xyz coordinate for a town's spawn rather than the homeblock's Towny coords.
display_xyz_instead_of_towny_coords : 'false'
# If set to true the /town list command will list randomly, rather than by whichever comparator is used, hiding resident counts.
display_town_list_randomly : 'false'
2018-10-13 15:56:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Global nation settings | #
# +------------------------------------------------------+ #
############################################################
global_nation_settings :
# Nation Zones are a special type of wilderness surrounding Capitals of Nations or Nation Capitals and their Towns.
# When it is enabled players who are members of the nation can use the wilderness surrounding the town like normal.
# Players who are not part of that nation will find themselves unable to break/build/switch/itemuse in this part of the wilderness.
# The amount of townblocks used for the zone is determined by the size of the nation and configured in the nation levels.
# Because these zones are still wilderness anyone can claim these townblocks.
# It is recommended that whatever size you choose, these numbers should be less than the min_plot_distance_from_town_plot otherwise
# someone might not be able to build/destroy in the wilderness outside their town.
nationzone :
# Nation zone feature is disabled by default. This is because it can cause a higher server load for servers with a large player count.
enable : 'false'
# When set to true, only the capital town of a nation will be surrounded by a nation zone type of wilderness.
only_capitals : 'true'
# Amount of buffer added to nation zone width surrounding capitals only. Creates a larger buffer around nation capitals.
capital_bonus_size : '0'
# When set to true, nation zones are disabled during the the Towny war types.
war_disables : 'true'
2019-12-05 23:46:47 +00:00
# When set to true, players will receive a notification when they enter into a nationzone.
# Set to false by default because, like the nationzone feature, it will generate more load on servers.
show_notifications : 'false'
2018-10-13 15:56:20 +00:00
# If Towny should show players the nationboard when they login.
display_board_onlogin : 'true'
# If enabled, only allow the nation spawn to be set in the capital city.
capital_spawn : 'true'
# Allow the use of /nation spawn
# Valid values are: true, false, war, peace
# When war or peace is set, it is only possible to teleport to the nation,
# when there is a war or peace.
allow_nation_spawn : 'true'
# Allow regular residents to use /nation spawn [nation] (TP to other nations if they are public).
# Valid values are: true, false, war, peace
# When war or peace is set, it is only possible to teleport to the nation,
# when there is a war or peace.
allow_nation_spawn_travel : 'true'
# Allow regular residents to use /nation spawn [nation] to other nations allied with your nation.
# Valid values are: true, false, war, peace
# When war or peace is set, it is only possible to teleport to the nations,
# when there is a war or peace.
allow_nation_spawn_travel_ally : 'true'
2019-08-19 00:12:51 +00:00
# If higher than 0, it will limit how many towns can be joined into a nation.
# Does not affect existing nations that are already over the limit.
max_towns_per_nation : '0'
2018-10-13 15:56:20 +00:00
default :
# If set to true, any newly made nation will have their spawn set to public.
public : 'false'
2019-09-30 07:13:25 +00:00
# If set to true, any newly made nation will have open status and any town may join without an invite.
open : 'false'
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Plugin interfacing | #
# +------------------------------------------------------+ #
############################################################
plugin :
2019-08-19 00:12:51 +00:00
# Valid load and save types are: flatfile, mysql, h2.
2018-05-15 23:30:20 +00:00
database :
database_load : flatfile
database_save : flatfile
# SQL database connection details (IF set to use SQL).
sql :
hostname : localhost
port : '3306'
dbname : towny
table_prefix : towny_
username : root
2019-11-10 18:39:59 +00:00
password : 'NOPE'
2018-05-26 10:45:39 +00:00
ssl : 'false'
2018-05-15 23:30:20 +00:00
# Flatfile backup settings.
daily_backups : 'true'
backups_are_deleted_after : 90d
# Valid entries are: zip, none.
flatfile_backup : zip
interfacing :
tekkit :
# Add any fake players for client/server mods (aka Tekkit) here
fake_residents : '[IndustrialCraft],[BuildCraft],[Redpower],[Forestry],[Turtle]'
# Enable using_essentials if you are using cooldowns in essentials for teleports.
2018-05-18 19:58:46 +00:00
using_essentials : 'true'
2018-05-15 23:30:20 +00:00
2018-10-13 15:56:20 +00:00
# This enables/disables all the economy functions of Towny.
2019-08-19 00:12:51 +00:00
# This will first attempt to use Vault or Reserve to bridge your economy plugin with Towny.
# If Reserve/Vault is not present it will attempt to find a supported economy plugin.
# If neither Vault/Reserve or supported economy are present it will not be possible to create towns or do any operations that require money.
2018-05-15 23:30:20 +00:00
using_economy : 'true'
day_timer :
# The number of hours in each "day".
# You can configure for 10 hour days. Default is 24 hours.
day_interval : 1d
# The time each "day", when taxes will be collected.
# MUST be less than day_interval. Default is 12h (midday).
new_day_time : 12h
# Lots of messages to tell you what's going on in the server with time taken for events.
debug_mode : 'false'
# Info tool for server admins to use to query in game blocks and entities.
2019-08-19 00:12:51 +00:00
info_tool : BRICK
2018-05-15 23:30:20 +00:00
# Spams the player named in dev_name with all messages related to towny.
dev_mode :
enable : 'false'
dev_name : ElgarL
# Record all messages to the towny.log
logging : 'true'
# If true this will cause the log to be wiped at every startup.
reset_log_on_boot : 'true'
############################################################
# +------------------------------------------------------+ #
# | Filters colour and chat | #
# +------------------------------------------------------+ #
############################################################
filters_colour_chat :
# This is the name given to any NPC assigned mayor.
npc_prefix : NPC
# Regex fields used in validating inputs.
regex :
name_filter_regex : '[ /]'
name_check_regex : ^[a-zA-Z0-9._\[\]-]*$
2019-11-08 01:31:44 +00:00
string_check_regex : ^[a-zA-Z0-9 \s._\[\]\#\?\!\@\$\%\^\&\*\-\,\*\(\)\{\}]*$
2019-12-05 23:46:47 +00:00
name_remove_regex : '[^a-zA-Z0-9\&._\[\]-]'
2018-05-15 23:30:20 +00:00
modify_chat :
# Maximum length of Town and Nation names.
max_name_length : '20'
# Maximum length of titles and surnames.
max_title_length : '10'
2019-12-05 23:46:47 +00:00
# See the Placeholders wiki page for list of PAPI placeholders.
# https://github.com/TownyAdvanced/Towny/wiki/Placeholders
2019-11-08 01:31:44 +00:00
papi_chat_formatting :
# When using PlaceholderAPI, and a tag would show both nation and town, this will determine how they are formatted.
both : '&f[&6%n&f|&b%t&f] '
# When using PlaceholderAPI, and a tag would showing a town, this will determine how it is formatted.
town : '&f[&b%s&f] '
# When using PlaceholderAPI, and a tag would show a nation, this will determine how it is formatted.
nation : '&f[&6%s&f] '
# Colour code applied to player names using the %townyadvanced_towny_colour% placeholder.
ranks :
nomad : '&f'
resident : '&f'
mayor : '&b'
king : '&6'
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | block/item/mob protection | #
# +------------------------------------------------------+ #
############################################################
protection :
# Items that can be blocked within towns via town/plot flags
# 259 - flint and steel
# 325 - bucket
# 326 - water bucket
# 327 - lava bucket
# 351 - bone/bonemeal
# 359 - shears
# 368 - ender pearl
# 374 - glass bottle
# 385 - fire charge
2019-11-08 01:31:44 +00:00
item_use_ids : BONE_MEAL,FLINT_AND_STEEL,BUCKET,WATER_BUCKET,LAVA_BUCKET,MINECART,STORAGE_MINECART,INK_SACK,SHEARS,ENDER_PEARL,GLASS_BOTTLE,FIREBALL,ARMOR_STAND,SKULL_ITEM,BIRCH_BOAT,ACACIA_BOAT,DARK_OAK_BOAT,JUNGLE_BOAT,OAK_BOAT,SPRUCE_BOAT,END_CRYSTAL,POWERED_MINECART,COMMAND_MINECART,EXPLOSIVE_MINECART,HOPPER_MINECART,CHORUS_FRUIT,BLACK_DYE,BLUE_DYE,BROWN_DYE,CYAN_DYE,GRAY_DYE,GREEN_DYE,LIGHT_BLUE_DYE,LIGHT_GRAY_DYE,LIME_DYE,MAGENTA_DYE,ORANGE_DYE,PINK_DYE,PURPLE_DYE,RED_DYE,WHITE_DYE,YELLOW_DYE
2018-05-15 23:30:20 +00:00
# Items which can be blocked or enabled via town/plot flags
# 25 - noteblock
# 54 - chest ...etc
2019-12-05 23:46:47 +00:00
switch_ids : JUKEBOX,NOTE_BLOCK,BEACON,CHEST,TRAPPED_CHEST,FURNACE,DISPENSER,HOPPER,DROPPER,LEVER,COMPARATOR,REPEATER,STONE_PRESSURE_PLATE,ACACIA_PRESSURE_PLATE,BIRCH_PRESSURE_PLATE,DARK_OAK_PRESSURE_PLATE,JUNGLE_PRESSURE_PLATE,OAK_PRESSURE_PLATE,SPRUCE_PRESSURE_PLATE,HEAVY_WEIGHTED_PRESSURE_PLATE,LIGHT_WEIGHTED_PRESSURE_PLATE,STONE_BUTTON,ACACIA_BUTTON,BIRCH_BUTTON,DARK_OAK_BUTTON,JUNGLE_BUTTON,OAK_BUTTON,SPRUCE_BUTTON,ACACIA_DOOR,BIRCH_DOOR,DARK_OAK_DOOR,JUNGLE_DOOR,OAK_DOOR,SPRUCE_DOOR,ACACIA_FENCE_GATE,BIRCH_FENCE_GATE,DARK_OAK_FENCE_GATE,OAK_FENCE_GATE,JUNGLE_FENCE_GATE,SPRUCE_FENCE_GATE,ACACIA_TRAPDOOR,BIRCH_TRAPDOOR,DARK_OAK_TRAPDOOR,JUNGLE_TRAPDOOR,OAK_TRAPDOOR,SPRUCE_TRAPDOOR,MINECART,COMMAND_BLOCK_MINECART,CHEST_MINECART,FURNACE_MINECART,HOPPER_MINECART,TNT_MINECART,SHULKER_BOX,WHITE_SHULKER_BOX,ORANGE_SHULKER_BOX,MAGENTA_SHULKER_BOX,LIGHT_BLUE_SHULKER_BOX,LIGHT_GRAY_SHULKER_BOX,YELLOW_SHULKER_BOX,LIME_SHULKER_BOX,PINK_SHULKER_BOX,GRAY_SHULKER_BOX,CYAN_SHULKER_BOX,PURPLE_SHULKER_BOX,BLUE_SHULKER_BOX,BROWN_SHULKER_BOX,GREEN_SHULKER_BOX,RED_SHULKER_BOX,BLACK_SHULKER_BOX,CARROT_STICK,DAYLIGHT_DETECTOR,STONECUTTER,SMITHING_TABLE,FLETCHING_TABLE,SMOKER,LOOM,LECTERN,GRINDSTONE,COMPOSTER,CARTOGRAPHY_TABLE,BLAST_FURNACE,BELL,BARREL,DRAGON_EGG,ITEM_FRAME,POTTED_ACACIA_SAPLING,POTTED_ALLIUM,POTTED_AZURE_BLUET,POTTED_BAMBOO,POTTED_BIRCH_SAPLING,POTTED_BLUE_ORCHID,POTTED_BROWN_MUSHROOM,POTTED_CACTUS,POTTED_CORNFLOWER,POTTED_DANDELION,POTTED_DARK_OAK_SAPLING,POTTED_DEAD_BUSH,POTTED_FERN,POTTED_JUNGLE_SAPLING,POTTED_LILY_OF_THE_VALLEY,POTTED_OAK_SAPLING,POTTED_ORANGE_TULIP,POTTED_OXEYE_DAISY,POTTED_PINK_TULIP,POTTED_POPPY,POTTED_RED_MUSHROOM,POTTED_RED_TULIP,POTTED_SPRUCE_SAPLING,POTTED_WHITE_TULIP,POTTED_WITHER_ROSE,BARREL,BREWING_STAND
2018-05-15 23:30:20 +00:00
2018-10-13 15:56:20 +00:00
# permitted entities https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/LivingEntity.html
2018-05-15 23:30:20 +00:00
# Animals, Chicken, Cow, Creature, Creeper, Flying, Ghast, Giant, Monster, Pig,
2018-05-26 10:45:39 +00:00
# PigZombie, Sheep, Skeleton, Slime, Spider, Squid, WaterMob, Wolf, Zombie, Shulker
# Husk, Stray, SkeletonHorse, ZombieHorse, Vex, Vindicator, Evoker, Endermite, PolarBear
2018-05-15 23:30:20 +00:00
# Remove living entities within a town's boundaries, if the town has the mob removal flag set.
2019-08-19 00:12:51 +00:00
town_mob_removal_entities : Monster,Flying,Slime,Shulker,ZombieHorse
2018-05-15 23:30:20 +00:00
2019-09-30 07:13:25 +00:00
# Whether the town mob removal should remove THE_KILLER_BUNNY type rabbits.
town_mob_removal_killer_bunny : 'true'
2018-05-15 23:30:20 +00:00
# Prevent the spawning of villager babies in towns.
town_prevent_villager_breeding : 'false'
# Disable creatures triggering stone pressure plates
disable_creature_pressureplate_stone : 'true'
# Globally remove living entities in all worlds that have their flag set.
2019-08-19 00:12:51 +00:00
world_mob_removal_entities : Monster,Flying,Slime,Shulker,SkeletonHorse,ZombieHorse
2018-05-15 23:30:20 +00:00
# Prevent the spawning of villager babies in the world.
world_prevent_villager_breeding : 'false'
2019-11-08 01:31:44 +00:00
# When set to true, mobs who've been named with a nametag will not be removed by the mob removal task.
mob_removal_skips_named_mobs : 'false'
2018-05-15 23:30:20 +00:00
# The maximum amount of time a mob could be inside a town's boundaries before being sent to the void.
# Lower values will check all entities more often at the risk of heavier burden and resource use.
# NEVER set below 1.
mob_removal_speed : 5s
2018-10-13 15:56:20 +00:00
# permitted entities https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/package-summary.html
2018-05-15 23:30:20 +00:00
# Animals, Chicken, Cow, Creature, Creeper, Flying, Ghast, Giant, Monster, Pig,
# PigZombie, Sheep, Skeleton, Slime, Spider, Squid, WaterMob, Wolf, Zombie
# Protect living entities within a town's boundaries from being killed by players.
2019-08-19 00:12:51 +00:00
mob_types : Animals,WaterMob,NPC,Snowman,ArmorStand
2018-05-15 23:30:20 +00:00
2018-10-13 15:56:20 +00:00
# permitted Potion Types https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionType.html
2018-05-15 23:30:20 +00:00
# ABSORPTION, BLINDNESS, CONFUSION, DAMAGE_RESISTANCE, FAST_DIGGING, FIRE_RESISTANCE, HARM, HEAL, HEALTH_BOOST, HUNGER,
# INCREASE_DAMAGE, INVISIBILITY, JUMP, NIGHT_VISION, POISON, REGENERATION, SATURATION, SLOW , SLOW_DIGGING,
# SPEED, WATER_BREATHING, WEAKNESS, WITHER.
# When preventing PVP prevent the use of these potions.
potion_types : BLINDNESS,CONFUSION,HARM,HUNGER,POISON,SLOW,SLOW_DIGGING,WEAKNESS,WITHER
############################################################
# +------------------------------------------------------+ #
# | Wilderness settings | #
# +------------------------------------------------------+ #
############################################################
# These Settings defaults only. They are copied to each worlds data files upon first detection
# To make changes for each world edit the settings in the relevant worlds data file 'plugins/Towny/data/worlds/'
unclaimed :
unclaimed_zone_build : 'false'
unclaimed_zone_destroy : 'false'
unclaimed_zone_item_use : 'false'
2018-10-13 15:56:20 +00:00
unclaimed_zone_ignore : SAPLING,GOLD_ORE,IRON_ORE,COAL_ORE,LOG,LEAVES,LAPIS_ORE,LONG_GRASS,YELLOW_FLOWER,RED_ROSE,BROWN_MUSHROOM,RED_MUSHROOM,TORCH,DIAMOND_ORE,LADDER,RAILS,REDSTONE_ORE,GLOWING_REDSTONE_ORE,CACTUS,CLAY,SUGAR_CANE_BLOCK,PUMPKIN,GLOWSTONE,LOG_2,VINE,NETHER_WARTS,COCOA
2018-05-15 23:30:20 +00:00
unclaimed_zone_switch : 'false'
############################################################
# +------------------------------------------------------+ #
# | Town Notifications | #
# +------------------------------------------------------+ #
############################################################
# This is the format for the notifications sent as players move between plots.
# Empty a particular format for it to be ignored.
# Example:
# [notification.format]
# ~ [notification.area_[wilderness/town]][notification.splitter][notification.[no_]owner][notification.splitter][notification.plot.format]
# ... [notification.plot.format]
# ... [notification.plot.homeblock][notification.plot.splitter][notification.plot.forsale][notification.plot.splitter][notification.plot.type]
# ~ Wak Town - Lord Jebus - [Home] [For Sale: 50 Beli] [Shop]
notification :
format : '&6 ~ %s'
splitter : '&7 - '
area_wilderness : '&2%s'
area_wilderness_pvp : '%s'
area_town : '&6%s'
area_town_pvp : '%s'
owner : '&a%s'
no_owner : '&a%s'
plot :
splitter : ' '
format : '%s'
homeblock : '&b[Home]'
outpostblock : '&b[Outpost]'
forsale: '&e[For Sale : %s]'
type : '&6[%s]'
2018-05-26 10:45:39 +00:00
# If set to true MC's Title and Subtitle feature will be used when crossing into a town.
# Could be seen as intrusive/distracting, so false by default.
using_titles : 'false'
2018-05-27 16:20:44 +00:00
2018-10-13 15:56:20 +00:00
# Requires the above using_titles to be set to true.
# Title and Subtitle shown when entering a town or the wilderness. By default 1st line is blank, the 2nd line shows {townname} or {wilderness}.
# You may use colour codes &f, &c and so on.
titles :
# Entering Town Upper Title Line
town_title : ''
# Entering Town Lower Subtitle line.
town_subtitle : '&b{townname}'
# Entering Wilderness Upper Title Line
wilderness_title : ''
# Entering Wilderness Lower Subtitle line.
wilderness_subtitle : '&2{wilderness}'
# If the notification.owner option should show name or {title} name.
# Titles are the ones granted by nation kings.
owner_shows_nation_title : 'false'
2018-05-27 16:20:44 +00:00
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Default Town/Plot flags | #
# +------------------------------------------------------+ #
############################################################
default_perm_flags :
# Default permission flags for residents plots within a town
#
# Can allies/friends/outsiders perform certain actions in the town
#
# build - place blocks and other items
# destroy - break blocks and other items
# itemuse - use items such as furnaces (as defined in item_use_ids)
# switch - trigger or activate switches (as defined in switch_ids)
resident :
friend :
build : 'true'
destroy : 'true'
item_use : 'true'
switch : 'true'
2019-12-05 23:46:47 +00:00
town :
build : 'false'
destroy : 'false'
item_use : 'false'
switch : 'false'
2018-05-15 23:30:20 +00:00
ally :
build : 'false'
destroy : 'false'
item_use : 'false'
switch : 'false'
outsider :
build : 'false'
destroy : 'false'
item_use : 'false'
switch : 'false'
# Default permission flags for towns
# These are copied into the town data file at creation
#
# Can allies/outsiders/residents perform certain actions in the town
#
# build - place blocks and other items
# destroy - break blocks and other items
# itemuse - use items such as flint and steel or buckets (as defined in item_use_ids)
# switch - trigger or activate switches (as defined in switch_ids)
town :
default :
pvp : 'true'
fire : 'false'
explosion : 'false'
mobs : 'false'
resident :
build : 'true'
destroy : 'true'
item_use : 'true'
switch : 'true'
2019-12-05 23:46:47 +00:00
nation :
build : 'false'
destroy : 'false'
item_use : 'false'
switch : 'false'
2018-05-15 23:30:20 +00:00
ally :
build : 'false'
destroy : 'false'
item_use : 'false'
switch : 'false'
outsider :
build : 'false'
destroy : 'false'
item_use : 'false'
switch : 'false'
2018-10-13 15:56:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Towny Invite System | #
# +------------------------------------------------------+ #
############################################################
invite_system :
# Command used to accept towny invites)
#e.g Player join town invite.
accept_command : accept
# Command used to deny towny invites
#e.g Player join town invite.
deny_command : deny
# Command used to confirm some towny actions/tasks)
#e.g Purging database or removing a large amount of townblocks
confirm_command : confirm
# Command used to cancel some towny actions/tasks
#e.g Purging database or removing a large amount of townblocks
cancel_command : cancel
# When set for more than 0m, the amount of time (in minutes) which must have passed between
# a player's first log in and when they can be invited to a town.
cooldowntime : 0m
# You can increase these limits but it is not recommended. Invites/requests are not saved between server reloads/stops.
maximum_invites_sent :
# How many invites a town can send out to players, to join the town.
town_toplayer : '35'
# How many invites a nation can send out to towns, to join the nation.
nation_totown : '35'
# How many requests a nation can send out to other nations, to ally with the nation.
# Only used when war.disallow_one_way_alliance is set to true.
nation_tonation : '35'
# You can increase these limits but it is not recommended. Invites/requests are not saved between server reloads/stops.
maximum_invites_received :
# How many invites can one player have from towns.
player : '10'
# How many invites can one town have from nations.
town : '10'
# How many requests can one nation have from other nations for an alliance.
nation : '10'
2019-12-05 23:46:47 +00:00
# When set above 0, the maximum distance a player can be from a town's spawn in order to receive an invite.
# Use this setting to require players to be near or inside a town before they can be invited.
maximum_distance_from_town_spawn : '0'
2018-10-13 15:56:20 +00:00
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Resident settings | #
# +------------------------------------------------------+ #
############################################################
resident_settings :
# player is flagged as inactive after 1 hour (default)
inactive_after_time : 1h
2019-11-08 01:31:44 +00:00
# if enabled old residents will be deleted, losing their town, townblocks, friends
2018-05-15 23:30:20 +00:00
# after Two months (default) of not logging in
delete_old_residents :
enable : 'false'
deleted_after_time : 60d
delete_economy_account : 'true'
2019-11-08 01:31:44 +00:00
# When true only residents who have no town will be deleted.
delete_only_townless : 'false'
2018-05-15 23:30:20 +00:00
# The name of the town a resident will automatically join when he first registers.
default_town_name : ''
# If true, players can only use beds in plots they personally own.
deny_bed_use : 'false'
2018-10-13 15:56:20 +00:00
# If true, players who join the server for the first time will cause the msg_registration message in the language files to be shown server-wide.
is_showing_welcome_message : 'true'
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Economy settings | #
# +------------------------------------------------------+ #
############################################################
economy :
# By default it is set to true.
# Rarely set to false. Set to false if you get concurrent modification errors on timers for daily tax collections.
use_async : 'true'
# Prefix to apply to all town economy accounts.
town_prefix : town-
# Prefix to apply to all nation economy accounts.
nation_prefix : nation-
2018-10-13 15:56:20 +00:00
# The cost of renaming a town.
town_rename_cost : '0'
# The cost of renaming a nation.
nation_rename_cost : '0'
2018-05-15 23:30:20 +00:00
spawn_travel :
# Cost to use /town spawn
price_town_spawn_travel : '0.0'
# Cost to use '/town spawn [town]' to another town in your nation.
price_town_nation_spawn_travel : '5.0'
# Cost to use '/town spawn [town]' to another town in a nation that is allied with your nation.
price_town_ally_spawn_travel : '10.0'
# Cost to use /town spawn [town]
# This is paid to the town you goto.
price_town_public_spawn_travel : '10.0'
2018-10-13 15:56:20 +00:00
# When set to true, any cost paid by a player to use any variant of '/town spawn' will be paid to the town bank.
# When false the amount will be paid to the server account whose name is set in the closed economy setting below..
town_spawn_cost_paid_to_town : 'true'
2018-05-15 23:30:20 +00:00
# The daily upkeep to remain neutral during a war. Neutrality will exclude you from a war event, as well as deterring enemies.
price_nation_neutrality : '100.0'
new_expand :
# How much it costs to start a nation.
price_new_nation : '1000.0'
# How much it costs to start a town.
price_new_town : '250.0'
# How much it costs to make an outpost. An outpost isn't limited to being on the edge of town.
2018-08-22 20:43:26 +00:00
price_outpost : '1500.0'
2018-05-15 23:30:20 +00:00
# The price for a town to expand one townblock.
price_claim_townblock : '6.25'
2019-09-30 07:13:25 +00:00
# How much every additionally claimed townblock increases in cost. Set to 1 to deactivate this. 1.3 means +30% to every bonus claim block cost.
price_claim_townblock_increase : '1.0'
# The amount refunded to a town when they unclaim a townblock.
2019-12-05 23:46:47 +00:00
# Warning: do not set this higher than the cost to claim a townblock.
2019-09-30 07:13:25 +00:00
# It is advised that you do not set this to the same price as claiming either, otherwise towns will get around using outposts to claim far away.
price_claim_townblock_refund : '0.0'
2018-05-15 23:30:20 +00:00
# How much it costs a player to buy extra blocks.
2018-10-13 15:56:20 +00:00
price_purchased_bonus_townblock : '75.0'
2018-05-15 23:30:20 +00:00
# How much every extra bonus block costs more. Set to 1 to deactivate this. 1.2 means +20% to every bonus claim block cost.
2018-08-22 20:43:26 +00:00
price_purchased_bonus_townblock_increase : '1.2'
2018-05-15 23:30:20 +00:00
death :
# Either fixed or percentage.
# For percentage 1.0 would be 100%. 0.01 would be 1%.
price_death_type : fixed
2018-10-13 15:56:20 +00:00
# A maximum amount paid out by a resident from their personal holdings for percentage deaths.
# Set to 0 to have no cap.
percentage_cap : '0.0'
2018-05-15 23:30:20 +00:00
# If True, only charge death prices for pvp kills. Not monsters/environmental deaths.
price_death_pvp_only : 'false'
price_death : '1.0'
price_death_town : '0.0'
price_death_nation : '0.0'
banks :
# Maximum amount of money allowed in town bank
# Use 0 for no limit
town_bank_cap : '0.0'
2019-12-05 23:46:47 +00:00
# Set to true to allow withdrawals from town banks
town_allow_withdrawals : 'true'
2018-05-15 23:30:20 +00:00
# Maximum amount of money allowed in nation bank
# Use 0 for no limit
nation_bank_cap : '0.0'
2019-12-05 23:46:47 +00:00
# Set to true to allow withdrawals from nation banks
nation_allow_withdrawals : 'true'
2018-10-13 15:56:20 +00:00
# When set to true, players can only use their town withdraw/deposit commands while inside of their own town.
# Likewise, nation banks can only be withdrawn/deposited to while in the capital city.
disallow_bank_actions_outside_town : 'false'
2018-05-15 23:30:20 +00:00
closed_economy :
# The name of the account that all money that normally disappears goes into.
server_account : towny-server
# Turn on/off whether all transactions that normally don't have a second party are to be done with a certain account.
# Eg: The money taken during Daily Taxes is just removed. With this on, the amount taken would be funneled into an account.
# This also applies when a player collects money, like when the player is refunded money when a delayed teleport fails.
enabled : 'false'
daily_taxes :
# Enables taxes to be collected daily by town/nation
# If a town can't pay it's tax then it is kicked from the nation.
# if a resident can't pay his plot tax he loses his plot.
# if a resident can't pay his town tax then he is kicked from the town.
# if a town or nation fails to pay it's upkeep it is deleted.
enabled : 'true'
# Maximum tax amount allowed when using flat taxes
max_tax_amount : '1000.0'
# maximum tax percentage allowed when taxing by percentages
max_tax_percent : '25'
# The server's daily charge on each nation. If a nation fails to pay this upkeep
# all of it's member town are kicked and the Nation is removed.
2018-08-22 20:43:26 +00:00
price_nation_upkeep : '250.0'
2019-09-30 07:13:25 +00:00
# Uses total number of towns in the nation to determine upkeep instead of nation level (Number of Residents)
# calculated by (number of towns in nation X price_nation_upkeep).
nation_pertown_upkeep : 'false'
# If set to true, the per-town-upkeep system will be modified by the Nation Levels' upkeep modifiers.
nation_pertown_upkeep_affected_by_nation_level_modifier : 'false'
2018-05-15 23:30:20 +00:00
# The server's daily charge on each town. If a town fails to pay this upkeep
# all of it's residents are kicked and the town is removed.
2018-08-22 20:43:26 +00:00
price_town_upkeep : '5.0'
2018-05-15 23:30:20 +00:00
# Uses total amount of owned plots to determine upkeep instead of the town level (Number of residents)
# calculated by (number of claimed plots X price_town_upkeep).
2018-08-22 20:43:26 +00:00
town_plotbased_upkeep : 'true'
2018-05-26 10:45:39 +00:00
# If set to true, the plot-based-upkeep system will be modified by the Town Levels' upkeep modifiers.
2018-08-22 20:43:26 +00:00
town_plotbased_upkeep_affected_by_town_level_modifier : 'true'
2019-12-05 23:46:47 +00:00
# If set to any amount over zero, if a town's plot-based upkeep totals less than this value, the town will pay the minimum instead.
town_plotbased_upkeep_minimum_amount : '0.0'
2019-09-30 07:13:25 +00:00
# The server's daily charge on a town which has claimed more townblocks than it is allowed.
price_town_overclaimed_upkeep_penalty : '0.0'
# Uses total number of plots that the town is overclaimed by, to determine the price_town_overclaimed_upkeep_penalty cost.
# If set to true the penalty is calculated (# of plots overclaimed X price_town_overclaimed_upkeep_penalty).
price_town_overclaimed_upkeep_penalty_plotbased : 'false'
2018-05-15 23:30:20 +00:00
# If enabled and you set a negative upkeep for the town
# any funds the town gains via upkeep at a new day
# will be shared out between the plot owners.
use_plot_payments : 'false'
2019-12-05 23:46:47 +00:00
plot_type_costs :
# Cost to use /plot set shop to change a normal plot to a shop plot.
set_commercial : '0.0'
# Cost to use /plot set arena to change a normal plot to a arena plot.
set_arena : '0.0'
# Cost to use /plot set embassy to change a normal plot to a embassy plot.
set_embassy : '0.0'
# Cost to use /plot set wilds to change a normal plot to a wilds plot.
set_wilds : '0.0'
# Cost to use /plot set inn to change a normal plot to a inn plot.
set_inn : '0.0'
# Cost to use /plot set jail to change a normal plot to a jail plot.
set_jail : '0.0'
# Cost to use /plot set farm to change a normal plot to a farm plot.
set_farm : '0.0'
# Cost to use /plot set bank to change a normal plot to a bank plot.
set_bank : '0.0'
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Jail Plot settings | #
# +------------------------------------------------------+ #
############################################################
jail :
#If true attacking players who die on enemy-town land will be placed into the defending town's jail if it exists.
2018-05-26 10:45:39 +00:00
#Requires town_respawn to be true in order to work.
2018-11-24 22:22:39 +00:00
is_jailing_attacking_enemies : 'true'
2018-05-26 10:45:39 +00:00
#If true attacking players who are considered an outlaw, that are killed inside town land will be placed into the defending town's jail if it exists.
#Requires town_respawn to be true in order to work.
2018-11-24 22:22:39 +00:00
is_jailing_attacking_outlaws : 'true'
2018-05-15 23:30:20 +00:00
#If true jailed players can use Ender Pearls but are still barred from using other methods of teleporting.
jail_allows_ender_pearls : 'false'
#If false jailed players can use /town leave, and escape a jail.
jail_denies_town_leave : 'false'
bail :
#If true players can pay a bail amount to be unjailed.
is_allowing_bail : 'false'
2019-12-05 23:46:47 +00:00
#Amount that bail costs for normal residents/nomads.
2018-05-15 23:30:20 +00:00
bail_amount : '10'
2019-12-05 23:46:47 +00:00
#Amount that bail costs for Town mayors.
bail_amount_mayor : '10'
#Amount that bail costs for Nation kings.
bail_amount_king : '10'
2019-11-08 01:31:44 +00:00
# Commands which a jailed player cannot use.
blacklisted_commands : home,spawn,teleport,tp,tpa,tphere,tpahere,back,dback,ptp,jump,kill,warp,suicide
2018-05-15 23:30:20 +00:00
2018-10-13 15:56:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Bank Plot settings | #
# +------------------------------------------------------+ #
############################################################
# Bank plots may be used by other economy plugins using the Towny API.
bank :
# If true players will only be able to use /t deposit, /t withdraw, /n deposit & /n withdraw while inside bank plots belonging to the town or nation capital respectively.
# Home plots will also allow deposit and withdraw commands.
is_banking_limited_to_bank_plots : 'false'
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | War settings | #
# +------------------------------------------------------+ #
############################################################
war :
#This setting allows you disable the ability for a nation to pay to remain neutral during a war.
2019-02-11 21:37:37 +00:00
nation_can_be_neutral : 'true'
2018-10-13 15:56:20 +00:00
#By setting this to true, nations will receive a prompt for alliances and alliances will show on both nations.
2018-11-24 18:07:35 +00:00
disallow_one_way_alliance : 'true'
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Economy Transfers During War settings | #
# +------------------------------------------------------+ #
############################################################
economy :
enemy :
# Amount charged to place a warflag (payed to server).
place_flag : '10'
# Amount payed from the flagbearer to the defender after defending the area.
defended_attack : '10'
# Defending town pays attaking flagbearer. If a negative (attacker pays defending town),
# and the attacker can't pay, the attack is canceled.
townblock_won : '3'
# Same as townblock_won but for the special case of winning the homeblock.
homeblock_won : '100'
############################################################
# +------------------------------------------------------+ #
# | War Event settings | #
# +------------------------------------------------------+ #
############################################################
2018-12-10 23:07:54 +00:00
# This is started with /townyadmnin toggle war
2018-05-15 23:30:20 +00:00
# In peace time War spoils are accumulated from towns and nations being
# deleted with any money left in the bank.
#
# These funds are increased during a war event upon a player death.
# An additional bonus to the war chest is set in base_spoils.
#
# During the event a town losing a townblock pays the wartime_town_block_loss_price to the attacking town.
# The war is won when the only nations left in the battle are allies, or only a single nation.
#
# The winning nations share half of the war spoils.
# The remaining half is paid to the town which took the most town blocks, and lost the least.
event :
warning_delay : '30'
#If false all towns not in nations can be attacked during a war event.
2018-11-24 22:38:54 +00:00
towns_are_neutral : 'false'
2018-05-26 10:45:39 +00:00
enemy :
# If true, enemy's can only attack the edge plots of a town in war.
only_attack_borders : 'true'
plots :
# If true, nation members and allies can regen health on plots during war.
healable : 'true'
# If true, fireworks will be launched at plots being attacked or healed in war every war tick.
firework_on_attacked : 'true'
2018-05-15 23:30:20 +00:00
# If true and the monarch/king dies the nation is removed from the war.
remove_on_monarch_death : 'false'
2018-05-26 10:45:39 +00:00
# If enabled players will be able to break/place any blocks in enemy plots during a war.
# This setting SHOULD NOT BE USED unless you want the most chaotic war possible.
# The editable_materials list in the Warzone Block Permission section should be used instead.
allow_block_griefing : 'false'
2018-05-15 23:30:20 +00:00
# A townblock takes damage every 5 seconds that an enemy is stood in it.
block_hp :
2018-11-24 18:07:35 +00:00
town_block_hp : '20'
2018-05-15 23:30:20 +00:00
home_block_hp : '120'
eco :
# This amount is new money injected into the economy with a war event.
base_spoils : '100.0'
# This amount is taken from the losing town for each plot lost.
2018-11-24 18:07:35 +00:00
wartime_town_block_loss_price : '0.0'
2018-05-15 23:30:20 +00:00
# This amount is taken from the player if they die during the event
price_death_wartime : '200.0'
2018-05-26 10:45:39 +00:00
# If set to true when a town drops an enemy townblock's HP to 0, the attacking town gains a bonus townblock,
# and the losing town gains a negative (-1) bonus townblock.
costs_townblocks : 'false'
2019-12-05 23:46:47 +00:00
# If set to true when a town drops an enemy townblock's HP to 0, the attacking town takes full control of the townblock.
# One available (bonus) claim is given to the victorious town, one available (bonus) claim is removed from the losing town.
winner_takes_ownership_of_townblocks : 'false'
2018-05-15 23:30:20 +00:00
points :
points_townblock : '1'
2018-11-24 18:07:35 +00:00
points_town : '0'
points_nation : '0'
points_kill : '0'
2018-05-15 23:30:20 +00:00
# The minimum height at which a player must stand to count as an attacker.
min_height : '60'
############################################################
# +------------------------------------------------------+ #
2019-12-05 23:46:47 +00:00
# | Flag War Settings | #
2018-05-26 10:45:39 +00:00
# | | #
2019-12-05 23:46:47 +00:00
# | [Separate from Event War] | #
# | -------------------------------- | #
# | DEPRECATED: Minimally Supported Through | #
# | 3rd Party Contributions Only | #
2018-05-15 23:30:20 +00:00
# +------------------------------------------------------+ #
############################################################
2018-05-27 16:20:44 +00:00
2018-05-15 23:30:20 +00:00
enemy :
# If false, players won't be able to place war flags, effectively disabling warzones.
allow_attacks : 'false'
# If true, enemy's can only attack the edge plots of a town with war flags.
only_attack_borders : 'true'
# This many people must be online in target town in order to place a war flag in their domain.
min_players_online_in_town : '2'
# This many people must be online in target nation in order to place a war flag in their domain.
min_players_online_in_nation : '3'
max_active_flags_per_player : '1'
flag :
2019-12-05 23:46:47 +00:00
# This setting modifies the time between a war flag's Material shift. Accepts `s`(seconds) and `m`(minutes).
# Currently, you would multiply this times 10 to get the total time a flag should be in play.
# (It can also be set to `h` and `d` - but ain't nobody got time fo' that.)
2018-05-15 23:30:20 +00:00
waiting_time : 1m
# This is the block a player must place to trigger the attack event.
2019-12-05 23:46:47 +00:00
base_block : oak_fence
2018-05-15 23:30:20 +00:00
# This is the block a player must place to trigger the attack event.
light_block : torch
beacon :
# Must be smaller than half the size of town_block_size.
radius : '3'
# The range the beacon will be drawn in. It's flexibility is in case the flag is close to the height limit.
# If a flag is too close to the height limit (lower than the minimum), it will not be drawn.
height_above_flag :
min : '3'
max : '64'
draw : 'true'
wireframe_block : glowstone
2019-12-05 23:46:47 +00:00
# While true, prevent players from performing certain actions while their town
# has an active enemy war flag placed.
prevent_interaction_while_flagged : 'true'
# While true, prevent players from performing certain actions while a town in their nation
# has an active enemy war flag placed.
prevent_nation_interaction_while_flagged : 'true'
# This is how much time that must pass after a town in a nation has been flagged
# before certain actions can be performed, measured in milliseconds.
time_to_wait_after_flagged : '600000'
# If set to true, when a war flag finishes it's countdown successfully, the attacking town takes full control of the townblock.
# Setting this to 'False' will result only in monetary exchanges.
flag_takes_ownership_of_townblocks : 'true'
2018-05-15 23:30:20 +00:00
############################################################
# +------------------------------------------------------+ #
# | Warzone Block Permissions | #
2018-05-26 10:45:39 +00:00
# | | #
# | Used in Flag & Event Wars | #
2018-05-15 23:30:20 +00:00
# +------------------------------------------------------+ #
############################################################
warzone :
2019-12-05 23:46:47 +00:00
# List of materials that can be modified in a warzone.
2018-05-15 23:30:20 +00:00
# '*' = Allow all materials.
# Prepend a '-' in front of a material to remove it. Used in conjunction with when you use '*'.
# Eg: '*,-chest,-furnace'
2019-12-05 23:46:47 +00:00
editable_materials : tnt,oak_fence,birch_fence,spruce_fence,jungle_fence,dark_oak_fence,acacia_fence,ladder,oak_door,birch_door,spruce_door,jungle_door,dark_oak_door,acacia_fence,iron_door,fire
2018-05-15 23:30:20 +00:00
item_use : 'true'
switch : 'true'
# Add '-fire' to editable materials for complete protection when setting is false. This prevents fire to be created and spread.
fire : 'true'
explosions : 'true'
explosions_break_blocks : 'true'
# Only under affect when explosions_break_blocks is true.
explosions_regen_blocks : 'true'
2018-05-26 10:45:39 +00:00
# A list of blocks that will not be exploded, mostly because they won't regenerate properly.
# These blocks will also protect the block below them, so that blocks like doors do not dupe themselves.
# Only under affect when explosions_break_blocks is true.
explosions_ignore_list : WOODEN_DOOR,ACACIA_DOOR,DARK_OAK_DOOR,JUNGLE_DOOR,BIRCH_DOOR,SPRUCE_DOOR,IRON_DOOR,CHEST,TRAPPED_CHEST,FURNACE,BURNING_FURNACE,DROPPER,DISPENSER,HOPPER,ENDER_CHEST,WHITE_SHULKER_BOX,ORANGE_SHULKER_BOX,MAGENTA_SHULKER_BOX,LIGHT_BLUE_SHULKER_BOX,YELLOW_SHULKER_BOX,LIME_SHULKER_BOX,PINK_SHULKER_BOX,GRAY_SHULKER_BOX,SILVER_SHULKER_BOX,CYAN_SHULKER_BOX,PURPLE_SHULKER_BOX,BLUE_SHULKER_BOX,BROWN_SHULKER_BOX,GREEN_SHULKER_BOX,RED_SHULKER_BOX,BLACK_SHULKER_BOX,NOTE_BLOCK,LEVER,STONE_PLATE,IRON_DOOR_BLOCK,WOOD_PLATE,JUKEBOX,DIODE_BLOCK_OFF,DIODE_BLOCK_ON,FENCE_GATE,GOLD_PLATE,IRON_PLATE,REDSTONE_COMPARATOR_OFF,REDSTONE_COMPARATOR_ON,BEACON