BedWars1058-Inviter

About

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

Features

Automatic Arena Announcements

• When enabled, the plugin periodically (default: every 30 seconds) checks all waiting or starting arenas.
• As long as an arena has at least one player, a beautifully formatted clickable invitation is broadcast to all players in the lobby.
• 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.

Server-wide Announcement Command (/hh)

• Players can use /hh <message> to broadcast a message to all players across the entire server, regardless of which world they are in.
• The command features a configurable cooldown (default: 90 seconds) to prevent spam, with a fully customizable cooldown message.
• The broadcast format supports {player} and {message} placeholders, allowing server owners to style announcements to match their server's theme.

Smart Cooldown System

• Prevents spam by enforcing a configurable cooldown between /yq uses (default: 30 seconds).
• Players receive a clear, customizable cooldown message showing exactly how many seconds remain.

Highly Configurable

Every message, sound, and behavior can be customized directly in config.yml:

• Toggle Switches: Enable or disable automatic announcements and the /yq command 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).
• Cooldown Settings: Adjust the cooldown duration and the cooldown message to fit your server's needs.

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 like "Left‑Click to Join".
• Bilingual Configuration: The default config.yml includes both English and Chinese 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 (or load the plugin with /plugman load Bedwars1058-ArenaStartMessage).
4. Edit plugins/Bedwars1058-ArenaStartMessage/config.yml to customize messages and behavior.
5. Reload the configuration with /bw reload. After editing, restart your server for the changes to take effect.

Important Note

To use the /yq and /hh commands, you must add them to the allowed-commands list in BedWars1058's config.yml file (located at plugins/BedWars1058/config.yml).
Example:

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

After editing, restart your server for the changes to take effect.

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

Please replace the sound name accordingly if you encounter issues.

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