🌟 ServerSideBuilds

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

ServerSideBuilds is a 100% server-side, zero-dependency Minecraft plugin that transforms building from blueprints and 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 (like Haste, Jump Boost, and Slow Falling) inside the active zone, 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

Command	Permission	Description
/ssb wand	serversidebuilds.use	Get the blueprint selection wand.
/ssb pos1 / /ssb pos2	serversidebuilds.use	Set selection corners at your feet.
/ssb save <name>	serversidebuilds.feature.save	Save selection as a blueprint.
/ssb list	serversidebuilds.use	Open the Blueprint Library Chest GUI.
/ssb project <name>	serversidebuilds.use	Render a hologram at your crosshair/feet.
/ssb clear	serversidebuilds.use	Clear active projection & exit Build Mode.
/ssb buildmode	serversidebuilds.use	Toggle hotbar Build Mode.
/ssb materials	serversidebuilds.use	View list of remaining blocks needed.
/ssb rotate <90/180/270>	serversidebuilds.feature.rotate	Rotate the projection.
/ssb mirror <x/y/z>	serversidebuilds.feature.mirror	Mirror the projection.
/ssb nudge <dir> [amt]	serversidebuilds.feature.nudge	Shift projection (north/south/east/west/up/down).
/ssb layer [up/down/set/off]	serversidebuilds.feature.layer	View projection slice-by-slice.
/ssb paste	serversidebuilds.feature.paste	Instantly place all blocks (Creative/OP).
/ssb fill	serversidebuilds.feature.fill	Place matching blocks from inventory.
/ssb undo	serversidebuilds.feature.undo	Revert the last /ssb paste or /ssb fill.
/ssb import <file> <name>	serversidebuilds.feature.import	Asynchronously import a .schem or .litematic file.
/ssb reload	serversidebuilds.admin	Reload the config and blueprint files.

---

⚙️ Configuration Setup (config.yml)

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

# The material used for the selection wand
# Must be a valid Bukkit Material name
wand-item-material: "GOLDEN_HOE"
# Maximum number of blocks allowed in a single blueprint selection
# Prevents performance issues on heavy selections
max-blueprint-blocks: 50000
# Action bar progress configuration
enable-action-bar-progress: true
# Sound configuration
# Must be valid Bukkit Sound names (case-insensitive)
sounds:
  correct-placement: "ENTITY_EXPERIENCE_ORB_PICKUP"
  incorrect-placement: "BLOCK_NOTE_BLOCK_BASS"
  completion: "UI_TOAST_CHALLENGE_COMPLETE"
# Particle configuration
particles:
  enable: true
  correct-count: 8
  incorrect-count: 5
# Ghost Block Appearance
# Controls how unplaced hologram blocks are rendered to the player
ghost-blocks:
  # true = Show tinted stained glass (easy to tell placed from unplaced)
  # false = Show the raw block type (old behavior, harder to distinguish)
  use-tinted-glass: false
  # Enable the cyan/custom glowing outline on unplaced blocks
  glow-enabled: true
  # RGB color for the glow outline (R,G,B format, values 0-255)
  glow-color: "0,240,255"
# Build Aura (Survival Buffs)
# Grants status effects to builders standing inside their active projection bounds
build-aura:
  enable: true
  effects:
    - "FAST_DIGGING:1"
    - "JUMP:2"
    - "SLOW_FALLING:1"
  # Displays glowing border particles at the 8 outer corners of the active construction zone
  boundary-particles: true
# Auto-Material Switcher
# Automatically pulls the correct block type from your inventory when right-clicking a hologram block with an empty hand
auto-material-switcher:
  enable: true
# Feature access control settings. OPs always bypass checks.
admin-panel:
  paste:
    enabled: true
    creative-only: true
    permission: "serversidebuilds.feature.paste"
  fill:
    enabled: true
    permission: "serversidebuilds.feature.fill"
  rotate:
    enabled: true
    permission: "serversidebuilds.feature.rotate"
  mirror:
    enabled: true
    permission: "serversidebuilds.feature.mirror"
  nudge:
    enabled: true
    permission: "serversidebuilds.feature.nudge"
  layer:
    enabled: true
    permission: "serversidebuilds.feature.layer"
  undo:
    enabled: true
    permission: "serversidebuilds.feature.undo"
  material-switcher:
    enabled: true
    permission: "serversidebuilds.feature.material-switcher"
  build-aura:
    enabled: true
    permission: "serversidebuilds.feature.build-aura"
  import:
    enabled: true
    permission: "serversidebuilds.feature.import"
  save:
    enabled: true
    permission: "serversidebuilds.feature.save"

---

💾 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>.