Hydro Hologram

全息投影

在你的世界中任意位置创建浮动文字显示！

HydroHologram 是一个功能强大且易于使用的 Hytale 服务器全息投影插件，允许你在世界中创建、编辑和管理浮动文字显示。非常适合服务器信息、欢迎消息、规则、路径点等等！

---

温馨提示：由于 Hytale 锁定了名称牌的彩色文字代码，彩色文字目前暂时无效。待该问题修复后，将更新全息投影以支持彩色文字！

---

大家好，以下是当前与 HydroHologram 冲突且我们目前无法修复的模组列表。

- 目前暂无

---

功能特性

多行全息投影

• 创建包含无限行文字的全息投影
• 每行均可独立编辑
• 创建图片全息投影（1.0.3及以上版本）
• 创建GIF全息投影（1.0.8及以上版本）
• 为图片和GIF使用自定义动画

直观的GUI编辑器

• 游戏内编辑器界面
• 点击任何一行即可直接编辑
• 一键添加、更新或删除行
• 实时预览更改
• 通过 x,y,z 按钮更改位置
• 更新全息投影方向

轻松定位

• 在你当前位置创建全息投影
• 使用“移动到此处”按钮将现有全息投影移至你的位置
• 编辑器中显示精确坐标
• 可以使用实体工具移动和缩放它们

开发路线图
- 在文件夹中添加配置选项，以便您也可以在内部更改
- 为全息投影添加光照
- 以及其他任何请求

🖼️ 图片全息投影行（仅适用于1.0.3及以上版本）

基本格式： image:<name> (以默认比例显示图片)

带比例： image:<name>:<scale> (以自定义比例显示图片) 示例：image:logo:2.0 (2x大小) 示例：image:logo:0.5 (一半大小)

带方向 image:<name>:<direction> (按指定方向显示图片) image:<name>:<scale>:<direction> (比例 + 方向) 示例：image:logo:s (朝南) 示例：image:logo:2.0:sw (2x大小，朝西南)

可用方向： n(北), ne(东北), e(东), se(东南), s(南), sw(西南), w(西), nw(西北)

广告牌模式：(始终面向每位玩家！) image:<name>:true (始终面向每位玩家) image:<name>:true:<distance> (面向指定距离(方块)内的玩家) image:<name>:true:<distance>:<dir> (广告牌模式，超出距离后回退到配置方向) image:<name>:<scale>:true:<distance>:<dir> (完整选项)

示例：image:logo:true (广告牌模式) 示例：image:logo:true:20 (20方块内广告牌模式) 示例：image:logo:1.5:true:20:s (1.5倍大小，20方块内广告牌模式，超出范围时朝南)

双面模式：(1.10.0及以上版本) 在行中任意位置添加 :ds 或 :doublesided，即可从正面和背面同时看到图片！

image:<name>:ds (双面图片) image:<name>:<scale>:ds (带比例的双面图片) image:<name>:true:ds (广告牌 + 双面)

示例：image:logo:ds (从两侧可见) 示例：image:logo:2.0:ds (2x大小，双面) 示例：image:logo:true:ds (广告牌 + 双面)

动画标签：(1.10.0及以上版本) 在行中任意位置添加 :anim_<name> 来为你的图片添加动画！

image:<name>:anim_bounce (弹跳图片) image:<name>:<scale>:anim_float (带比例的浮动图片) image:<name>:ds:anim_spin (双面旋转图片) image:<name>:true:anim_pulse (广告牌脉动图片)

示例：image:logo:anim_bounce (弹跳标志) 示例：image:logo:2.0:anim_float (2x大小浮动标志) 示例：image:logo:ds:anim_spin (双面旋转标志) 示例：image:logo:true:anim_pulse (广告牌脉动标志)

可用动画： ** 浮动：** :anim_float, :anim_float_slow, :anim_float_fast ** 旋转：** :anim_spin, :anim_spin_slow, :anim_spin_fast, :anim_tumble ** 脉动：** :anim_pulse, :anim_pulse_big, :anim_heartbeat, :anim_breathe ** 弹跳：** :anim_bounce, :anim_bounce_small ** 摇摆：** :anim_sway, :anim_sway_big ** 晃动：** :anim_wobble, :anim_wobble_slow, :anim_wobble_fast ** 震动：** :anim_shake, :anim_shake_big ** 环绕：** :anim_orbit, :anim_orbit_small, :anim_orbit_fast ** 其他：** :anim_wave, :anim_flip, :anim_flip_full

在游戏中使用 /holo animlist 查看所有可用动画！

---

📝 如何添加自定义图片

1. 将你的 PNG 文件放入：mods/com.hydrohologram_HydroHologram/images/
2. 运行：/holo reload 来生成资源压缩包以便加载图片。从1.0.5版本起无需重启服务器。
3. 使用：/holo edit (name)，确保你已先创建了一个全息投影才能编辑它。(/Holo create (name))

🎬 GIF全息投影行（1.0.8及以上版本）

基本格式： gif:<name> (以默认比例和速度显示GIF)

带比例： gif:<name>:scale_<value> (自定义比例) 示例：gif:fire:scale_2 (2x大小) 示例：gif:fire:scale_0.5 (一半大小)

带速度： gif:<name>:speed_<value> (自定义动画速度) 示例：gif:fire:speed_2 (2倍速) 示例：gif:fire:speed_0.5 (半速 / 更慢)

带方向： gif:<name>:dir_<direction> (面向方向) 示例：gif:fire:dir_s (朝南) 示例：gif:fire:dir_ne (朝东北)

可用方向： n(北), ne(东北), e(东), se(东南), s(南), sw(西南), w(西), nw(西北)

广告牌模式：(始终面向每位玩家！) gif:<name>:true (始终面向每位玩家) gif:<name>:true:blocks_<distance> (面向指定距离内的玩家)

示例：gif:fire:true (广告牌模式) 示例：gif:fire:true:blocks_20 (20方块内广告牌模式)

组合参数： 参数可以任意顺序组合！ gif:<name>:scale_1.5:speed_2:dir_sw (比例 + 速度 + 方向) gif:<name>:true:blocks_30:scale_2 (广告牌 + 距离 + 比例)

示例：gif:fire:scale_2:speed_0.5 (2x大小，半速) 示例：gif:fire:true:blocks_20:scale_1.5 (广告牌，20方块，1.5倍大小)

双面模式：(1.10.0及以上版本) 在行中任意位置添加 :ds 或 :doublesided，即可从正面和背面同时看到GIF！

gif:<name>:ds (双面GIF) gif:<name>:scale_2:ds (带比例的双面GIF) gif:<name>:true:ds (广告牌 + 双面)

示例：gif:fire:ds (从两侧可见) 示例：gif:fire:scale_2:ds (2x大小，双面) 示例：gif:fire:true:ds (广告牌 + 双面) 示例：gif:fire:scale_2:speed_0.5:ds (2x大小，半速，双面)

动画标签：(1.10.0及以上版本) 在行中任意位置添加 :anim_<name> 为你的GIF添加移动动画！

gif:<name>:anim_float (浮动GIF) gif:<name>:scale_2:anim_wobble (带比例的晃动GIF) gif:<name>:ds:anim_bounce (双面弹跳GIF) gif:<name>:true:anim_pulse (广告牌脉动GIF)

示例：gif:fire:anim_float (浮动火焰GIF) 示例：gif:fire:scale_2:anim_wobble (2x大小晃动火焰) 示例：gif:fire:ds:anim_bounce (双面弹跳火焰) 示例：gif:fire:true:anim_spin (广告牌旋转火焰)

可用动画： ** 浮动：** :anim_float, :anim_float_slow, :anim_float_fast ** 旋转：** :anim_spin, :anim_spin_slow, :anim_spin_fast, :anim_tumble ** 脉动：** :anim_pulse, :anim_pulse_big, :anim_heartbeat, :anim_breathe ** 弹跳：** :anim_bounce, :anim_bounce_small ** 摇摆：** :anim_sway, :anim_sway_big ** 晃动：** :anim_wobble, :anim_wobble_slow, :anim_wobble_fast ** 震动：** :anim_shake, :anim_shake_big ** 环绕：** :anim_orbit, :anim_orbit_small, :anim_orbit_fast ** 其他：** :anim_wave, :anim_flip, :anim_flip_full

在游戏中使用 /holo animlist 查看所有可用动画！

---

📝 如何添加自定义GIF

1. 将你的 GIF 文件放入：mods/com.hydrohologram_HydroHologram/gifs/
2. 运行：/holo reload 来提取帧并生成资源压缩包以便加载GIF。从1.0.5版本起无需重启服务器。
3. 使用：/holo edit (name)，确保你已先创建了一个全息投影才能编辑它。(/holo create (name))

命令：

命令	描述
/holo create <name>	在你的位置创建新的全息投影
/holo delete <name>	删除现有的全息投影
/holo edit <name>	打开全息投影的GUI编辑器
/holo list	列出服务器上所有全息投影
/holo moveto <name>	传送到全息投影的位置
/holo movehere <name>	将全息投影移动到你的当前位置
/holo addline <name> <text>	向全息投影添加一行文字
/holo setline <name> <line#> <text>	设置特定行的文字
/holo removeline <name> <line#>	移除特定行
/holo info <name>	查看全息投影的详细信息
/holo animlist	显示所有可用于图片和GIF的动画
/holo entityreload	重新加载所有玩家客户端的实体。这是在holo reload后修复实体缩小的唯一方法

权限：

权限	描述
hydrohologram.admin	通配符 - 授予所有权限
hydrohologram.create	创建全息投影
hydrohologram.delete	删除全息投影和移除行
hydrohologram.edit	编辑全息投影 (添加/更新行，更改方向，动画列表)
hydrohologram.list	查看全息投影
hydrohologram.move	移动/传送全息投影
hydrohologram.reload	重载插件 / 重新加载实体
hydrohologram.cleanup	清理孤儿实体

命令与权限对应表

命令	所需权限
/holo create <name>	hydrohologram.create
/holo delete <name>	hydrohologram.delete
/holo edit <name>	hydrohologram.edit
/holo list	hydrohologram.list
/holo info <name>	hydrohologram.list
/holo moveto <name>	hydrohologram.move
/holo movehere <name>	hydrohologram.move
/holo addline <name> <text>	hydrohologram.edit
/holo setline <name> <#> <text>	hydrohologram.edit
/holo removeline <name> <#>	hydrohologram.edit
/holo reload	hydrohologram.reload
/holo cleanup	hydrohologram.cleanup
/holo animlist	hydrohologram.edit
/holo entityreload	hydrohologram.reload

GUI编辑器权限

GUI操作	所需权限
添加行 (ADD按钮)	hydrohologram.edit
更新行 (点击行编辑)	hydrohologram.edit
移除行 (X按钮)	hydrohologram.delete
更改方向 (N/S/E/W按钮)	hydrohologram.edit
移动到此处按钮	hydrohologram.move
位置控制 (+/- 按钮)	hydrohologram.move
设置位置 (SET按钮)	hydrohologram.move
删除全息投影 (DELETE按钮)	hydrohologram.delete

备注

• OP管理员绕过所有权限 - 拥有 *, hytale.op, 或 hytale.operator 的玩家可访问所有内容
• Admin是通配符 - hydrohologram.admin 授予所有命令和GUI操作的访问权限
• GUI遵循权限设置 - 如果权限被拒绝，按钮将显示错误信息并正确刷新 此功能从版本 (1.0.8+) 开始可用

请访问我们的Discord以获取支持： Discord

如果您想资助此项目，请点击下方链接。感谢每一位支持者： ko-fi.com

感谢大家的下载和支持。作为Hytale模组制作的新手，我仍在不断学习中 :)

模组贡献者：

• wiflow Curseforge Mod Page for Wilflow