神秘精华

神秘核心

为 Hytale 服务器打造的模块化、API 优先的基础功能核心。

神秘核心（Mystic Essentials）在一个可配置的模组中为服务器提供了日常所需的各种系统——传送、家、传送点、私信、邮件、聊天频道、管理工具、礼包、玩家仓库、通知、在线时长统计，以及更多功能。

每个主要功能都是模块化的，因此你可以只启用服务器需要的部分。

亮点

• 传送请求、直接传送、随机传送以及跨世界传送
• 家、服务器传送点、玩家传送点、出生点管理和传送门
• 私信、回复、邮件、聊天频道、提及与社交监控
• 带历史记录、筛选器、操作、优先级和多种显示样式的通知中心
• 聊天中丰富的物品预览和安全物品链接
• 离开（AFK）检测、离开区域、问候语、公告和在线时长统计
• 礼包、飞行控制、背包检查、昵称和玩家仓库
• 补丁说明、教程、自定义命令和可配置的服务器工具
• 与 LuckPerms、PlaceholderAPI、VaultUnlocked、MysticVanish 和 MysticModeration 的集成
• JSON 或 MySQL/MariaDB 存储，可选的 Redis 同步
• 面向开发者构建集成和附加组件的公共 API

通知中心

神秘核心包含一个面向服务器和附加组件消息的统一通知系统。

通知可以包含：

• 分类和低、普通、重要或紧急优先级
• 聊天、标题、副标题、动作栏、弹出提示、横幅、声音和历史记录交付
• 交互式操作和定向受众
• 按玩家筛选和通知历史记录
• 面向附加组件的可扩展分类、受众解析器和交付筛选器

玩家可以使用以下命令打开通知中心：

/notifications
/notifs

工作人员可以使用 /broadcast 和 /alert 发送分类广播和警报。

提及与聊天频道

在聊天中使用玩家的准确名称来提及他们：

@PlayerName

玩家可以使用以下命令管理提及历史记录和偏好设置：

/mentions
/mentionsettings

提及控制包括冷却时间、屏蔽、请勿打扰、批量提及、可配置范围以及由附加组件提供的范围。

聊天频道支持详细的成员名册、角色、标签、活动信息、锁定、管理、所有权转移、继承、审计历史以及可选的语音提供商集成。

物品预览与链接

神秘核心可以安全地显示物品信息，而无需信任可变的库存数据。

物品系统支持：

• 不可变的物品快照
• 物品分类和可配置的详细信息区块
• 供附加组件提供物品信息的提供商 API
• 聊天中可悬停或可点击的物品链接
• 面向玩家和工作人员的物品检查命令

常用的命令包括：

/itemlinks
/itemview
/iteminspect

安装

1. 下载最新的神秘核心 .jar 文件。
2. 将其放入服务器的 mods 目录。
3. 启动服务器一次以生成配置文件。
4. 配置你想要使用的模块。
5. 运行 /mystic reload 或重启服务器。

神秘核心当前目标为 Hytale Server 0.5.6，并声明与服务器版本 >=0.5.0 <0.6.0 兼容。

配置文件生成于：

mods/MysticEssentials/

使用 /mystic 打开管理界面，使用 /mystic reload 重新加载受支持的配置变更。

CustomContent 和 CustomDialogs

可选的 customcontent 模块使用 .gui.html 文件提供声明式的自定义界面。

它支持：

• 自定义窗口和 HUD
• 行、列、网格、面板、按钮、输入框和下拉选择
• 物品展示、图片、进度指示器和玩家头像
• 需求、操作和自动占位符刷新
• CustomDialogs 构建器
• QuestLines 兼容性和导入支持
• 附带示例布局
• 构建时和运行时验证

CustomContent 许可要求

CustomContent 是一个获得许可的高级模块，默认处于禁用状态。要获得访问权限：

1. 加入 Hyzion Discord 并成为获批合作伙伴。
2. 在 Patreon 购买符合条件的 Hyzion 会员资格。
3. 使用 Discord 登录 Hyzion 许可门户 以关联你的账户。
4. 运行 /mystic license 查找你的服务器许可 ID。
5. 下载你的 license.mclicense 文件并将其放在：

mods/MysticEssentials/license.mclicense

1. 运行：

/mystic license reload
/mystic reload

如果许可文件缺失、无效或已过期，只有 CustomContent 模块会被禁用。神秘核心的其余部分将继续正常运行。

常用命令

命令	描述
/mystic	打开管理界面
/mystic reload	重新加载受支持的配置
/notifications	打开通知历史记录和设置
/tpa <player>	请求传送到另一名玩家
/tp world <player> <world>	在世界之间传送玩家
/rtp	在配置的范围内随机传送
/spawn	传送到出生点
/home	打开家的界面
/warp	打开服务器传送点界面
/pwarp	打开玩家传送点界面
/portal	管理传送门
/msg <player> <message>	发送私信
/mail	打开邮件界面
/channel	管理聊天频道
/mentions	查看提及历史记录
/itemlinks	配置物品链接偏好
/broadcast	发送服务器广播
/alert	发送重要的服务器警报
/afk	切换离开状态
/kit	打开礼包界面
/fly	切换飞行
/pv	打开玩家仓库
/patchnotes	查看服务器补丁说明

权限、别名、冷却时间、限制、格式和模块行为均可配置。

迁移支持

正在从其他基础模组迁移？神秘核心可以扫描并导入来自以下模组的受支持数据：

• EssentialsPlus
• Hyssentials
• EliteEssentials
• Essentials
• HyEssentialsX

迁移可以包括家、全局和按世界的出生点、服务器传送点、玩家传送点和礼包。

/mystic migrate scan <provider|auto>
/mystic migrate import <provider|auto> [--dry-run] [--replace]

导入会创建备份，并默认与现有的神秘核心数据合并。使用 --dry-run 可在进行更改之前预览导入。

在迁移生产服务器之前，请阅读迁移指南。

存储与网络支持

神秘核心默认使用 JSON 存储，也可以使用 MySQL 或 MariaDB。

可选的 Redis 支持可以为兼容系统启用跨服务器同步，例如：

• 邮件
• 私信和回复
• 工作人员聊天
• 社交监控
• 隐身状态
• 离开状态
• 传送请求

集成

神秘核心可以与以下系统集成：

• LuckPerms：用于前缀、后缀、称号和权限
• PlaceholderAPI：用于共享占位符和延迟注册支持
• VaultUnlocked：用于经济功能
• MysticVanish：用于感知隐身状态的行为
• MysticModeration：用于感知管理状态的工具
• Redis：用于跨服务器同步

当依赖项不可用时，可选集成会安全降级。

开发者 API

神秘核心不仅是一个服务器工具模组，它也被设计为一个平台。

开发者可以集成的服务和扩展点包括：

• 通知和自定义受众
• 物品检查和自定义物品区块
• 在线时长信息
• 自定义 UI 注册
• 提及范围
• 聊天频道事件和语音在线状态
• 经济提供商
• 占位符和模块发现

支持与文档

• 文档
• Discord
• 许可门户
• Patreon 会员

如需安装帮助、配置问题、合作伙伴审批、许可支持或错误报告，请加入 Discord 服务器。