Item Bingo Plugin

Overview

What does this plugin do?

This is a Spigot server-side plugin for playing a bingo minigame, in which you compete to find or craft a full row, column, or diagonal of items.

The goals on the bingo card 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 or solo player 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 by this plugin 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 is an item considered 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.
• Solo playthrough is possible. Just set teams like this: /teams [your_name]. This means you only play against yourself.
• 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] (parentheses required!)
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.

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

Note: This project has existed since january 2026 and was already uploaded to another mod sharing platform (Modrinth).