区域管理器混合

RegionManager Mixin 扩展 for Hytale

概述

本 Mixin 扩展 直接集成到 Hytale 的 RegionManager 插件中，提供深度游戏系统集成，实现超越标准插件能力的高级区域保护功能。这些 Mixin 修改了 Hytale 的核心系统，在最低层级执行基于区域的规则。

---

功能特性

1. 指令保护

• 在执行前拦截所有玩家指令
• 无缝集成 RegionManager 的权限系统
• 通过可自定义的拒绝消息阻止受限指令
• 保持与 Hytale 指令框架的完全兼容

2. 死亡背包保护

• 在受保护区域防止死亡物品丢失
• 直接作用于 Hytale 的死亡系统组件
• 支持位置感知保护（世界和坐标）
• 非保护区域不干扰物品掉落

3. 流体放置限制

• 在限制区域阻止流体放置（水、熔岩等）
• 放置尝试时实时位置验证
• 玩家反馈带区域适切消息
• 支持游戏中所有流体类型

---

安装指南

Hyxin 是什么？

Hyxin 是 Hytale 官方的 Mixin 实现，允许安全修改游戏代码。Mixin 可实现：

• 非破坏性代码修改，无需编辑游戏文件
• 深度系统集成，普通插件无法实现
• 兼容性，与未来游戏更新保持一致

安装步骤

1. 前提条件

• RegionManager 插件 安装在 plugins 文件夹中
• Hytale 服务器（早期访问兼容版本）

2. 安装 Hyxin

1. 从官方渠道下载最新的 Hyxin JAR
2. 创建 earlyplugins 文件夹（如果不存在）：
   • 服务器：位于 plugins 和 logs 文件夹旁
   • 单人游戏：位于你的世界文件夹内
3. 将 hyxin.jar 放入 earlyplugins 文件夹

3. 安装 Mixin 扩展

1. 下载 RegionManagerMixin.jar
2. 将其放入与 Hyxin 相同的 earlyplugins 文件夹
3. 不要将其放入常规的 plugins 文件夹

4. 验证安装

1. 启动你的 Hytale 服务器/世界
2. 检查日志中是否出现：

[Region Manager Mixin] Hello from Region Manager Mixin Plugin!
[RegionManager] Mixin extensions loaded successfully

1. 测试需要 Mixin 支持的区域功能（指令阻止、死亡保护）

---

Mixin 启用的功能

无 Mixin（标准 RegionManager）：

• 基本区域创建/管理
• 通过事件进行标准权限检查
• 有限的集成深度

有 Mixin（本扩展）：

• 在指令执行层级阻止指令（不可绕过）
• 在物品掉落计算前生效的死亡保护
• 在交互层级阻止流体放置

---

兼容性

• 需要：RegionManager v2.10+
• 兼容：所有 RegionManager 附加组件
• 服务器类型：专用服务器和单人游戏均可
• Hytale 版本：早期访问兼容版本

---

故障排除

常见问题：

1. "Mixin 未加载"

解决方案：确保 Hyxin 和本扩展都位于 'earlyplugins' 文件夹，而非 'plugins' 文件夹

1. "区域功能不生效"

解决方案：确认 RegionManager 位于 'plugins' 文件夹且正确加载

1. "游戏启动时崩溃"

解决方案：检查 Hyxin 与你使用的 Hytale 版本是否兼容

日志验证：

成功安装会显示：

[Hyxin] Loading mixin configs...
[Region Manager Mixin] Extension initialized
[RegionManager] Mixin hooks registered

---

支持

本扩展是 RegionManager 的官方组成部分，需要：

• 无需额外配置
• 无需单独权限
• 无需独立管理

所有功能均通过标准 RegionManager 界面控制。

---

注意：这是一个 系统层级扩展，并非独立插件。它需要主 RegionManager 插件才能运行，并提供深度集成，使 RegionManager 的保护功能全面可靠。

---

体验深度游戏系统集成的完整区域保护！