New Bedwars

---

📖 Overview

NewBedwars is a modern, fully configurable Bedwars plugin built from the ground up for Paper 1.17+. It delivers the classic Bedwars experience with a powerful in-game setup system, YAML-driven GUIs, multi-arena support, and deep gamerule control - all without requiring any additional plugin dependencies.

Whether you're running a small survival server looking to add a Bedwars minigame, or building a dedicated Bedwars network, NewBedwars gives you the tools to create polished, production-ready arenas with minimal configuration effort.

⚠️ This is a beta release. Core gameplay is stable and feature-complete. Please report any issues via the GitHub issue tracker.

---

✨ Key Features

⚔️ Gameplay

Feature	Description
Multi-Arena	Run unlimited simultaneous arenas, each with its own world
Team System	Configurable team count, colors, player limits
Quick Void	Instant death below a configurable Y level
Build Protection	Per-team zones where players cannot place blocks
Rejoin System	Players can reconnect within a configurable time window
Party System	Group up with friends via /party; invite with clickable chat buttons; party admin leads the whole group into an arena together

💬 Chat & Visibility

Feature	Description
Arena Chat Isolation	Each arena has its own chat — lobby players and other arenas are completely isolated
Team Chat	Type !message to send a team-only message, controlled per arena via gamerule
Global Arena Chat	Optional arena-wide chat channel, toggle per arena via gamerule
Tab List Isolation	Each arena gets its own tab list — lobby players are hidden from arena players and vice versa

🎭 Display & HUD

Feature	Description
Bossbar	YAML templates for waiting, playing, and ending states
Scoreboard	Per-player scoreboards with full placeholder support
Spectator Mode	Fly around the arena; compass teleports to live players
Multi-Language	English, Polish, German, Spanish, French, and Russian — missing keys fall back to English automatically
Per-Arena Resource Pack	Force a custom resource pack for each arena; automatically sent on join and cleared on leave

🔌 Integrations

Feature	Description
PlaceholderAPI	14 placeholders under %newbedwars_*% for scoreboards, chat formatters, and external plugins (soft dependency — plugin loads without it)
WorldEdit / FAWE	Create arenas directly from .schem / .schematic files saved in the WorldEdit schematics folder (soft dependency — manual setup still works without it)

---

💻 Commands

Player Commands

/bw join [arena]      — Open arena selector or join a specific arena
/bw rejoin            — Rejoin your previous arena
/bw lobby             — Leave the arena and return to the main lobby
/bw spectate [arena]  — Join a running arena as spectator
/bw lang <en|pl|de|es|fr|ru>  — Change your display language
/bw help              — Show all available commands
/bw stats [player]    - Show players stats
/bw profile [player]    - Show players stats
/bw leaderboard [wins|kills|beds|fk] - Show top 10 players by a stat.
/lobby                — Shortcut: teleport to lobby
/lang <en|pl|de|es|fr|ru>     — Shortcut: change language

Party Commands

/party invite <player>  — Invite a player to your party
/party accept           — Accept a pending invite (clickable in chat)
/party deny             — Deny a pending invite (clickable in chat)
/party leave            — Leave your current party
/party list             — List all party members
/party kick <player>    — Kick a member from your party (admin only)
/party admin <player>   — Transfer the admin role (admin only)
/p                      — Alias for /party

Admin Commands

/bw arena create <name> [-sche <schematic>] [-n]  — Create a new arena (optionally from a WorldEdit schematic)
/bw arena list                  — List all arenas and their current status
/bw arena delete <name>         — Permanently delete an arena
/bw arena enable <name>         — Enable a fully configured arena
/bw arena disable <name>        — Disable a running arena
/bw arena setup <name>          — Enter setup mode for an arena
/bw setLobby                    — Set the global lobby spawn point
/bw setupGuis                   — Open the GUI configuration tool
/bw manageGame                  — In-game admin management panel (phase skip, force-start, stop)
/bw reload                      — Save arenas, kick all players, and reload the configuration

---

🔑 Permissions

Admin Permissions

Permission	Default	Description
newbedwars.bw.admin	op	Full admin access — grants all sub-permissions below
newbedwars.bw.arena	op	Manage arenas (grants the 5 sub-permissions below)
newbedwars.bw.arena.create	op	Create arenas
newbedwars.bw.arena.delete	op	Delete arenas
newbedwars.bw.arena.enable	op	Enable arenas
newbedwars.bw.arena.disable	op	Disable arenas
newbedwars.bw.arena.setup	op	Enter arena setup mode
newbedwars.bw.setlobby	op	Set the lobby location
newbedwars.bw.setupguis	op	Open the GUI editor
newbedwars.bw.managegame	op	Manage running games
newbedwars.bw.bypass	op	Bypass setup-mode restrictions

Player Permissions

Permission	Default	Description
newbedwars.bw.player	true	Bundle — grants all player permissions below
newbedwars.bw.join	true	Join arenas
newbedwars.bw.lobby	true	Teleport to the lobby
newbedwars.bw.rejoin	true	Rejoin after disconnect
newbedwars.bw.spectate	true	Spectate arenas
newbedwars.bw.lang	true	Change language
newbedwars.bw.help	true	View help menu
newbedwars.party	true	Use all /party commands

Config: Set RequireJoinPermission: true or RequireLobbyPermission: true in config.yml to restrict /bw join and /bw lobby to players with the explicit permission. Both default to false (open to everyone).

---

📦 Requirements

• Server: Paper 1.17 – 26.2 (Spigot likely compatible but untested — Paper recommended)
• Java: 16 or higher

Soft Dependencies (optional)

Plugin	Purpose
PlaceholderAPI	Enables %newbedwars_*% placeholders for scoreboards, chat formatters, etc.
WorldEdit or FastAsyncWorldEdit	Required only for schematic-based arena creation (-sche flag)

---

🚀 Installation

1. Download NewBedwars-2.1-beta.jar
2. Drop it into your server's /plugins/ folder
3. Start the server — config files generate automatically
4. Set your lobby spawn: /bw setLobby
5. Create your first arena: /bw arena create myArena
6. Follow the checklist shown by /bw arena
7. Save arena by /bw save
8. Enable when ready: /bw arena enable myArena

Creating an arena from a schematic

1. Save your map as a .schem file in WorldEdit's schematics folder (plugins/WorldEdit/schematics/ or plugins/FastAsyncWorldEdit/schematics/)
2. Run: /bw arena create myArena -sche myMap
3. The map is pasted automatically at world origin; continue with normal setup

---

🐛 Support & Bug Reports

Found a bug or have a suggestion? Please open an issue on GitHub or use the platform's discussion section.

Most problems can be resolved quickly with a bug report.

---

PlaceholderAPI Placeholders

All placeholders use the prefix %newbedwars_<placeholder>%.

In-Game (per-player)

Placeholder	Description
%newbedwars_arena%	Arena name the player is in, or ""
%newbedwars_status%	Game status: waiting / starting / playing / ending / restarting, or lobby
%newbedwars_team%	Team name, or ""
%newbedwars_team_color%	Team ChatColor code, or ""
%newbedwars_kills%	Kills in the current game
%newbedwars_deaths%	Deaths in the current game
%newbedwars_final_kills%	Final kills in the current game
%newbedwars_beds_broken%	Beds broken in the current game
%newbedwars_players%	Current player count in the arena
%newbedwars_max_players%	Max players in the arena
%newbedwars_is_spectator%	true / false
%newbedwars_phase%	Current phase name, or ""
%newbedwars_game_time%	Seconds elapsed since game start, or 0

Lifetime Stats (per-player)

Placeholder	Description
%newbedwars_stat_wins%	Total wins
%newbedwars_stat_losses%	Total losses
%newbedwars_stat_kills%	Total kills
%newbedwars_stat_deaths%	Total deaths
%newbedwars_stat_final_kills%	Total final kills
%newbedwars_stat_beds%	Total beds broken
%newbedwars_stat_games%	Total games played
%newbedwars_stat_kd%	Kill/death ratio (1 decimal, e.g. 2.3)
%newbedwars_stat_wl%	Win/loss ratio (1 decimal)

Per-Arena

Placeholder	Description
%newbedwars_arena_<name>_status%	Game status of the named arena
%newbedwars_arena_<name>_players%	Current player count
%newbedwars_arena_<name>_max_players%	Max players
%newbedwars_arena_<name>_phase%	Current phase name

---

🗺️ Roadmap

Beta exit: NewBedwars will leave beta once stable operation is verified across all supported server versions (Paper 1.17 – 26.1.2).

• Party support
• PlaceholderAPI support
• WorldEdit / FAWE schematic-based arena creation
• Per-arena resource pack forcing
• More languages (DE, ES, FR, RU) (partial support)
• More custom items (Iron Golem, Silverfish, etc.)
• Arena statistics and leaderboards
• Player profile GUI with stats history
• In-game map voting system
• Network / BungeeCord / Velocity mode

---

📸 Screenshots

Joining & Waiting

Arena selector GUI

Waiting lobby with bossbar & scoreboard

In-Game HUD & Events

In-game HUD — scoreboard, phase info, NPC labels	Respawn countdown
Bed destroyed announcement	Trap alarm
End game — spectator view with bossbar

Shop & Upgrades

Shop GUI	Bridge Egg — shop tooltip (cost: 4 Gold)
Team Upgrades shop

Resource Generators

Emerald Generator — hologram

Diamond Generator — hologram

Arena Setup

Help command output	Arena setup checklist (NORMAL_SETUP)
Team configuration checklist — missing fields highlighted

Map & Environment

Arena map — aerial overview	Live gameplay — combat near a bed 1
Live gameplay — bed protection	Live gameplay — building bridge
Live gameplay — combat near a bed 2

---