{"id":31070036,"url":"https://github.com/allycraftmc/btb","last_synced_at":"2026-04-16T01:33:28.284Z","repository":{"id":314748396,"uuid":"752318027","full_name":"allycraftmc/btb","owner":"allycraftmc","description":"Bedrock Tower Battle - Minecraft Minigame Plugin","archived":false,"fork":false,"pushed_at":"2026-02-28T00:16:17.000Z","size":209,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2026-02-28T06:17:41.397Z","etag":null,"topics":["minecraft","minecraft-minigame","minecraft-plugin","papermc"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/allycraftmc.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":"2024-02-03T16:06:22.000Z","updated_at":"2026-02-28T00:16:20.000Z","dependencies_parsed_at":"2025-09-14T15:36:39.176Z","dependency_job_id":"c1eaaa8d-503e-409d-bf27-f5abbb4ee8ce","html_url":"https://github.com/allycraftmc/btb","commit_stats":null,"previous_names":["allycraftmc/btb"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/allycraftmc/btb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allycraftmc%2Fbtb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allycraftmc%2Fbtb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allycraftmc%2Fbtb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allycraftmc%2Fbtb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/allycraftmc","download_url":"https://codeload.github.com/allycraftmc/btb/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allycraftmc%2Fbtb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31867711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"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":["minecraft","minecraft-minigame","minecraft-plugin","papermc"],"created_at":"2025-09-15T22:45:18.029Z","updated_at":"2026-04-16T01:33:28.262Z","avatar_url":"https://github.com/allycraftmc.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Project Logo\" src=\"assets/logo.png\" /\u003e\n\u003c/p\u003e\n\n# Bedrock Tower Battle\nBedrock Tower Battle is a Minecraft PVP Minigame.\nThe plugin is currently built specific for our needs and some stuff is hard coded (that should be configurable).\n## Development\nFor development, you can use the `docker-compose.yaml` in this repository.\nThe lobby and btb map are (currently) not included and not public, therefore you have to put these maps into `assets/lobby-world` and `assets/map-world`.\nSubsequently, you have to build the plugin with gradle:\n```bash\ngradle build\n# OR\n./gradlew build\n```\nNow you can start the development server with docker compose and join with multiple clients\n```bash\ndocker compose up\n```\nTo configure the server you can use `.env.dev`.\nSee the documentation of the docker image for options: https://docker-minecraft-server.readthedocs.io/en/latest/\n## Map Building\nTo change the lobby and/or btb world you can use the `docker-compose.yaml` file in `assets/`.\nBefore starting the docker compose stack, configure it using `assets/.env`.\nSet `WORLD_PATH` to either `./lobby-world` or `./map-world` depending on which map you want to change:\n```env\nWORLD_PATH=./lobby-world\n```\n\n**WARNING: The following could destroy your world. Make a backup and check the script to check what exactly it deletes!** \n\nTo remove empty chunks and player data, you can use `scripts/clean-world.sh` as follows:\n```bash\nnix run .#btb-clean-world \u003cpath_to_world\u003e\n```\n## Configuration\nThe plugin can be configured through environment variables.\n- `BTB_MAX_TEAM_SIZE`: Maximal Count of Players per Team. (Default: 2)\n- `BTB_AUTO_START`: Determines if the game starts 10s after all teams are full. (Default: true)\n## Deploy to production\nTODO\nTo upload world assets and the build plugin jar to a production sever you can use `btb-prod-upload`:\n```bash\n# Enter nix develop shell / Or use direnv\nnix develop\n\nbtb-prod-upload \u003cuser\u003e@\u003chost\u003e \u003cremote_base_path\u003e\n```\n## License\n```\nBTB: Bedrock Tower Battle Minecraft Minigame Plugin\nCopyright (C) 2025 Tert0\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU Affero General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU Affero General Public License for more details.\n\nYou should have received a copy of the GNU Affero General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallycraftmc%2Fbtb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fallycraftmc%2Fbtb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallycraftmc%2Fbtb/lists"}