OrbisGuard 混入

OrbisGuard-Mixins

OrbisGuard 的配套 Mixin 模块 - 关闭所有已知的保护绕过漏洞。

OrbisGuard-Mixins 直接挂钩 Hytale 插件 API 未暴露的服务端内部逻辑，提供完整的区域保护覆盖。没有该模块，玩家可通过游戏机制（如自动拾取、锤子循环、F 键收获）绕过特定保护。

---

需求

OrbisGuard - 主区域保护插件（0.9.0 及以上版本，请使用匹配的发行版）

Hyinit - Hytale 的 Mixin 启动器/引导器

---

安装

1. 下载 OrbisGuard-Mixins-x.x.x.jar
2. 将其放入服务器的 earlyplugins/ 文件夹中（不是 mods/ 文件夹）
3. 通过 Hyinit 启动你的服务器，而不是直接启动 HytaleServer.jar。Hyinit 会引导服务器并应用 earlyplugins/ 中的所有内容。例如： java -jar Hyinit-x.x.x.jar --assets="<Hytale安装目录>/Assets.zip"
4. 启动服务器。

OrbisGuard 会自动检测到 mixin 模块，并在启动横幅中显示 [+] Mixins loaded。

---

保护内容

保护项目	无 Mixins	有 Mixins
自动物品拾取（走过）	可绕过	已阻止
F 键作物/方块收获	可绕过	已阻止
锤子方块循环	可绕过	已阻止
爆炸方块损坏	可绕过	已阻止
火焰/火焰喷射器蔓延	可绕过	已阻止
命令阻止	有限	全覆盖
生物生成控制	有限	全覆盖
生物/NPC 死亡掉落	可绕过	已控制
传送门与传送器使用	可绕过	已阻止
制作与工作台访问	有限	全覆盖
建造工具	可绕过	已阻止
死亡保留物品	不可能	生效
防止耐久度损失	不可能	生效
自定义重生点	不可能	生效

---

Mixin 列表

Mixin	用途
PlayerItemEntityPickupSystemMixin	阻止走过式自动物品拾取
CycleBlockGroupInteractionMixin	防止锤子方块循环
HarvestCropInteractionMixin	阻止镰刀收获作物
BlockHarvestUtilsMixin	阻止 F 键收获
CommandManagerMixin	完全命令阻止（blocked-cmds / allowed-cmds）
ExplosionBlockDamageMixin	保护方块免受爆炸破坏
FireFluidTickerMixin	阻止火焰/火焰喷射器蔓延
SpawnMarkerEntityMixin	控制基于标记物的生物生成
WorldSpawnJobSystemsMixin	控制自然生物生成
NPCPluginSpawnMixin	控制 NPC/插件生成
NPCDeathItemDropMixin	控制 NPC 死亡掉落（mob-loot 标志）
DeathItemDropMixin	启用 keep-inventory 标志
ItemDurabilityMixin	启用物品耐久度保护
RespawnLocationMixin	自定义重生点（respawn-location 标志）
CraftingManagerMixin	制作保护
BenchWindowMixin	工作台容器访问过滤
BuilderToolsPacketHandlerMixin	建造工具保护
FloodFillPositionSelectorMixin	选取魔杖的洪水填充保护
InteractionEntryMixin	核心交互保护
InteractionChainMixin	链式交互保护
StoreAddEntityMixin	实体生成追踪
EnterPortalInteractionMixin	传送门进入保护
ReturnPortalInteractionMixin	返回传送门保护
HubPortalInteractionMixin	集线器传送门保护
TeleporterInteractionMixin	传送器保护
TeleportConfigInstanceInteractionMixin	实例传送配置保护
TeleportInstanceInteractionMixin	实例传送保护
ExitInstanceInteractionMixin	实例退出保护

---

Mixins 启用的标志

以下 OrbisGuard 标志依赖 mixin 模块才能完全执行：

• item-pickup-auto - 阻止走过式自动拾取
• hammer - 阻止锤子方块循环
• blocked-cmds / allowed-cmds - 完全命令阻止
• mob-spawning - 控制所有生物生成
• mob-loot - 控制生物/NPC 死亡掉落
• crafting - 制作与工作台访问
• use-portals / use-teleporters - 控制传送门与传送器使用
• keep-inventory - 死亡保留物品
• item-durability - 防止耐久度损失
• respawn-location - 设置自定义重生点

---

支持

问题反馈： GitHub Issues

Discord： WiFlow 的 Discord

---

OrbisGuard-Mixins 为可选模块，但在生产环境中强烈推荐。没有它，有经验的玩家可以绕过特定保护。