{"id":31798278,"url":"https://github.com/solterramc/townycatalog","last_synced_at":"2026-04-15T16:32:03.306Z","repository":{"id":318083769,"uuid":"1069863451","full_name":"SolterraMC/TownyCatalog","owner":"SolterraMC","description":"A GUI to easily find Towny plots ","archived":false,"fork":false,"pushed_at":"2025-10-04T23:30:40.000Z","size":1003,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-05T01:14:14.094Z","etag":null,"topics":["minecraft-plugin","papermc","towny","townyadvanced-plugins"],"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/SolterraMC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-04T19:14:38.000Z","updated_at":"2025-10-04T23:30:43.000Z","dependencies_parsed_at":"2025-10-05T01:14:19.328Z","dependency_job_id":"44d3301f-156b-492c-bbbc-4ed847185c9d","html_url":"https://github.com/SolterraMC/TownyCatalog","commit_stats":null,"previous_names":["solterramc/townycatalog"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/SolterraMC/TownyCatalog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolterraMC%2FTownyCatalog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolterraMC%2FTownyCatalog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolterraMC%2FTownyCatalog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolterraMC%2FTownyCatalog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SolterraMC","download_url":"https://codeload.github.com/SolterraMC/TownyCatalog/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolterraMC%2FTownyCatalog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005410,"owners_count":26083883,"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","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["minecraft-plugin","papermc","towny","townyadvanced-plugins"],"created_at":"2025-10-10T21:17:48.881Z","updated_at":"2025-10-10T21:17:50.812Z","avatar_url":"https://github.com/SolterraMC.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TownyCatalog\n\nA GUI catalog plugin for browsing and purchasing Towny plots. TownyCatalog provides players with an inventory-based interface to view all available plots across towns without needing to explore in-game.\n\n## Features\n\n- **Two-level GUI navigation** - Browse by town, then view individual plots\n- **Smart filtering** - Configurable filters for town status (public/open), plot affordability, and plot types\n- **Plot information** - View prices, town details, mayor, tax rates, and more\n- **Quick access** - One command (`/town catalog`) opens the catalog\n- **Teleportation** - Click any plot to teleport to its location\n- **Lightweight** - Only depends on Towny and Paper\n- **Pagination support** - Handles towns with large numbers of plots\n\nBy default, only plots from public and open towns are shown.\n\n## Screenshots\n\n**Town Selection Menu**\n\n![Town Selection](.github/resources/towny-catalog-towns.png)\n\n**Plot Display**\n\n![Plot Display](.github/resources/towny-catalog-plots.png)\n\n## Installation\n\n1. Ensure Towny is installed and running on your server\n2. Download the latest TownyCatalog JAR from releases\n3. Place the JAR file in your server's `plugins/` directory\n4. Restart the server\n\nThe plugin will automatically generate a `config.yml` file on first run.\n\n## Commands\n\n**Player Command:**\n- `/town catalog` - Opens the plot catalog GUI\n\n**Admin Commands:**\n- `/tcatalog reload` - Reload configuration\n- `/tcatalog info` - Display plugin information\n\nPlayers use `/town catalog` to open the town selection menu, which displays all towns with available plots (filtered by configuration settings). Clicking a town opens a second GUI showing that town's plots. Clicking a plot teleports the player to its location.\n\n## Configuration\n\nThe plugin generates a `config.yml` file with the following options:\n\n```yaml\nfilters:\n  # Only show plots from towns marked as \"open\"\n  require-town-open: true\n\n  # Only show plots from towns marked as \"public\"\n  require-town-public: true\n\n  # Only show plots the player can afford\n  require-affordable: false\n\n  # Only show residential plots\n  residential-only: false\n```\n\n**Default behavior:** Shows all for-sale plots from public and open towns, regardless of price or plot type.\n\nUse `/tcatalog reload` to apply configuration changes without restarting the server.\n\n## Requirements\n\n- Paper 1.21+ (or compatible fork)\n- Java 21+\n- Towny 0.101.2.0+\n\n## Permissions\n\n| Permission | Description | Default |\n|------------|-------------|---------|\n| `townycatalog.use` | Access the plot catalog | All players |\n| `townycatalog.admin` | Reload plugin configuration | Operators only |\n\n## Building from Source\n\n```bash\n./gradlew build\n```\n\nThe compiled JAR will be in `build/libs/TownyCatalog-1.0-SNAPSHOT.jar`.\n\n## License\n\nMIT License. See `LICENSE` for details.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolterramc%2Ftownycatalog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolterramc%2Ftownycatalog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolterramc%2Ftownycatalog/lists"}