Item Bingo Plugin

Disclaimer

Spigot API was used to make this. See https://github.com/SpigotMC/Spigot-API or https://hub.spigotmc.org Copyright lies with SpigotMC. I only wrote this plugin.

You are free to use or modify this plugin however you want, however I won´t be responsible for anything. For more information, see LICENSE or the github repostiory at view source

What does this plugin do?

This is for playing a Bingo minigame on your Spigot server.

The Bingo goals are all vanilla items that are obtainable in survival mode. To mark an item as found, you either craft it, pick it up or find it in a chest. The first Team thal collects a full row, column or diagonal of items wins!

What kind of different items are there?

• All vanilla items that are obtainable in survival mode can appear in the bingo card
  

• Creative items like spawn eggs or command blocks don´t appear
  

• Spawners and reinforced deepslate are made obtainable with silk touch contrary to vanilla mc. They can also appear on the bingo card
  

• Potions (normal, lingering, splash) and tipped Arrows with all obtainable potion types
  

• Each armor piece with every possible armor trim variation, these count as different items as the plain armor without trim
  

• Each enchantable item with every possible combination of enchantments
  

• Ominous bottles, different levels are treated as different items, e.g. an ominous bottle with bad omen 2 is not the same as one with bad omen 5
  

When does an item count as equal to an item on the bingo card?

• Durability is ignored
  

• Stack count is ignored
  

• The item must fulfill at least all properties of the corresponding item on the Bingo card
  

  Example: On the card, there is a diamond chestplate with thorns 1 and protection 3. Then a diamond chestplate with thorns 1, protection 3 and mending would count as the same item, while one with only protection 3 wouldn´t.

Can you customize which items can appear on Bingo cards?

No, not yet.

Gameplay

What options do I have when starting a new game?

• Bingo card size can be anywhere from 3x3 - 9x9
  

• Team constellation. You choose which players go into which teams. There are no predefined team sizes. Teams don´t necessarily have to be the same size.
  

• Each team gets a synchronized Backpack inventory, its size can be 9-54 slots.
  

• Choose whether all teams get the same Bingo card, or each team gets a separate card with different, randomized items. Latter would mean that different teams have different item goals to collect.
  

• Whether every player gets an enchanted netherite pickaxe
  

• Whether every player gets a crafting table (the crafting table doesn´t need to be placed down, it opens a crafting gui on right click)
  

• Whether keepInventory is turned on
  

• Whether hunger is turned off
  

Game loop

1. Set teams. 
   

   This is done with the /teams command. Let´s say, players named "player1" and "player2" go into team 1, "player3" into team 2. Then do /teams [player1,player2][player3]

2. Start game and choose settings. This is done with the /start command.
      Argument 1: card size (3-9)
      Argument 2: backpack inventory rows (1-6)
      Argument 3: different maps for different teams (true/false)
      Argument 4: with pickaxes given to players (true/false)
      Argument 5: with crafting tables given to players (true/false)
      Argument 6: whether hunger is turned off (true/false)
      Argument 7: whether keepInventory is turned on (true/false)
   

   Example: /start 5 6 false true true true true. This game will have a 5x5 bingo card, a 6 row backpack inventory, every team will have the same card and the same item goals, players will be given pickaxes and crafting tables, hunger is turned off and keepInventory is on.

3. The game will finish when
      A team has collected a full row, column or diagonal OR
      someone performs the /cancel command
   

Is there a way to store settings or teams?

No.

Is it possible to join a team after a game was started?

No.

What if someone leaves/disconnects mid-game?

The plugin will remember this player and put it back in the right team once it rejoins the server.

Commands

/teams: Sets the specified teams
/start: starts a new game with specified settings
/cancel: cancels a currently running game

These commands to not require any permission, anyone on the server can execute them, including non-admins and players who don´t participate in a running game.

Installation

• download the plugin .jar file
• put it in the plugin directory of your folder
• restart the server or do /reload