{"id":33068,"date":"2026-06-01T18:18:58","date_gmt":"2026-06-01T15:18:58","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/"},"modified":"2026-06-01T18:18:58","modified_gmt":"2026-06-01T15:18:58","slug":"bluemap-towny","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/","title":{"rendered":"BlueMap-Towny"},"content":{"rendered":"

# BlueMap-Towny<\/p>\n

> *BlueMap addon for showing your Towny towns on your beautiful map*<\/p>\n

Configuration, placeholders and main features heavily inspired by Dynmap-Towny.
\nHas support for holes in claims and claims outside main town.
\nDoes not have support for external plugins hooking into placeholders.<\/p>\n

## Installation<\/p>\n

Put the plugin jar file inside your plugins folder and have both Towny and BlueMap installed.
\nThe plugin does not come with any default icons. I recommend just using
\nDynmap’s marker icons<\/p>\n

## Config<\/p>\n

“`yml
\n# BlueMap-Towny configuration
\n# https:\/\/github.com\/Chicken\/BlueMap-Towny#config<\/p>\n

# Seconds between checks for marker updates
\nupdate-interval: 30
\n# Display name of the marker set shown in BlueMap UI
\nmarker-set-name: Towns
\n# Label for town markers, %name% is replaced with the town name
\ntown-label: ‘%name%’
\n# Label for outpost markers, %name% is replaced with the town name, %index% with the outpost number
\noutpost-label: ‘%name% Outpost %index%’
\n# Set by \/n set mapcolor
\ndynamic-nation-colors: true
\n# Set by \/t set mapcolor
\ndynamic-town-colors: true
\n# HTML for town popup, placeholders documented in README
\npopup: ‘%name% (%nation%)<\/span>
Mayor %mayor%<\/strong><\/span>
Residents %residents%<\/strong><\/span>
Bank %bank%<\/strong><\/span>‘
\n# HTML for War popup(SiegeWar Only), placeholders documented in README
\npopup-siege: ‘Siege: %attacker% vs %defender%<\/strong><\/span><\/p>\n

\n

Town %name%<\/strong><\/span>
Type %siege_type%<\/strong><\/span>
War Chest %war_chest%<\/strong><\/span>
Siege Progress %sessions_completed%\/%sessions_total%<\/strong><\/span>
Siege Status %siege_status%<\/strong><\/span>
Siege Balance %siege_balance%<\/strong><\/span>
Banner Control %banner_control%<\/strong><\/span>
Battle Points %battle_points_attacker% \/ %battle_points_defender%<\/strong><\/span>
Battle Time Left %battle_time_left%<\/strong><\/span>‘
\n# If you want claims with holes in them to show up as fully claimed if only the perimeter is claimed.
\n# This means that the map will LIE about the actual claim status of the area!!!
\nlie-about-holes: false
\n# For servers with a lot of towns, filter smaller ones out of the map, -1 to disable filter
\nmin-town-blocks: -1
\nmin-residents: -1
\nstyle:
\n # Y-level to put area markers at, icons are at spawn positions
\n y-level: 62
\n # Use y level of town home for areas, fallback to y-level
\n use-home-y: false
\n # Town border settings
\n border-color: ‘#FF0000’
\n border-opacity: 0.8
\n border-width: 3
\n # Town fill settings
\n fill-color: ‘#FF0000’
\n fill-opacity: 0.35
\n # Path to icons on web or a link
\n # Town home
\n home-icon-enabled: false
\n home-icon: assets\/house.png
\n home-icon-anchor-x: 8
\n home-icon-anchor-y: 8
\n # Nation capital
\n capital-icon-enabled: false
\n capital-icon: assets\/king.png
\n capital-icon-anchor-x: 8
\n capital-icon-anchor-y: 8
\n # Icon during war
\n war-icon-enabled: false
\n war-icon: assets\/war.png
\n war-icon-anchor-x: 8
\n war-icon-anchor-y: 8
\n # Icon for ruined towns
\n ruined-icon-enabled: false
\n ruined-icon: assets\/ruined.png
\n ruined-icon-anchor-x: 8
\n ruined-icon-anchor-y: 8
\n # Icon for outposts
\n outpost-icon-enabled: false
\n outpost-icon: assets\/tower.png
\n outpost-icon-anchor-x: 8
\n outpost-icon-anchor-y: 8
\n“`<\/p>\n

### Label placeholders<\/p>\n

`town-label` and `outpost-label` support the following placeholders:<\/p>\n

| Placeholder | Content |
\n|————-|———————————|
\n| `%name%` | Town name |
\n| `%index%` | Outpost number (outpost-label only) |<\/p>\n

### Popup placeholders<\/p>\n

| Placeholder | Content |
\n|————————–|————————————————————————|
\n| `%name%` | Town name |
\n| `%mayor%` | Town mayor |
\n| `%residents%` | Town residents |
\n| `%assistants%` | Town assistants |
\n| `%residentdisplaynames%` | Town residents but display names |
\n| `%residentcount%` | Number of town residents |
\n| `%founded%` | Town founding date |
\n| `%board%` | Town board text |
\n| `%trusted%` | Town trusted residents |
\n| `%tax%` | Town tax |
\n| `%bank%` | Town bank balance |
\n| `%nation%` | Nation of the town |
\n| `%nationstatus%` | Capital\/Member of … |
\n| `%public%` | Town publicity status |
\n| `%peaceful%` | Is the town peaceful |
\n| `%flags%` | Flags of the town (pvp, mobs…) |
\n| `%war%` | Has active war (Works for EventWar\/FlagWar) |
\n| `%town_culture%` | Culture of town, see https:\/\/github.com\/TownyAdvanced\/TownyCultures |
\n| `%town_resources%` | Resources of town, see https:\/\/github.com\/TownyAdvanced\/TownyResources |<\/p>\n

### SiegeWar Placeholders<\/p>\n

| Placeholder | Content |
\n|—————————-|———————————————|
\n| `%attacker%` | Attacking town\/nation in war |
\n| `%defender%` | Defending town\/nation in war |
\n| `%siege_type%` | Type of Siege (Conquest, Revolt etc) |
\n| `%sessions_completed%` | Battle Sessions completed |
\n| `%session_total%` | Total amount of Battle Sessions |
\n| `%war_chest%` | War Chest (If economy is enabled for Towny) |
\n| `%banner_control%` | the ones controlling the banner |
\n| `%siege_status%` | Siege status |
\n| `%siege_balance%` | Siege balance |
\n| `%battle_points_attacker%` | Battle points on the attacker’s side |
\n| `%battle_points_defender%` | Battle points on the defender’s side |
\n| `%battle_time_left%` | Time left in the Battle Session |<\/p>\n","protected":false},"excerpt":{"rendered":"

BlueMap addon for showing your Towny towns on your beautiful map<\/p>\n","protected":false},"featured_media":33069,"template":"","meta":{"_minecraft_slug":"bluemap-towny","_minecraft_project_id":"Y6O9cRjl","_minecraft_author":"Antti","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":3571,"_minecraft_follows":21,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bluemap-towny.zip","_minecraft_size_bytes":261553,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T04:41:20.173481Z","_minecraft_date_created":"2023-05-21T17:26:50.639978Z","_minecraft_date_modified":"2026-04-17T13:12:09.479278Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bluemap-towny","_minecraft_icon_attachment_id":33069,"_minecraft_imported_at":"2026-06-01T15:18:59+00:00","_minecraft_import_hash":"0557a3fb09457ddcd6b2a19617eb8d0c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,129,92],"mod_loader":[131,132,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-33068","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nBlueMap-Towny - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"BlueMap-Towny - Minecraft\" \/>\n<meta property=\"og:description\" content=\"BlueMap addon for showing your Towny towns on your beautiful map\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bluemap-towny\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bluemap-towny\\\/\",\"name\":\"BlueMap-Towny - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bluemap-towny\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bluemap-towny\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bluemap-towny-icon-3497e9fd12e8e629a41689e91699485209da4598_96.webp\",\"datePublished\":\"2026-06-01T15:18:58+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bluemap-towny\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bluemap-towny\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bluemap-towny\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bluemap-towny-icon-3497e9fd12e8e629a41689e91699485209da4598_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bluemap-towny-icon-3497e9fd12e8e629a41689e91699485209da4598_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bluemap-towny\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"BlueMap-Towny\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"BlueMap-Towny - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/","og_locale":"en_US","og_type":"article","og_title":"BlueMap-Towny - Minecraft","og_description":"BlueMap addon for showing your Towny towns on your beautiful map","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/","name":"BlueMap-Towny - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bluemap-towny-icon-3497e9fd12e8e629a41689e91699485209da4598_96.webp","datePublished":"2026-06-01T15:18:58+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bluemap-towny-icon-3497e9fd12e8e629a41689e91699485209da4598_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bluemap-towny-icon-3497e9fd12e8e629a41689e91699485209da4598_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bluemap-towny\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"BlueMap-Towny"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/33068","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/33069"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=33068"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=33068"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=33068"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=33068"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}