Bingo

Changelog — (2.0)

---

Français

#### Corrections - Cartes BINGO : la mise à jour des cases cochées utilisait la mauvaise partie lorsqu’il y avait plusieurs parties en cours. Le renderer est maintenant pris sur la partie du joueur concerné. - Paramètres partagés : la grille, le temps limite, le PvP et la difficulté étaient globaux à tout le serveur. Ils sont désormais stockés par partie : chaque host modifie uniquement les réglages de sa partie depuis la boussole (lobby). - Fin de partie : lors d’un /bingo finish, la partie est correctement retirée du gestionnaire et les données en mémoire (items trouvés, classement) sont nettoyées. #### Nouvelles fonctionnalités - Temps limite : en partie, si un temps limite est configuré (30 min, 1 h ou 1 h 30 en cycle dans la GUI), la partie se termine automatiquement à l’expiration. Le classement est alors établi selon le nombre d’items trouvés. - PvP : option « PvP » dans les paramètres de la partie. Si désactivée, les dégâts entre joueurs de la même partie sont annulés. - Difficulté du monde : l’option « Difficulté » règle désormais la difficulté du monde Minecraft (Paisible / Facile / Normal / Difficile) pendant la partie, et non le contenu des cartes. Cycle : Paisible → Facile → Normal → Difficile → Paisible. - Validation par craft : en plus du ramassage, le craft d’un item présent sur la carte valide la case. - Whitelist : nouvelles commandes `/bingo whitelist add <joueur>` et `/bingo whitelist remove <joueur>` (host uniquement, partie en LOBBY) pour gérer la liste des joueurs autorisés quand la whitelist est activée. - Scoreboard en partie : pendant une partie active, le scoreboard à droite affiche le nombre d’objets trouvés (X / total) et le temps restant (si un temps limite est défini), mis à jour environ chaque seconde. #### Technique - BingoGame : champs ajoutés gridSize, timeLimit, pvp, difficulty, startTime. - GameSettings.Difficulty : valeur PEACEFUL ajoutée pour la difficulté du monde. - Nouveau listener PvpListener pour annuler les dégâts entre joueurs lorsque le PvP est désactivé. - Tâche planifiée pour la fin au temps limite ; annulation propre lorsque la partie se termine autrement (tous BINGO ou /bingo finish). - Nouvelles clés de langue (FR/EN) : game.time_limit_reached, scoreboard.line_items, scoreboard.line_time_left, commands.whitelist.*, gui.difficulty.*. ---

English

#### Bug fixes - BINGO cards : updating checked cells used the wrong game when multiple games were running. The renderer is now taken from the player’s actual game. - Shared settings : grid size, time limit, PvP, and difficulty were global for the whole server. They are now stored per game : each host only changes their game’s settings from the compass (lobby). - Game end : when using /bingo finish, the game is properly removed from the manager and in-memory data (found items, ranking) is cleaned up. #### New features - Time limit : if a time limit is set (30 min, 1 h, or 1 h 30 in the GUI cycle), the game ends automatically when time runs out. Ranking is then based on number of items found. - PvP : “PvP” option in game settings. When disabled, damage between players in the same game is cancelled. - World difficulty : the “Difficulty” option now sets the Minecraft world difficulty (Peaceful / Easy / Normal / Hard) during the game, not the card contents. Cycle: Peaceful → Easy → Normal → Hard → Peaceful. - Craft validation : in addition to pickup, crafting an item that appears on your card validates that cell. - Whitelist : new commands `/bingo whitelist add <player>` and `/bingo whitelist remove <player>` (host only, game in LOBBY) to manage the allowed player list when whitelist is enabled. - In-game scoreboard : during an active game, the sidebar scoreboard shows items found (X / total) and time left (when a time limit is set), updated about every second. #### Technical - BingoGame : new fields gridSize, timeLimit, pvp, difficulty, startTime. - GameSettings.Difficulty : PEACEFUL value added for world difficulty. - New PvpListener to cancel damage between players when PvP is disabled. - Scheduled task for time-limit game end; proper cancellation when the game ends otherwise (everyone BINGO or /bingo finish). - New language keys (FR/EN): game.time_limit_reached, scoreboard.line_items, scoreboard.line_time_left, commands.whitelist.*, gui.difficulty.*.

Changelog (1.1) EN

Added

- Invitations system - /bingo invite <player> (host) - /bingo accept, /bingo deny (players) - Invites expire after 5 minutes - Invited players can bypass whitelist + lock when joining (still cannot bypass “full”) - Kick command - /bingo kick <player> (host/admin) - Prevents kicking the host, notifies both sides - Auto-lock on start - When a game starts (ACTIVE), it is automatically locked - Improved `/bingo join` GUI - Detailed lore: host, players/current max, locked, whitelist - Visual “badges” via different item types: - BARRIER if full - IRON_DOOR if locked - NAME_TAG if whitelist enabled - PAPER otherwise - Lobby leave item - A red bed item is given in the lobby - Right click the bed to leave the game (requires bingo.player.leave)

Permissions / Localization

- Added permissions: - bingo.player.invite, bingo.player.invite.accept, bingo.player.invite.deny - bingo.admin.kick - Added FR/EN messages for: - invites, kick - join GUI lore/status - lobby leave bed item name ---

Changelog (1.1) FR

Ajouté

- Système d’invitations - /bingo invite <joueur> (host) - /bingo accept, /bingo deny (joueurs) - Expiration des invitations au bout de 5 minutes - Les invités peuvent bypass la whitelist + le lock pour rejoindre (pas le “full”) - Commande de kick - /bingo kick <joueur> (host/admin) - Impossible de kick le host, messages envoyés aux joueurs concernés - Auto-lock au start - Au démarrage (ACTIVE), la partie est automatiquement verrouillée - GUI `/bingo join` améliorée - Lore détaillé : host, joueurs/maximum, verrouillée, whitelist - “Badges” visuels via types d’items différents : - BARRIER si pleine - IRON_DOOR si verrouillée - NAME_TAG si whitelist activée - PAPER sinon - Item lit pour quitter dans le lobby - Un lit rouge est donné dans le lobby - Clic droit sur le lit => quitte la partie (permission bingo.player.leave)

Permissions / Traductions

- Ajout des permissions : - bingo.player.invite, bingo.player.invite.accept, bingo.player.invite.deny - bingo.admin.kick - Ajout des messages FR/EN pour : - invitations, kick - lore/statuts de la GUI join - nom de l’item lit “quitter”

Changelog (1.0.6) — FR

Ajout : Limite de joueurs par partie

- Chaque partie BINGO a maintenant une limite de joueurs (maxPlayers) propre à la partie. - Valeur par défaut : 8 (appliquée à la création de la partie). - Si la partie est pleine, le join est refusé avec un message dédié : - commands.join_denied_full ({current}/{max})

Ajout : Verrouillage de la partie

- Chaque partie peut maintenant être verrouillée/déverrouillée (locked). - Si la partie est verrouillée, les joueurs ne peuvent pas rejoindre (sauf le host) : - commands.join_denied_locked

Intégration dans le GUI des paramètres (host-only en lobby)

- Ajout de 2 contrôles dans le GUI Paramètres (boussole) : - Verrouillage (slot 20) : ON/OFF - Limite de joueurs (slot 24) : clic pour changer la valeur (2 → 4 → 6 → 8 → 10 → 12 → 16 → 20 → 2) - Ces actions ne fonctionnent que si : - tu es le host - la partie est en LOBBY

Permissions

- Ajout de : - bingo.admin.lock (toggle verrouillage via GUI) - bingo.admin.maxplayers (modifier max players via GUI) - Inclus dans bingo.admin (children), défaut op.

Traductions

- Ajout des clés FR/EN pour : - textes GUI (lock + max players) - messages de refus de join (locked/full) ---

Changelog (1.0.6) — EN

Added: Per-game player limit

- Each Bingo game now has its own player limit (maxPlayers). - Default value: 8 (applied when creating a new game). - If the game is full, joining is denied with: - commands.join_denied_full ({current}/{max})

Added: Per-game join lock

- Each game can now be locked/unlocked (locked flag). - When locked, players cannot join (host excluded): - commands.join_denied_locked

Settings GUI integration (host-only in lobby)

- Added 2 new controls to the Settings GUI (compass menu): - Game Lock (slot 20): ON/OFF - Max Players (slot 24): click to cycle values (2 → 4 → 6 → 8 → 10 → 12 → 16 → 20 → 2) - Only works if: - you are the game host - the game is in LOBBY

Permissions

- Added: - bingo.admin.lock (toggle lock via settings GUI) - bingo.admin.maxplayers (change max players via settings GUI) - Included under bingo.admin (children), default op.

Localization

- Added EN/FR keys for: - GUI labels/lore (lock + max players) - join denied messages (locked/full)

Changelog (1.0.5) — FR

Ajout: Whitelist par partie (via GUI)

- Ajout d’un bouton Whitelist dans le menu des paramètres (boussole) pour activer/désactiver la whitelist d’une partie (ON/OFF). - Le toggle est possible uniquement : - si tu es host de la partie - si la partie est en LOBBY

Join bloqué si whitelist activée

- Si la whitelist est activée et que le joueur n’est pas whitelisté, le join est refusé avec un message dédié : - commands.join_denied_whitelist

Permissions

- Ajout de la permission : - `bingo.admin.whitelist` (par défaut op) - Ajoutée dans les enfants de `bingo.admin`. ---

Changelog (1.0.5) — EN

Added: Per-game whitelist (via GUI)

- Added a Whitelist button in the settings GUI (compass menu) to toggle the game whitelist (ON/OFF). - Toggle is only allowed if: - you are the game host - the game is in LOBBY

Join denied when whitelist is enabled

- If whitelist is enabled and the player is not whitelisted, joining is denied with a dedicated message: - commands.join_denied_whitelist

Permissions

- Added permission: - `bingo.admin.whitelist` (default op) - Included as a child of `bingo.admin`.

Changelog (1.0.4) — FR

Multi-parties

- Ajout d’un système permettant d’avoir plusieurs parties BINGO en parallèle. - Chaque partie possède un ID unique à 4 chiffres (interne) et un monde dédié `bingo_<id>`.

Commandes multi-parties

- `/bingo create` - Crée une nouvelle partie + son monde bingo_<id>. - Seul le host rejoint automatiquement la partie. - `/bingo join` - Ouvre un GUI listant les parties en attente (LOBBY) sous forme “Bingo de <Host>” (ID non affiché). - Refuse la commande si le joueur est déjà dans une partie. - `/bingo leave` - Quitte la partie actuelle (un joueur ne peut être que dans une seule partie à la fois). - `/bingo finish` - Termine la partie du host (suppression du monde bingo_<id> + sortie des joueurs).

États & fin de partie

- Ajout de l’état `FINISHED` pour marquer la fin d’une partie. - Fin automatique (quand tous ont terminé) : passage en FINISHED avant cleanup.

Stats par partie (stats.yml)

- Sauvegarde des infos par gameId : - created_at, started_at, finished_at, state, host - players.<uuid>.joined_at / left_at - Fin automatique : enregistrement de - `winner` (uuid) - `ranking` (liste ordonnée des uuid)

Protections lobby waiting

- La plateforme waiting (verre + barrières) est protégée contre break/place dans les phases LOBBY/GENERATING pour chaque monde bingo_<id>. ---

Changelog (1.0.4) — EN

Multi-game support

- Added a system to run multiple BINGO games concurrently. - Each game has a unique 4-digit ID (internal) and its own world `bingo_<id>`.

Multi-game commands

- `/bingo create` - Creates a new game + its world bingo_<id>. - Only the host is auto-joined. - `/bingo join` - Opens a GUI listing waiting games (LOBBY) as “Bingo by <Host>” (ID hidden). - Denies joining if the player is already in a game. - `/bingo leave` - Leaves the current game (a player can only be in one game at a time). - `/bingo finish` - Ends the host’s game (deletes bingo_<id> + removes players from the game).

States & end of game

- Added `FINISHED` state to represent a completed game. - Automatic end (when everyone finishes): state switches to FINISHED before cleanup.

Per-game stats (stats.yml)

- Saved per gameId: - created_at, started_at, finished_at, state, host - players.<uuid>.joined_at / left_at - Automatic end also saves: - `winner` (uuid) - `ranking` (ordered uuid list)

Changelog (v1.0.2) — FR

- Langues - Système de langues ajouté - Tous les textes du plugin sont maintenant dans des fichiers de langue. - Choix de la langue via config - Dans config.yml : language: fr ou language: en - Langues personnalisées supportées - Tu peux ajouter un fichier plugins/BINGO/language/<code>.yml - Puis mettre language: <code> dans config.yml - Placeholders + couleurs - Support des placeholders ({player}, {count}, {rank}, etc.) - Support des couleurs & (ex: &a, &6&l) - /bingo create simplifié - La commande crée/charge automatiquement le monde bingo - Plus besoin d’utiliser /bingo generate pour générer le monde - Lobby d’attente généré automatiquement - Création d’une grande plateforme en verre dans le monde bingo - Zone dégagée en air au-dessus pour servir de waiting lobby - Téléportation du host sur ce lobby à la création - Nouvelles commandes - /bingo join : rejoint le lobby BINGO et téléporte dans le monde bingo - /bingo leave : quitte la partie, retour au spawn principal (nettoyage offhand) - Tab / Scoreboard plus propre - Le Tab + Scoreboard ne s’affichent que pour les joueurs concernés (joueurs/spectateurs de la partie) - Les autres joueurs gardent un affichage neutre ---

Changelog (v1.0.2) — EN

- Languages - Added language system - All plugin text is now stored in language files. - Language selection via config - In config.yml : language: fr or language: en - Custom languages supported - Add your own file: plugins/BINGO/language/<code>.yml - Then set language: <code> in config.yml - Placeholders + color codes - Placeholder support ({player}, {count}, {rank}, etc.) - & color code support (e.g. &a, &6&l) - Simplified /bingo create - The command now creates/loads the bingo world automatically - No need to use /bingo generate anymore to generate the world - Auto-generated waiting lobby - A large glass platform is generated in the bingo world - Air-cleared space above it for a clean waiting lobby - Host is teleported to the lobby on creation - New commands - /bingo join: joins the BINGO lobby and teleports to the bingo world - /bingo leave: leaves the game, returns to main spawn (offhand cleaned) - Cleaner Tab / Scoreboard - Tab + Scoreboard are only shown to players involved in the game (players/spectators) - Other players keep a neutral display

Changelog (1.0.1) — FR

- Protection map Bingo étendue - Impossible de mettre la map dans un ItemFrame - Impossible de transférer la map via hoppers (mouvement auto d’inventaire) - Reconnexion en partie - Si un joueur rejoint en ACTIVE et qu’il est dans la partie : - téléport au monde bingo si besoin - remise du bon gamemode (survival/spectator) - redonne la map Bingo - met à jour tab/scoreboard - Reset plus robuste - Nettoyage complet : inventaire + armure + offhand, effets, XP, feu, fly, gamemode - Scoreboard remis à un état neutre - Nettoyage des listes (players, spectators, tpaRequests, etc.) ---

Changelog (1.0.1) — EN

- Extended Bingo map protection - Prevented placing the map into ItemFrames - Prevented moving the map via hoppers (automatic inventory transfers) - Reconnect handling - When a player joins during ACTIVE and is part of the game: - teleports to the bingo world if needed - restores correct gamemode (survival/spectator) - re-gives the Bingo map - refreshes tab/scoreboard - More robust reset - Full cleanup: inventory + armor + offhand, potion effects, XP, fire, flight, gamemode - Reset scoreboard to a neutral state - Cleared internal state (players, spectators, tpaRequests, etc.)