uxmEssentials

插件

· 作者 siracozmen

适用于 Paper 26.2+ 的现代模块化基础插件。提供家园、传送点、传送、经济、套装、管理、保险箱及日常所需的其他功能,界面简洁,兼容 Folia,并支持完全本地化。关闭任意模块即切断其所有关联;可重命名或为命令设置别名

0 本站下载 0 关注 更新于 3 周前

最新 0.10.1 · 26.2 · Folia / Paper

一键开服(送7天)

uxmEssentials

面向现代 Paper 服务器的全功能基础套件:包含家园、经济、套装、保险箱、管理、员工模式、全息图、NPC、世界管理、等级系统、跨服务器交易,以及另外 24 项功能,全部整合在一个统一的插件中。

阅读文档 在 GitHub 上查看我们

适用于 Paper 适用于 Purpur 适用于 Velocity

在 Modrinth 上获取 在 Hangar 上获取 基于 Java 25 构建

Paper 26.2+  ·  支持 Folia  ·  35 个模块  ·  统一的配置风格、消息系统、权限体系和数据库

一个插件,取代零散的拼凑组合

uxmEssentials 用一套统一的套件替代了大多数服务器拼凑在一起的多个独立插件(核心 Essentials、经济插件、套装插件、Vault 插件、管理工具包、全息图插件、NPC 插件、多世界管理等)。所有功能共享相同的配置风格、消息系统、权限体系和数据库,使你的服务器运行行为可预测,而不是像一堆各自为政的插件那样杂乱无章。

该插件专为仅支持 Paper 26.2+ 而设计,充分利用当前 API 的正确用法,从第一行代码起就准备好支持 Folia,并将经济余额和玩家保险箱数据存储在真正的数据库中,以抵御世界回滚带来的风险。

最棒的部分是:每个模块都附带一个游戏内管理 GUI。你可以通过点击来配置全息图、NPC、传送点、保险箱和惩罚措施,而无需编辑文件并重启服务器。

为什么选择 uxmEssentials

  • 真正的模块化。 35 个功能模块,每个均可单独启用。禁用的模块不会连接任何内容:没有命令、监听器、数据库表或额外开销。只运行你需要的部分。
  • 在游戏内配置。 每个模块都提供通过 /uxmess gui 访问的管理 GUI。插件中的每个界面都通过同一个数据驱动的菜单引擎渲染,因此网格、槽位和图标本身也是配置值。
  • 自定义你的菜单。 除了内置界面外,/menu 命令会从 menus/*.conf 加载由 OP 作者编写的菜单文件,并通过 /menu open <name> 打开它们——使用相同的引擎、通用的动作词汇表和自定义 GUI,无需编写代码。
  • 无硬编码内容。 所有面向玩家的文本都存放在按语言分类的目录中;每个命令都可以重命名、添加别名或禁用;每个布局、费用、冷却时间和限制都是配置值。
  • 开箱即用十二种语言。 英语、土耳其语、德语、俄语、西班牙语、巴西葡萄牙语、法语、波兰语、乌克兰语、简体中文、日语和韩语,所有语言文件均可在磁盘上编辑。玩家可通过 /lang 选择自己的语言;如果某条翻译缺失,则默认回退到英文显示。
  • 防回滚的数据存储。 余额和保险箱数据保存在数据库中,而非物品 NBT 标签中,因此世界回滚永远不会导致金钱或物品重复。
  • 支持 Folia。 没有任何任务通过旧版调度器计划执行;工作被分发到正确的区域线程。同一份代码可以在 Paper 和 Folia 上无缝运行。
  • 原生支持冒险模式。 所有文本均使用 MiniMessage 格式,并通过统一的主题呈现,彻底告别传统的颜色代码。

内部包含的 35 个模块

玩家基础功能 家园、传送点、玩家传送点、传送
  • 家园 (Homes) 基于槽位的 GUI:点击空单元格设置家园,点击已有家园进行传送 / 重命名 / 重新定位 / 更改图标。支持家园可见性与邀请机制(/visit, /invite)、可选的经济收费、死亡重生链(家园、床、出生点)、不安全 / 黑名单世界的保护,以及跨九种土地所有权提供商(Lands、GriefPrevention、uxmClaims 等)的地块申请门控。
  • 传送点 (Warps) 支持单个传送点的费用、权限、密码锁定、欢迎消息、预热 / 冷却时间覆盖、出发 / 到达音效与粒子效果,以及评分系统。
  • 玩家传送点 (Player-warps) 玩家拥有的传送点,支持按等级配额、公开 / 私有可见性、密码锁定、访客计数和自定义图标。
  • 传送 (Teleport) 支持 /tpa、/tpahere、/back、/rtp(预热的安全搜索队列,确保随机传送即时生效)、/spawn,移动取消预热,按等级设置的冷却时间,以及可配置的到达特效。
经济与进度 经济、套装、保险箱、等级、交易
  • 经济系统 一个严肃的多货币、基于数据库的经济系统:/pay(支付)、/balance(余额),带缓存的 /baltop,带有利息的共享银行,贷款系统,货币兑换,实体纸币(防复制),按命令收费,薪资和每日奖励。注册到 Vault / Treasury 或使用其原生账本运行。
  • 套装 远超简单的冷却物品:分类,按权限组变体,一次性及首次加入奖励,费用,要求,类型化动作引擎(标题、声音、粒子、命令),轮换和定时可用性,全局库存,购买解锁,以及完整的编辑器 GUI。
  • 保险箱 基于数据库的玩家存储(可抵抗回滚),通过配额节点支持每个玩家的保险箱数量和每个保险箱的大小,物品黑名单,每个保险箱的名称和图标,溢出救援,以及非活跃保险箱清理。
  • 权限组 /rankup(升级权限组)、/prestige(声望)和自动权限组升级,由可配置的命令动作驱动(或 LuckPerms 组 + 权限节点),包含经济费用、占位符要求、声望循环和 /ranks GUI。
  • 交易 安全的玩家间交易窗口(/trade):双方押注物品和金钱,双方确认后,任何更改都会重置确认状态(防骗)。支持多货币、物品黑名单、请求/接受流程、距离和冷却限制、审计日志,以及跨服务器交易(在共享数据库的后端之间进行)。
生存与玩法 生存机制、姿势、村民
  • 生存 一系列生存机制,每项均可独立开关并设置权限(其中几项可由玩家通过命令切换):伐木机(/treefeller)、矿脉矿工(/veinminer)、快速树叶腐烂、农田保护(/farmprotect)、农田辅助(自动补种)、单人睡眠、头颅掉落,以及自动拾取 / 自动熔炼 / 自动出售 / 自动工具。
  • 姿势 坐、坐在其他玩家身上、躺、趴、旋转和爬行,支持区域 / WorldGuard 门控、设置 GUI 和冷却时间。
  • 村民 无限交易、补货计时器、交易管理器、禁用交易、村民保护、桶装村民、跟随与牵引绳、即时补货和点击交易。
管理与安全 管理、工作人员模式、隐身、物品栏回滚、安全、命令控制
  • Moderation 封禁、IP 封禁、临时封禁、静音、踢出、警告、监禁,支持静默制裁、持续时间分级、警告升级、小号检测、IP 历史记录、处罚模板、员工分析 + Discord 通知,以及统一的 /history、/checkban、/checkmute 和管理 GUI 与 LiteBans 导入器。
  • Staff Mode 专用模式:通过装备切换进行切换,包含检视、冻结、跟随、导航、员工聊天、在线员工列表、警报、飞行、制裁回滚、服务器锁定和定向社交间谍功能。
  • Vanish 基于自研数据包层的数据包级不可见性:模拟加入/退出、无声访问箱子/潜影盒/末影箱、物品拾取开关、夜视和飞行、分层可见/交互等级、动作栏指示器、/vanish list、生物目标抑制、跨服务器及 Folia 支持。
  • Inventory rollback 每次死亡和登出时自动快照(主手、护甲、副手、末影箱),并支持配置保留窗口;/invrestore 打开玩家历史快照的 GUI 以进行恢复。
  • Security 服务端账户安全(无需登录/认证插件):双因素认证,支持 PIN 码 GUI 或 TOTP(/2fa、/pin)、OP 命令保护、同 IP 小号检测(/ipalts)以及客户端品牌检测/屏蔽。密钥采用数据库哈希存储。
  • Command control 命令白名单、Tab 补全过滤、隐藏插件列表(/plugins、/pl、/?、/help)、自定义未知命令提示消息,以及基于权限驱动的 namespace:command 绕过阻止,支持 Geyser / Folia / 跨服务器。它以透明方式工作,自身不附带任何命令。
Chat and social 聊天与社交
  • 消息系统 私聊(/msg, /r)、支持离线回退的邮箱与 /mail sendall、AFK 提示以及按玩家设置的屏蔽列表。
  • 通信 公共聊天格式化(LuckPerms 前缀/后缀 + MiniMessage + PlaceholderAPI)、按死因显示的死亡信息、按权限组显示的加入消息、首次加入欢迎语和 MOTD、击杀武器占位符,以及多频道定时公告(支持条件判断与占位符)、广播、清屏、自定义进度通知,以及数据驱动的 /info、/rules、/discord 页面。
  • 状态显示 昵称、在线状态及显示名称管理。
  • 玩家状态 游戏模式、治疗、喂食、飞行、无敌、速度,以及支持离线的 /invsee 和 /endersee。
视觉与互动 全息图、NPC、计分板、Tab 列表、名字标签、投票、皮肤
  • 全息图 显示实体全息图:支持多行、多页(每位观看者点击循环切换)、由提供程序驱动的排行榜、点击动作链、内联动画、每位玩家可见性与黑名单、发光与透明度、链接至 NPC 跟随,以及 FancyHolograms / DecentHolograms 导入器。
  • NPC 基于自定义数据包层的基于数据包的 NPC:玩家、生物和显示实体;通过名称 / MineSkin / URL 获取皮肤;点击动作链;装备、发光、姿势、深度的每种类型变体;每位拥有者的配额和命令黑名单。
  • 计分板 每位玩家独立、按优先级条件选择的侧边栏,带有动画和条件行以及隐藏的分数数字。
  • 标签页列表 每位玩家的标签页名称格式化和排序,带标题/页脚的动画,固定槽位布局及填充物。
  • 名字标签 头顶上方的显示实体名字标签,支持每位观看者且感知隐身状态。
  • 投票 完整的投票奖励引擎:Votifier 接收、总数和排行榜、跨服务器投票派对(含升级机制)、连击、各站点冷却时间和提醒、多渠道广播,以及 Discord Webhook 通知。
  • 皮肤 /skin <player>、/skin url、/skin clear:玩家可穿着任何账户的皮肤或你托管的图片,并且重新加入后依然保留。MineSkin 对上传内容进行签名,Bedrock 玩家保留 Geyser 识别的皮肤,每个来源都有开关和黑名单规定允许的内容,模块本身则保持独立。
世界与实用工具 世界、区域、物品世界、服务器调整、discord-link、自定义菜单
  • 世界 完整的多世界管理器:创建 / 导入 / 删除(确认暂存阶段),每个世界的属性和游戏规则,内置虚空和平地生成器,通过经济入场费进行访问门控,跨世界传送门,世界编辑器 GUI,预生成,备份 / 恢复,以及空闲自动卸载。
  • 区域 WorldGuard 区域管理 GUI:列出、创建(双位置选择)、编辑标志、管理成员 / 所有者,并设置优先级。WorldGuard 是软依赖项;如果没有它,该模块将保持静止。
  • 物品世界 日常实用界面:一个 /itemedit 编辑器(重命名、描述、附魔、标志、属性、耐久度、自定义模型数据、不可破坏),从库存打开潜影盒,虚拟工作台(铁砧、合成等,随处可用),强力工具、生物和实体工具、时间 / 天气别名、库存清理,以及管理员趣味功能,这些都是可独立禁用的子组。
  • 服务器调整 小型可选基础设施开关:自定义 F3 服务器品牌、控制台垃圾信息过滤、无聊天报告,以及 SignedVelocity 协调。每个开关均可独立关闭。
  • Discord 链接 将 Minecraft 账户链接到 Discord,同步角色,并推送审计 / 经济通知(配合 Discord 附加组件)。
  • 自定义菜单 在内置菜单引擎之上构建你自己的 GUI:放入 menus/<name>.conf 文件并使用 /menu open <name> 打开它,使用通用动作词汇表(关闭、打开另一个菜单、运行命令、发送消息)。无需代码;特权控制台动作默认被禁用。

在游戏中配置所有内容

/uxmess gui 打开一个中心枢纽,链接到每个模块的编辑器。实体模块(全息图、NPC、传送点、金库、审核、区域)会先列出列表,然后选择一个实体,接着通过开关、步进器、文本 / 数字 / 枚举编辑器、颜色选择器和列表编辑器翻转其属性。设置模块则获得一组开关面板。

底层架构是一个 数据驱动的菜单引擎:包括运行裸命令如 /eco、/jail 或 /list 时打开的 GUI 在内的所有屏幕,都是规范加上类型安全的绑定,背后只有一个窗口持有者和监听器,没有针对每个菜单的代码。因此,你可以重新设计每个屏幕的外观而无需触碰代码,操作员也可以使用 /menu 完全自行构建新菜单。

权限与占位符查找

两者都在插件内部声明一次,并在每次构建时针对运行中的代码进行检查,因此发布的参考文档是生成的而非记忆的。

  • 508 个权限节点,每个都带有描述、默认值和形状(固定、配额、等级、标签)。委托一直细化到具体能力:例如 /npc create 除了 /npc delete,/bank deposit 除了 /bank withdraw,/heal <player> 除了 /gamemode <player>。/uxmess permissions 在游戏中列出它们,/uxmess permissions export 将其写入文件。
  • 338 个 PlaceholderAPI 键,涵盖每个模块以及玩家自身:生命值、延迟、游戏时长、坐标、生物群系、手中的物品、整个原版统计家族、任何按标签划分的冷却时间、格式化辅助函数、他人的 p_<name>_<key>,以及用于每位观看者格式的关联 rel_ 形式。/uxmess placeholders 列出它们,/uxmess placeholders export 将其导出。

完整列表:权限参考 和 占位符参考。

面向开发者

uxmEssentials 发布了一个开发者 API,你可以像编译任何其他库一样编译它,附带 javadocs 和版本化坐标。

  • 事件 约九十多个,涵盖插件所做的所有事情,另外九个你可以在它们发生之前取消的事件。
  • 查询 API 询问当前为真的内容:家园、余额、惩罚、游戏时长、谁离开了,涵盖二十七个上下文。
  • 操作 API 改变状态:设置家园、支付玩家、发放套件、禁止某人,涵盖二十三个上下文。
  • 菜单 API 教给 GUI 引擎你自己的动作、要求、占位符、列表源和图标。
  • REST 附加组件 通过 HTTP 和 WebSocket 实现相同的访问范围,适用于那些非插件的程序。

每次构建都会记录并对比已发布的 API 表面(surface),并且在 CI 中针对每个提交发布工件编译示例消费者插件,因此移除的方法或损坏的坐标会在破坏它们的提交时立即失败,而不是几个月后在某个人的服务器上才报错。完整参考见 docs.uxplima.com。

如何迁移?只需一条命令。

/uxmess import <source> 运行一次性、幂等的迁移,并提供预演预览和文档化的冲突处理策略:

来源 导入内容
EssentialsX 家(采用槽位模型)、传送点、套装、经济系统
FancyHolograms / DecentHolograms 全息图
LiteBans 封禁、IP 封禁、静音、警告
Vault / PlayerPoints 经济余额

要求

服务端 Paper 26.2(或 Paper 分支 Folia / Purpur / Pufferfish)
Java 25
数据库 默认 SQLite(零配置)。可选 MySQL、MariaDB 和 PostgreSQL。
可选组件 PlaceholderAPI、Vault / Treasury、LuckPerms、WorldGuard、Votifier 监听器均可自动检测。

Spigot 和 CraftBukkit 不受支持。uxmEssentials 使用 paper-plugin.yml、Brigadier 和内置的 Adventure。旧版本客户端仍可通过服务端的 ViaVersion 连接。

快速上手

  1. 将 uxmEssentials-0.8.1.jar 放入服务端的 plugins/ 文件夹并启动服务器。
  2. 配置文件按模块生成于 plugins/uxmEssentials/modules/ 下。通过各模块的 config.conf 启用或禁用任意模块。
  3. 运行 /uxmess doctor 确认数据库、经济提供商和集成状态健康。
  4. 正在迁移?尝试 /uxmess import essentialsx(先进行预演)。

管理员根命令为 /uxmess(别名 /uxe、/uxmessentials)。

可选配套插件

  • uxmEssentials-velocity 一个 Velocity 代理协调器,可在网络中同步家、传送点、经济、保险箱、交易、隐身等功能。
  • uxmEssentials-redis 通过 Redis pub/sub 实现跨服务器同步,无需代理。
  • uxmEssentials-discord 一个 JDA 桥接插件,用于账号绑定以及审计和经济通知。
  • uxmEssentials-rest 一个 HTTP 和 WebSocket API,供面板、机器人和脚本(非插件形式)使用。

您只需主插件即可开始使用;当您的设置需要时再添加配套插件。

文档与支持

文档包含安装指南、每个模块的命令/权限/设置/占位符页面、完整的权限与占位符参考,以及开发者 API。如果某页文档未解答您的问题,请在 Discord 提问;如果遇到问题,请提交 Issue。/uxmess doctor 和你的服务器日志是获得修复的最快途径。

备注

uxmEssentials 是开源软件(GPL-3.0)且处于积极开发中。我们真诚欢迎功能请求和反馈,每个版本在正式发布前都会在更改日志标签页中撰写说明。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源