config.yml

############################################################
# +------------------------------------------------------+ #
# |             block/item/mob protection                | #
# +------------------------------------------------------+ #
############################################################

protection:

    # Prevent fly and double block jump cheats.
    cheat_protection: 'false'

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

    # Globally remove living entities in all worlds that have their flag set.
    world_mob_removal_entities: WaterMob,Flying,Slime

    # 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
    item_use_ids: 259,325,326,327,351

    # permitted entities http://jd.bukkit.org/apidocs/org/bukkit/entity/package-summary.html
    # Animals, Chicken, Cow, Creature, Creeper, Flying, Ghast, Giant, Monster, Pig,
    # PigZombie, Sheep, Skeleton, Slime, Spider, Squid, WaterMob, Wolf, Zombie

    # Remove living entities within a town's boundaries, if the town has the mob removal flag set.
    town_mob_removal_entities: Monster,WaterMob,Flying,Slime

    # Items which can be blocked or enabled via town/plot flags
    # 25 - noteblock
    # 54 - chest
    # 61 - furnace
    # 62 - lit furnace
    # 64 - wooden door
    # 69 - lever
    # 70 - stone pressure plate
    # 71 - iron door
    # 72 - wooden pressure plate
    # 77 - stone button
    # 96 - trap door
    # 84 - jukebox
    # 93/94 - redstone repeater
    switch_ids: 25,54,61,62,64,69,70,71,72,77,96,84,93,94


############################################################
# +------------------------------------------------------+ #
# |             Default Town/Plot flags                  | #
# +------------------------------------------------------+ #
############################################################


default_perm_flags:

    # 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:
        ally:
            destroy: 'false'
            item_use: 'false'
            switch: 'true'
            build: 'false'
        outsider:
            destroy: 'false'
            item_use: 'false'
            switch: 'false'
            build: 'false'
        resident:
            destroy: 'false'
            item_use: 'false'
            switch: 'true'
            build: 'false'

    # 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:
        ally:
            destroy: 'false'
            item_use: 'false'
            switch: 'false'
            build: 'false'
        outsider:
            destroy: 'false'
            item_use: 'false'
            switch: 'false'
            build: 'false'
        friend:
            destroy: 'true'
            item_use: 'true'
            switch: 'true'
            build: 'true'


############################################################
# +------------------------------------------------------+ #
# |                  Economy settings                    | #
# +------------------------------------------------------+ #
############################################################

economy:
    # How much it costs to make an outpost. An outpost isn't limited to being on the edge of town.
    price_outpost: '500.0'
    # Cost to use /town spawn [town]
    # This is paid to the town you goto.
    price_town_public_spawn_travel: '10.0'
    # How much it costs to start a town.
    price_new_town: '250.0'
    price_death_wartime: '200.0'
    # 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.
    price_town_upkeep: '10.0'
    # Cost to use /town spawn
    price_town_spawn_travel: '10.0'
    # The price for a town to expand one townblock.
    price_claim_townblock: '25.0'
    price_death: '10.0'
    # How much it costs to start a nation.
    price_new_nation: '1000.0'
    # 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.
    price_nation_upkeep: '100.0'
    # 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'


############################################################
# +------------------------------------------------------+ #
# |             Default new world settings               | #
# +------------------------------------------------------+ #
############################################################

# These flags are only used at the initial setp of a new world.

# Once Towny is running each world can be altered from within game
# using '/townyworld toggle'

new_world_settings:
    # force_pvp_on is a global flag and overrides any towns flag setting
    force_pvp_on: 'false'
    # force_fire_on is a global flag and overrides any towns flag setting
    force_fire_on: 'false'
    # force_town_monsters_on is a global flag and overrides any towns flag setting
    force_town_monsters_on: 'false'
    # Disable creatures trampling crops
    disable_creature_crop_trampling: 'true'
    # force_explosions_on is a global flag and overrides any towns flag setting
    force_explosions_on: 'false'
    # Disable players trampling crops
    disable_player_crop_trampling: 'true'
    # world_monsters_on is a global flag setting per world.
    world_monsters_on: 'true'


############################################################
# +------------------------------------------------------+ #
# |                Global town settings                  | #
# +------------------------------------------------------+ #
############################################################

global_town_settings:

    # 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
    # Allow the use of /town spawn
    allow_town_spawn: 'true'

    # 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.
    daily_taxes: 'false'
    # Respawn the player at his town spawn point when he/she dies
    town_respawn: 'false'
    # can residents/Allies harm other residents when in a town with pvp enabled?
    friendly_fire: 'true'
    # If non zero it delays any spawn request by x seconds.
    teleport_warmup_time: '0'
    # Players within their town or allied towns will regenerate half a heart after every health_regen_speed seconds.
    health_regen:
        speed: '3'
        enable: 'true'
    # Allow regular residents to use /town spawn [town] (TP to other towns if they are public).
    allow_town_spawn_travel: 'true'
    # Allow towns to claim outposts (a townblock not connected to town).
    allow_outposts: 'true'
    # 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'


############################################################
# +------------------------------------------------------+ #
# |                  Wartime settings                    | #
# +------------------------------------------------------+ #
############################################################

war:
    wartime_points_kill: '1'
    wartime_home_block_hp: '120'
    wartime_remove_on_monarch_death: 'false'
    wartime_points_town: '10'
    wartime_warning_delay: '30'
    #This setting allows you disable the ability for a nation to pay to remain neutral during a war.
    wartime_nation_can_be_neutral: 'true'
    wartime_points_townblock: '1'
    wartime_min_height: '60'
    wartime_town_block_loss_price: '100'
    wartime_points_nation: '100'
    wartime_base_spoils: '100'
    wartime_town_block_hp: '60'


############################################################
# +------------------------------------------------------+ #
# |                 Plugin interfacing                   | #
# +------------------------------------------------------+ #
############################################################

plugin:
    # The time taken between each "day". At the start of each day, taxes will be collected.
    # Judged in seconds. Default is 24 hours.
    day_interval: 1d
    interfacing:
        # Enable if you are using cooldowns in essentials for teleports.
        using_essentials: 'true'
        using_permissions: 'true'
        using_questioner: 'true'
        using_iconomy: 'true'
    # Record all messages to the towny.log
    logging: 'true'
    # Lots of messages to tell you what's going on in the server with time taken for events.
    debug_mode: 'false'
    # If true this will cause the log to be wiped at every startup.
    reset_log_on_boot: 'true'
    database:
        database_save: flatfile
        flatfile_backup: zip
        database_load: flatfile
        daily_backups: 'true'
    # Spams the player named in dev_name with all messages related to towny.
    dev_mode:
        dev_name: ElgarL
        enable: 'false'
version:
    last_run_version: 0.75.1
    # This is for showing the changelog on updates.  Please do not edit.
    version: 0.75.1
levels:

    ############################################################
    # +------------------------------------------------------+ #
    # |                default Nation levels                 | #
    # +------------------------------------------------------+ #
    ############################################################

    nation_level:
    -   capitalPostfix: ''
        upkeepModifier: 1.0
        namePostfix: ' (Nation)'
        kingPrefix: 'Leader '
        namePrefix: 'Land of '
        numResidents: 0
        capitalPrefix: ''
        kingPostfix: ''
    -   capitalPostfix: ''
        upkeepModifier: 1.0
        namePostfix: ' (Nation)'
        kingPrefix: 'Count '
        namePrefix: 'Federation of '
        numResidents: 10
        capitalPrefix: ''
        kingPostfix: ''
    -   capitalPostfix: ''
        upkeepModifier: 1.0
        namePostfix: ' (Nation)'
        kingPrefix: 'Duke '
        namePrefix: 'Dominion of '
        numResidents: 20
        capitalPrefix: ''
        kingPostfix: ''
    -   capitalPostfix: ''
        upkeepModifier: 1.0
        namePostfix: ' (Nation)'
        kingPrefix: 'King '
        namePrefix: 'Kingdom of '
        numResidents: 30
        capitalPrefix: ''
        kingPostfix: ''
    -   capitalPostfix: ''
        upkeepModifier: 1.0
        namePostfix: ' Empire'
        kingPrefix: 'Emperor '
        namePrefix: 'The '
        numResidents: 40
        capitalPrefix: ''
        kingPostfix: ''
    -   capitalPostfix: ''
        upkeepModifier: 1.0
        namePostfix: ' Realm'
        kingPrefix: 'God Emperor '
        namePrefix: 'The '
        numResidents: 60
        capitalPrefix: ''
        kingPostfix: ''

    ############################################################
    # +------------------------------------------------------+ #
    # |                 default Town levels                  | #
    # +------------------------------------------------------+ #
    ############################################################

    town_level:
    -   upkeepModifier: 1.0
        namePostfix: ' Ruins'
        mayorPrefix: 'Spirit '
        mayorPostfix: ''
        townBlockLimit: 1
        namePrefix: ''
        numResidents: 0
    -   upkeepModifier: 1.0
        namePostfix: ' (Settlement)'
        mayorPrefix: 'Hermit '
        mayorPostfix: ''
        townBlockLimit: 16
        namePrefix: ''
    -   upkeepModifier: 1.0
        namePostfix: ' (Hamlet)'
        mayorPrefix: 'Chief '
        mayorPostfix: ''
        townBlockLimit: 32
        namePrefix: ''
        numResidents: 2
    -   upkeepModifier: 1.0
        namePostfix: ' (Village)'
        mayorPrefix: 'Baron Von '
        mayorPostfix: ''
        townBlockLimit: 96
        namePrefix: ''
        numResidents: 6
    -   upkeepModifier: 1.0
        namePostfix: ' (Town)'
        mayorPrefix: 'Viscount '
        mayorPostfix: ''
        townBlockLimit: 160
        namePrefix: ''
        numResidents: 10
    -   upkeepModifier: 1.0
        namePostfix: ' (Large Town)'
        mayorPrefix: 'Count Von '
        mayorPostfix: ''
        townBlockLimit: 224
        namePrefix: ''
        numResidents: 14
    -   upkeepModifier: 1.0
        namePostfix: ' (City)'
        mayorPrefix: 'Earl '
        mayorPostfix: ''
        townBlockLimit: 320
        namePrefix: ''
        numResidents: 20
    -   upkeepModifier: 1.0
        namePostfix: ' (Large City)'
        mayorPrefix: 'Duke '
        mayorPostfix: ''
        townBlockLimit: 384
        namePrefix: ''
        numResidents: 24
    -   upkeepModifier: 1.0
        namePostfix: ' (Metropolis)'
        mayorPrefix: 'Lord '
        mayorPostfix: ''
        townBlockLimit: 448
        namePrefix: ''
        numResidents: 28


############################################################
# +------------------------------------------------------+ #
# |                  Resident settings                   | #
# +------------------------------------------------------+ #
############################################################

resident_settings:
    # player is flagged as inactive after 1 hour (default)
    inactive_after_time: 1h
    # The name of the town a resident will automatically join when he first registers.
    default_town_name: ''
    # if enabled old residents will be kicked and deleted from a town
    # after Two months (default) of not logging in
    delete_old_residents:
        enable: 'false'
        deleted_after_time: 60d


############################################################
# +------------------------------------------------------+ #
# |             Unclaimed plot settings                  | #
# +------------------------------------------------------+ #
############################################################

unclaimed:
    unclaimed_zone_switch: 'true'
    unclaimed_zone_ignore: 6,14,15,16,17,18,21,31,37,38,39,40,50,56,65,66,73,74,81,82,83,86,89
    unclaimed_zone_item_use: 'false'
    unclaimed_zone_build: 'false'
    unclaimed_zone_destroy: 'false'

############################################################
# +------------------------------------------------------+ #
# |                   Permission nodes                   | #
# +------------------------------------------------------+ #
############################################################

#  Possible permission nodes
#
#    towny.admin: User is able to use /townyadmin, as well as the ability to build/destroy anywhere. User is also able to make towns or nations when set to admin only.
#    towny.cheat.bypass : User is able to use any fly mods and double block jump (disables towny cheat protection for this user).
#    towny.town.new :User is able to create a town
#    towny.town.claim : User is able to expand his town with /town claim
#    towny.town.plot : User is able to use the /plot commands
#    towny.town.resident : User is able to join towns upon invite.
#    towny.nation.new :User is able to create a nation
#    towny.wild.*: User is able to build/destroy in wild regardless.
#        towny.wild.build
#        towny.wild.destroy
#        towny.wild.switch
#        towny.wild.item_use
#    towny.wild.block.[block id].* : User is able to edit [block id] in the wild.
#    towny.spawntp :Use /town spawn
#    towny.publicspawntp : Use ''/town spawn [town]'' (teleport to other towns)
#
# these will be moved to permissions nodes at a later date
permissions:
    town_creation_admin_only: 'false'
    nation_creation_admin_only: 'false'

# The language file you wish to use
language: english.yml

############################################################
# +------------------------------------------------------+ #
# |               Town Claim/new defaults                | #
# +------------------------------------------------------+ #
############################################################

town:
    # maximum number of plots any single resident can own
    max_plots_per_resident: '2'

    # 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: '5'
    # 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: '20'
    # Maximum number of towns allowed on the server.
    town_limit: '3000'

    # 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.
    town_block_ratio: '16'

    # Maximum distance between homblocks.
    # This will force players to build close together.
    max_distance_between_homeblocks: '0'


############################################################
# +------------------------------------------------------+ #
# |               Filters colour and chat                | #
# +------------------------------------------------------+ #
############################################################

filters_colour_chat:

    # Text colouring
    # --------------
    # Black = &0, Navy = &1, Green = &2, Blue = &3, Red = &4
    # Purple = &5, Gold = &6, LightGray = &7, Gray = &8
    # DarkPurple = &9, LightGreen = &a, LightBlue = &b
    # Rose = &c, LightPurple = &d, Yellow = &e, White = &f

    # Chat colours
    colour:
        mayor: '&b'
        king: '&6'
    # This is the name given to any NPC assigned mayor.
    npc_prefix: NPC
    # Regex fields used in validating inputs.
    regex:
        name_remove_regex: '[^a-zA-Z0-9._-]'
        name_check_regex: ^[a-zA-Z0-9._-]*$
        name_filter_regex: '[ /]'

    # The format below will specify the changes made to the player name when chatting.
    # keys are
    # {nation} - Displays nation name in [ ] if a member of a nation.
    # {town} - Displays town name in [ ] if a member of a town.
    # {permprefix} - Permission group prefix
    # {townynameprefix} - Towny name prefix taken from the townLevel/nationLevels
    # {playername} - default player name
    # {modplayername} - modified player name (use if Towny is over writing some other plugins changes).
    # {townynamepostfix} - Towny name postfix taken from the townLevel/nationLevels.
    # {permsuffix} - Permission group suffix.
    modify_chat:
        enable: 'false'
        max_title_length: '15'
        format: '{nation}{town}{permprefix}{townynameprefix}{playername}{townynamepostfix}{permsuffix}'