原创 娱乐 CyuSpatial | 空间全息交互系统 | Display 3D面板 | 不止全息公告 | 支持Folia [1.20.1-26.x] 1.0

CyuSpatial - 空间全息交互 / 3D 菜单 / Display 面板

一个基于 Display 的空间全息交互插件

它不是传统箱子 GUI，也不是普通全息公告

CyuSpatial 主要用来把文字、物品、方块、按钮、NPC、声音和粒子组合成一个放在游戏世界里的空间界面

当前是第一个公开版本
整体功能还会根据实际使用反馈继续修复和调整

---

这个插件能做什么

● 出生点公告牌
● 服务器功能菜单
● 传送入口
● 活动提示面板
● 可点击的空间按钮
● NPC 展示和简单交互
● 音效、粒子、标题、浮字反馈
● HUD 面板切换和返回
● 简单商店 / 抽奖 / 对话模板参考
● 游戏内位置微调
● 支持 Paper / Purpur / Folia

首发版本更建议先用于公告、菜单、按钮、入口、展示面板这些场景

商店、抽奖、NPC 任务这类模块也有示例和基础能力
但后续还会继续根据服主反馈优化

---

为什么写这个插件

很多服务器的交互基本都是箱子菜单

公告是菜单
商店是菜单
任务是菜单
活动入口也是菜单

箱子 GUI 确实稳定，也很好用
但所有东西都塞进一个背包界面里，时间久了会有点没感觉

CyuSpatial 想做的是另一种交互方式

把菜单放到世界里
把公告、按钮、NPC、商品、奖励提示这些东西变成可以看到、可以点击、可以靠近交互的空间对象

它不是为了取代所有 GUI
而是给服务器多一个更有沉浸感的展示和交互选择

---

两种基础模式

个人 HUD

玩家打开后，面板会出现在玩家面前
适合功能菜单、个人操作、任务详情、简单商店、抽奖界面

公共公告板

固定在世界里的空间面板
适合出生点公告、规则牌、活动入口、NPC 展示、传送点提示

简单说就是：

想做玩家自己的界面，用 HUD
想放在世界里给所有人看，用公告板

---

简单公告也能直接做

如果只是想做一个普通公告，不需要一开始就写复杂 layout

可以直接用指令创建：

/cyuspatial new notice spawn_notice 服务器公告

添加正文：

/cyuspatial line add spawn_notice &b欢迎来到服务器

添加按钮：

/cyuspatial button add spawn_notice 打开菜单 -> open example/menu

移动到当前位置：

/cyuspatial movehere spawn_notice

先把公告显示出来
再慢慢调文字、按钮、距离和位置

---

空间组件

CyuSpatial 的界面由多个组件组成

目前常用组件包括：

text　文字，用来做标题、说明、按钮
item　物品展示，用来做图标、商品、奖励
block　方块展示，用来做边框、展台、装饰
npc　NPC 展示和交互
collision　临时碰撞层，用于一些简单机关或阻挡场景

每个组件都可以调整位置、缩放、旋转和点击范围

---

动作系统

按钮点下去以后，不只是执行一条命令

CyuSpatial 支持动作链

比如一个按钮可以先播放音效，再显示浮字，再打开另一个面板
也可以先做二次确认，再执行购买、传送或者后台命令

常用动作包括：

message　发送消息
title　显示标题
sound　播放声音
particle　播放粒子
console　后台执行命令
player　玩家执行命令
open_hud　打开空间 HUD
transform_to　切换到另一个空间界面
transform_back　返回上一个界面
confirm　二次确认
float_text　浮字提示
flash_glow　闪光反馈

首发版本建议先从简单动作开始用
比如打开菜单、执行命令、播放声音、显示提示

复杂动作链可以等熟悉后再慢慢加

---

空间菜单

CyuSpatial 的菜单不是箱子 GUI

它仍然是空间模板
只是提供了类似菜单的布局、按钮和切换能力

可以做：

● 出生点功能菜单
● 服务器导航菜单
● 活动入口菜单
● NPC 交互面板
● 简单商品展示
● 抽奖预览面板

目前更推荐把它当成“空间展示 + 点击入口”来使用
不要一开始就把所有复杂业务都堆进去

---

点击体验

空间菜单和箱子 GUI 不一样

箱子 GUI 点的是格子
空间菜单点的是世界里的组件和点击区域

所以 CyuSpatial 支持单独设置点击范围

文字可以小一点
但点击范围可以给大一点

HUD 也可以调距离、缩放、上下偏移、自动关闭距离和贴墙避让

建议刚开始做界面时，不要把按钮排得太密
先保证玩家能稳定点到，再去追求好看

---

NPC 展示和交互

CyuSpatial 支持 NPC 组件

NPC 可以放在空间模板里
玩家点击、靠近、离开或注视时，可以触发动作

首发版本可以先用来做：

● NPC 引导
● 商店入口
● 活动介绍
● 简单对话
● 任务提示入口

后续会继续完善更复杂的 NPC 对话、任务状态和剧情分支

---

商店和抽奖

插件内置了商店和抽奖相关的模块示例

可以用空间面板做商品展示、购买按钮、抽奖预览、抽奖触发这些东西

不过首发版本我更建议先把它们当成基础示例使用

后续会根据实际服主反馈继续优化：

● 商品分页
● 商品详情
● 库存和限购
● 抽奖权重
● 每日免费次数
● 保底
● 抽奖记录

如果是正式商业服，建议先在测试服跑一遍流程，再放给玩家使用

---

游戏内编辑器

空间界面最难调的是位置

比如文字高一点还是低一点
按钮靠左一点还是靠右一点
图标要不要放大
NPC 要不要转一点角度

这些如果全靠改配置会比较麻烦

CyuSpatial 提供了游戏内编辑器
可以在游戏里选择组件，然后微调位置、缩放和旋转

常用命令：

/cyuspatial edit　进入编辑模式
/cyuspatial edit list　查看组件
/cyuspatial select 组件ID　选择组件
/cyuspatial nudge x 0.05　微调位置
/cyuspatial scale all 0.05　微调缩放
/cyuspatial rotate yaw 5　微调旋转
/cyuspatial undo　撤销
/cyuspatial save　保存
/cyuspatial cancel　取消编辑

编辑器权限不建议给普通玩家
比较适合服主、建筑师或者可信管理使用

---

数据存储

如果只是做公告、菜单、按钮和传送入口，不一定需要数据库

如果要保存玩家变量、任务状态、商店库存、商店日志、抽奖历史，可以启用 SQLite 或 MySQL

SQLite
适合单服和轻量使用

MySQL
适合长期运行或需要统一数据的服务器

Redis
多服需要同步刷新空间面板时可以使用

普通服务器不需要一上来就把所有数据功能都打开

---

适合的场景

● 出生点公告
● 主城导航
● 传送入口
● 活动介绍
● 服务器功能菜单
● NPC 引导
● 简单商店展示
● 抽奖箱展示
● 剧情入口
● 空间展台

如果只是想要一个传统箱子 GUI，那它可能不是最合适的选择

如果你想让服务器里的公告、菜单、NPC 和活动入口更像一个真实场景
那 CyuSpatial 会比较适合

---

命令

/cyuspatial help　查看帮助
/cyuspatial list　查看模板和公共全息
/cyuspatial reload　重载配置
/cyuspatial open 模板ID　打开个人 HUD
/cyuspatial spawn 模板ID　在当前位置生成临时公共全息
/cyuspatial preview 模板ID　预览模板
/cyuspatial bind 模板ID 位置ID　绑定公共全息
/cyuspatial unbind 位置ID　删除公共全息
/cyuspatial movehere 位置ID　移动公共全息到当前位置

---

权限

cyuspatial.admin
管理员权限，允许使用管理命令、重载、生成、绑定、编辑等功能

cyuspatial.open.模板ID
允许玩家打开指定模板

例如：

cyuspatial.open.example/menu

cyuspatial.editor.use
允许进入编辑模式

cyuspatial.editor.save
允许把编辑结果保存到 layout 文件

编辑保存权限不建议给普通玩家

---

当前版本说明

这是 CyuSpatial 的第一个公开版本

目前更推荐用于：

● 公告
● 空间菜单
● 传送入口
● NPC 展示
● 简单按钮动作
● 活动面板

商店、抽奖、NPC 对话、任务、路线状态这些属于后续会继续增强的方向

如果你在实际使用中遇到问题，或者觉得某个配置不好用，可以反馈给我
我会根据反馈慢慢修复和调整

---

插件信息

作者：HansOffice
插件名：CyuSpatial
支持核心：Paper / Purpur / Folia
主要技术：Display / 空间 HUD / 动作 DSL
依赖：packetevents
数据存储：SQLite / MySQL
交流群：331910315

---

获取方式

CyuSpatial 当前为首发版本

想体验或反馈问题，可以加入交流群
后续版本会根据实际使用情况继续修复和完善
文档：nexu.cyucloud.cn/#/docs/30-cyuspatial

交流群：331910315