BedWars1058-Inviter

(https://img.shields.io/badge/1.15-Release-success?logo=modrinth)](https://modrinth.com/plugin/bedwars1058-inviter/versions) (https://img.shields.io/badge/Java-11%2B-important)](https://adoptium.net/) (https://img.shields.io/badge/Terms%20of%20Use-%E4%BD%BF%E7%94%A8%E6%9D%A1%E6%AC%BE-blue?style=flat&logo=googledocs&logoColor=white&labelColor=0a3069)](https://docs.qq.com/doc/DYU9uc2dGSWpMUnZS) --- ## About BedWars1058‑Inviter is a lightweight yet powerful addon for BedWars1058 that fills your arenas faster, keeps players connected, and puts communication entirely in your hands. It works seamlessly on single‑arena servers, BungeeCord networks, and Velocity proxies (experimental). Every message, sound, and behaviour is configurable – and the entire plugin is fully localisable through editable YAML language files. > **Note**: This plugin is **closed‑source**. You may distribute the compiled JAR file freely, but you may **not** decompile, modify, reverse‑engineer, or integrate it into other projects without explicit permission from the author. ## Features ### Automatic Arena Announcements - Periodically checks waiting or starting arenas (default interval: 30 s). - Broadcasts a clickable invitation to lobby players when an arena has at least the configured minimum number of players. - Entire feature can be toggled on/off via `enable‑auto‑invite`. ### Manual Invite (`/yq`) - Players inside a waiting or starting arena can send a personalised clickable invitation to the lobby **and** their current game world. - Configurable cooldown (default 30 s) with a customisable cooldown message. - Invitations work during `waiting` **and** `starting` states. ### Server‑wide Shout (`/hh`) - `/hh <message>` broadcasts to every player on the server, regardless of world. - Separate cooldown (default 90 s) with its own configurable message. ### Quick Invite Item - A customisable item (default: **Bed**) appears in the player’s inventory while they are waiting. - Right‑click the item to instantly send a `/yq` invitation. - Fully configurable: material, display name, lore, inventory slot, and optional movement lock. ### Force‑Start Game (`/bi startgame`) - Players with the `bi.start` permission (op by default) can force‑start the current game immediately – team assignment is skipped, only the arena status is set to `STARTING`. - A configurable quick‑start item (default: **Diamond**, slot 2) is given to players in waiting/starting arenas; right‑click it to trigger the same action. - If the game is already in the `STARTING` state, a configurable warning message is shown instead of doing nothing. ### Admin Command (`/bi`) - `/bi reload` – reloads configuration with a two‑step confirmation (10 s window). - `/bi language <lang>` – switches the server‑wide language on the fly, writing the change directly to `config.yml` without removing any comments or formatting. - `/bi version` – displays the plugin author and current version. - `/bi update` – triggers a manual update check; the result is sent only to the command sender and does not affect the automatic update checker. - `/bi startgame` – force‑starts the current arena (requires `bi.start`). - `/bi help` – shows a fully customisable help menu that is defined entirely in the language files. ### Config Auto‑Completion - On every server start, the plugin automatically detects any missing options in `config.yml` and appends them – together with their default comments – at the end of the file. - Your existing custom values, formatting, and comments are **fully preserved**. - This ensures a seamless upgrade from older versions without manual config edits. ### Placeholder System - `{arena}`, `{arenagroup}`, `{player}`, `{luckpermprefix}` (LuckPerms prefix, empty if not present), `{acceptbutton}`, `{rejectbutton}`, `{seconds}`, `{nowarenaplayercount}`, `{maxarenaplayercount}`, `{version}`. - Accept / reject buttons: **Accept** runs `/bw join <arena>`, **Reject** silently dismisses the invitation. - Error messages such as “You are not in a waiting/starting arena” and the force‑start warning are also defined in the language files and can be customised. ### Language System - All player‑visible text (invite lines, button labels, cooldown alerts, help menu, errors, broadcast format, force‑start messages) is stored in editable YAML files inside the `language/` folder. - Default languages: `en_us` and `zh_cn`. Create custom languages by copying an existing file and renaming it `<language>.yml`. - Switch languages instantly with `/bi language <lang>` – no restart required. - Language selection is saved in `config.yml` (under `language`) and persists across restarts. The old `language‑settings.yml` file has been removed to simplify management. ### Multi‑Line & Multi‑Proxy - Invite messages support both a single line and a YAML list (multiple lines). - Works with BedWars1058 `MULTIARENA` mode, `SHARED` (BungeeC