---

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:

• Toggle Switches: Enable or disable automatic announcements, /yq, /hh, and the quick invite item independently.
• Placeholder Support: Use {player}, {arena}, {arenagroup}, and {seconds} to dynamically insert information into messages.
• Customizable Sounds: Choose any sound effect supported by your server version (1.8 through 1.21).
• Post-game Visibility: 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

• Single-Arena 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

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

Technical Details

• Requirements: BedWars1058 (BedWarsProxy optional for Bungee mode)
• Java Version: Java 11 or higher
• Server Compatibility: 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:

   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.

Important: 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.

Sound Compatibility: The Sound option in config.yml must match your server version. Using an incorrect sound name may cause errors or silence the plugin.

• 1.8.x: LEVEL_UP
• 1.12.x: 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