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, a BungeeCord network, or a Velocity proxy, 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 the configured minimum number of players, a beautifully formatted clickable invitation is broadcast to all players in the lobby.
• Both the announcement interval and minimum player threshold 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.
• Optionally lock the item in place to prevent players from moving it.

Admin Command (/bi)

• /bi reload – Reloads plugin configuration with a 10-second confirmation step to prevent accidental reloads (requires bi.admin permission).
• /bi language <lang> – Switches the server-wide language instantly (requires bi.admin permission). Language files are stored in the language/ folder.
• /bi help – Displays all available commands and their descriptions.

Multi-line Invite Messages

• Invite messages 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.

Accept / Reject Buttons

• Use {acceptbutton} and {rejectbutton} placeholders in your invite messages to insert interactive buttons.
• Accept button runs /bw join to enter the arena.
• Reject button dismisses the invitation silently.
• Button text and hover text are fully customizable via language files.

Language System

• All user-facing messages (invite texts, button labels, cooldown alerts, item names, broadcast format) are stored in editable YAML language files.
• Default languages: en_us and zh_cn.
• Create custom language files by copying the default ones and naming them <language>.yml.
• Switch languages on the fly with /bi language <lang> – no restart required.
• Language selection persists across server restarts.

Highly Configurable

Almost every message, sound, and behavior can be customized:

• Toggle Switches: Enable or disable automatic announcements, /yq, /hh, and the quick invite item independently.
• Placeholder Support: Use {player}, {arena}, {arenagroup}, {acceptbutton}, {rejectbutton}, 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).

Multi-Proxy 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.
• Velocity Mode (Experimental): Automatically detects Velocity proxy environments and runs in single-arena mode.

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.
• Multi-language Support: Full localization support with instant language switching.

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
• Proxy Compatibility: BungeeCord (with BedWarsProxy), Velocity (experimental)
• 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. Edit language files in plugins/BedWars1058-Inviter/language/ to customize messages.
8. 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 language <lang>	None	Switches the server-wide language	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