格莱梅拉情节

GlymeraPlots - 保护你的领地，掌控天气与时间！

一款完整的地皮保护系统，支持每块地皮独立的天气与时间控制、世界白名单以及 DebugShape 边界可视化。圈地、保护方块、信任好友，并在你的领地上设置自定义天气和固定的白天时间。

当前版本仅适用于 Hytale 稳定版 5！不要错过我的其他精彩项目——查看 GlymeraCraft 的个人主页 Discord: https://discord.gg/s5NRFWfxgy

---

GlymeraPlots 是什么？

GlymeraPlots 允许玩家圈占方形地皮并保护其免受其他玩家破坏。除了地皮主人（以及受信任的玩家）外，任何人都无法在受保护的地皮上破坏、放置方块或与之互动。地皮上的 PvP 和 PvE 伤害也会被阻止。

地皮主人可以为其地皮设置自定义天气——下雨、下雪、雷暴、萤火虫等等。每个进入地皮的玩家都会看到自定义天气。一旦离开地皮——无论是步行、传送，还是直接踏入拥有不同天气的相邻地块——所有其他玩家看到的真实世界天气都会立刻恢复。

主人还可以冻结地皮上的时间——使其永久保持在正午、午夜、黄昏或多种预设时间之一。地皮内所有人的天空都会保持在该时间，而他们一旦离开，天空便会立刻跳回正常的游戏世界时间。

/gp show 命令会在地皮周围切换一个紫色 DebugShape 边界——四条边缘的清晰线条，并在角落有垂直柱体。该显示效果会跟随你的 Y 坐标位置，并且从任何距离都可见，没有闪烁，也没有粒子限制。

服务器管理员可以通过白名单限制在某些世界内圈地。

---

指令

地皮管理

指令	适用对象	描述
/gp claim	所有人	在你当前位置中心圈占一块地皮
/gp remove	主人	移除你当前站立的地皮
/gp trust <玩家名>	主人	允许某位玩家在你的地皮上建造（玩家必须在线）
/gp untrust <玩家名>	主人	撤销某位玩家在你地皮上的信任权限
/gp list	所有人	显示你拥有的所有地皮，包括坐标、天气和受信任玩家
/gp info	所有人	显示你当前站立地皮的详细信息
/gp show	所有人	切换地皮边界显示（紫色 DebugShape 线条）
/gp testprotect	所有人	切换测试模式——在你自己的地皮上阻止你自己，用于测试

天气控制

指令	适用对象	描述
/gp weather <类型>	主人	设置地皮上的自定义天气
/gp weather clear	主人	移除天气覆盖，恢复自然天气
/gp weather list	所有人	显示所有可用的天气类型及其别名

时间控制

指令	适用对象	描述
/gp time <时间>	主人	将你的地皮冻结在固定的白天时间
/gp time clear	主人	移除时间覆盖，恢复正常的游戏世界时间
/gp time list	所有人	显示所有可用的白天时间预设

传送

指令	适用对象	描述
/gpt <编号>	主人	通过编号传送至你的地皮（可跨世界传送）

---

天气类型

便于使用的简短别名：

别名	Hytale 天气	描述
sunny	Zone1_Sunny	晴朗天空，明亮
cloudy	Zone1_Cloudy_Medium	多云
foggy	Zone1_Foggy_Light	轻雾
rain	Zone1_Rain	下雨
rain_light	Zone1_Rain_Light	小雨
storm	Zone1_Storm	暴风雨
snow	Zone3_Snow	下雪
snow_heavy	Zone3_Snow_Heavy	大雪
snow_storm	Zone3_Snow_Storm	暴风雪
sandstorm	Zone2_Sand_Storm	沙漠沙尘暴
thunder	Zone2_Thunder_Storm	雷暴
blood_moon	Blood_Moon	血月事件
fireflies	Zone1_Sunny_Fireflies	晴朗有萤火虫
azurewood	Zone1_Azurewood_Fireflies	青木萤火虫
northern_lights	Zone3_Northern_Lights	北极光
swamp	Zone1_Swamp	沼泽氛围
void	Void	虚空（非常暗）
desert	Zone2_Sunny	沙漠阳光
desert_haze	Zone2_Desert_Haze	沙漠炎热雾气
spooky	Zone4_Spooky	恐怖氛围
lava	Zone4_Lava_Fields	火山/熔岩辉光

你也可以直接使用完整的 Hytale 天气名称（例如 Zone1_Swamp_Rain，Zone4_GhostForest）。总共有 87 种天气类型。

注意： 某些天气类型专为特定生物群系设计，在其他环境中可能会显得不自然。请尽情尝试！

---

白天时间

使用 /gp time <时间> 冻结地皮上空的时间：

时间	天空状态
dawn	日出
morning	上午中段
midday	最亮时刻（正午）
afternoon	下午初段
dusk	日落
evening	傍晚
night	夜晚
midnight	最暗时刻

时间是被冻结的——太阳不会移动——并且适用于地皮上的所有玩家。/gp time clear 会恢复正常流逝的白天时间。与天气类似，一旦玩家离开地皮，时间会立刻恢复原样。

---

地皮保护

地皮上被保护的交互（针对未授权玩家）：

• 破坏方块 - 被阻止并显示消息
• 放置方块 - 被阻止并显示消息
• 开采/损伤方块 - 被静默取消
• 与方块交互（箱子、门等）- 被阻止并显示消息
• PvP - 玩家无法在地皮上互相攻击
• PvE - 未授权玩家无法在地皮上攻击生物
• EvP - 生物/环境无法对地皮上的玩家造成伤害

授权者如下：

• 地皮主人（始终有效，除非开启了测试保护模式）
• 通过 /gp trust 添加的受信任玩家

---

边界显示

/gp show 命令可切换地皮周围的视觉边界：

• 技术实现： 使用 Hytale 的 DebugShape.Cube（与 GlymeraChunkGrid 相同）而非粒子效果
• 外观： 紫色线条（RGB 0.78, 0.36, 1.0），60% 透明度 - 地皮边界的 4 条水平边缘加上角落的 4 个垂直柱体
• 切换： 会一直保持开启，直到你再次输入 /gp show（无计时器）
• 跟随你： 边界的 Y 坐标位置与你当前高度匹配，因此始终与视线齐平
• 无距离限制： DebugShapes 没有剔除距离 - 完整的 101 格边界可从地皮内任何位置看到
• 无闪烁： 500ms 刷新间隔配合 2s 显示时间，形状平滑重叠
• 极低的网络流量： 每次刷新仅生成 8 个形状（4 条边 + 4 个柱体）

注意： 如果 /grid（GlymeraChunkGrid）同时激活，区块网格的 ClearDebugShapes 可能每隔 500ms 刷新周期短暂隐藏地皮边界。两种显示均会自动恢复。

---

配置

配置文件路径：mods/de.glymera_GlymeraPlots/config.json

{
  "_guide_plotRadius": "每块地皮的边长 = (2 * plotRadius + 1)。默认值 50 = 101x101 格。",
  "plotRadius": 50,
  "_guide_maxPlots": "一个玩家可以拥有的最大地皮数量。",
  "maxPlots": 3,
  "_guide_allowedWorlds": "世界白名单：仅允许在这些世界中圈地。空列表 = 允许所有世界。",
  "allowedWorlds": []
}

设置项	默认值	描述
plotRadius	50	地皮半径。总大小 = (2 * 半径 + 1)。默认为 101x101 格
maxPlots	3	每个玩家拥有的最大地皮数量
allowedWorlds	[]	世界白名单。空列表 = 允许所有世界。添加世界名称以限制圈地

更改配置需要重启服务器才能生效。