1. 🌐 100% Server-Side Holographic Projections (Ghost Blocks)

What it does: Renders a semi-transparent or solid preview outline of any blueprint structure directly in the player's game world relative to where they are looking. How it works: Rather than spawning real blocks in the world, the plugin uses standard Bukkit API packets (player.sendBlockChange) to send block-state updates directly to the player's client. The Benefit: Zero Client Dependencies: Players do not need to install Litematica, WorldEdit, or any client-side mods/shaders. Cross-Play Support: It works flawlessly for players using unmodified vanilla clients, consoles (PlayStation, Xbox, Switch), and mobile devices joining via Geyser/Floodgate. Clean Cleanup: Projections automatically clear when players log off or run /ssb clear, leaving no permanent modification or block desync in the world.

2. ⚡ Active Build Aura (Survival Construction Buffs)

What it does: Turns the construction site into a literal "construction zone simulator" by giving players helpful survival buffs while they work inside the footprint of their blueprint. How it works: A background scheduler checks active builder coordinates every 5 seconds. If a player is standing inside their active projection boundaries, the plugin automatically applies configurable status effects. Included Buffs (Fully Customizable in config.yml): Haste I/II (FAST_DIGGING): Helps clear terrain, dirt, and stone in the zone rapidly. Jump Boost II (JUMP): Allows builders to climb tall scaffolding and walls without constantly placing temporary dirt pillars. Slow Falling I (SLOW_FALLING): Eliminates fall damage so builders can build roofs and high towers safely. 💠 Corner Boundary Indicators: The 8 outer corners of the active projection glow with pulsing, colored dust particles (Particle.REDSTONE with custom Cyan colors), clearly outlining the active buff zone.

3. 🎒 Auto-Material Switcher (Frictionless Building)

What it does: Automatically equips the correct building blocks in your hand as you construct, preventing you from constantly opening and closing chest interfaces. How it works: If a builder right-clicks a hologram block with an empty hand (or while holding the selection wand), the plugin performs a raycast check along their line of sight to identify the blueprint block type. It instantly searches the player's inventory for that material. If found, the plugin swaps the block into their main hand. If the item is already on their hotbar, it simply switches their active slot index. If it is in their main inventory, it swaps it into their active hand. It executes a forced inventory update packet (player.updateInventory()) to eliminate client-side visual "ghost item" glitches, plays a grab chime, and displays an action-bar alert: ★ Equipped: oak planks.

4. 💠 Dynamic Block Matching & Real-Time Feedback

What it does: Validates block placements instantly, providing audio-visual confirmation. How it works: Correct Placement: Placing the right block type at a hologram coordinate plays an experience pickup chime (ENTITY_EXPERIENCE_ORB_PICKUP) and spawns green star particles (Particle.VILLAGER_HAPPY). The ghost block is cleared, and progress increases. Incorrect Placement: Placing an incorrect block type flashes a warning bass note (BLOCK_NOTE_BLOCK_BASS), emits gray smoke particles (Particle.SMOKE_NORMAL), and schedules a tiny delay before re-sending the ghost block outline so the error remains highlighted. Block Breaks: If a correct block is broken, the plugin immediately restores the ghost block hologram overlay, updating the progress bar dynamically. Completion Chime: Completing a blueprint plays a grand challenge completion toast sound (UI_TOAST_CHALLENGE_COMPLETE).

5. 📊 Action Bar Progress Tracker

What it does: Keeps builders updated on their exact building status. How it works: Upon every correct block placement, block break, or initial hologram projection, the plugin sends a real-time progress update to the player's Action Bar (above the hotbar): text ServerSideBuilds: [■■■■■□□□□□] 50.0% (50/100) This displays a visual completion bar, progress percentage, and the absolute ratio of completed blocks to total blueprint blocks.

6. 📁 Chest GUI Blueprint Library

What it does: Provides a visual, interactive menu of all saved and imported blueprints on the server. How it works: Openable with /ssb list, it opens a 54-slot chest interface: Quick Project: Left-clicking any blueprint item (modeled as a bookshelf) closes the UI and projects that blueprint relative to the block the player is looking at. Hover Tooltips: Hovering over a blueprint displays its exact dimensions ($W \times H \times L$), total block count, and a detailed checklist of the first 5 required materials and their exact quantities. Admin Deletion: Admins can delete blueprints directly from the UI using Shift + Right-Click (which deletes the file, plays a break sound, and refreshes the GUI). Bypass Safety: Clicks are only intercepted inside slots 0-53. Players are completely free to click, organize, or drag items inside their own player inventory hotbars below the menu.

7. 📥 Async Sponge (.schem) & Litematica (.litematic) Importers

What it does: Allows importing blueprints made in WorldEdit or Litematica. How it works: The plugin includes custom binary NBT stream decoders: Sponge Schematic Decoder: Unpacks VarInt byte arrays and maps block palettes. Litematica File Decoder: Parses multi-region structures, calculating dynamic bit-widths and unpacking bit-index arrays across 64-bit boundaries. Safety First: The heavy file reading and bit-unpacking run on an asynchronous worker thread off the main server thread. This guarantees that importing a massive 50,000-block schematic will not drop the server's TPS or freeze gameplay. Once done, the plugin schedules a quick main-thread write to save the blueprint config and reload the cache.

8. 🪄 Selection Wand & Command Scaffolding

What it does: Allows creators to select and save new blueprints directly in-game. How it works: Running /ssb wand grants a custom item (default GOLDEN_HOE) with lore explaining left-click (Position 1) and right-click (Position 2). Alternatively, /ssb pos1 and /ssb pos2 can be run to set coordinates at the builder's feet. Once two corners are marked, /ssb save <name> compiles all non-air blocks in the selection area, verifies it doesn't exceed the configuration block limit (default: 50,000 blocks), and saves it as a lightweight .yml blueprint.