BedLamCore - Premium 1.04.0

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Build your lobby and arenas with a hotbar compass, players queue on NPCs, and matches run with a full scoreboard, kill feed, forge, item shop, upgrades and traps, cosmetics, and an end-game dragon phase. One jar runs Solo, Doubles, Trios, and Quads across every supported version. Set it up in-game — there is no config file to hand-edit before you can play.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Game modes

1. Solo — 1 player per team
2. Doubles — 2 per team
3. Trios — 6 teams of 3
4. Quads — 8 teams of 4

Each mode has its own queue NPCs, quick-join, per-mode stats, and leaderboard tabs.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Match feel

1. ★ level-tier star in the tab list, kill feed, and match sidebar
2. First Blood broadcast on the first bed break of the match
3. Kill-streak action-bar counter (×2, ×3, ×4…), reset on death
4. Per-player Final Kills line on the sidebar, updated live
5. BED DESTROYED and YOU DIED title cards (killer, their held item, your final-kill count)
6. Mid-match level-up detection that drops the cosmetic reward on the spot
7. End-game dragon phase — once every bed is gone and teams still contend, Ender Dragons spawn and hunt survivors so a bedless stalemate is forced to a finish (configurable, can be turned off)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Core gameplay

1. Item Shop with Quick Buy and Blocks / Melee / Armor / Tools / Ranged / Potions / Utility categories
2. Upgrades and Traps GUI for per-team purchases
3. Team forge with pooled iron and gold (levels 1–4) and rare diamond/emerald drops from level 2
4. Tiered diamond and emerald generators with a ground-item cap
5. Bridge Egg and Dream Defender items
6. Punch-to-deposit team chests
7. Soft spectate (adventure + flight + invisibility, not SPECTATOR gamemode) so it works on 1.8
8. Match rewards, a dragon-mount win effect, and a Play Again button

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Cosmetics — 10 categories, 130 items

1. Kill Effects — 10
2. Victory Dances — 20
3. Glyphs — 25
4. Bed Destroys — 10
5. Wood Skins — 9
6. Final Kill Effects — 8
7. Death Cries — 25
8. Island Toppers — 5
9. Prestige — 8
10. Projectile Trails — 10

Earned with tokens and equipped from the lobby Cosmetics NPC. (The kill feed itself is part of the translated message system, not a cosmetic pack.)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Progression, leaderboards & economy

1. Tokens, XP, and levels tracked per player
2. 10 leaderboards: Wins, Kills, Final Kills, Beds Broken, Winstreak, KDR, FKDR, Level, XP, Tokens
3. Hypixel-style floating lobby board plus a /leaderboard GUI and chat rankings
4. Storage: YAML by default (nothing to set up) or MySQL (storage.backend: mysql, driver bundled); migrate with /bc storage migrate mysql
5. PlaceholderAPI support — %bedlamcore_level%, %bedlamcore_tokens%, KDR/FKDR, per-mode stats, live player counts, and more

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Languages

1. Ships with English, Deutsch, Español, and Français
2. Players pick their own language with /bedlam lang

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Parties & NPCs

1. Built-in party system — /party invite, queue together onto the same team, dedicated party chat (/pc); can bridge BungeeParties / Party and Friends
2. Real player-model queue NPCs via Citizens when installed, or a built-in armor-stand / mob fallback (Citizens not required)
3. Profile NPC (stats GUI) and Cosmetics NPC (token shop)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Screenshots

Lobby & queue NPCs



Profile, stats & leaderboards




Cosmetics menu




In-match: shops, upgrades & generators





Maps, islands & bed break

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Setup (in-game, no config editing)

1. 1. Paste your license key into plugins/BedLamPremium/config.yml and start the server.
2. 2. Op yourself and open the hotbar compass → Lobby Setup: set the spawn, place the queue / Profile / Cosmetics NPCs, then Apply.
3. 3. Compass → Game World Setup: create a Solo / Doubles / Trios / Quads world (or use a template / import a folder), place spawns, beds, forges, shops, chests, and generators, run /bc spawnbuild for the waiting area, then Apply.
4. 4. Players queue on the NPCs. For solo testing use /bedlam forcestart.

Edits are drafts — Apply writes to disk, Cancel discards. A pristine world snapshot is restored between matches. Bundled showcase template: bedwars-e2560.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Requirements

1. Spigot or Paper — one jar, no version-specific builds. Tested on 1.26, 1.20, 1.16, 1.12, and 1.8.
2. Java 8 or newer (Java 8 bytecode).
3. License key + outbound HTTPS — this is licensed software with an online key check. The server needs outbound HTTPS (port 443) to activate; once activated it tolerates a temporary outage for up to 48h (see Licensing).
4. Optional: Citizens (nicer NPC bodies), PlaceholderAPI (placeholders), MySQL (if you choose the MySQL backend).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Licensing

1. One key, one server. Each key covers a single concurrent server, bound to its IP, port, and machine ID.
2. RSA-signed online activation. Keys are RSA-2048 / SHA-256 signed and validated online.
3. 48-hour offline grace. Once activated, a brief license-server or network outage will not take your server down mid-match — it keeps running on the last valid activation for up to 48 hours of continuous outage and retries in the background. Only a genuinely expired/revoked key disables it right away.
4. Activate in config.yml before starting — paste the key under license-key, then (re)start. There is no /bedlam license command; activation is config-only.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Support

Found a bug or need help getting set up? Open a support ticket in our Discord, or post in the discussion tab on this resource. Include your server version and the console log around the error.