Minecraft plugin Dynmap-Towny

🔌 About Dynmap-Towny

Dynmap-Towny — is a Minecraft plugin that displays Towny towns, nations and home markers on Dynmap maps. Dynmap-Towny integrates with the Towny API and requires both Dynmap and Towny Advanced to be installed. The plugin processes zone updates on a configurable period (default 300 seconds) and is active after placing its distribution into plugins/ and restarting the server.

🎯 Purpose

Dynmap-Towny solves the need to visualise Towny territory data on a web map. It makes town and nation borders, home locations and basic town information viewable from Dynmap so staff and players can inspect claims and town placement without joining the server.

⚙ Main features

• Display Towny towns and nations as filled outlines and borders on Dynmap maps. ()
• Computed outlines that encompass contiguous blocks of a town (Dynmap limitations: holes may appear filled). ()
• Support for outposts, including outposts on other worlds.
• Configurable home icons (distinct icon for capital towns supported).
• Per-global, per-nation and per-town style customization: color, opacity, fill, and optional altitude (Y) for outlines (default Y = 64). ()
• Visibility controls: show/hide specific towns or worlds via visibleregions / hiddenregions and minzoom setting to restrict display by zoom level.

🧩 Who it's for

Dynmap-Towny is suited for servers running Towny who want map-based visibility: survival/Towny servers, roleplay servers, and networks that use Dynmap for public mapping.

🏗 Usage examples

• Show all Towny claims on the public Dynmap for players to browse.
• Highlight capital towns with a special home icon.
• Hide selected towns from the map using hiddenregions configuration.

⌨️ Commands

The plugin does not add new player commands (no documented plugin commands in the official repo/readme). ()

🔐 Permissions

Dynmap-Towny does not document plugin-specific permissions in the official README; no permission nodes are listed there. If permissions exist they should be found in the plugin's plugin.yml in the distribution or in the generated config. ()

⚙ Installation

📥 Installation

• Download the Dynmap-Towny .jar from the plugin Releases (official GitHub releases). ()
• Place the .jar into your server's plugins/ directory.
• Ensure you have Dynmap and Towny Advanced installed and compatible versions.
• Restart the server (full restart, not /reload).
• On first load a config.yml will be generated under plugins/Dynmap-Towny.

📦 Dependencies

• Dynmap (required)
• Towny Advanced (required)

Dynmap-Towny interacts directly with the Towny API and therefore requires Towny; Dynmap is required for map rendering. Check release notes for Towny compatibility (the repository notes releases targeted at specific Towny versions). ()

🧾 Configuration

• After first start a config.yml is created in plugins/Dynmap-Towny.
• Config options include update interval (default 300 seconds), visibleregions/hiddenregions, minzoom, custstyle for per-town Y altitude and other display settings. ()
• The plugin supports per-nation and per-town style overrides (color, opacity, icons).
• There is no mention in the official README of built‑in MySQL/SQLite storage — Dynmap-Towny reads Towny data via the Towny API.

🧠 Additional information

Known limitations & conflicts

• Dynmap itself can cause 'holes' inside a town area to appear filled; this is a Dynmap rendering limitation documented by the plugin. ()
• Compatibility depends on Towny and Dynmap versions — use the release notes on the official repository to match Towny/Dynmap versions. ()

FAQ

Q: Do I need both Dynmap and Towny to use Dynmap-Towny? A: Yes — Dynmap-Towny requires Towny Advanced and Dynmap to operate. ()

Q: How often does Dynmap-Towny update the map data? A: Updates are processed on a configurable period; the default is 300 seconds (5 minutes). ()

Q: Can I change the fill color per town or per nation? A: Yes — styles can be tailored globally, per-nation or per-town in the config.

Q: Does Dynmap-Towny add chat/GUI commands for players? A: The official README does not document any player commands. The plugin focuses on rendering Towny data to Dynmap. ()

Telemetry / third‑party services

• Information about bStats or telemetry is not documented in the project's README. Information absent from official sources.

Support / Discord

• No official Discord link is listed in the Dynmap-Towny README. Use the GitHub repository Issues or the TownyAdvanced project portal for support. ()

Sources: Official Dynmap-Towny repository and Towny Advanced project portal. ()