EliteEssentials | TPA, 家园, 出生点, 随机传送, 传送点, 礼包, 聊天, 群组, 飞行, 无敌, 私信, 每日消息, 加入, LuckPerms, 多语言 & 更多

EliteEssentials | TPA, 家园, 出生点, 随机传送, 传送点, 礼包, 聊天, 群组, 飞行, 无敌, 私信, 每日消息, 加入, LuckPerms, 多语言 & 更多

你的Hytale服务器所需的一切，尽在一个基础插件中。家园、传送点、传送请求、随机传送、出生点、死亡回溯、跳过夜晚、完全可定制、多语言支持，并与LuckPerms兼容。

实用

EliteEssentials | TPA, 家园, 出生点, 随机传送, 传送点, 礼包, 聊天, 群组, 飞行, 无敌, 私信, 每日消息, 加入, LuckPerms, 多语言 & 更多预览查看大图

EliteEssentials

适用于 Hytale 的完整服务器工具包。 包含传送点、地标、工具包、传送、经济、聊天格式、管理、管理员图形界面以及整套生活便利系统。一个模组，完全模块化。可根据你的需求进行任意配置。

受到大型 Hytale 社区的信任

  • 为目前活跃玩家数量排名第一的 Hytale 服务器提供支持。
  • 在具有数百名并发玩家的网络上运行，零性能问题报告。
  • 经过生产环境实战考验，持续根据真实场景修复漏洞（隐身实体问题、ECS 架构竞争、启动轮询器韧性、工具包领取漏洞等，均记录于公开更新日志）。

如果你正在搭建一个严肃的 Hytale 服务器，EliteEssentials 正是其他人已经在使用的工具包。

开源且公开构建

EliteEssentials 在 GitHub 上完全开源，采用 MIT 许可证。每一行代码都公开可见，更新日志中的每一个修复都有对应的提交记录可供阅读，问题跟踪器也是公开的。

  • 没有秘密。 模组的所有行为都是可见的。没有隐藏行为，没有混淆逻辑，没有“请相信我们”的黑箱。如果一个命令在你的服务器上执行了某些操作，你可以确切地看到它是如何执行的。
  • 自行审计。 在生产环境信任它之前，请阅读源代码。查看玩家数据如何存储，版主操作如何持久化，传送如何与 ECS 交互，一切尽在公开视野。
  • 分支、修改、发布。 采用 MIT 许可证，因此你可以复刻该项目，为你的服务器构建自定义版本，并按你的意愿运行它。无任何限制。
  • 欢迎 Pull Request。 更新日志中一些最好的修复来自社区贡献者。如果你想要一个功能，你可以请求、原型化或提交 PR。帮助将模组塑造成你真正想要的样子。
  • 错误报告转化为真正的修复。 由于代码是公开的，错误报告会附带堆栈跟踪、复现步骤，有时还有补丁。这就是模组每次发布都能变得更强的原因。

如果你对该模组有想法，或想讨论贡献事宜，Discord 是最快的途径。

Wiki | 报告问题 | Discord | GitHub 源码

一览全部功能

系统 你获得的功能
家 /home、/sethome、/delhome、/homes 图形界面、按权限组限制数量
地标 带图形界面的服务器地标、各地标权限、描述
玩家地标 完整 /pwarp 系统，公开/私人，按权限组限制数量，图形界面
出生点 每个世界独立出生点，多出生点，首次加入出生点，登录传送
随机传送 /rtp，带安全落点检测，每个世界独立范围
传送请求 /tpa、/tpahere、/tpaccept、/tpdeny，图形界面选择器
返回 /back，带多步历史记录和死亡返回功能
顶部 /top，传送到当前坐标最高方块处
工具包 图形界面，一次性工具包，按权限组冷却，新手工具包，领取时执行命令
经济 钱包，/pay，/baltop，命令花费，完整模组接口 API
邮件 发送给在线或离线玩家，登录提醒，反垃圾
聊天格式 按权限组格式，十六进制颜色，前缀/后缀，渐变
群组聊天 频道，基于距离的邻近聊天，监视模式，格式继承
MOTD / 规则 / Discord 可编辑的 JSON 文件，颜色代码，可点击 URL
加入 / 退出 / 欢迎 首次加入检测，广播欢迎规则，屏蔽原版消息
自动广播 在 autobroadcast.json 中安排轮播公告
死亡信息 能识别击杀者和死亡原因，完全可配置
昵称 在聊天、Tab、邮件、私信、玩家列表中持久化的昵称
离开模式 自动 AFK，Tab 标记，睡眠排斥，奖励排斥
玩家信息 /seen、/playerinfo、/joindate、/playtime
玩家管理 /god、/heal、/fly、/flyspeed、/clearinv、/repair、/trash、/vanish、/invsee
管理 /mute、/warn + 自动惩罚、/ban、/tempban、/ipban、/freeze
管理员监视 私聊监视、群聊监视、命令监视，全部通过 /spy
睡眠百分比 /sleeppercent，AFK 排斥，可配置唤醒时间
出生点保护 半径 + Y 范围，PVP 开关，每个世界独立，管理员绕过
在线时长奖励 可重复 + 里程碑奖励，支持 LuckPerms 和经济操作
自定义命令别名 /alias 用于跨模组快捷方式、命令链，双重门禁安全
管理图形界面 /eeadmin 仪表盘，用于管理、统计、玩家数据、传送
帮助系统 /eehelp 仅显示玩家可用的命令，支持自定义条目
本地化 500+ 条消息，所有内容在 messages.json 中，支持占位符
数据迁移 /eemigration 从 EssentialsCore、EssentialsPlus、Hyssentials、HomesPlus 迁移
存储 JSON、SQLite（内嵌）或 MySQL/MariaDB（用于网络）
权限 简单的 OP 模式或带细粒度节点的完整 LuckPerms / HyperPerms
集成 LuckPerms、HyperPerms、VaultUnlocked、PlaceholderAPI

这就是一个模组。禁用你不需要的任何功能。每个命令都在配置中由 enabled 开关控制，关闭时仅限 OP 使用。

为什么选择 EliteEssentials

模块化设计

每个系统都可以在 config.json 中独立开关。只需要家、地标和经济？关闭其余部分。禁用的命令会自动变为仅 OP 可用，任何人都无法误触。配置会在版本间自动迁移，因此更新永远不会破坏你的设置。

每条消息都可由你重写

超过 500 条玩家可见的字符串都存放在 messages.json 中。你可以将整个模组翻译成任何语言，为你的服务器重新命名，或重写语气以符合你的社区风格。全程支持像 {player}、{seconds}、{name}、{location}、{group}、{prefix} 和 {suffix} 这样的占位符。

真正的集成，不仅仅是声称

  • LuckPerms 用于高级权限组、前缀、后缀和按权限组的元数据。
  • HyperPerms 作为同等级别的替代品，拥有相同的组同步工具。
  • VaultUnlocked 使其他经济模组可以无缝接入。
  • PlaceholderAPI 使其他模组能读取 EliteEssentials 数据，EliteEssentials 聊天也能读取它们的。
  • 公开的经济 API 位于 com.eliteessentials.api.EconomyAPI，任何模组都可以直接调用。

随你扩展的存储

在单个服务器社区上使用 JSON。无需设置即可迁移到内嵌 SQLite 以获得性能和完整性。在共享的 MySQL 或 MariaDB 上运行服务器网络，让玩家数据跟随玩家跨节点移动。使用 /eemigration sql 即可在它们之间迁移，无需手动编辑文件。

你可衡量的性能

EliteEssentials 正确地围绕 Hytale ECS 构建。异步文件写入、用于读取的内存缓存、HikariCP 连接池的 SQL，以及世界线程和命令线程工作的仔细分离。更新日志充满了来自真实生产问题的修复（启动轮询器崩溃安全、ECS 架构竞争保护、隐身幽灵清理），因此下一个在数百名玩家身上运行它的人不会遇到这些问题。

积极开发中

看看更新日志。我们定期发布更新，包括针对新 Hytale 服务器版本的当周兼容补丁。Hytale Update 5（服务器 0.5.1）发布的同一周，EliteEssentials 就已经提供了可用的构建版本。

真正的管理图形界面

/eeadmin 打开一个完整的图形仪表盘，包含玩家、封禁、禁言、警告、统计、活动日志、经济、传送和玩家数据等标签页。每个活跃的封禁、禁言和警告都配有快速删除按钮。每个家和个人地标都配有传送和删除按钮。所有管理操作都可以通过部分名称匹配在离线玩家身上执行。

EliteEssentials 的与众不同之处

Hytale 领域中有几个基础插件类模组，它们大多涵盖了显而易见的功能。以下是 EliteEssentials 真正更进一步的地方。

  • 采用 MIT 许可证开源，没有秘密。 整个模组托管在 GitHub 上，采用 MIT 许可证。所有代码都是公开的，任何人都可以复刻，欢迎 Pull Request。如果你想帮助塑造这个模组，你可以。
  • 玩家地标（/pwarp）。 一个完整的公开/私人玩家地标系统，带有分页图形界面、按权限组限制、冷却、启动和创建费用。非常适合生存、角色扮演和经济服务器。
  • 欢迎规则引擎。 由权限组、权限、世界或首次加入状态驱动的有条件加入、世界进入和重生消息。可选的 VIP 加入公告广播模式。隐身感知。
  • 由 LuckPerms 驱动的在线时长奖励。 可重复奖励（每小时奖励）和里程碑奖励（100 小时 = VIP），可以直接执行 LuckPerms 命令：设置组、设置权限、在轨道上升级/降级。将其与我们经济系统结合，你即刻拥有一个完整的成长系统。
  • 带有双重门禁安全的命令别名。 创建跨模组快捷方式和命令链，其权限模型默认阻止权限提升，并验证目标命令的实际权限，而不仅仅是别名的权限。
  • 带有邻近范围的群聊。 频道可以按组锁定、权限锁定，或限制在可配置半径内以实现邻近/角色扮演聊天。
  • 对 HyperPerms 的一流支持。 与 LuckPerms 完全同等的待遇，内置双向组同步命令。
  • 三种存储后端，一个配置开关。 JSON、内嵌 SQLite 或外部 MySQL/MariaDB。MySQL 路径专为玩家数据在服务器间跟随玩家移动的网络构建，配备 HikariCP 连接池和异步写入。
  • 从任何地方一键迁移。 /eemigration essentialsplus、essentialscore、hyssentials 或 homesplus 可一步将地标、工具包、出生点、家、余额、游戏时间、IP 历史、被忽略的玩家和工具包冷却数据导入 EliteEssentials。
  • 生产环境强化的性能。 更新日志就是最好的销售宣传。启动轮询器崩溃安全、ECS 架构竞争保护、隐身幽灵清理、工具包领取漏洞修复，全部来自运行着数百名并发玩家的真实服务器上的真实事件。
  • 当周 Hytale 兼容性。 Update 5（服务器 0.5.1）发布，EliteEssentials 在同一周便发布了可用的构建版本。

如果你已经在运行另一个基础插件模组并想尝试我们，迁移只需一个命令。无需手动复制任何内容。

从其他基础插件模组切换

运行一个命令。我们为你迁移数据。

/eemigration essentialscore
/eemigration essentialsplus
/eemigration hyssentials
/eemigration homesplus

在末尾加上 force 可在重新迁移时覆盖现有数据。

从 JSON 切换到 SQL

在 config.json 中将 storage.storageType 设置为 "sqlite" 或 "mysql"，重启，然后运行：

/eemigration sql

添加 force 可在重新运行时覆盖已有的 SQL 数据，或之后使用 /eemigration cleanup 将旧的 JSON 文件移动到 backup/ 文件夹。首次启动时会自动创建模式和索引。

权限

两种模式，通过 config.json 中的 advancedPermissions 选择。

简单模式（默认）。 命令要么是“所有人”，要么是“仅管理员”。管理员需要 OP。启动服务器无需任何设置。

高级模式。 遵循 eliteessentials.command.<类别>.<操作> 模式的细粒度权限节点。按权限组设置冷却、启动、花费、家的数量限制、工具包冷却和绕过节点。接入 LuckPerms 或 HyperPerms 即可开始使用。

完整参考见 Wiki。

详细功能

传送

命令 功能
/home [名称] 传送到保存的家
/sethome [名称] 保存一个命名的家位置
/delhome <名称> 删除一个家
/homes 图形界面，用于查看、传送和管理家
/spawn [名称] 传送到出生点（最近或按名称，当每个世界独立时）
/setspawn [名称] 设置出生点（按名称，当每个世界独立时）（管理员）
/delspawn <名称> 删除命名的出生点（管理员）
/spawns 列出当前世界中的出生点（管理员）
/setfirstjoinspawn 设置新玩家出生点（管理员）
/delfirstjoinspawn 移除首次加入出生点（管理员）
/back 返回你之前的位置（死亡可用）
/rtp 带有安全落点检测的随机传送
/rtp <玩家> [世界] 管理员或控制台 RTP
/top 传送到最高方块处（管理员）
/tpa [玩家] / /tpahere [玩家] 请求传送（未指定目标时显示图形界面）
/tpaccept / /tpdeny 响应请求
/tphere <玩家> 将玩家拉到你身边（管理员）
  • 可配置最大家的数量，全局或按权限组，通过 home.limit.<n> 设置。
  • 每个世界独立的 RTP 范围和出生点行为。
  • 每次传送均可设置冷却、启动和经济花费。
  • 基于权限的冷却、启动和花费覆盖，按权限组设置。
  • 传送时俯仰角被归一化，玩家永远不会倾斜着陆。

玩家地标（默认关闭）

命令 功能
/pwarp gui 玩家地标图形界面，带分页和筛选
/pwarp <名称> 传送到一个玩家地标
`/pwarp create <public private> <名称> [描述]`
/pwarp delete <名称> 删除你的地标（管理员可以删除任何地标）
/pwarp toggle <名称> 在公开和私人之间切换
/pwarp list 你的地标列表（含数量和限制）
/pwarp info <名称> 查看地标详情
/pwarp setdesc <名称> <描述> 更新描述
/pwarp setloc <名称> 将地标移动到当前位置

按权限组的限制、冷却、启动、创建费用，以及完整的 JSON、SQLite 或 MySQL 存储。

工具包

  • 用于选择的图形界面，直接使用 /kit <名称> 进行领取。
  • 一次性工具包和冷却工具包。
  • 通过 kit.cooldown.<工具包名称>.<秒数> 按权限组覆盖冷却时间。
  • 背包空间检查，确保工具包永远不会无声地将物品丢在地上。
  • 首次加入时自动给予新手工具包。
  • 工具包在领取时可以执行任何服务器命令（授予权限组、给予货币、启动其他模组功能）。

经济（默认关闭）

命令 功能
/wallet [玩家] 查看自己或另一玩家的余额
/wallet set/add/remove <玩家> <金额> 管理员更改余额
/pay <玩家> <金额> 向另一玩家发送金钱
/baltop 最富玩家排行榜
/eco 控制台/管理员经济管理
  • 可配置的货币名称、符号和初始余额。
  • 货币符号位置（金额 之前 或 之后）。
  • 带基于权限的绕过和覆盖的命令花费。
  • 余额变动通知（聊天、广播或 HUD 提示）。
  • 自定义服务器发送者名称（例如“银行”或“系统”）。
  • 其他模组可用的公开 API：com.eliteessentials.api.EconomyAPI。
  • 用于跨模组经济兼容性的 VaultUnlocked 集成。

聊天与通信

命令 功能
/msg <玩家> <消息> 私信（别名：/whisper、/pm、/tell）
/reply <消息> 回复上一条对话
/gc [聊天] <消息> 群组/频道聊天（别名：/groupchat、/g）
/gcset [聊天] 设置你的默认群聊频道
/chats 列出你可用的聊天频道
`/spy gchat dm
/broadcast <消息> 向所有玩家广播（管理员）
/clearchat 为所有人清屏（管理员）
/sendmessage 向玩家或群组发送格式化消息（管理员）
  • 基于群组的聊天格式，支持十六进制颜色、渐变和完整的 LuckPerms 前缀/后缀支持。
  • Tab 列表前缀支持。
  • 带有可选邻近范围的群聊频道，适用于角色扮演服务器。
  • 用于跨插件占位符双向支持的 PlaceholderAPI。
  • 玩家聊天颜色由可配置的权限节点控制。
  • 隐身感知，隐身玩家仍可被其他管理员听到，而不会泄露给普通玩家。

服务器信息

命令 功能
/motd 每日消息，支持颜色代码、十六进制颜色、可点击 URL 和占位符
/rules 服务器规则
/discord 带可点击邀请链接的 Discord 信息
/list 在线玩家（别名：/online、/who）
/eehelp 仅列出玩家有权限使用的命令

custom_help.json 允许你为来自其他模组的命令添加帮助条目，使 /eehelp 成为你服务器的单一入口页面。

玩家管理

命令 功能
/god 切换无敌模式（管理员）
/heal [玩家] 恢复满血（自身在启用时可用，他人则需要管理员）
/fly 切换飞行模式（管理员），可选每分钟消耗
`/flyspeed <1-100 reset>`
/clearinv [玩家] 清空背包（管理员）
/trash [大小] 垃圾箱窗口（1 到 45 格）
/repair [all] 修复手中的物品或整个背包（管理员）
/vanish 切换隐形模式，带假的加入和退出消息（管理员）
/invsee <玩家> 查看或修改其他玩家的背包（管理员）
/seen <玩家> 上次在线信息
/playerinfo [玩家] 详细的玩家统计信息
/joindate [玩家] 首次加入日期
/playtime [玩家] 总在线时长
/afk 切换离开模式（无活动自动 AFK，Tab 标记）

控制台可以对 /repair、/heal、/god、/fly、/flyspeed 和 /clearinv 命令的目标玩家进行操作。可以为每个命令设置黑名单世界，支持通配符。

管理

命令 功能
/mute <玩家> [原因] 禁言一名玩家（全服）
/unmute <玩家> 解除禁言
/warn <玩家> [原因] 添加一个警告
/warnings [玩家] 列出警告
/clearwarnings <玩家> 清除警告
/ban <玩家> [原因] 永久封禁
/tempban <玩家> <时间> [原因] 临时封禁（1d、2h、30m、1d12h）
/ipban <玩家> [原因] IP 封禁（适用于 TCP 和 QUIC）
/unban / /unipban 解除封禁
/freeze <玩家> 将玩家固定在原地
/ignore / /unignore 个人屏蔽列表（聊天和私信）
  • 在可配置的警告阈值处自动惩罚（封禁或临时封禁）。
  • 所有管理操作都可以通过部分名称匹配在离线玩家身上执行。
  • /eeadmin 的封禁、禁言和警告标签页中设有快速删除按钮。

邮件

/mail send、/mail read、/mail list、/mail clear [read]、/mail delete <编号>。有未读邮件时登录提醒，按接收者有冷却时间以防止垃圾邮件，可配置邮箱大小，支持在线和离线收件人。

在线时长奖励

  • 每 X 分钟可重复的奖励（每小时奖励等）。
  • 在固定阈值处的里程碑奖励（游戏达到 100 小时获得 VIP）。
  • 直接执行 LuckPerms 命令：lp user {player} group set vip、设置/取消权限、在轨道上升级/降级。
  • 授予经济货币或发送自定义消息。
  • onlyCountNewPlaytime 使现有玩家不会追溯获得奖励。

命令别名

/alias create <名称> <命令> [权限]。可与其他任何模组的命令配合使用。通过 ; 链接（例如 warp spawn; heal; fly）。每个别名自动生成权限节点。静默模式用于清理传送消息。双重门禁安全，玩家无法通过别名管理命令来提升权限，当第二道门阻止时，会记录调试日志。

昵称

/nick、/realname。昵称会显示在聊天、群聊、Tab 列表、邮件、私信和加入/退出消息中。颜色代码由各自的权限控制。在重启后持久保存。

睡眠、出生点保护、欢迎语、自动广播

  • /sleeppercent 具有可配置的 nightStartHour 和 morningHour。AFK 玩家不计入统计。
  • 出生点保护，带有半径、Y 范围、PVP 开关、每个世界独立配置和管理员绕过节点。
  • 基于规则的加入、世界进入或重生时的欢迎语，可选 VIP 加入公告的广播模式。隐身感知。
  • autobroadcast.json 中的自动广播调度器，用于轮播公告。

管理界面（/eeadmin）

标签页：仪表盘、玩家、封禁、禁言、警告、统计、活动日志、经济、传送、玩家数据。支持点击传送、删除、封禁、禁言、警告、冻结、更改余额和离线查找。每个操作都有细粒度权限。

组同步

保持 LuckPerms / HyperPerms 组与 EliteEssentials 配置同步。

  • /ee groupsync lp-to-ee
  • /ee groupsync hp-to-ee
  • /ee groupsync ee-to-lp
  • /ee groupsync ee-to-hp

配置与存储

所有数据位于 mods/EliteEssentials/ 目录下。

  • 配置和内容：config.json、messages.json、motd.json、rules.json、discord.json、aliases.json、custom_help.json、groupchat.json、greetings.json、autobroadcast.json、playtime_rewards.json。
  • 服务器数据：warps.json、player_warps.json、kits.json、spawn.json、firstjoinspawn.json、mutes.json、warns.json、bans.json、tempbans.json、ipbans.json、freezes.json。
  • 玩家数据：players/<uuid>.json，包含家、返回历史、工具包领取、邮件、钱包、在线时长、昵称、忽略列表、默认群聊和 IP 历史。

在 config.json 中选择你的存储后端：

  • JSON 用于零设置的单服务器。
  • SQLite 用于无需外部软件的内嵌式 SQL。
  • MySQL 或 MariaDB 用于玩家数据在服务器间跟随玩家移动的网络。

使用 /eemigration sql 在它们之间迁移。之后使用 /eemigration cleanup 将旧的 JSON 文件归档到 backup/ 文件夹中。

配置更新提醒

更新 EliteEssentials 会保留你现有的配置，仅使用默认值添加新选项。你不需要在版本之间删除任何东西。如果你遇到问题，删除 config.json 会重新生成一个干净的配置，你可以将自定义值复制回去。

有建议或遇到错误？

这个模组的目标是成为你真正想运行的工具包。如果某些功能缺失或可以改进，我们很想听听。加入我们的 Discord 让我们聊一聊，或者在 GitHub 上开启一个 issue。

路线图

  • 随着 Hytale 模组生态系统的发展，持续与其余部分集成。

EliteEssentials。 模块化。本地化。集成化。积极开发。已在最大的 Hytale 服务器上运行。