Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
NewBedwars
A modern, fully configurable Bedwars plugin built from the ground up for Paper 1.17 – 26.x. You get the classic Bedwars experience (teams, beds, generators, shops) plus a proper in-game setup system, YAML-driven GUIs, multi-arena support and deep gamerule control. No extra plugins needed.
Whether you're running a small survival server and just want a Bedwars minigame, or building a full network, NewBedwars gives you the tools to build polished arenas without a headache.
This is a beta release, close to the first stable version (see the roadmap below). Core gameplay is stable and feature-complete. Please report issues on GitHub.
Why this exists
A lot of free Bedwars plugins make you pick one: simple but bare-bones, or powerful but bloated with dependencies and a config file the size of a novel. NewBedwars tries to skip that trade-off. You set up an arena entirely in-game through a guided setup flow, so there is no hand-editing YAML just to place a bed or a generator. Everything from the shop GUI to the scoreboard is defined in YAML you can reshape without touching Java. PlaceholderAPI, WorldEdit and Citizens are supported if you have them, but you don't need any of them.
Features
Gameplay
- Multi-arena support: run as many arenas as you want at once, each in its own world
- Automatic map reset after every game, with backups, export, import and copying of arenas
- Configurable team count, colors and player limits per arena
- Quick Void: instant death below a configurable Y level
- Per-team build protection zones
- Rejoin system for players who get disconnected
- Parties:
/party, clickable invites, and the party admin leads everyone into an arena together - Configurable game phases: generator upgrades, bed destruction, Ender Dragons, and more
- Smart Ender Dragons from the Dragon Buff upgrade: they hunt enemy players, dive at them, aim their fireballs and never hurt their own team
- Resource generators (iron, gold, diamond, emerald) with levels, plus team Forge upgrades
- Arena groups with map voting at the end of a game
Arena setup
- A guided in-game setup with a checklist (
/bw info) and floating labels for every point you set - Automatic setup: build the map, run
/bw startAutomaticSetup, and the plugin finds the beds (one team per bed colour), the generator blocks and marker signs ([spawn],[shop],[upgrades],[gen]). It then guesses the team areas and walks you through whatever is still missing with clickable chat buttons - Create an arena from a WorldEdit schematic (optional)
Shop and upgrades
- YAML shop and upgrade GUIs, with fast-buy customization
- Team upgrades (Forge, Heal Pool, Dragon Buff, traps and more), each level with its own price and currency (
data/upgrades.yml), and optional different prices per upgrade GUI (for example cheaper upgrades in solo arenas) - Custom items: Bridge Egg, Fireball, custom potions, Iron Golem, Silverfish, Lucky Block, Portable Tower and more
- Team-colored blocks: wool, terracotta, glass, concrete and more are given in the buyer's team color
Chat, display and HUD
- Arena chat isolation, team chat with
!message, optional arena-wide chat, tab list isolation - YAML-templated boss bars and per-player scoreboards
- Spectator mode with flight and a compass teleporter
- Six languages: English, Polish, German, Spanish, French and Russian (missing keys fall back to English)
- Per-arena resource packs
- Player stats, leaderboards and a profile GUI. Stats are stored by UUID, so a name change keeps them
Servers and networks
- JSON storage by default, or MySQL/MariaDB to share stats between servers
- Velocity network mode: lobby servers and game servers, with players and parties routed to the best free arena (needs the
NewBedwars-Proxyjar on Velocity) - Update notifications: NewBedwars tells the console and admins about new versions and can download them for you (
/bw update) - Web admin panel: the optional NewBedwars Panel addon adds a browser panel. It shows live arenas, game control, game logs, player stats and a visual shop editor, works across a whole network, and is published as a separate project on Modrinth
Integrations
- PlaceholderAPI: 34 placeholders under
%newbedwars_*%(optional) - WorldEdit / FastAsyncWorldEdit: build an arena from a
.schemfile (optional) - Citizens: lobby join NPCs with a live hologram (optional; without Citizens,
/bw npc createspawns a simple NPC) - Addon API with events and registration of your own shop items, upgrades, armor, commands and phase actions
Requirements
- Server: Paper 1.17 – 26.x
- Java: 16 or higher, or whatever your Paper version needs
- No other plugins are required. PlaceholderAPI, WorldEdit / FastAsyncWorldEdit and Citizens are optional.
- For network mode: Velocity 4.x on Java 25, and the same NewBedwars version on every server
Getting started
- Download the jar from this page and drop it into your server's
plugins/folder. - Start the server. Config files generate automatically.
- Set your lobby spawn:
/bw setLobby - Create your first arena:
/bw arena create myArena - Follow the setup checklist shown by
/bw info. Or pick the Automatic setup mode and run/bw startAutomaticSetupto let the plugin find the beds, generators and marker signs for you. - Save the arena:
/bw save - Enable it when ready:
/bw arena enable myArena
Building an arena from a schematic. Save your map as a .schem file in WorldEdit's schematics folder, then run /bw arena create myArena -sche myMap. The map is pasted at the world origin; continue with the normal setup checklist from there. This needs WorldEdit or FastAsyncWorldEdit.
Marker signs for the automatic setup. Place a sign with [spawn], [shop], [upgrades] or [gen] on the first line and, optionally, the team colour on the second line (for example red). Signs without a colour belong to the team of the nearest bed. The used signs are removed after the scan.
Web panel (optional addon)
NewBedwars Panel is a separate, free addon that lets you manage your Bedwars server from any browser. It runs inside your Paper server, with HTTPS out of the box, and needs no separate website or database.
- Live arenas: state, players, phase and time left, teams and beds. Enable, back up, restore, reset, copy, export and import arenas.
- Game control and a live game log: start, skip phase, stop and broadcast. The log shows chat, kills with the real death reason, beds and phases.
- Player stats and leaderboards.
- Visual shop editor: items, prices, languages, drag-and-drop shop and upgrade menus, and upgrade prices per level.
- Accounts: accounts with roles and an activity log.
- Network mode: one panel on the lobby manages every game server.
Web panel dashboard
Web panel dashboard
To install it, put NewBedwars-Panel-<version>.jar next to this plugin (same version), restart, and run nbwpanel user create <name> admin in the console. Then open https://<server>:8150/. Download NewBedwars-Panel-<version>.jar from the GitHub releases. A Modrinth project for it is coming soon. Full guide: panel.md.
Commands
/bw help shows the commands you can use right now, and /bw setupHelp [page] [command] shows the setup commands of your current setup mode.
Player commands
| Command | Description |
|---|---|
/bw join [arena|group] |
Open the arena selector, join a specific arena, or join the fullest waiting arena of a group |
/bw rejoin |
Rejoin the game you disconnected from |
/bw spectate <arena> |
Join a running arena as a spectator |
/bw lobby (or /lobby) |
Leave the arena and return to the lobby |
/bw lang <en|pl|de|es|fr|ru> (or /lang) |
Change your language |
/bw help [page] |
Show the commands you can use |
/bw stats [player] |
Show a player's stats |
/bw profile [player] |
Open a player's profile GUI |
/bw leaderboard [wins|kills|beds|fk] |
Top 10 players by a stat |
Party commands
/party (alias /p)
| Command | Description |
|---|---|
/party invite <player> |
Invite a player to your party |
/party accept / /party deny |
Accept or deny an invite (clickable in chat) |
/party leave |
Leave your party |
/party list |
List the party members |
/party kick <player> |
Kick a member (party admin only) |
/party admin <player> |
Give the party admin role to another member (party admin only) |
Admin commands
| Command | Description |
|---|---|
/bw arena create <name> [-sche <schematic>] [-n] |
Create an arena, optionally from a schematic (-n: do not teleport to it) |
/bw arena list |
List arenas and their status |
/bw arena setup <name> |
Enter setup mode for an arena |
/bw arena enable <name> / disable <name> |
Enable or disable an arena |
/bw arena delete <name> |
Permanently delete an arena, its world and saved data |
/bw arena backup <name> / backups <name> / restore <name> [id] |
Back up an arena, list its backups, restore one |
/bw arena export <name> / import <file> |
Export an arena to a zip in data/exports, or import one (loaded disabled) |
/bw arena copy <name> <newName> |
Copy an arena (settings and map) to a new arena |
/bw arena resetmap <name> |
Put the arena map back to its saved state |
/bw group <create|delete|add|remove|list|info|setitem> ... |
Arena groups for map voting |
/bw npc <set|clear|info|list|create|remove> ... |
Lobby join NPCs (Citizens or simple NPCs) |
/bw setlobby |
Set the lobby spawn |
/bw game <start|forcestart|stop|forcestop|nextPhase> |
Manage the game you are in or spectating |
/bw game broadcast <message> |
Send a highlighted message to everyone in your arena |
/bw update [check|download] |
Look for a new version, or download it for the next restart |
/bw reload |
Save arenas, send everyone to the lobby and reload the configuration |
Setup commands
Used inside the arena world after /bw arena setup <name>. Pick a mode with /bw setupMode; each mode includes the commands of the ones before it. Position commands use your location when you give no coordinates.
| Mode | Commands |
|---|---|
| All | /bw info [gui], /bw setupMode, /bw setupHelp, /bw save, /bw remove, /bw leave |
| Normal | /bw createTeam <color> <name>, setTeamSpawn, setTeamBed, setTeamShop, setTeamUpgrades, setGenerator <type> [team], setMinPlayers, setMaxInTeam, setWaitingSpawn, setWaitingPos1/2, setWaitingTime, setQuickVoidY, setTeamBasePos1/2, setTeamBuildProtAreaPos1/2 |
| Advanced | /bw gamerule <name> <true|false>, setGui, setGeneratorLeveling, setResourcePack |
| Automatic | Everything from Normal, plus /bw startAutomaticSetup [radius|next|skip|cancel] |
The complete list with every argument is in the command reference.
Permissions
Parent permissions grant their children. Everything not marked true defaults to op.
| Permission | Default | Description |
|---|---|---|
newbedwars.bw.admin |
op | All admin commands |
newbedwars.bw.arena |
op | All /bw arena ... commands |
newbedwars.bw.arena.<action> |
op | A single arena command: create, delete, enable, disable, setup, list, backup, backups, restore, export, import, copy, resetmap |
newbedwars.bw.group |
op | All /bw group ... commands |
newbedwars.bw.npc |
op | /bw npc ... |
newbedwars.bw.setlobby |
op | /bw setlobby |
newbedwars.bw.managegame |
op | /bw game ... |
newbedwars.bw.update |
op | /bw update |
newbedwars.update.notify |
op | A chat line on join when a new version is out |
newbedwars.bw.bypass |
op | Bypass setup-mode restrictions |
newbedwars.bw.player |
true | Bundle of all player permissions below |
newbedwars.bw.join / lobby / rejoin / spectate |
true | Join arenas, go to the lobby, rejoin, spectate |
newbedwars.bw.lang / help / stats / profile / leaderboard |
true | Language, help, stats, profile and leaderboard commands |
newbedwars.party |
true | All /party commands |
newbedwars.bw.join and newbedwars.bw.lobby are only checked when RequireJoinPermission / RequireLobbyPermission is true in config.yml. Both default to false, which means everyone can use them.
Configuration
Files are created in plugins/NewBedwars/:
| File | What it controls |
|---|---|
config.yml |
Defaults, gamerules, game phases, dragons, rejoin, storage, updates, network mode |
language/*.yml |
All messages (add or edit translations) |
bossBars.yml / scoreboards.yml |
Boss bar and scoreboard templates |
generators/defaultGenerators.yml |
Resource generator speeds and levels |
data/guis/*.yml |
Shop and upgrade GUIs |
data/items.yml |
Shop items |
data/upgrades.yml |
Upgrade and trap prices per level |
data/arenas/*.json |
Saved arenas (edited by the setup commands) |
More guides: storage (JSON and MySQL), network mode, web panel.
PlaceholderAPI
If PlaceholderAPI is installed, NewBedwars registers 34 placeholders under %newbedwars_<placeholder>%, for example %newbedwars_arena%, %newbedwars_team%, %newbedwars_kills%, %newbedwars_stat_wins% and %newbedwars_arena_<name>_players%. See the full list.
Addon developers
NewBedwars has an API with events, so other plugins can hook into it. You can register your own shop items, upgrades, armor tiers, commands and phase actions, read stats and leaderboards, control games, edit the shop, store extra data on arenas and edit arenas. Documentation: Addon API, with a complete example addon.
Roadmap
2.7-beta is one of the last betas. All planned features are done: parties, PlaceholderAPI, schematics, stats, the addon API, Citizens NPCs, map voting, network mode, automatic arena setup, update notifications and the web panel.
What comes next:
- One or two bug-fix betas after 2.7-beta, depending on what is reported. They fix problems and don't add big features.
- The first stable release. NewBedwars leaves beta when no major bugs are open and it has been tested on every supported server version (Paper 1.17 – 26.x), on a single server and on a network.
Found a bug in a beta? Please report it. Every report brings the stable release closer.
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 defense with end stone
Live gameplay — building bridge
Live gameplay — combat near a bed 2
Support and bug reports
Found a bug or have a suggestion? Open an issue on GitHub or use the discussion section here. Most problems can be fixed quickly with a good bug report: include your server version, the NewBedwars version and the relevant part of the log.
License
See LICENSE.txt.
NewBedwars, developed by l299l. Paper 1.17 – 26.x


