BedWars1058-Inviter

---

About

BedWars1058-Inviter is a lightweight yet powerful addon for BedWars1058 that enhances player engagement by automatically broadcasting clickable arena invitations, providing manual invite commands, and offering server-wide announcement capabilities. Whether you run a single-arena server or a BungeeCord network, this plugin helps fill your games faster, keeps players informed, and streamlines communication across your entire server.

Features

Automatic Arena Announcements

- When enabled, the plugin periodically checks all waiting or starting arenas (default interval: 30 seconds). - As long as an arena has at least one player, a beautifully formatted clickable invitation is broadcast to all players in the lobby. - Both the announcement interval and message format are fully configurable, and the entire feature can be toggled on or off via the `enable-auto-invite` option.

Manual Invite Command (`/yq`)

- Players waiting in an arena can use `/yq` (aliases: `/yaoqing`, `/invite`) to manually send a personalized invitation. - The invitation is broadcast across both the lobby world and the current game world, ensuring maximum visibility. - Invitations work during both `waiting` and `starting` game states, so players can still call for reinforcements even after the countdown has begun. - Features a configurable cooldown (default: 30 seconds) to prevent spam.

Server-wide Announcement (`/hh`)

- Players can use `/hh <message>` to shout to the entire server, regardless of which world they are in. - Includes a configurable cooldown (default: 90 seconds) with a customizable cooldown message. - Message format supports `{player}` and `{message}` placeholders for full customization.

Quick Invite Item

- A configurable item (default: Bed) appears in the player's inventory during waiting/starting phases. - Right-click the item to instantly trigger a `/yq` invitation. - Fully customizable: material, display name, lore, and inventory slot position.

Admin Command (`/bi`)

- `/bi reload` – Reloads plugin configuration with a 10-second confirmation step to prevent accidental reloads (requires `bi.admin` permission). - `/bi help` – Displays all available commands and their descriptions.

Multi-line Invite Messages

- `autoInviteText` and `yqInviteText` support both single-line strings and YAML list format for multiple lines. - Each line is sent as an independent clickable message with full hover and click effects.

Highly Configurable

Almost every message, sound, and behavior can be customized directly in `config.yml`: - Debug Mode: Enable or disable automatic announcements, `/yq`, `/hh`, and the quick invite item independently. - Debug Mode: Use `{player}`, `{arena}`, `{arenagroup}`, and `{seconds}` to dynamically insert information into messages. - Debug Mode: Choose any sound effect supported by your server version (1.8 through 1.21). - Debug Mode: Optionally show invitations to players who have finished their game so they can quickly join the next match. - Debug Mode: Configurable debug output levels (0 = off, 1 = simple, 2 = verbose).

Dual Mode Support

- BungeeCord Mode: Works seamlessly with BedWars1058's `MULTIARENA` server type. - BungeeCord Mode: Fully compatible with BedWarsProxy, automatically detecting which mode is active and adjusting behavior accordingly.

Polished User Experience

- English Configuration: All announcements and invites feature clickable text that runs `/bw join <arena>` when clicked. - English Configuration: Players can hover over invitations to see helpful instructions. - English Configuration: The default `config.yml` includes detailed English comments for easy setup.

Technical Details

- Lightweight: BedWars1058 (BedWarsProxy optional for Bungee mode) - Lightweight: Java 11 or higher - Lightweight: Spigot / Paper 1.8.8 through 1.21 - Lightweight: Minimal performance impact; all broadcasts run asynchronously

Installation

1. Download the latest `.jar` file. 2. Place the file into your server's `plugins/` folder. 3. Restart your server. 4. Add `/yq` and `/hh` to the `allowed-commands` list in `plugins/BedWars1058/config.yml`: ```yaml allowed-commands: - shout - bw - leave - yq - hh ``` 5. Restart the server again for the command whitelist to take effect. 6. Edit `plugins/BedWars1058-Inviter/config.yml` to customize settings. 7. Use `/bi reload` to apply configuration changes without restarting.

> must: The `/yq` and `/hh` commands must be added to BedWars1058's `allowed-commands` list. If you skip this step, the commands will not work in-game.

> 1.16+: The `Sound` option in `config.yml` must match your server version. Using an incorrect sound name may cause errors or silence the plugin. > - 1.16+: `LEVEL_UP` > - 1.16+: `ENTITY_PLAYER_LEVELUP` > - 1.16+: `ENTITY_PLAYER_LEVELUP`

Commands & Permissions

| Command | Aliases | Description | Permission | | :--- | :--- | :--- | :--- | | `/yq` | `/yaoqing`, `/invite` | Sends a manual invitation to join your current arena | None (default) | | `/hh` | None | Broadcasts a message to the entire server | None (default) | | `/bi` | None | Admin command for BedWars1058-Inviter | None (default) | | `/bi reload` | None | Reloads the plugin configuration (requires confirmation) | `bi.admin` | | `/bi help` | None | Displays help information for plugin commands | None (default) |

Support & Feedback

If you encounter any issues or have suggestions, please submit them via our GitHub Issue Tracker: Report bugs