ULTRA 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

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

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

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

• ★ level-tier star in the tab list, kill feed, and match sidebar
• First Blood broadcast on the first bed break of the match
• Kill-streak action-bar counter (×2, ×3, ×4…), reset on death
• Per-player Final Kills line on the sidebar, updated live
• BED DESTROYED and YOU DIED title cards (killer, their held item, your final-kill count)
• Mid-match level-up detection that drops the cosmetic reward on the spot
• 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

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

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

• Kill Effects — 10
• Victory Dances — 20
• Glyphs — 25
• Bed Destroys — 10
• Wood Skins — 9
• Final Kill Effects — 8
• Death Cries — 25
• Island Toppers — 5
• Prestige — 8
• 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

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

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

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

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

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

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


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

• 1. Paste your license key into plugins/BedLamPremium/config.yml and start the server.
• 2. Op yourself and open the hotbar compass → Lobby Setup: set the spawn, place the queue / Profile / Cosmetics NPCs, then Apply.
• 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. 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

• Spigot or Paper — one jar, no version-specific builds. Tested on 1.26, 1.20, 1.16, 1.12, and 1.8.
• Java 8 or newer (Java 8 bytecode).
• 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).
• Optional: Citizens (nicer NPC bodies), PlaceholderAPI (placeholders), MySQL (if you choose the MySQL backend).

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

• One key, one server. Each key covers a single concurrent server, bound to its IP, port, and machine ID.
• RSA-signed online activation. Keys are RSA-2048 / SHA-256 signed and validated online.
• 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.
• 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.