BedWars1058-Inviter

---

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.

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.

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 help – shows a fully customisable help menu that is defined entirely in the language files.

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” are also defined in the language files (errors.not‑in‑arena) and can be customised.

Language System

• All player‑visible text (invite lines, button labels, cooldown alerts, help menu, errors, broadcast format) 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 (BungeeCord via BedWarsProxy), and Velocity (experimental).
• Optional “show invite after game” setting to keep eliminated players informed.

Update Checker

• Automatic update checks run every 60 minutes (if check_update is enabled) and notify online players with the bi.update permission.
• Console update messages are now coloured (via ConsoleSender) for better visibility in server logs.
• All update‑related messages are in English regardless of the server’s language setting.
• Manual checks can be performed at any time with /bi update.

Polished Experience

• Clickable messages with hover tooltips.
• Customisable sounds (works across 1.8 – 1.21).
• Debug mode (0/1/2) for troubleshooting.
• Lightweight – all broadcasts run asynchronously.
• bStats metrics integration follows the official recommended pattern (new Metrics(this, pluginId)).

---

Technical Requirements

• BedWars1058 (BedWarsProxy optional for BungeeCord)
• Java 11+
• Spigot / Paper 1.8.8 – 1.21
• LuckPerms (optional, for the {luckpermprefix} placeholder)

Installation

1. Drop the .jar into your server’s plugins/ folder.
2. Restart the server.
3. Add /yq and /hh to allowed-commands in plugins/BedWars1058/config.yml:

   allowed-commands:
     - shout
     - bw
     - leave
     - yq
     - hh
   

4. Restart again.
5. Edit plugins/BedWars1058‑Inviter/config.yml and the language files in language/.
6. Apply changes without a restart: /bi reload.

Important: /yq and /hh must be in BedWars1058’s allowed-commands list; otherwise they will not work in‑game.

Sound Compatibility: The Sound option in config.yml must match your server version. Examples:

• 1.8.x: LEVEL_UP
• 1.12.x+: ENTITY_PLAYER_LEVELUP

Commands & Permissions

| Command | Description | Permission |
| :--- | :--- | :--- |
| /yq | Send a manual arena invitation | none (default) |
| /hh <msg> | Server‑wide shout | none (default) |
| /bi reload | Reload configuration (confirmation required) | bi.admin |
| /bi language <lang> | Switch server language (preserves config comments) | bi.admin |
| /bi version | Show plugin author and version | none |
| /bi update | Manually check for updates | bi.admin |
| /bi help | Display customisable help menu | none |

• bi.use – allows using /yq, /hh, and /bi help (granted by default).
• bi.admin – allows /bi reload, /bi language, and /bi update.
• bi.update – receives automatic update notifications (op by default).

Support

Issue Tracker: GitHub Issues
Test server: mc.xiyijicraft.top:25565

Stats