🐱 CatsAndMice — Red light, green light with moderators
A competitive click game for your Minecraft server
📖 What is CatsAndMice?
CatsAndMice is a Minecraft adaptation of the original Cats-n-Mice Discord bot by Seblor.
Players click a hologram to increase a shared score. Moderators (cats 🐱) can reset the score at any time — the goal for players (mice 🐭) is to reach the highest score possible before it gets wiped! The current score and last clicks are displayed in real-time on a clickable hologram.
✨ Features
- Clickable hologram — real-time leaderboard powered by DecentHolograms
- Role-based gameplay — mice click to increase the score, cats reset it
- Click cooldown — configurable delay between each click (default: 5 minutes)
- Best score tracking — records the best score with the player name, date and time
- Mock (fake) player names — automatically fills empty hologram slots to keep the display full
- Configurable display order — most recent click at the bottom or at the top
- LuckPerms support — displays rank prefixes next to player names in the hologram
- Discord webhook alerts — sends a notification when a score threshold is reached
- Fully customizable — every message, color and setting is configurable in
config.yml - Async data saving — click history and hologram location are saved automatically
🚀 Installation
- Make sure DecentHolograms is installed on your server
- Download the CatsAndMice JAR and place it in your
plugins/folder - Start or restart your server
- Stand where you want the hologram and run
/mice create - Edit
plugins/CatsAndMice/config.ymlto customize messages and settings - Run
/mice reloadto apply your changes
⚙️ Commands & Permissions
Commands:
| Command | Permission | Description |
|---|---|---|
/mice create |
catsandmice.create |
Creates the game hologram at your location |
/mice reload |
catsandmice.reload |
Reloads the configuration |
/mice help |
catsandmice.help |
Displays the help menu |
Permissions:
| Permission | Description |
|---|---|
catsandmice.mice |
Allows clicking the hologram to increase the score |
catsandmice.cat |
Allows clicking the hologram to reset the score |
catsandmice.bypass |
Bypasses the click cooldown delay |
catsandmice.* |
Grants all plugin permissions (OP by default) |
🔗 Discord Webhook (optional)
CatsAndMice can send an alert to a Discord channel when the score reaches a configurable threshold.
- Create a webhook in your Discord channel settings
- Set
webhook.enabled: trueinconfig.yml - Paste your webhook URL in
webhook.url - Set your score threshold with
webhook.threshold
📦 Dependencies
| Dependency | Type | Link |
|---|---|---|
| DecentHolograms | Required | SpigotMC |
| LuckPerms | Optional | luckperms.net |
Server: Spigot / Paper 1.20.6 or higher — Java 17+
👥 Credits
| Role | Author |
|---|---|
| Original idea & Discord bot | Seblor |
| First Minecraft plugin version | Eniox59 |
| Plugin completion & final work | Loot1 |
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
CatsAndMice 1.0.5 1.0.5 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
bukkit, paper, spigot
|
Download |
|
CatsAndMice 1.0.4 1.0.4 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6
|
bukkit, paper, spigot
|
Download |