- 版权类型
- 二次开发
- 插件中文名称
- 广场小镇
- 插件英文名称
- SquareTowny
- 支持的核心（服务端）
- Spigot
- Paper
- Leaves
- 语言支持
- 多语言
- 适配版本（Java）
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
理论上应该不只支持这点版本，但我只测试过1.21.4 Leaves
[MD] > 厌倦了 squaremap 上所有 Towny 领地都是同一种颜色、根本分不清谁是谁？ > 试试 **SquareTowny** —— 每个城镇都有专属颜色，同一国家的城镇同色，领土范围一眼就能看清。 ## 项目简介 SquareTowny 是一个基于 [Spigot](https://www.spigotmc.org/) 的插件，作为 [Towny](https://github.com/TownyAdvanced/Towny) 的扩展，把每个城镇的领地范围渲染到网页地图上，玩家可以直接在地图上看到各个城镇（以及国家）的领土。 本仓库是 [TownyAdvanced/MapTowny](https://github.com/TownyAdvanced/MapTowny)（原作者 Silverwolfg11，MIT 协议）的**面向 squaremap 的定制分支**，主要改动如下： - **自动配色（新增功能）**：每个城镇在地图上显示不同的颜色，同一国家的城镇颜色相同。 - **移除**了 `maptowny-pl3xmap-v2` 和 `maptowny-pl3xmap-v3` 模块——这两个模块的构建依赖已从 Modrinth 的 Maven 仓库下架，无法再解析。 - 目前支持的地图插件为：**squaremap、dynmap、BlueMap 和 Pl3xMap v1**（squaremap 为主要目标）。 ## 功能特性 - 每个城镇自动生成**独一无二的颜色**；同一**国家**内的城镇共用同一种颜色，国家边界一目了然。 - Towny 中手动设置的颜色（`/town set mapcolor`、`/nation set mapcolor`）始终优先于自动颜色。 - 可配置的标记样式：填充/描边颜色、透明度、描边粗细、图标等。 - 全异步处理，不阻塞主线程。 - 同时支持多种网页地图：squaremap、dynmap、BlueMap（支持有限）、Pl3xMap v1。 - 附带单元测试的多边形轮廓算法与负空间（"找洞"）算法。 ## 支持的地图插件 | 地图 | 版本 | 支持程度 | | --- | --- | --- | | [squaremap](https://github.com/jpenilla/squaremap) | 最新 | 完整（主要目标） | | [dynmap](https://www.spigotmc.org/resources/dynmap%C2%AE.274/) | 最新 | 完整 | | [BlueMap](https://www.spigotmc.org/resources/bluemap.83557/) | v3.3+ | 有限 | | [Pl3xMap](https://github.com/pl3xgaming/Pl3xMap) v1 | v1（1.18+ 请用这个[分支](https://github.com/NeumimTo/Pl3xMap)） | 完整 | ## 依赖 - [Towny](https://github.com/TownyAdvanced/Towny) 0.97.1 及以上（**必需**） - 上表中的一个网页地图插件（**必需**） ## 安装 1. 把插件 jar（`maptowny-plugin/target/SquareTowny-1.0.jar`）放入服务器的 `plugins` 目录。 2. 重启服务器，会自动生成 `SquareTowny/config.yml`。 3. 把 `enabled-worlds` 改成你想显示领地范围的世界名。 ## 使用与配置 开箱即用，最常需要调整的是 `enabled-worlds`。 ### 命令 | 命令 | 说明 | 权限 | | --- | --- | --- | | `/maptowny reload` | 重载配置并重新渲染所有城镇 | `maptowny.reload` | | `/maptowny render <城镇名>` | 渲染指定城镇 | `maptowny.render` | | `/maptowny unrender <城镇名或UUID>` | 从地图上移除指定城镇 | `maptowny.unrender` | 所有命令都需要 `maptowny.use`（默认 op）；`maptowny.admin` 包含以上所有权限。 ### 配置项（config.yml） | 配置项 | 默认值 | 说明 | | --- | --- | --- | | `enabled-worlds` | `["world"]` | 显示领地范围的世界 | | `update-period` | `5` | 全量重渲染周期（分钟） | | `layer.*` | — | 图层名称、显示开关、优先级、z-index | | `fill-style.fill-color` | `"#3388ff"` | 默认填充色 | | `fill-style.fill-opacity` | `0.2` | 填充不透明度 | | `fill-style.use-nation-color-fill` | `true` | 用国家颜色填充领地 | | `fill-style.stroke-color` | `"#3388ff"` | 默认描边色 | | `fill-style.use-town-color-fill` | `false` | 用城镇自己的颜色（优先于国家色） | | `fill-style.use-auto-colors` | `true` | **自动配色（本分支新增）**：让每个城镇/国家颜色各不相同 | | `icon-info.*` | — | 城镇/首都/前哨站图标及尺寸 | | `icon-info.capital-icon-size` | `24` | 首都图标尺寸（默认小于城镇图标，缩小地图时不会遮挡画面） | ### 自动配色说明 - **没有国家**的城镇：按城镇 UUID 生成独一无二的颜色（重启后保持稳定）。 - **同一国家**内的城镇：共用同一种颜色（按国家 UUID 生成）。 - 城镇或国家在 Towny 中手动设置过颜色时，使用手动颜色。 - 颜色会在下一次周期重渲染时自动更新（或执行 `/maptowny reload`）。 ## 插件 API SquareTowny 提供小型 API（`maptowny-api` 模块）供其他插件集成，详见原项目的 [Wiki](https://github.com/TownyAdvanced/MapTowny/wiki/MapTowny-API)。 ## 构建 这是一个标准 Maven 多模块项目，使用 [maven-toolchains-plugin](https://maven.apache.org/plugins/maven-toolchains-plugin/) 针对不同 JDK 版本编译各模块： | 模块 | JDK 目标 | | --- | --- | | `maptowny-api`、`maptowny-plugin`、`maptowny-dynmap` | 8 | | `maptowny-bluemap` | 11 | | `maptowny-squaremap`、`maptowny-pl3xmap-v1` | 16 | 两种构建方式： 1. **标准 toolchains**：在 `~/.m2/toolchains.xml` 中配置 JDK 8、11、16（参考 [toolchains 指南](https://maven.apache.org/guides/mini/guide-using-toolchains.html)），然后执行 `mvn clean package`。 2. **单一现代 JDK（仓库自带配置）**：本仓库附带了 `toolchains-local.xml`，把所有需要的版本映射到同一个 JDK（21 或更新）。把其中 `jdkHome` 改成你本机的 JDK 路径后执行： ``` mvn -t toolchains-local.xml clean package ``` 构建产物为 `maptowny-plugin/target/SquareTowny-1.0.jar`。 ## 许可证 MIT。本分支保留上游项目的 MIT 许可证与版权声明，欢迎提交 Pull Request。 开源地址：https://github.com/Creat319/SquareTowny [/MD]
[MD] > 厌倦了 squaremap 上所有 Towny 领地都是同一种颜色、根本分不清谁是谁？ > 试试 **SquareTowny** —— 每个城镇都有专属颜色，同一国家的城镇同色，领土范围一眼就能看清。 ## 项目简介 SquareTowny 是一个基于 [Spigot](https://www.spigotmc.org/) 的插件，作为 [Towny](https://github.com/TownyAdvanced/Towny) 的扩展，把每个城镇的领地范围渲染到网页地图上，玩家可以直接在地图上看到各个城镇（以及国家）的领土。 本仓库是 [TownyAdvanced/MapTowny](https://github.com/TownyAdvanced/MapTowny)（原作者 Silverwolfg11，MIT 协议）的**面向 squaremap 的定制分支**，主要改动如下： - **自动配色（新增功能）**：每个城镇在地图上显示不同的颜色，同一国家的城镇颜色相同。 - **移除**了 `maptowny-pl3xmap-v2` 和 `maptowny-pl3xmap-v3` 模块——这两个模块的构建依赖已从 Modrinth 的 Maven 仓库下架，无法再解析。 - 目前支持的地图插件为：**squaremap、dynmap、BlueMap 和 Pl3xMap v1**（squaremap 为主要目标）。 ## 功能特性 - 每个城镇自动生成**独一无二的颜色**；同一**国家**内的城镇共用同一种颜色，国家边界一目了然。 - Towny 中手动设置的颜色（`/town set mapcolor`、`/nation set mapcolor`）始终优先于自动颜色。 - 可配置的标记样式：填充/描边颜色、透明度、描边粗细、图标等。 - 全异步处理，不阻塞主线程。 - 同时支持多种网页地图：squaremap、dynmap、BlueMap（支持有限）、Pl3xMap v1。 - 附带单元测试的多边形轮廓算法与负空间（"找洞"）算法。 ## 支持的地图插件 | 地图 | 版本 | 支持程度 | | --- | --- | --- | | [squaremap](https://github.com/jpenilla/squaremap) | 最新 | 完整（主要目标） | | [dynmap](https://www.spigotmc.org/resources/dynmap%C2%AE.274/) | 最新 | 完整 | | [BlueMap](https://www.spigotmc.org/resources/bluemap.83557/) | v3.3+ | 有限 | | [Pl3xMap](https://github.com/pl3xgaming/Pl3xMap) v1 | v1（1.18+ 请用这个[分支](https://github.com/NeumimTo/Pl3xMap)） | 完整 | ## 依赖 - [Towny](https://github.com/TownyAdvanced/Towny) 0.97.1 及以上（**必需**） - 上表中的一个网页地图插件（**必需**） ## 安装 1. 把插件 jar（`maptowny-plugin/target/SquareTowny-1.0.jar`）放入服务器的 `plugins` 目录。 2. 重启服务器，会自动生成 `SquareTowny/config.yml`。 3. 把 `enabled-worlds` 改成你想显示领地范围的世界名。 ## 使用与配置 开箱即用，最常需要调整的是 `enabled-worlds`。 ### 命令 | 命令 | 说明 | 权限 | | --- | --- | --- | | `/maptowny reload` | 重载配置并重新渲染所有城镇 | `maptowny.reload` | | `/maptowny render <城镇名>` | 渲染指定城镇 | `maptowny.render` | | `/maptowny unrender <城镇名或UUID>` | 从地图上移除指定城镇 | `maptowny.unrender` | 所有命令都需要 `maptowny.use`（默认 op）；`maptowny.admin` 包含以上所有权限。 ### 配置项（config.yml） | 配置项 | 默认值 | 说明 | | --- | --- | --- | | `enabled-worlds` | `["world"]` | 显示领地范围的世界 | | `update-period` | `5` | 全量重渲染周期（分钟） | | `layer.*` | — | 图层名称、显示开关、优先级、z-index | | `fill-style.fill-color` | `"#3388ff"` | 默认填充色 | | `fill-style.fill-opacity` | `0.2` | 填充不透明度 | | `fill-style.use-nation-color-fill` | `true` | 用国家颜色填充领地 | | `fill-style.stroke-color` | `"#3388ff"` | 默认描边色 | | `fill-style.use-town-color-fill` | `false` | 用城镇自己的颜色（优先于国家色） | | `fill-style.use-auto-colors` | `true` | **自动配色（本分支新增）**：让每个城镇/国家颜色各不相同 | | `icon-info.*` | — | 城镇/首都/前哨站图标及尺寸 | | `icon-info.capital-icon-size` | `24` | 首都图标尺寸（默认小于城镇图标，缩小地图时不会遮挡画面） | ### 自动配色说明 - **没有国家**的城镇：按城镇 UUID 生成独一无二的颜色（重启后保持稳定）。 - **同一国家**内的城镇：共用同一种颜色（按国家 UUID 生成）。 - 城镇或国家在 Towny 中手动设置过颜色时，使用手动颜色。 - 颜色会在下一次周期重渲染时自动更新（或执行 `/maptowny reload`）。 ## 插件 API SquareTowny 提供小型 API（`maptowny-api` 模块）供其他插件集成，详见原项目的 [Wiki](https://github.com/TownyAdvanced/MapTowny/wiki/MapTowny-API)。 ## 构建 这是一个标准 Maven 多模块项目，使用 [maven-toolchains-plugin](https://maven.apache.org/plugins/maven-toolchains-plugin/) 针对不同 JDK 版本编译各模块： | 模块 | JDK 目标 | | --- | --- | | `maptowny-api`、`maptowny-plugin`、`maptowny-dynmap` | 8 | | `maptowny-bluemap` | 11 | | `maptowny-squaremap`、`maptowny-pl3xmap-v1` | 16 | 两种构建方式： 1. **标准 toolchains**：在 `~/.m2/toolchains.xml` 中配置 JDK 8、11、16（参考 [toolchains 指南](https://maven.apache.org/guides/mini/guide-using-toolchains.html)），然后执行 `mvn clean package`。 2. **单一现代 JDK（仓库自带配置）**：本仓库附带了 `toolchains-local.xml`，把所有需要的版本映射到同一个 JDK（21 或更新）。把其中 `jdkHome` 改成你本机的 JDK 路径后执行： ``` mvn -t toolchains-local.xml clean package ``` 构建产物为 `maptowny-plugin/target/SquareTowny-1.0.jar`。 ## 许可证 MIT。本分支保留上游项目的 MIT 许可证与版权声明，欢迎提交 Pull Request。 开源地址：https://github.com/Creat319/SquareTowny [/MD]
