🌟 ServerSideBuilds

The Ultimate Server-Side Holographic Construction Zone Simulator for Paper & Spigot

ServerSideBuilds is a 100% server-side, zero-dependency Minecraft plugin that transforms building from blueprints/schematics into an interactive survival gameplay mechanic.

Unlike basic copy-paste tools or heavy schematic projection mods, ServerSideBuilds behaves as an active Construction Zone Simulator—providing builders with survival assistance (Haste, Jump Boost, Slow Falling) inside the boundary, managing block placements, tracking progress in real-time, and auto-switching materials from inventory.

Because it renders holograms using native client-side BlockDisplay packets, Vanilla clients, Bedrock Edition / Console players (via Geyser), and Java players can instantly view, rotate, mirror, and construct complex projections without installing any local mods or resource packs!

✨ Features

• ⚡ Active Build Aura (Survival Buffs): Standing inside your projected structure's boundaries grants custom builder status effects (like Haste for clearing blocks, Jump Boost for climbing walls, and Slow Falling to prevent rooftop fall deaths).
• 💠 Corner Boundary Indicators: The 8 corners of the active construction zone pulse with Cyan dust particles, clearly defining the boundaries of the hologram.
• 🎒 Auto-Material Switcher (Raytrace-First): Right-click any hologram block with an empty hand, and the plugin will search your inventory and instantly swap that material into your main hand with a chime. The new raytrace-first logic checks your direct line-of-sight first, letting you easily select blocks even when pointing through empty space!
• 🛠️ Interactive Build Mode (/ssb buildmode): Temporary hotbar tool interface that maps complex translation actions (Rotate, Mirror, Nudge, Layer, Paste, Fill) directly to hotbar clicks, complete with absolute protection against inventory loss (saves/restores on exit, reload, disconnect, and death).
• 📐 Advanced Mirroring & 90° Rotations: Translate your structures on the fly. Vertical Y-Mirroring is fully supported, intelligently updating block states for slabs, stairs, trapdoors, dripstones, buttons, levers, and lanterns.
• 👁️ Dynamic Block Outlines & Appearance: Configure whether unplaced blocks are rendered as standard blocks or tinted stained glass. Enable/disable glowing outlines and customize the glow color (RGB) in the config!
• ⚡ Async .schem & .litematic Importers: Convert Sponge .schem and Litematica .litematic files asynchronously off the main thread, keeping your server's TPS perfectly smooth.
• 📦 Action Bar Progress Tracker: Watch your building progress in real-time with a custom progress bar: ServerSideBuilds: [■■■■■□□□□□] 50% (50/100).
• ⚙️ Complete Administrative Access Control: Full per-command/per-feature permission node overrides and creative-mode requirements.
• 🔒 Highly Optimized & Safe: Display entities are completely non-persistent, meaning zero chunk pollution or stranded entities after a crash or reload.

🎮 Build Mode Hotbar Tools

Typing /ssb buildmode (or /ssb bm) swaps your current inventory with custom tools to manipulate your projection. Your real inventory is completely saved and restored when exiting build mode!

• Slot 1 (Compass) — Rotate 90°: Right-click to rotate the projection 90 degrees clockwise.
• Slot 2 (Ender Eye) — Mirror X & Y: Right-click to toggle Mirror X. Left-click to toggle Mirror Y (Vertical mirroring of stairs, slabs, buttons, etc.).
• Slot 3 (Ender Pearl) — Mirror Z & Reset: Right-click to toggle Mirror Z. Left-click to reset all mirrors.
• Slot 4 (Arrow) — Nudge: Right-click to nudge the projection 1 block in the direction you are facing. Left-click to nudge upward.
• Slot 5 (Feather) — Layer ▲: Right-click to step up one layer (Layer Mode).
• Slot 6 (Brick) — Layer ▼: Right-click to step down one layer. Left-click to disable Layer Mode.
• Slot 7 (Nether Star) — Paste All: Right-click to instantly place all remaining blocks of the blueprint into the world (Creative/OP feature).
• Slot 8 (Hopper) — Fill: Right-click to automatically place matching blocks directly from your saved inventory into the projection.
• Slot 9 (Barrier) — Exit: Right-click to exit Build Mode and restore your inventory.

📖 Command Reference

⚙️ Configuration Setup (config.yml)

The configuration file is generated at plugins/ServerSideBuilds/config.yml. Customize materials, feedback indicators, and caps:

💾 How to Import Schematics & Litematic Files

ServerSideBuilds supports Sponge .schem and Litematica .litematic files.

1. Navigate to the plugins/ServerSideBuilds/imports/ folder on your server.
2. Drop your schematic or litematic files into the folder.
3. In-game, run the import command: /ssb import <filename> <blueprint_name>
4. The plugin will asynchronously import and compile the blueprint, notifying you once complete. You can then access it immediately using /ssb list or /ssb project <blueprint_name>.