GameBox | Inventory games collection 3.3.1

Native Minecraft Version:

1.14

Tested Minecraft Versions:

• 1.14
• 1.15
• 1.16

Source Code:

https://github.com/NiklasEi/GameBox

Languages Supported:

Mandarin, French, Spanish, German; all messages are configurable

Donation Link:

https://paypal.me/NiklasEicker

☛ Support chat on Discord

For MC < 1.14 please use GameBox v2

Spoiler: Legacy games

Cookie Clicker, GemCrush, Minesweeper, Battleship, ConnectFour, Sudoku, Three In A Row, Whac A Mole, MatchIt, Tic Tac Toe, Rock Paper Scissors and 2048
games without a Spigot link are already included in GameBox by default​

Play a bunch of inventory games accessible from one GUI

​

Setup

1. Put GameBox.jar into your plugin folder
2. Give yourself (and your admins?) the permission 'gamebox.admin.modules'
3. Start/reload your server
   
4. Open Minecraft, run '/gb' and click on the chest icon in the middle of the bottom row (if you can't see it you didn't follow point 2 )
5. Rightclick the modules in the inventory to install them
   • Each module can contain several games
   • For information on different modules and their customisation/configuration see the modules website
6. Enjoy playing

GameBox provides a GUI for all my inventory games. The goal is for you to be able to customize your own game modes.​

To open the main menu players can either use the command /gb (/gamebox, /games) or (if enabled and configured) click with the hub item.

Each menu includes help buttons with configurable messages in the lore. The lore explains the games. In the main menu is a toggle button for each player to turn on/off sounds, a token counter (see below) and a shortcut to the shop.

GameBox includes a token system which allows you to reward your Players with tokens when winning games. These tokens can be used to buy configurable items in the shop. The shop can also be used to run commands.

For multiplayer games there is an invitation system to allow the players to invite anyone over the chat. The invited player will receive a message and can then accept the invitation inside the menu. For easier use, a clickable message is sent together with the invitation. If the player clicks on it he is taken to the menu and can accept the invitation.​

​

Easy to use and good looking GUI

All the fun games

Token system with configurable shop

Highly customizable

Controllable by Permissions​

What is customizable?

➳ All messages via language files (including name and prefix of the plugin!)

➳ All buttons, lores, display names, Inventory titles and so on...

➳ Configure the navigation buttons (back to the main menu, exit, back to game menu). You can change their slots or disable them completely by giving them a negative slot.

➳ You can add your own game modes to any game
⤷ for example an easy minesweeper game with 5 mines, a normal one with 8 and a hard one with 10.
⤷ Additional settings for each game mode are rewards, cost and whether to save high scores for a top list

➳ Configure the token shop (in tokenShop.yml):
⤷ Make your own categories
⤷ Fill the categories with as many items as you want (automatic page system)
⤷ Until it was configured the shop will say 'shop is closed at the moment' and will not sell anything by default. This is to ensure that the plugin can't deal damage to a server's economy prior configuration.

➳ Turn on/off the economy support

➳ Turn on/off sounds

➳ Configure the hub mode for your hub world

➳ Disable the plugin in some worlds

Complete table with all commands and some more explanation is on my homepage​

/gamebox or /gb, /games
Opens the main GUI

/gb help and /gb ?
Display configurable help messages

/gb info
Display configurable information about all installed games. Per default, this includes lists of all shortcut commands (see below).


Shortcut Commands

/gb gc
Directly opens the GemCrush GUI

/gb bs
Directly opens the Battleship GUI

/gb ms
Directly opens the Minesweeper GUI

/gb 2048
Directly opens the 2048 GUI

/gb c4
Directly opens the ConnectFour GUI

/gb sudoku
Directly opens the Sudoku GUI

/gb wam
Directly opens the Whac A Mole GUI

/gb cc
Directly opens the Cookie Clicker GUI​

Admin Commands

Main command /gameboxadmin, /gbadmin or /gba
Permission: "gamebox.admin"​

/gba token [player name]
Displays the token count of said player

/gba reload
Reload GameBox and all the installed games

/gba token [give|take|set] [player name] [count]
Manipulate the token count of said player. Works with online and offline players as long as the player has been on the server before.



​

​

Complete table with all permissions and more explanation on my homepage​

The permission system allows for different people having access to different games. You can take the default permission "gamebox.play.*" from everyone and then give only access to specific games with "gamebox.play.(game ID here)". The IDs are cookieclicker, minesweeper, battleship, 2048, connect4, sudoku, whacamole and gemcrush. To completely forbid players to open the GUI via commands or the hub item, take the permission "gamebox.use" from them.

With the play permissions the starting of games is controlled. Players can still access the game GUIs and for example look at top lists and the different game modes. To restrict this access you can take the default permission "gamebox.gamegui.*" from everyone and then give only access to specific game GUIs with "gamebox.gamegui.(game ID here)".

To forbid specific players to use the token shop, take "gamebox.shop" from them. If you do not want anyone to use the shop, you should disable tokens in generall (can be done in the configuration file). This will lead to the shop and tokens not being displayed and no tokens will be payed when winning games.

Other permissions:

"gamebox.admin"
Permission needed for admin commands

"gamebox.info"
Gives access to /gb info
Default: true

"gamebox.help"
Gives access to /gb help and /gb ?
Default: true​

PlaceholderAPI:

- %gamebox_game_name% will be replaced by the game the player is currently playing

Code (Java):

@EventHandler
public void onInvClick(InventoryClickEvent event) {
    Bukkit.getConsoleSender().sendMessage(PlaceholderAPI.setPlaceholders((Player)event.getWhoClicked(), event.getWhoClicked().getName() + " is currently playing %gamebox_game_name%"));
}

If you want more placeholders please write in the discussion.

(outdated video)



Click here for a list of all published, planed and currently worked on games


GameBox on bStats​

Please report any problems in the discussion, via GitHub or on Discord. I am always interested in improving GameBox and the games.
Reviews are not for bug reports ​