? ServerSideBuilds
适用于 Paper 和 Spigot 服务器的终极服务器端全息建筑模拟器
ServerSideBuilds 是一款完全基于服务器端、零依赖的 Minecraft 插件,它将蓝图和结构图的建筑过程转化为一种互动式的生存游戏玩法机制。
与简单的复制粘贴工具或沉重的结构投影模组不同,ServerSideBuilds 作为一个活跃的 建筑区域模拟器——为建筑者提供生存辅助(如在活跃区域内给予急迫、跳跃提升和缓慢下落效果),管理方块放置,实时追踪进度,并自动从物品栏切换材料。
由于它使用原生的客户端 BlockDisplay 数据包来渲染全息图,原版客户端、基岩版 / 主机玩家(通过 Geyser)以及 Java 版玩家都可以即时查看、旋转、镜像和构建复杂投影,无需安装任何本地模组或资源包!
✨ 功能特性
- ⚡ 活跃建造光环(生存增益):站在投影结构的边界内可获得自定义的建筑师状态效果(如用于清除方块的急迫效果、用于攀爬墙壁的跳跃提升效果,以及防止屋顶坠落死亡的缓慢下落效果)。
- ? 角落边界指示器:活跃建筑区域的 8 个角会脉冲式地显示青色尘埃粒子,清晰地定义全息图的边界。
- ? 自动材料切换器(射线检测优先):用空手右键点击任意全息图方块,插件将搜索你的物品栏并将该材料瞬间切换到主手,同时伴随一声清脆的提示音。新的“射线检测优先”逻辑会首先检查你的视线直连路径,即使指向空旷空间也能轻松选择方块!
- ?️ 交互式建造模式 (
/ssb buildmode):临时热键工具界面,将复杂的平移操作(旋转、镜像、微调、分层、粘贴、填充)直接映射到热键点击,并提供绝对的防丢失保护(退出、重载、断开连接及死亡时保存/恢复)。
- ? 高级镜像与 90° 旋转:实时平移你的结构。完全支持垂直 Y 轴镜像,智能更新台阶、楼梯、活板门、滴水石锥、按钮、杠杆和灯笼的方块状态。
- ?️ 动态方块轮廓与外观:配置未放置的方块是渲染为标准方块还是着色的染色玻璃。可在配置文件中启用/禁用发光轮廓并自定义发光颜色(RGB)!
- ⚡ 异步
.schem 和 .litematic 导入器:在主线程之外异步转换 Sponge .schem 和 Litematica .litematic 文件,保持服务器 TPS 完美流畅。
- ? 动作栏进度追踪器:通过自定义进度条实时观看建筑进度:
ServerSideBuilds: [■■■■■□□□□□] 50% (50/100)。
- ⚙️ 完整的行政管理权限控制:针对每个命令/功能的完整权限节点覆盖以及创造模式要求。
- ? 高度优化且安全:显示实体完全非持久化,这意味着在崩溃或重载后不会有区块污染或滞留实体的问题。
? 建造模式热键工具
输入 /ssb buildmode(或 /ssb bm)会将你当前的物品栏替换为用于操控投影的自定义工具。退出建造模式时,你的真实物品栏会被完全保存并恢复!
- 槽位 1 (指南针) — 旋转 90°:右键点击以顺时针旋转投影 90 度。
- 槽位 2 (末影之眼) — X 与 Y 镜像:右键点击切换 X 轴镜像。左键点击切换 Y 轴镜像(台阶、楼梯、按钮等的垂直镜像)。
- 槽位 3 (末影珍珠) — Z 镜像 & 重置:右键点击切换 Z 轴镜像。左键点击重置所有镜像。
- 槽位 4 (箭矢) — 微调:右键点击沿你面向的方向微调投影 1 个方块。左键点击向上微调。
- 槽位 5 (羽毛) — 上层 ▲:右键点击进入上一层(分层模式)。
- 槽位 6 (砖块) — 下层 ▼:右键点击退入下一层。左键点击关闭分层模式。
- 槽位 7 (下界之星) — 全部粘贴:右键点击立即将蓝图中的所有剩余方块放置到世界中(创造模式/OP 功能)。
- 槽位 8 (漏斗) — 填充:右键点击直接从保存的物品栏中自动放置匹配的方块到投影中。
- 槽位 9 (屏障) — 退出:右键点击退出建造模式并恢复你的物品栏。
? 命令参考
| 命令 |
权限 |
描述 |
/ssb wand |
serversidebuilds.use |
获取蓝图选择法杖。 |
/ssb pos1 / /ssb pos2 |
serversidebuilds.use |
在你脚下设置选择角点。 |
/ssb save <name> |
serversidebuilds.feature.save |
将选区保存为蓝图。 |
/ssb list |
serversidebuilds.use |
打开蓝图库箱子 GUI。 |
/ssb project <name> |
serversidebuilds.use |
在准星/脚下渲染全息投影。 |
/ssb clear |
serversidebuilds.use |
清除当前投影并退出建造模式。 |
/ssb buildmode |
serversidebuilds.use |
切换快捷栏建造模式。 |
/ssb materials |
serversidebuilds.use |
查看所需剩余方块列表。 |
/ssb rotate <90/180/270> |
serversidebuilds.feature.rotate |
旋转投影。 |
/ssb mirror <x/y/z> |
serversidebuilds.feature.mirror |
镜像投影。 |
/ssb nudge <dir> [amt] |
serversidebuilds.feature.nudge |
微调投影位置(北/南/东/西/上/下)。 |
/ssb layer [up/down/set/off] |
serversidebuilds.feature.layer |
逐层查看投影切片。 |
/ssb paste |
serversidebuilds.feature.paste |
瞬间放置所有方块(仅创造模式/OP 权限)。 |
/ssb fill |
serversidebuilds.feature.fill |
从背包中放置匹配的方块。 |
/ssb undo |
serversidebuilds.feature.undo |
撤销上一次 /ssb paste 或 /ssb fill 操作。 |
/ssb import <file> <name> |
serversidebuilds.feature.import |
异步导入 .schem 或 .litematic 文件。 |
/ssb reload |
serversidebuilds.admin |
重新加载配置文件和蓝图文件。 |
⚙️ 配置设置 (config.yml)
配置文件生成于 plugins/ServerSideBuilds/config.yml。你可以自定义材质、反馈指示器和数量上限:
# 用于选择法杖的材质
# 必须是有效的 Bukkit Material 名称
wand-item-material: "GOLDEN_HOE"
# 单个蓝图中允许的最大方块数量
# 防止重型选区导致性能问题
max-blueprint-blocks: 50000
# 动作条进度显示配置
enable-action-bar-progress: true
# 声音配置
# 必须是有效的 Bukkit Sound 名称(不区分大小写)
sounds:
correct-placement: "ENTITY_EXPERIENCE_ORB_PICKUP"
incorrect-placement: "BLOCK_NOTE_BLOCK_BASS"
completion: "UI_TOAST_CHALLENGE_COMPLETE"
# 粒子效果配置
particles:
enable: true
correct-count: 8
incorrect-count: 5
# 幽灵方块外观
# 控制未放置的全息投影方块如何向玩家渲染
ghost-blocks:
# true = 显示带颜色的染色玻璃(易于区分已放置和未放置的方块)
# false = 显示原始方块类型(旧版行为,较难区分)
use-tinted-glass: false
# 在未放置方块上启用青色/自定义发光轮廓
glow-enabled: true
# 发光轮廓的 RGB 颜色(R,G,B 格式,值范围 0-255)
glow-color: "0,240,255"
# 建造光环(生存增益)
# 为站在其活动投影范围内的建造者提供状态效果
build-aura:
enable: true
effects:
- "FAST_DIGGING:1"
- "JUMP:2"
- "SLOW_FALLING:1"
# 在活动建筑区域的 8 个外角处显示发光边框粒子
boundary-particles: true
# 自动材质切换器
# 当空手右键点击全息投影方块时,自动从背包中取出正确的方块类型
auto-material-switcher:
enable: true
# 功能访问控制设置。OP 始终绕过检查。
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"
? 如何导入 Schematics 和 Litematic 文件
ServerSideBuilds 支持 Sponge .schem 和 Litematica .litematic 文件。
- 前往服务器上的
plugins/ServerSideBuilds/imports/ 文件夹。
- 将你的结构文件或 litematic 文件放入该文件夹中。
- 在游戏中,运行导入命令:
/ssb import <filename> <blueprint_name>
- 插件将异步导入并编译蓝图,完成后会通知你。之后你可以立即使用
/ssb list 或 /ssb project <blueprint_name> 访问它。
? 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.
- 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>.
评论 0
登录后参与评分
还没有评论,来抢沙发吧