VAULT+ HYTALE PLUGIN Hytale BedWars Core v1.4

Hytale BedWars Core is a fully modular, Hytale-native BedWars plugin designed with performance, stability, and extensibility in mind.
It provides a complete BedWars gameplay experience while leveraging modern architecture and Hytale-specific concepts such as prefab-based arena resets and NPC-driven systems.


This resource is built to be sell-ready, future-proof, and easy to adapt once the official Hytale server SDK is released.

---

Core Gameplay​

• Multi-arena support with a clean state machine
  (WAITING → STARTING → RUNNING → ENDING → RESETTING)
• Team-based BedWars rules with beds, elimination, and spectator mode
• Robust respawn handling (bed alive vs bed destroyed)

---

Generators & Economy​

• Iron, Gold, Diamond, and Emerald generators
• Tiered generator upgrades
• Optimized single-task-per-arena scheduling
• Stack caps and safety checks to reduce lag

---

Shop System​

• Fully configurable item and upgrade shops
• Server-authoritative purchase validation
• Permanent item support (auto re-grant on respawn)
• Centralized loadout handling for consistency

---

Prefab Reset System (Hytale-Native Feature)​

• Complete arena reset pipeline:
  • Stops all arena tasks
  • Cleans dropped items and entities
  • Restores the arena using prefabs at anchor points
  • Resets teams, beds, upgrades, and sessions
• Ensures fast, clean, and repeatable matches

---

NPC Systems​

NPC Shopkeepers

• Interaction-based shops (Item Shop / Upgrade Shop)
• Configurable positions per arena
• Automatically despawn and respawn on arena reset

NPC Defenders (AI)

• Team upgrade that spawns defenders on islands
• Radius-based enemy targeting
• Level-based stat scaling
• Fully cleaned up on reset

---

Classes & Skill Tree (Per-Match Progression)​

• Class selection during lobby and countdown
• Starter kits and passive bonuses
• Per-match XP system with skill upgrades
• No permanent progression (balanced and fair gameplay)

---

Stats & Leaderboards​

• Persistent global player statistics:
  • Wins, losses, kills, final kills, deaths, beds broken
• JSON-based storage (MVP, swappable later)
• Global leaderboards accessible via commands

---

Anti-Exploit & Stability​

• Transaction lock to prevent shop duplication
• Rejoin-state restoration to prevent rejoin abuse
• Permissions-ready command structure
• Clean task shutdown on reset and server stop

---

Commands (Highlights)​

• /bw join <arena>
• /bw leave
• /bw class [id]
• /bw skills
• /bw skill <skillId>
• /bw top <wins|kills|beds_broken>

Admin:

• /bw create
• /bw start
• /bw stop
• /bw reset
• /bw save
• /bw reload

---

Configuration​

• arenas.json – arenas, teams, beds, resets, NPCs
• generators.json – generator locations and tiers
• shops.json – items and upgrades
• classes.json – classes and skills

All systems are modular and fully configurable.

---

Requirements​

• Hytale Server (when officially released)
• No external runtime dependencies
  (SDK-specific functionality is abstracted via adapters)

---

Developer Notes​

This plugin uses adapter interfaces for:

• Prefabs
• NPCs
• Shopkeepers
• UI systems

This ensures minimal refactoring is required once the official Hytale API becomes available.