PerfWordle
Full Wordle experience plugin — daily puzzles, private multiplayer lobbies, GUI boards, custom skull keyboard, stats, and PlaceholderAPI.
Paper and Folia 1.21 -26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – Runs on Folia and Paper with region-safe scheduling
• Daily Wordle – Three puzzles per day (Easy 4 / Normal 5 / Hard 7 letters); progress saves if you close the GUI and resume the same puzzle on the same day
• Private multiplayer – Host creates a game, picks difficulty and secret word, invites up to 8 players, shared collaborative board
• GUI gameplay – Main menu, daily menu, difficulty picker, secret-word keyboard, lobby, play board, and letter keyboard — all configurable via YAML
• Custom skull keyboard – Letter heads with color states (default, correct, present, absent); configurable rows and skull sets in keyboard-gui.yml
• Play board legend – Color-coded cells with hover lore (correct, wrong spot, not in word)
• Lifetime stats – Private games played/won/lost, daily wins/losses, current daily streak and best streak stored in the database
• Daily win broadcast – Optional server-wide message on daily wins; filter by attempt count in config
• Lobby idle timeout – Private lobbies auto-close after configurable inactivity (default 120s; 0 = disabled)
• Admin tools – View stats, list/end sessions, peek today's daily words, reset daily or all stats, reload configs
• Word lists – Separate easy/normal/hard word pools in words.yml; daily words rotate by date and timezone
Placeholders
%perfwordle_in_session% – 1 if the player is in a Wordle session, otherwise 0
%perfwordle_session_state% – none, lobby, or active
%perfwordle_private_played% – Lifetime private games played
%perfwordle_private_won% – Lifetime private games won
%perfwordle_private_lost% – Lifetime private games lost
%perfwordle_private_winrate% – Private win rate in percent
%perfwordle_daily_won% – Lifetime daily puzzles won
%perfwordle_daily_lost% – Lifetime daily puzzles lost
%perfwordle_daily_streak% – Current consecutive-day daily streak
%perfwordle_daily_best_streak% – Best daily streak ever
%perfwordle_daily_today_done% – Daily puzzles finished today (0–3)
%perfwordle_daily_today_won% – Daily puzzles won today (0–3)
%perfwordle_daily_today_easy% – Today's easy status: none, won, or lost
%perfwordle_daily_today_normal% – Today's normal status: none, won, or lost
%perfwordle_daily_today_hard% – Today's hard status: none, won, or lost
Commands
/wordle – Open main menu or resume current game (perfwordle.use)
/wordle daily – Open the daily Wordle menu (perfwordle.use)
/wordle invite (player) – Invite a player to your lobby (perfwordle.use)
/wordle join – Accept a pending lobby invite (perfwordle.use)
/wordle leave – Leave the current game (perfwordle.use)
/wordle end – Host ends the game for all players (perfwordle.use)
/wordle keyboard – Open the letter keyboard during an active game (perfwordle.use)
/perfwordle reload – Reload configs and messages (perfwordle.admin)
/perfwordle help – Show admin command usage (perfwordle.admin)
/perfwordle stats (player) – View today's daily, lifetime stats, and live session (perfwordle.admin)
/perfwordle sessions – List all active Wordle sessions (perfwordle.admin)
/perfwordle end (player) – Force-end a player's session (perfwordle.admin)
/perfwordle resetdaily (player) – Reset today's daily progress for a player (perfwordle.admin)
/perfwordle resetstats (player) – Wipe all stats and daily history for a player (perfwordle.admin)
/perfwordle dailywords – Show today's daily words per difficulty (perfwordle.admin)
Database
• SQLite (default)
• MySQL (configurable)
