GameBox | Inventory games collection 2.2.6

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13

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

Play a bunch of inventory games accessible from one GUI

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

(outdated video)
​

Most games are add-ons! Additional games:
Singleplayer: GemCrush, Minesweeper, Sudoku, Three In A Row, Whac A Mole and 2048
Multiplayer (2 players): Battleship, Tic Tac Toe, Rock Paper Scissors
CookieClicker, ConnectFour and MatchIt are included in GameBox by default

You can find a zip file containing GameBox and all games on GitHub


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


GameBox on bStats​

GameBox provides a gui for all my inventory games to hook into. The goal is for you to be able to customize your own game modes. For example: per default GameBox provides an easy, normal and hard game mode for Minesweeper. But you could easily add your own ones, or modify these default game modes. In the example of minesweeper you can customize the number of mines and the grid size. Be creative with your 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 default lores explain the games. There is a toggle button for each player to turn on/off sounds in the menus and all games, a token counter (see below) and a shortcut to the shop.

GameBox also includes a token system which allows you to reward your Players with tokens when winning games. These tokens can then be used to buy configurable items in the shop. The shop can also be used to run commands. An example usage would be to sell timed play permissions for games using pex commands.

For multi player 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 send together with the invitation. If the player clicks on it he is taken to the menu with the invitation inside.​

​

Easy to use and good looking GUI

All the fun games

Token system with a directly from the main menu accessible shop

Highly customizable

Permissions to use games as donator perks​

What is customizable?

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

➳ All buttons, lores, displaynames, Inventory titles and so on...

➳ Configure the navigation buttons (back to 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 servers economy prior configuration.

➳ Turn on/off economy

➳ 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.



ToDo:

• Add command to run in console that will open the gamebox gui for a player (@ethanrws )
• Add win commands / fireworks @Number3504
  
• Add more Games...
  
• Tell me what to do

Planed games: Complete and up-to-date game list
If you have any game idea that is not on that list, please tell me about it

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 ​