🌟 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

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:

yaml

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

Navigate to the plugins/ServerSideBuilds/imports/ folder on your server.
Drop your schematic or litematic files into the folder.
In-game, run the import command: /ssb import <filename> <blueprint_name>
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>.

🌟 ServerSideBuilds

✨ Features

🎮 Build Mode Hotbar Tools

📖 Command Reference

⚙️ Configuration Setup (config.yml)

💾 How to Import Schematics & Litematic Files

⚙️ Configuration Setup (`config.yml`)