{"id":28395106,"url":"https://github.com/townyadvanced/flagwar","last_synced_at":"2026-01-24T18:13:59.850Z","repository":{"id":37895675,"uuid":"334440858","full_name":"TownyAdvanced/FlagWar","owner":"TownyAdvanced","description":"The original war system for Towny, now with it's own repository. Celebrating over Ten Years of warfare.","archived":false,"fork":false,"pushed_at":"2026-01-24T16:54:20.000Z","size":6771,"stargazers_count":24,"open_issues_count":16,"forks_count":14,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-01-24T17:39:51.962Z","etag":null,"topics":["java","minecraft","multiplayer","paper-api","pvp-plugin","towny","townyadvanced-plugins","war"],"latest_commit_sha":null,"homepage":"https://townyadvanced.github.io/flagwar.html","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TownyAdvanced.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.MD","funding":".github/FUNDING.yml","license":"LICENSE","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,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["LlmDl"]}},"created_at":"2021-01-30T15:08:50.000Z","updated_at":"2026-01-24T16:51:00.000Z","dependencies_parsed_at":"2023-10-03T00:57:42.913Z","dependency_job_id":"41d56bfc-5b6a-4650-9431-f3a6d1a19094","html_url":"https://github.com/TownyAdvanced/FlagWar","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/TownyAdvanced/FlagWar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FFlagWar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FFlagWar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FFlagWar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FFlagWar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TownyAdvanced","download_url":"https://codeload.github.com/TownyAdvanced/FlagWar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TownyAdvanced%2FFlagWar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28733705,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T17:51:25.893Z","status":"ssl_error","status_checked_at":"2026-01-24T17:50:48.377Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["java","minecraft","multiplayer","paper-api","pvp-plugin","towny","townyadvanced-plugins","war"],"created_at":"2025-05-31T19:39:02.968Z","updated_at":"2026-01-24T18:13:59.835Z","avatar_url":"https://github.com/TownyAdvanced.png","language":"Java","funding_links":["https://github.com/sponsors/LlmDl","https://github.com/sponsors"],"categories":[],"sub_categories":[],"readme":"[FlagWar for Towny Advanced](https://townyadvanced.github.io/wars)\n==================================================================\n\n----\n### Important Notices\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eTransitioning from the Integrated FlagWar system.\u003c/b\u003e\u003c/summary\u003e\n\nFlagWar has its own methods for configuration and localization, independent of Towny. Please be advised that we\ncurrently only provide an English translation. There will likely be other teething issues, but we are here to help with\nthem when required. See [Getting Support][get-support] if you have issues.\n\nIf you would like to help out with development, translations, or other efforts: please see the \n\u003ca href=\"#developer-resources\"\u003eDeveloper Resources\u003c/a\u003e section.\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eMetrics / Telemetry\u003c/b\u003e\u003c/summary\u003e\n\nFlagWar, makes use of the [bStats](https://bstats.org/) metrics library. For an idea of what is collected, you can view\nthe telemetry reports [here](https://bstats.org/plugin/bukkit/FlagWar/10325).\nWhile we would appreciate it if you were to keep bStats reporting enabled, you can opt out of sending telemetry\nby modifying the bStats config found at `yourServer/plugins/bStats/`.\n\u003c/details\u003e\n\n----\nSummary\n----\n\nFlagWar is one of the first official war systems in the Towny Advanced ecosystem, dating back\naround 2011. FlagWar works similar to a strategy game, where players can capture regions of other Nations and\nTowns quickly and with pinpoint precision.\n\n\u003e I started getting re-involved with Towny’s development, and got some inspiration from users about\n\u003e how to do warring Nations. I also took a gander at some of the mechanics of a similar plugin that\n\u003e did PvP stuff right, Factions. I coded up some threaded tasks that created a huge beacon in the\n\u003e sky overtop the area under attack. The game mechanic was to attack and hold the area. Towny’s war\n\u003e event is the same thing, but there’s nothing physical. So I created a focus for the defenders.\n\u003e Attacking would have the attacker place a flag, which the defenders would need to break / take\n\u003e down. I eventually merged this into the Towny plugin.\u0026nbsp;\u0026mdash;\u0026nbsp;[@Zren](https://github.com/Zren)\n\u003e \u0026ndash; [from his blog][zren-blog]\n\nIt has since then been adapted over time to retain its core functionality, while it continues to\nprovide server communities with a simple, yet fast and effective, way to capture territory.\n\nAbout mid-2020, an effort to split it back off from Towny began. FlagWar was finally fully split off in 2021, marking\nits 10th anniversary.\n\nSections\n--------\n1) [Licensing 📜][licensing]\n2) [Administrator Resources 👨‍💻][admin-resources]\n   - [Supported Releases 📦][supported-releases]\n   - [Staying up to Date 📨][staying-updated]\n   - [Getting Support ⚕][get-support]\n3) [Developer Resources 🧰][developer-resources]\n   - [Contributing Code 💻][contrib-code]\n   - [Contributing Documentation 🗒][contrib-docs] - WIP\n   - [Localizing FlagWar 🗺][contrib-localize]    - WIP\n   - [Building FlagWar 🏗][building]\n4) [Supporting the Project 🦸][supporting-flagwar]    \n\nLicensing\n---------\n\n\u003cimg alt=\"OSI Approved License\" style=\"float: right;\" height=\"155\" src=\"https://i0.wp.com/opensource.org/wp-content/uploads/2009/06/OSIApproved_100X125.png?resize=100%2C125\u0026ssl=1\"\u003e\n\nFlagWar is licensed under the [Apache License, Version 2.0][apache-v2], a license approved by the\n[Open Source Initiative][osi] and is [GPL Compatible][gpl-apache].\nSome portions, such as shaded libraries, may be alternatively licensed. See the [NOTICE][notice] for any alternative\nlicensing or copyright limitations.\n\nDocumentation found on the [FlagWar Wiki][wiki] is licensed under [CC BY 4.0][cc by].\n\nAdditionally, please respect [Towny's license][cc by-nc-nd 3.0] when using FlagWar with Towny.\nUse of FlagWar does not constitute a way to bypass Towny's license restrictions.\nWhen in doubt, [ask for clarification][get-support]. \n\nAdministrator Resources\n-----------------------\n\n### Supported Releases\n\n| FlagWar Release |  📅 Released On  |                                   Requirements                                    |\n|:---------------:|:----------------:|:---------------------------------------------------------------------------------:|\n| [v0.5.3][0.5.3] | October 20, 2022 | Towny (_0.97.3.0_+), Bukkit API-based\u0026ast; server (_1.17.1_, _1.18.2_, _1.19.2_)  |\n| [v0.5.2][0.5.2] | October 27, 2021 |      Towny (_0.97.3.0_+), Bukkit API-based\u0026ast; server (_1.16.5_, _1.17.1_)       |\n| [v0.5.1][0.5.1] | August 12, 2021  | Towny (_0.97.2.0 - 0.97.2.14_), Bukkit API-based\u0026ast; server (_1.16.5_, _1.17.1_) |\n|  _Pre-History_  |  _2011 - 2021_   |    Deprecated \u0026 Removed in Towny versions 0.97.0.0 and 0.97.1.0, respectively.    | \n\n\u003e FlagWar has adopted the use of Paper as an API provider. Spigot should however still be viable. Please\n\u003e submit a ticket if you experience any issues.\n\n[0.5.3]: https://github.com/TownyAdvanced/FlagWar/releases/tag/0.5.3 \"FlagWar Release 0.5.3\"\n[0.5.2]: https://github.com/TownyAdvanced/FlagWar/releases/tag/0.5.2 \"FlagWar Release 0.5.2\"\n[0.5.1]: https://github.com/TownyAdvanced/FlagWar/releases/tag/0.5.1b \"FlagWar Release 0.5.1b\"\n\n### Staying up to Date\n\n\u003cimg alt=\"Staying Up to Date: Github: click Watch, click Releases Only\" style=\"float: right;\" src=\"https://user-images.githubusercontent.com/879756/65964779-3a067200-e423-11e9-9928-938b976af2c2.gif\" height=\"155\"\u003e\n\nAll Release builds and most Development builds have been made available here on GitHub's [Releases][releases] page.  \nWe encourage server admins to \"watch\" FlagWar on GitHub in order to receive update notifications.  \nJust click the watch button in the upper right and select \"Releases Only\".\n\nSometimes, releases can be incubating for extended periods of time.   \nYou can build from main if you want to test on the bleeding edge.\n\n### Getting Support\n\nThe documentation found on the [FlagWar Wiki][wiki] will be updated semi-regularly, usually after a tagged release.\nIf you find the documentation insufficient, please open an issue so that we can address it.\n\nOn the [Issue Tracker][issue-tracker] you can file [bug reports][bug],\n[feature requests][feature], or review / submit a [QA discussion][discuss-towny] on the Towny discussion board.\n\n[![Average Issue Resolution Time][iim-time-badge]][iim-time] [![Percentage of Issues 'Open'][iim-percent-badge]][iim-percent]\n\nIf you still need help, come and join us on the [TownyAdvanced Discord server][discord]. There, you can also find\nsupport, get notified on the latest updates for Towny, chat with other admins, and have discussions over plugin\ndevelopment with developers from multiple projects.\n\nDeveloper Resources\n-------------------\n\n### Contributing Code\n\nIf you would like to contribute to the FlagWar code, first please read the [Contributing Guidelines][contributing].\n\nYou will also want to ensure that your working environment is in order. You can check out\n[Environment Setup][env-setup] over on our wiki to help you get started.\n\n### Contributing Documentation\n\nDocumentation could also use a fair bit of work. Help in this department would be much appreciated.\n\nWe document both in plain-text (LICENSE, NOTICE) and in GitHub-Flavored Markdown (everywhere else).\n\nIf you are interested in writing for the [FlagWar Wiki][wiki], feel free to ask on the [Towny Discord][discord]\n(please use the `#flagwar` channel), or chime in on the [Towny Discussion Board][discuss-towny] to be given write access. \n\n### Localizing FlagWar\n\nThe localization files for FlagWar are built directly into the jar using ResourceBundles.\n\nTo localize FlagWar to your language, copy the \n[Translation_en_US.properties](src/main/resources/Translation_en_US.properties) file from the\n[`resources` directory](src/main/resources) as `Translation_{LOCALE}.properties`.\n\nIf a locale already exists, please refrain from creating a duplicate. Some locales may be stubs that were added for\ndebugging purposes (en_GB, en_US[-_]POSIX, es_MX.) Feel free to modify them, but ensure they have the same key values\nas the master file (en_US).\n\nThe `LOCALE`, or the locale id compatible with the Java Locale class,\nis a 1-to-3 segment string representing the _language_, the _region_, and the _variant_ (if desired);\ndelimited primarily by underscores, with variants optionally being hyphenated. \n\nExamples: en, en_US, en_US-POSIX.\n\nSee the Java [Locale](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Locale.html) documentation \nfor well-formed naming. \n\n\u003e \u0026ast; FlagWar's Locale IDs should stick to the `lang(_REGION([_\\-]VARIANT))` format.  \n\u003e PRs to Locale processing are welcome. It's pretty messy in there...\n\nAfter translation is complete, save your changes. You will need to [Build FlagWar](README.md#Building-FlagWar) to ensure\nthat all strings are accounted for, and that they render properly for end users.\n\n### Building FlagWar\n\nAssuming you've got your [environment properly set up][env-setup], building FlagWar is relatively straight forward.\n\nSteps:\n1) Clone FlagWar from GitHub.\n    - _See the [GitHub Docs][github-docs], if you are unfamiliar with cloning projects._\n2) Navigate into the cloned `FlagWar` directory in your terminal.\n3) Run `mvn clean package` to build FlagWar. This will generate files to the `FlagWar/target/` directory.\n    - We also supply several maven profiles for convenience. Append `-P profileX,profileY,profileZ` to use them,\n      obviously replacing the ridiculous placeholder profiles listed here.\n    - The `checkstyle` profile will ensure that code edits are in-line with the code style guidelines.\n    - The `javadocs` profile will generate a `FlagWar-version-javadoc.jar` file, as well as the\n      `FlagWar/target/apidocs/` folder.\n\nYou can alternatively build FlagWar through your IDE, provided that it includes Maven, or that\nit can at least find it. Check your IDE's documentation regarding Maven support.\n\nSupporting the Project\n----------------------\n\nIf you've found FlagWar to be of use and would like to support the project, then thank you!\n\nYou can support the project in multiple ways:\n\n- **Contribute to the project 📝**  \n  Be it through [adding or expanding a localization][contrib-localize], endorsing the project,\n  hunting for bugs, [writing code][contrib-code], or [writing documentation][contrib-docs], any help is appreciated.\n  \n\n- **Sponsor a Developer 💗**  \n  Sponsoring a developer gives back to those who have spent time to keep the project going.  \n  See the sidebar for open sponsorships and learn about GitHub's [Sponsors Program][gh-sponsors].\n\n\n- **Use FlagWar ⛳**  \n  Using FlagWar lets us know that people still love the war system.  \n  Keeping metrics on, while optional, also gives us a rough idea of the adoption of FlagWar in the\n  TownyAdvanced ecosystem.\n\n\u003c!-- Links --\u003e\n[admin-resources]: README.md#administrator-resources \"Administrator Resources\"\n[apache-v2]: LICENSE \"Apache License, Version 2.0\"\n[atom]: https://atom.io/ \"A hackable text editor for the 21st Century (Free, Cross Platform)\"\n[boards-1]: https://github.com/TownyAdvanced/FlagWar/projects/1 \"FlagWar: Feature Parity Checklist\"\n[bug]: https://github.com/TownyAdvanced/FlagWar/issues/new?assignees=\u0026labels=\u0026template=bug_report.md\u0026title= \"Report a FlagWar bug\"\n[building]: README.md#building-flagwar \"Building FlagWar\"\n[cc by-nc-nd 3.0]: https://creativecommons.org/licenses/by-nc-nd/3.0/legalcode \"Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported\"\n[cc by]: https://creativecommons.org/licenses/by/4.0/ \"Creative Commons Attribution 4.0 International\"\n[contrib-code]: README.md#contributing-code \"Contributing Code\"\n[contrib-docs]: README.md#contributing-documentation \"Contributing Documentation\"\n[contrib-localize]: README.md#localizing-FlagWar \"Localizing FlagWar\"\n[contributing]: ./.github/CONTRIBUTING.MD \"FlagWar Contributing Guidelines\"\n[corretto]: https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/patches.html \"Corretto OpenJDK 8 Patches\"\n[developer-resources]: README.md#developer-resources \"Developer Resources\"\n[discord]: https://discord.gg/gnpVs5m \"Join the TownyAdvanced Discord server\"\n[discuss-towny]: https://github.com/TownyAdvanced/Towny/discussions/categories/q-a \"View Towny's Q\u0026A Discussion Board\"\n[eclipse]: https://www.eclipse.org/eclipseide/ \"The Leading Open Platform for Professional Developers\"\n[env-setup]: https://github.com/TownyAdvanced/FlagWar/wiki/Environment-Setup \"FlagWar Docs: Environment Setup\"\n[feature]: https://github.com/TownyAdvanced/FlagWar/issues/new?assignees=\u0026labels=\u0026template=feature_request.md\u0026title=Suggestion%3A+ \"Request a new feature or tweak\"\n[get-support]: README.md#getting-support \"Getting Support\"\n[gh-sponsors]: https://github.com/sponsors \"Invest in the software that powers your world\"\n[git-docs]: https://git-scm.com/doc \"Git Documentation\"\n[git]: https://git-scm.org/ \"Git Version Control Software\"\n[github-docs]: https://docs.github.com/ \"GitHub Documentation\"\n[gpl-apache]: https://www.gnu.org/licenses/license-list.html#apache2 \"GPL Compatible Free Software Licenses\"\n[idea]: https://www.jetbrains.com/idea/ \"The Capable and Ergonomic Java IDE by JetBrains\"\n[iim-percent-badge]: http://isitmaintained.com/badge/open/TownyAdvanced/FlagWar.svg\n[iim-percent]: http://isitmaintained.com/project/TownyAdvanced/FlagWar \"Percentage of Issues 'Open'\"\n[iim-time-badge]: http://isitmaintained.com/badge/resolution/TownyAdvanced/FlagWar.svg\n[iim-time]: http://isitmaintained.com/project/TownyAdvanced/FlagWar \"Average Issue Resolution Time\"\n[issue-tracker]: https://github.com/TownyAdvanced/FlagWar/issues \"FlagWar Issue Tracker\"\n[jdk]: https://sdkman.io/jdks \"JDK Distributions | SDKMAN!\"\n[licensing]: README.md#licensing \"Licensing\"\n[maven]: https://maven.apache.org/ \"Apache Maven Software Project Management and Comprehension Tool\"\n[netbeans]: https://netbeans.apache.org/ \"Fits the Pieces Together\"\n[notice]: NOTICE \"Legal Notices for FlagWar\"\n[npp]: https://notepad-plus-plus.org/ \"A free (as in speech, and beer) source code editor and Notepad replacement (Free, Windows)\"\n[osi]: https://opensource.org/licenses \"Licenses \u0026 Standards | Open Source Initiative\"\n[releases]: https://github.com/TownyAdvanced/FlagWar/releases \"FlagWar Tagged Releases\"\n[sponsor-LlmDl]: https://github.com/sponsors/LlmDl \"Sponsor LlmDl, the current TownyAdvanced lead developer and maintainer\"\n[staying-updated]: README.md#staying-up-to-date \"Staying up to Date\"\n[sublime]: https://www.sublimetext.com/ \"A sophisticated text editor for code, markup and prose (Trialware, Cross Platform)\"\n[supported-releases]: README.md#supported-releases \"Supported Releases\"\n[supporting-flagwar]: README.md#supporting-the-project \"Supporting the Project\"\n[vim]: https://www.vim.org \"The ubiquitous text editor\"\n[vscode]: https://code.visualstudio.com \"Code editing. Redefined. (Free, Cross Platform)\"\n[wiki]: https://github.com/TownyAdvanced/FlagWar/wiki \"Official FlagWar Documentation\"\n[zren-blog]:https://zren.github.io/timeline/#bukkit-plugin--cellwar \"Timeline / Projects | zren.github.io\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftownyadvanced%2Fflagwar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftownyadvanced%2Fflagwar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftownyadvanced%2Fflagwar/lists"}