Back to Plugins

RA-EasterEggChat

v1.0Utility0 downloads

A secret Easter Egg chat reward system. Hide keywords in chat — players who type them get rewarded automatically with fully configurable one-time or limited claims.

Documentation

Description

RA-EasterEggChat is a Paper plugin that turns hidden chat keywords into rewarding Easter Eggs. When a player types a configured keyword in chat, the message is silently deleted and the reward is given — no one else knows it happened.

Features:
- Hidden keyword detection via chat — message is deleted from public chat
- Per-player one-time claim support (each player can only claim once)
- IP-based claim limiting to prevent abuse from the same network
- Max total claims per keyword (e.g. first 100 players only)
- Expiry date support per keyword (YYYY-MM-DD format)
- Enable/disable keywords on the fly without restarting
- Interactive in-game creation wizard for admins
- Auto-save claim data every 5 minutes
- Fully configurable messages and reward commands
- Bypass permission for admins to test without claiming

Commands:
  /eastereggchat reload                    — Reload all config files
  /eastereggchat list                      — List all keywords and their status
  /eastereggchat info <keyword>            — Show full details of a keyword
  /eastereggchat create <keyword>          — Create a new keyword (interactive wizard)
  /eastereggchat delete <keyword>          — Delete a keyword
  /eastereggchat toggle <keyword>          — Enable or disable a keyword
  /eastereggchat give <player> <keyword>   — Force give reward to a player
  /eastereggchat reset <player> <keyword>  — Reset a player's claim for a keyword
  /eastereggchat resetall <player>         — Reset all claims for a player

Aliases: /raeec, /eechat, /easteregg

Permissions:
  eastereggchat.admin    — Access to all admin commands (default: OP)
  eastereggchat.bypass   — Bypass one-time and IP restrictions, for testing (default: false)

Changelog

v1.0 — Initial Release
- Hidden keyword detection from player chat messages
- Automatic message deletion when keyword is typed
- One-time claim per player support
- IP-based claim limiting per keyword
- Max total claims limit per keyword
- Expiry date support per keyword
- Enable/disable toggle per keyword without restart
- Interactive in-game creation wizard for admins
- Force give reward to any player via command
- Per-player and full claim reset commands
- Auto-save claim data every 5 minutes
- Fully configurable messages via messages.yml
- Tab completion for all subcommands