{"id":15674428,"url":"https://github.com/niklasei/gamebox","last_synced_at":"2025-05-06T22:13:23.168Z","repository":{"id":94871896,"uuid":"92161154","full_name":"NiklasEi/gamebox","owner":"NiklasEi","description":"Minecraft plugin with a vast selection of inventory games","archived":false,"fork":false,"pushed_at":"2023-08-06T16:47:52.000Z","size":1642,"stargazers_count":17,"open_issues_count":6,"forks_count":14,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-06T22:13:15.634Z","etag":null,"topics":["bukkit","bukkit-plugin","gamebox","minecraft","minecraft-plugin","spigot","spigot-plugin"],"latest_commit_sha":null,"homepage":"http://gamebox.nikl.me","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NiklasEi.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","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}},"created_at":"2017-05-23T10:39:35.000Z","updated_at":"2024-10-18T14:50:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"d648e7ab-ad5e-4b95-bf75-4f83b76c23f7","html_url":"https://github.com/NiklasEi/gamebox","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiklasEi%2Fgamebox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiklasEi%2Fgamebox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiklasEi%2Fgamebox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiklasEi%2Fgamebox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NiklasEi","download_url":"https://codeload.github.com/NiklasEi/gamebox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252776600,"owners_count":21802469,"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":["bukkit","bukkit-plugin","gamebox","minecraft","minecraft-plugin","spigot","spigot-plugin"],"created_at":"2024-10-03T15:44:34.760Z","updated_at":"2025-05-06T22:13:22.613Z","avatar_url":"https://github.com/NiklasEi.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GameBox\n[![Discord](https://img.shields.io/discord/205041952431931392.svg?label=\u0026logo=discord\u0026logoColor=ffffff\u0026color=7389D8\u0026labelColor=6A7EC2)](https://discord.gg/WgCrwXF)\n[![Version](https://img.shields.io/spiget/version/37273.svg?label=version)](https://www.spigotmc.org/resources/37273/)\n[![Downloads](https://img.shields.io/spiget/downloads/37273.svg)](https://www.spigotmc.org/resources/37273/)\n[![Rating](https://img.shields.io/spiget/rating/37273.svg)](https://www.spigotmc.org/resources/37273/)\n\n\nGameBox is a minecraft plugin written with the Bukkit API and published on [Spigot].\n\nMany inventory games can be added to GameBox and can then be accessed by players through a single GUI. GameBox is configurable and all texts can be changed in the language files.\n\n![GameBox main menu](gamebox.png \"GameBox main menu with ten installed games\")\n\n## Features\n\n* Growing number of single and multiplayer games\n  * [List of all GameBox games][GameBox-games]\n  * Write your own games! ([Template game][example-project])\n* Customisable GUIs, texts, titles and game modes\n* Statistics and top lists\n* Support for MySQL and file storage\n* Token system with configurable [shop](#shop)\n\nGameBox uses language files for messages and inventory titles. You can add your own file or use one of the default files (German, English, Spanish and Chinese). [More info on the Wiki](https://github.com/NiklasEi/gamebox/wiki/Language).\n\nAll games have their own configuration and language files.\n\n### Token\n\nToken are a currency provided by GameBox. They can be awarded for winning games and spend to by items or other things in the [token shop](#shop). \n\nTokens can be read, awarded, and taken through the [API](#api) and through admin commands.\n\n### Shop\n\n[Wiki page](https://github.com/NiklasEi/gamebox/wiki/Token-Shop)\n\nThe first view of the token shop is a Menu that lists all shop categories. Each category has pages filled with configurable shop items and is automatically paginated.\n\nPer default players can access the shop with a button on the main GUI. This requires the permission **`gamebox.shop`**.\n\nThe shop can\n* sell items for token and/or money\n* run commands in exchange for token and/or money\n* sell things based on the players permissions\n  * an item can require the player to have a specific permission or to not have it\n* have custom categories\n* contain as many items in every category as you want\n\nThe shop can be configured in the file `tokenShop.yml` which is generated in the GameBox directory.\n\n### API\n\nGameBox provides an API to be used by other plugins.\n\nCurrently implemented features:\n* Give/take/set token for online and offline players.\n* Get the token count for an online or offline player.\n\n[API source](src/main/java/me/nikl/gamebox/GameBoxAPI.java)\n\n## Installation\n\n1. Download the newest version from [Spigot].\n2. Drop it in your servers plugin folder.\n3. Give GameBox admin permissions to your administrators.\n4. Restart your server.\n5. Configure GameBox:\n   1. Change the used language file in config.yml (if you need something else then english).\n   2. You should enable the hub mode ;)\n   3. You can customise your tokenShop.yml and open the shop for your players.\n6. Players with GameBox administrator permissions (`gamebox.admin.*` or `gamebox.admin.modules`) can download new games (modules) from the GUI.\n6. Optional: configure the games\n   1. The games' configuration files are in `GameBox/games/\u003cgameID\u003e`\n   2. The games' language files are in `GameBox/language/\u003cgameID\u003e`\n\n### Custom builds\n\nJust fork and clone this repository and run `mvn package`. The jar will be in the target folder in the root directory and is ready for distribution.\n\nGameBox and my nmsutilities are hosted on [my Artifactory server][artifactory]. You can check there for up-to-date versions.\n\n## Commands and permissions\n\nPlease refer to the plugins page for a detailed list of commands and permissions.\n\n[Commands list][GameBox-cmds]\n\n[Permissions list][GameBox-perms]\n\nThe permissions allow for different players having access to different games. By default, all players can play all games! To change that one has to take the permission `gamebox.play.*` from all players. Then add the game specific play permissions `gamebox.play.\u003cgameID\u003e`. The unique ids of all games can be found [on the project page][gamebox-ids].\n\n[Spigot]: https://www.spigotmc.org/resources/37273/\n[gamebox-ids]: https://www.nikl.me/projects/minecraft/gamebox/#ids\n[GameBox-games]: https://www.nikl.me/projects/minecraft/gamebox/#games\n[GameBox-cmds]: https://www.nikl.me/projects/minecraft/gamebox/#commands\n[GameBox-perms]: https://www.nikl.me/projects/minecraft/gamebox/#permissions\n[example-project]: https://github.com/NiklasEi/template-module-for-gamebox\n[artifactory]: https://repo.repsy.io/mvn/nikl/minecraft\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniklasei%2Fgamebox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fniklasei%2Fgamebox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniklasei%2Fgamebox/lists"}