一个插件,取代零散的拼凑组合
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 连接。
快速上手
- 将
uxmEssentials-0.8.1.jar 放入服务端的 plugins/ 文件夹并启动服务器。
- 配置文件按模块生成于
plugins/uxmEssentials/modules/ 下。通过各模块的 config.conf 启用或禁用任意模块。
- 运行
/uxmess doctor 确认数据库、经济提供商和集成状态健康。
- 正在迁移?尝试
/uxmess import essentialsx(先进行预演)。
管理员根命令为 /uxmess(别名 /uxe、/uxmessentials)。
可选配套插件
您只需主插件即可开始使用;当您的设置需要时再添加配套插件。
文档与支持
文档包含安装指南、每个模块的命令/权限/设置/占位符页面、完整的权限与占位符参考,以及开发者 API。如果某页文档未解答您的问题,请在 Discord 提问;如果遇到问题,请提交 Issue。/uxmess doctor 和你的服务器日志是获得修复的最快途径。
备注
uxmEssentials 是开源软件(GPL-3.0)且处于积极开发中。我们真诚欢迎功能请求和反馈,每个版本在正式发布前都会在更改日志标签页中撰写说明。
uxmEssentials
The all-in-one essentials suite for modern Paper servers Homes, Economy, Kits, Vaults, Moderation, a Staff Mode, Holograms, NPCs, Worlds, Ranks, cross-server Trade, and 24 more, in one cohesive plugin.



Paper 26.2+ · Folia ready · 35 modules · one config style, one message system, one permission scheme, one database
One plugin instead of a patchwork of ten
uxmEssentials replaces the stack of separate plugins most servers glue together an essentials core, an economy, a kit plugin, a vault plugin, a moderation toolkit, a hologram plugin, an NPC plugin, a multi-world manager with one cohesive suite. Every feature shares the same configuration style, the same message system, the same permission scheme, and the same database, so your server behaves predictably instead of like a patchwork of plugins that each do things their own way.
It is built Paper 26.2 only, on purpose the current API used the way it is meant to be, Folia-ready from line one, with economy balances and player vaults stored in a real database so they survive world rollbacks.
And the best part: every module ships with an in-game management GUI. You configure holograms, NPCs, warps, vaults, and punishments by clicking not by editing files and restarting.
Why uxmEssentials
- Genuinely modular. 35 feature modules, each toggled on its own. A disabled module wires nothing: no commands, no listeners, no database tables, no overhead. Run only what you need.
- Configure in-game. Every module has a management GUI from
/uxmess gui. Every screen in the plugin renders through one data-driven menu engine, so the grids, slots, and icons are themselves config values.
- Build your own menus. Beyond the built-in screens,
/menu loads operator-authored menu files from menus/*.conf and opens them with /menu open <name> the same engine, a generic action vocabulary, custom GUIs without code.
- Nothing hardcoded. Every player-facing string lives in a per-locale catalog; every command can be renamed, aliased, or disabled; every layout, cost, cooldown, and limit is a config value.
- Twelve languages out of the box. English, Turkish, German, Russian, Spanish, Brazilian Portuguese, French, Polish, Ukrainian, Simplified Chinese, Japanese, and Korean, all editable on disk. A player picks their own with
/lang; a line a translation is missing falls back to the English wording.
- Rollback-proof data. Balances and vaults live in the database never in item NBT so a world rollback never duplicates money or items.
- Folia-ready. Nothing schedules through the legacy scheduler; work is dispatched to the correct region thread. The same code runs unchanged on Paper and Folia.
- Adventure-native. All text is MiniMessage through one shared theme no legacy colour codes anywhere.
What's inside 35 modules
Player essentials homes, warps, player-warps, teleport
- Homes a slot-based GUI: click an empty cell to set a home, click a home to teleport / rename / relocate / re-icon. Home visibility + invites (
/visit, /invite), an optional economy charge, a death-respawn chain (home, bed, spawn), unsafe / blacklisted-world guards, and land-claim gating across nine providers (Lands, GriefPrevention, uxmClaims, and more).
- Warps per-warp cost, permission, password lock, welcome message, warmup / cooldown overrides, departure / arrival sounds and particles, and a rating system.
- Player-warps player-owned warps with per-rank quotas, public / private visibility, password locks, visitor counts, and custom icons.
- Teleport
/tpa, /tpahere, /back, /rtp (a pre-warmed safe-search queue, so random teleports are instant), /spawn, move-cancels-warmup, per-rank cooldowns, and configurable arrival effects.
Economy and progression economy, kits, vaults, ranks, trade
- Economy a serious, multi-currency, database-backed economy:
/pay, /balance, a cached /baltop, shared banks with interest, a loan system, a currency exchange, physical banknotes (anti-dupe), per-command costs, salary and daily rewards. Registers with Vault / Treasury or runs on its own native ledger.
- Kits far beyond items on a cooldown: categories, per-rank variants, one-time and first-join grants, costs, requirements, a typed action engine (titles, sounds, particles, commands), rotation and scheduled availability, global stock, buy-to-unlock, and a full editor GUI.
- Vaults database-backed player storage (survives rollbacks) with per-player vault counts and per-vault sizes via quota nodes, an item blacklist, per-vault name and icon, overflow rescue, and inactive-vault purge.
- Ranks
/rankup, /prestige, and autorank driven by configurable command-actions (or LuckPerms groups + permission nodes), with economy costs, placeholder requirements, a prestige loop, and a /ranks GUI.
- Trade a secure player-to-player trade window (
/trade): both sides stake items and money, both confirm, and any change resets the confirmation (anti-scam). Multi-currency, an item blacklist, request / accept flow, distance and cooldown limits, an audit log, and cross-server trading between backends that share a database.
Survival and gameplay survival, poses, villagers
- Survival a grab-bag of survival mechanics, each independently toggled and permissioned (several player-toggleable by command): tree-feller (
/treefeller), veinminer (/veinminer), fast-leaf-decay, farm protection (/farmprotect), farm assist (auto-replant), one-player-sleep, head drops, and auto-pickup / auto-smelt / auto-sell / auto-tool.
- Poses sit, sit-on-players, lay, belly-flop, spin, and crawl, with region / WorldGuard gating, a settings GUI, and cooldowns.
- Villagers infinite trading, restock timers, a trade manager, trade disabling, villager protection, villager-in-a-bucket, follow and leash, instant restock, and click-to-trade.
Staff and security moderation, staff mode, vanish, inventory rollback, security, command control
- Moderation bans, IP-bans, temp-bans, mutes, kicks, warns, jails, with silent sanctions, duration tiers, warn escalation, alt detection, IP history, punishment templates, staff analytics + Discord notifications, and a unified
/history, /checkban, /checkmute plus a management GUI and a LiteBans importer.
- Staff Mode a dedicated mode: toggle with loadout swap, examine, freeze, follow, navigator, staff chat, an online-staff list, alerts, flight, sanction rollback, server lockdown, and targeted socialspy.
- Vanish packet-level invisibility over the in-house packet layer: fake join / quit, silent chest / shulker / ender-chest access, an item-pickup toggle, night-vision and flight, layered see / interact levels, an action-bar indicator,
/vanish list, mob-targeting suppression, cross-server + Folia.
- Inventory rollback snapshots every death and logout (main, armor, offhand, ender-chest) with a configurable retention window;
/invrestore opens a GUI of a player's past snapshots to restore from.
- Security server-side account security (no login/auth): two-factor with a PIN GUI or TOTP (
/2fa, /pin), op-command protection, same-IP alt detection (/ipalts), and client-brand detection / blocking. Secrets are database-hashed.
- Command control command whitelisting, tab-completion filtering, plugin-list hiding (
/plugins, /pl, /?, /help), a custom unknown-command message, and namespace:command bypass blocking permission-driven, with Geyser / Folia / cross-server support. It works transparently, with no command of its own.
Chat and social messaging, communication, presence, player-state
- Messaging private messages (
/msg, /r), a mailbox with offline fallback and /mail sendall, AFK notices, and a per-player ignore list.
- Communication public chat formatting (LuckPerms prefix / suffix + MiniMessage + PlaceholderAPI), per-cause death messages, per-rank join messages, a first-join welcome and MOTD, a killer-weapon placeholder, plus multi-channel scheduled announcements (conditional, with placeholders), broadcasts, clear-chat, custom advancement notifications, and data-driven
/info, /rules, /discord pages.
- Presence nicknames, presence status, and display-name management.
- Player-state gamemode, heal, feed, fly, god, speed, plus offline-capable
/invsee and /endersee.
Visual and engagement holograms, NPCs, scoreboard, tablist, nametags, vote, skins
- Holograms Display-entity holograms: multi-line, multi-page (per-viewer click-to-cycle), provider-driven leaderboards, click-action chains, inline animations, per-player visibility and blacklists, glow and opacity, link-to-NPC follow, plus FancyHolograms / DecentHolograms importers.
- NPCs packet-based NPCs over an in-house packet layer: players, mobs, and display entities; skins by name / MineSkin / URL; click-action chains; equipment, glow, poses, deep per-type variants; per-owner quotas and a command blocklist.
- Scoreboard per-player, condition-selected sidebars by priority, with animated and conditional lines and hidden score numbers.
- Tablist per-player tab name formatting and sorting, animated header / footer, fixed-slot layouts with filler.
- Nametags above-head display-entity nametags, per-viewer and vanish-aware.
- Vote a full vote-rewards engine: Votifier intake, totals and a leaderboard, a cross-server vote party with escalation, streaks, per-site cooldowns and reminders, multi-channel broadcasts, and Discord webhook notifications.
- Skins
/skin <player>, /skin url, /skin clear: a player wears any account's skin or an image you host, and it survives a rejoin. MineSkin signs the uploads, Bedrock players keep the skin Geyser knows them by, a per-source switch and a blocklist say what is allowed, and the module ships off.
World and utility worlds, regions, itemworld, server tweaks, discord-link, custom menus
- Worlds a full multi-world manager: create / import / delete (confirm-staged), per-world properties and gamerules, built-in void and flat generators, access gating with economy entry fees, cross-world portals, a world-editor GUI, pre-generation, backup / restore, and idle auto-unload.
- Regions a WorldGuard region-management GUI: list, create (two-position selection), edit flags, manage members / owners, and set priority. WorldGuard is a soft-dependency; without it the module stays inert.
- Itemworld the everyday utility surface: an
/itemedit editor (rename, lore, enchants, flags, attributes, durability, custom-model-data, unbreakable), open-shulker-from-inventory, virtual workstations (anvil, crafting, and more, anywhere), powertool, mob and entity tools, time / weather aliases, inventory cleanup, and admin-fun each an independently disableable sub-group.
- Server tweaks small opt-in infrastructure toggles: a custom F3 server brand, console-spam filtering, no-chat-reports, and SignedVelocity coordination. Each ships off.
- Discord-link link a Minecraft account to Discord, sync roles, and push audit / economy notifications (with the Discord add-on).
- Custom menus build your own GUIs over the built-in menu engine: drop a
menus/<name>.conf file and open it with /menu open <name>, using a generic action vocabulary (close, open another menu, run a command, send a message). No code; the privileged console action is gated off by default.
Configure it all in-game
/uxmess gui opens a hub linking to every module's editor. Entity modules (holograms, NPCs, warps, vaults, moderation, regions) get a list, then an editor pick an entity, then flip its properties with toggles, steppers, text / number / enum editors, a colour picker, and list editors. Settings modules get a panel of switches.
Under the hood it is all one data-driven menu engine: every screen including the GUI that opens when you run a bare command like /eco, /jail, or /list is a spec plus type-safe bindings, behind a single window holder and listener with no per-menu code. So you can re-skin every screen without touching code, and operators can build entirely new menus of their own with /menu.
Permissions and placeholders you can look up
Both are declared once inside the plugin and checked against the running code on every build, so the published reference is generated rather than remembered.
- 508 permission nodes, each with its description, its default and its shape (fixed, quota, tier, label). Delegation goes all the way down to the capability:
/npc create apart from /npc delete, /bank deposit apart from /bank withdraw, /heal <player> apart from /gamemode <player>. /uxmess permissions lists them in game and /uxmess permissions export writes them to a file.
- 338 PlaceholderAPI keys, covering every module plus the player themselves: health, ping, playtime, coordinates, biome, the item in hand, the whole vanilla statistic family, any cooldown by label, formatting helpers,
p_<name>_<key> for somebody else, and the relational rel_ form for per-viewer formats. /uxmess placeholders lists them and /uxmess placeholders export writes them out.
Full lists: permission reference and placeholder reference.
For developers
uxmEssentials publishes a developer API you compile against like any other library, with javadocs and a versioned coordinate.
- Events ninety-odd of them, covering everything the plugin does, plus nine you can cancel before they happen.
- Query API ask what is true right now: homes, balances, punishments, playtime, who is away, across twenty-seven contexts.
- Action API change it: set a home, pay a player, hand over a kit, ban somebody, across twenty-three contexts.
- Menu API teach the GUI engine your own actions, requirements, placeholders, list sources, and icons.
- REST add-on the same reach over HTTP and WebSocket, for the programs that are not plugins.
The published surface is written down and compared on every build, and a sample consumer plugin is compiled in CI against the artifacts each commit publishes, so a removed method or a broken coordinate fails on the commit that broke it rather than on somebody's server months later. Full reference at docs.uxplima.com.
Migrating in? One command.
/uxmess import <source> runs a one-shot, idempotent migration with a dry-run preview and a documented conflict policy:
| Source |
Imports |
| EssentialsX |
homes (into the slot model), warps, kits, economy |
| FancyHolograms / DecentHolograms |
holograms |
| LiteBans |
bans, IP-bans, mutes, warns |
| Vault / PlayerPoints |
economy balances |
Requirements
|
|
| Server |
Paper 26.2 (or a Paper fork Folia / Purpur / Pufferfish) |
| Java |
25 |
| Database |
SQLite by default (zero setup). MySQL, MariaDB, and PostgreSQL optional. |
| Optional |
PlaceholderAPI, Vault / Treasury, LuckPerms, WorldGuard, a Votifier listener all auto-detected. |
Spigot and CraftBukkit are not supported uxmEssentials uses paper-plugin.yml, Brigadier, and bundled Adventure. Clients on older versions can still connect through a server-side ViaVersion.
Getting started
- Drop
uxmEssentials-0.8.1.jar into your server's plugins/ folder and start the server.
- Config is generated per module under
plugins/uxmEssentials/modules/. Toggle any module from its config.conf.
- Run
/uxmess doctor to confirm the database, economy provider, and integrations are healthy.
- Migrating? Try
/uxmess import essentialsx (dry-run first).
The admin root is /uxmess (aliases /uxe, /uxmessentials).
Optional companion jars
- uxmEssentials-velocity a Velocity proxy broker that syncs homes, warps, economy, vaults, trade, vanish, and more across a network.
- uxmEssentials-redis the same cross-server sync over Redis pub/sub, with no proxy required.
- uxmEssentials-discord a JDA bridge for account linking and audit / economy notifications.
- uxmEssentials-rest an HTTP and WebSocket API for panels, bots, and scripts that are not plugins.
You only need the main jar to get started; add the companions when your setup calls for them.
Documentation and support
The documentation carries an install guide, a page per module with its commands, permissions, settings and placeholders, the full permission and placeholder references, and the developer API. Ask on Discord when a page does not answer it; open an issue when something is broken. /uxmess doctor and your server log are the fastest path to a fix.
Notes
uxmEssentials is open source (GPL-3.0) and under active development. Feature requests and feedback are genuinely welcome, and every release is written up on the changelog tab before it lands here.
评论 0
登录后参与评分
还没有评论,来抢沙发吧