{"id":28395105,"url":"https://github.com/townyadvanced/maptowny","last_synced_at":"2025-06-27T01:31:30.212Z","repository":{"id":42676071,"uuid":"370238370","full_name":"TownyAdvanced/MapTowny","owner":"TownyAdvanced","description":"A Towny add-on Bukkit plugin that enables towns to show up on a web-map.","archived":false,"fork":false,"pushed_at":"2025-01-31T05:03:36.000Z","size":329,"stargazers_count":22,"open_issues_count":16,"forks_count":18,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-01T06:52:17.183Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TownyAdvanced.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-24T05:31:13.000Z","updated_at":"2025-04-02T14:50:20.000Z","dependencies_parsed_at":"2025-01-02T06:37:52.203Z","dependency_job_id":"8813aacd-1746-4f43-968a-0cde2a0fa3da","html_url":"https://github.com/TownyAdvanced/MapTowny","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/TownyAdvanced/MapTowny","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FMapTowny","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FMapTowny/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FMapTowny/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FMapTowny/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TownyAdvanced","download_url":"https://codeload.github.com/TownyAdvanced/MapTowny/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FMapTowny/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262172430,"owners_count":23270009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-31T19:39:02.676Z","updated_at":"2025-06-27T01:31:30.199Z","avatar_url":"https://github.com/TownyAdvanced.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MapTowny\nA Towny add-on Spigot plugin that enables towns to show up on a web-map.\n\n**Supported web-map plugins are Pl3xMap, squaremap, dynmap, and BlueMap**.\n\n## Dependencies\nThis plugin requires Towny to be installed on your server.\n- [Towny](https://github.com/TownyAdvanced/Towny) 0.97.1 (or later)\n\nThe plugin also requires one of the following web-map plugins to be installed on your server:\n- [Pl3xMap](https://github.com/pl3xgaming/Pl3xMap) v1 (use this [fork](https://github.com/NeumimTo/Pl3xMap) for 1.18+), v2 (alpha 1.19.2-319 or later), or v3 (beta 1.20.1-446).\n- [squaremap](https://github.com/jpenilla/squaremap)\n- [dynmap](https://www.spigotmc.org/resources/dynmap%C2%AE.274/)\n- [BlueMap](https://www.spigotmc.org/resources/bluemap.83557/) v3.3 (or later) (limited support)\n\n## Features\nHonestly, nothing uber special about this plugin other than it works, but if you really want to know:\n- Configurable Marker Options\n- Async Processing\n- Support multiple web-map plugins\n- Unit-tested Custom Polygon Outline (contour) Algorithm and Negative Space (contour \"hole-finding\") Algorithm\n\n## Installing\nInstall the plugin from the [releases page](https://github.com/TownyAdvanced/MapTowny/releases). Simply put the jar file into your `plugins` directory and start your server.\n\n## Usage and Configuration\nThe plugin should be ready for use out of the box. The one thing that may need to be adjusted is the `enabled-worlds` property in the `config.yml` to add the world names that you want town claims to show up on. For more information about the plugin's commands and configuring the plugin, see the [wiki](https://github.com/TownyAdvanced/MapTowny/wiki).\n\n## Plugin API:\nSee [this wiki page](https://github.com/TownyAdvanced/MapTowny/wiki/MapTowny-API) for more info.\n\n## Building\nThis plugin is a standard maven project that utilizes the [maven toolchains plugin](https://maven.apache.org/plugins/maven-toolchains-plugin/) in order to build against multiple JDK versions. In order to use the maven toolchains plugin, you must have a `toolchains.xml` file in your `.m2` folder properly configured with at least JDK versions 1.8 and 16. See [this guide](https://maven.apache.org/guides/mini/guide-using-toolchains.html#using-toolchains-in-your-project) for more info on setting up a `toolchains.xml` file. \n\nOnce that is setup, the project can be compiled with the command `mvn clean package` or `mvn clean install` ran in the project directory.\n\n## Licensing\nThis plugin is licensed under the MIT license. While highly permissible, I do kindly hope that you create pull-requests for any bug fixes or useful features so they can help the entire community.\n\n\\*All pull-requests made to the repository agree to license the code contributed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftownyadvanced%2Fmaptowny","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftownyadvanced%2Fmaptowny","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftownyadvanced%2Fmaptowny/lists"}