Advanced class system (behavior pack)
Go to files
Vanilla-friendly behavior pack adding a permanent class system with three unique classes, level-based abilities, and multiplayer support for balanced, progression-focused gameplay.
Class System — Behavior Pack Description
Version: 1.0.0
API Modules: @minecraft/server 1.15.0 · @minecraft/server-ui 1.3.0
Min Engine Version: 1.21.80
Type: Behavior Pack Only (no resource pack required)
What Is This Pack?
The Class System is a fully scripted behavior pack for Minecraft Bedrock Edition servers. When a player joins for the first time they must choose one of three permanent classes: Nether Warrior, End Shadow, or Human Being. Each class has a unique playstyle, a passive ability, three active abilities that unlock as the player levels up, and environmental interactions. The choice is permanent — once selected it cannot be changed unless a server operator clears dynamic properties.
This pack uses the Scripting API only and requires no resource pack, custom blocks, or add-on entities. All visuals use vanilla atlas keys.
How Classes Work
Selecting a Class
On first join a menu opens automatically. Players can view each class's description via three buttons and confirm their choice. After selection the player receives:
- Starter items for their class
- A locked Class Info paper item (cannot be dropped or moved)
- A name tag showing their class under their username
Ability Unlocks
- Passive — Level 5: Permanent passive effect
- Small Ability — Level 15: Ability item given (locked)
- Main Ability — Level 30: Ability item given (locked)
- Ultimate — Level 50: Ability item given (locked)
The pack checks every 20 seconds for level thresholds and grants items automatically.
Cooldown System
Active abilities have millisecond-tracked cooldowns. While holding an ability item the action bar shows remaining cooldown or READY in green. Cooldowns persist through death and disconnects (saved to dynamic properties).
Class Info Item
Right-clicking the locked Class Info paper opens a two-screen interface:
- Class Progress: current level and unlock status for all tiers
- Ability Info: full descriptions with costs and cooldowns
Classes
Nether Warrior
A fire-born fighter who thrives in the Nether but is weakened by water and rain.
Starter Items: Stone Sword (Fire Aspect I), Totem of Undying, Gold Chestplate
Passive — Fire Resistance (Level 5): Permanent Fire Resistance. Water contact and rain deal periodic damage (0.5 hearts every 2s in water; 0.5 hearts every 4s in rain when sky-exposed in the Overworld). Rain damage stops if the player goes underground, enters Nether/End, or rain ends. Gold chestplate helps avoid immediate piglin aggression on Nether entry.
Small Ability — Lifesteal (Level 15)
Item: Redstone Dust | Duration: 20s | Cooldown: 3 minutes. Grants Strength I for 20s; kills during this window heal 1.5 hearts and drain 0.5 hunger.
Main Ability — Nether Teleport (Level 30)
Item: Nether Wart | Cost: 2 hunger + 1 level | Cooldown: 1.5 minutes. Teleports between Overworld and Nether, remembering last Nether position. Teleport to Nether uses a two-step staging and scans downward for a safe landing; if none found, carves a pocket at Y=70.
Ultimate — Demon Mode (Level 50)
Item: End Crystal | Duration: 15s | Cost: 1 level + 2 hunger | Cooldown: 5 minutes. Grants Strength II, Speed I, Resistance I, and Haste I for 15s.
End Shadow
A fast, elusive scout with teleportation and information-gathering tools.
Starter Items: 10 Breeze Rods, Fishing Rod, Stone Sword (Knockback II + Looting II), 4 Ender Pearls, 10 Cobblestone
Passive — Speed I (Level 5): Permanent Speed I (suppressed during Tactical Backup Phase 1).
Small Ability — Locate (Level 15)
Item: Compass | Cooldown: 5 minutes. Opens a menu with two options:
- Biomes — cost: 1 level + 3 hunger: Dropdown of 35 biomes. Uses pre-built .mcstructure files to fire a /locate biome command via a temporary command-block structure (BSCompass technique). Nether biomes require Nether dimension; wrong-dimension attempt returns an error with no cost.
- Structures — unlocks at Level 50, cost: 5 levels per use: Unlock gives access to 16 structures (Village, Ancient City, Bastion Remnant, End City, Fortress, Mansion, Mineshaft, Monument, Pillager Outpost, Ruined Portal, Shipwreck, Stronghold, Temple, Trail Ruins, Buried Treasure, Trial Chambers). The level-50 unlock is permanent.
Main Ability — Coordinate Teleport (Level 30)
Item: Ender Pearl | Cost: 2 levels + 3 hunger | Cooldown: 4 minutes | Overworld only. Opens a coordinate form pre-filled with the player's current position. Validates destination (inside-blocks, high fall) and presents a confirmation dialog before teleporting.
Ultimate — Tactical Backup (Level 50)
Item: Ender Eye | Cost: 1 level + 2 hunger | Cooldown: 5 minutes. Gives 1 Ender Pearl + 1 Wind Charge and runs two phases: Phase 1 (10s) Invisibility + Slowness II + Resistance II; Phase 2 (8s) Speed II. Passive Speed I is restored after phases end.
Human Being
A versatile builder and trader who controls the land.
Starter Items: Iron Shovel (Unbreaking III), Stone Pickaxe (Silk Touch), 2 Villager Spawn Eggs, Elytra (locked)
Passive — Night Vision (Level 5): Permanent Night Vision.
Small Ability — Builder (Level 15)
Item: Quartz | Cost: 2 hunger | Cooldown: 30s. Opens a Build or Upgrade menu:
- Build: Enter two corner coordinates; script fills the region using blocks from the player's inventory, consuming items. Script counts non-air blocks first and offers Replace All or Air Only. Default limit is 32 blocks per use.
- Upgrade (unlocks at Level 50, permanent): Increase per-use limit from 32 → 64 (cost 5 levels) or 64 → 128 (cost 10 levels). Upgrade state stored in dynamic properties.
Main Ability — Levitation (Level 30)
Item: Feather | Cooldown: 3 minutes. Applies Levitation II for 12s.
Ultimate — Discounts (Level 50)
Item: Emerald | Cost: 2 levels | Cooldown: 10 minutes. Grants Hero of the Village II for 60s and instantly gives 5 Emeralds.
Technical Details
Script Structure — 15 Modules
Files and purposes:
- main.js — Event subscriptions, system wiring
- config.js — Constants: class IDs, item IDs, cooldowns, passives, spawn items
- playerData.js — Dynamic property helpers for per-player state
- utils.js — Shared helpers: effects, hunger, levels, cooldowns
- classes/netherWarrior.js — Nether Warrior logic
- classes/endShadow.js — End Shadow logic
- classes/humanBeing.js — Human Being logic
- systems/passives.js — Passive reapplication, water/rain damage, weather tracking
- systems/levelUnlock.js — Checks levels every 20s, grants unlock items
- systems/cooldownBar.js — Action bar cooldown display
- systems/cooldownPersist.js — Saves/restores cooldowns on leave/join
- systems/commands.js — Class Info item, Progress and Info menus
- systems/nameTag.js — Class name tag under player name
- ui/classMenu.js — Class selection and detail menus
- ui/abilityMenus.js — Ability-specific form dialogs
Data Storage
All player data uses Dynamic Properties (Scripting API). Stored values: class, unlock flags, builder limit and upgrades, Nether position, cooldown timestamps, and active state flags.
No Resource Pack
Textures use vanilla atlas keys (examples: nether_wart, redstone_dust, end_crystal, ender_pearl, feather, quartz, emerald, paper, compass_item).
Item Locking
All ability items and the Class Info item use ItemLockMode.inventory and cannot be dropped, thrown, or moved to chests.
Locate Structures (57 Files)
The pack includes 57 .mcstructure files (BSCompass technique). Each structure contains a pre-programmed command block to run a /locate command and is cleaned up immediately after use.
Q&A
Q: Is the class choice really permanent?
Yes. Once confirmed it is stored in a dynamic property and the selection menu never reopens. A server operator can clear dynamic properties via the API to reset a player.
Q: Do abilities work in all dimensions?
Most are dimension-specific. Nether Teleport works between Overworld and Nether only. Coordinate Teleport is Overworld only. Locate enforces correct dimension. Lifesteal, Demon Mode, Levitation, Builder, and Discounts work anywhere.
Q: What happens when a player dies?
Active ability states reset on respawn. Cooldowns persist. Ability items and the Class Info item are re-given on spawn if missing. The Nether Warrior's gold chestplate is a one-time item and is not re-given on death.
Q: What happens if a player disconnects mid-cooldown?
Remaining cooldowns are saved to dynamic properties and restored on rejoin; cooldown timers continue across disconnects.
Q: Can ability items be shared or dropped?
No. ItemLockMode.inventory prevents dropping. Class checks run on use — if the user is not the required class, the item does nothing.
Q: Does the Builder work underground or in the Nether?
Yes. The limit applies per use and works in all dimensions.
Q: How does Nether Teleport find a safe landing spot?
Teleport staging moves the player to Y=100 at target coords to load chunks, waits ~1s, then scans down from Y=110 for two air blocks above a non-lava solid floor. If none found, carves a 2-block pocket at Y=70.
Q: Why do Locate coordinates appear in chat for everyone?
Bedrock command block output is public; there is no API to make that output private.
Q: Can multiple players pick the same class?
Yes, classes are unlimited.
Q: What Minecraft version is required?
Minimum engine version 1.21.80, using @minecraft/server 1.15.0.
Q: Does this work on Realms?
Core functionality works on Realms. Some commands used for weather queries may be restricted, but abilities remain functional.
Q: Why doesn't the Nether Warrior have passive Strength?
Strength is tied to Lifesteal (20s) and Demon Mode (15s) to make power usage feel active rather than passive.
