# BlueMap-Towny > *[BlueMap](https://github.com/BlueMap-Minecraft/BlueMap) addon for showing your [Towny](https://github.com/TownyAdvanced/Towny) towns on your beautiful map* Configuration, placeholders and main features heavily inspired by Dynmap-Towny. Has support for holes in claims and claims outside main town. Does not have support for external plugins hooking into placeholders. ## Installation Put the plugin jar file inside your plugins folder and have both Towny and BlueMap installed. The plugin does not come with any default icons. I recommend just using [Dynmap's marker icons](https://github.com/webbukkit/dynmap/tree/v3.0/DynmapCore/src/main/resources/markers) ## Config ```yml # BlueMap-Towny configuration # https://github.com/Chicken/BlueMap-Towny#config # Seconds between checks for marker updates update-interval: 30 # Display name of the marker set shown in BlueMap UI marker-set-name: Towns # Label for town markers, %name% is replaced with the town name town-label: '%name%' # Label for outpost markers, %name% is replaced with the town name, %index% with the outpost number outpost-label: '%name% Outpost %index%' # Set by /n set mapcolor dynamic-nation-colors: true # Set by /t set mapcolor dynamic-town-colors: true # HTML for town popup, placeholders documented in README popup: '%name% (%nation%)
Mayor %mayor%
Residents %residents%
Bank %bank%' # HTML for War popup(SiegeWar Only), placeholders documented in README popup-siege: 'Siege: %attacker% vs %defender%

Town %name%
Type %siege_type%
War Chest %war_chest%
Siege Progress %sessions_completed%/%sessions_total%
Siege Status %siege_status%
Siege Balance %siege_balance%
Banner Control %banner_control%
Battle Points %battle_points_attacker% / %battle_points_defender%
Battle Time Left %battle_time_left%' # If you want claims with holes in them to show up as fully claimed if only the perimeter is claimed. # This means that the map will LIE about the actual claim status of the area!!! lie-about-holes: false # For servers with a lot of towns, filter smaller ones out of the map, -1 to disable filter min-town-blocks: -1 min-residents: -1 style: # Y-level to put area markers at, icons are at spawn positions y-level: 62 # Use y level of town home for areas, fallback to y-level use-home-y: false # Town border settings border-color: '#FF0000' border-opacity: 0.8 border-width: 3 # Town fill settings fill-color: '#FF0000' fill-opacity: 0.35 # Path to icons on web or a link # Town home home-icon-enabled: false home-icon: assets/house.png home-icon-anchor-x: 8 home-icon-anchor-y: 8 # Nation capital capital-icon-enabled: false capital-icon: assets/king.png capital-icon-anchor-x: 8 capital-icon-anchor-y: 8 # Icon during war war-icon-enabled: false war-icon: assets/war.png war-icon-anchor-x: 8 war-icon-anchor-y: 8 # Icon for ruined towns ruined-icon-enabled: false ruined-icon: assets/ruined.png ruined-icon-anchor-x: 8 ruined-icon-anchor-y: 8 # Icon for outposts outpost-icon-enabled: false outpost-icon: assets/tower.png outpost-icon-anchor-x: 8 outpost-icon-anchor-y: 8 ``` ### Label placeholders `town-label` and `outpost-label` support the following placeholders: | Placeholder | Content | |-------------|---------------------------------| | `%name%` | Town name | | `%index%` | Outpost number (outpost-label only) | ### Popup placeholders | Placeholder | Content | |--------------------------|------------------------------------------------------------------------| | `%name%` | Town name | | `%mayor%` | Town mayor | | `%residents%` | Town residents | | `%assistants%` | Town assistants | | `%residentdisplaynames%` | Town residents but display names | | `%residentcount%` | Number of town residents | | `%founded%` | Town founding date | | `%board%` | Town board text | | `%trusted%` | Town trusted residents | | `%tax%` | Town tax | | `%bank%` | Town bank balance | | `%nation%` | Nation of the town | | `%nationstatus%` | Capital/Member of ... | | `%public%` | Town publicity status | | `%peaceful%` | Is the town peaceful | | `%flags%` | Flags of the town (pvp, mobs...) | | `%war%` | Has active war (Works for EventWar/FlagWar) | | `%town_culture%` | Culture of town, see https://github.com/TownyAdvanced/TownyCultures | | `%town_resources%` | Resources of town, see https://github.com/TownyAdvanced/TownyResources | ### [SiegeWar](https://github.com/TownyAdvanced/SiegeWar) Placeholders | Placeholder | Content | |----------------------------|---------------------------------------------| | `%attacker%` | Attacking town/nation in war | | `%defender%` | Defending town/nation in war | | `%siege_type%` | Type of Siege (Conquest, Revolt etc) | | `%sessions_completed%` | Battle Sessions completed | | `%session_total%` | Total amount of Battle Sessions | | `%war_chest%` | War Chest (If economy is enabled for Towny) | | `%banner_control%` | the ones controlling the banner | | `%siege_status%` | Siege status | | `%siege_balance%` | Siege balance | | `%battle_points_attacker%` | Battle points on the attacker's side | | `%battle_points_defender%` | Battle points on the defender's side | | `%battle_time_left%` | Time left in the Battle Session |

Published on	April 17, 2026
Downloads	8

BlueMap-Towny

Release 2.4.0

Antti released BlueMap-Towny version 2.4.0 on April 17, 2026

Information

Platforms

Dependencies

Release
2.4.0