RpEssentials
Rp Essentials 是一款专为在 NeoForge 上运行 Minecraft 1.21.1 的沉浸式角色扮演服务器设计的综合性服务端工具模组。它涵盖了身份隐匿、职业与执照、管理功能、聊天格式化、服务器排班、死亡角色扮演(Death RP)、世界边界与区域等功能,所有设置均可实时配置而无需重启服务器。
当前版本:5.0.1。完整更新日志请查看 Modrinth。
完整的文档、配置参考和安装指南现已发布至 GitHub Wiki。
生成式 AI 披露
你好,以下是关于本项目中 AI 使用的所有你需要了解的信息:
-
AI 未用于生成任何视觉素材
-
添加到本模组中的每一个创意都来自我个人的小脑壳,但是我确实使用了 AI 来编写其中大部分代码。 我为我和其他人运营的一个 RP 服务器启动了此模组,因为我需要一些实用工具,而我缺乏编写所有这些内容的技能。 如今我正在学习自己实现大多数新功能,但 AI 仍然是帮助我编写复杂代码的好工具。 从我自己的角度来看,AI 是编程的绝佳工具,如果必要的话我会继续使用它,但我将绝对不使用 AI 来生成视觉素材。
-
基本上我就这些要说的,祝你有美好的一天!
功能概览
| 功能 | Wiki 页面 |
|---|---|
| 名称隐匿、昵称、名牌 | 身份系统 |
| 职业、执照、制作/装备限制 | 职业与执照系统 |
| 警告、禁言、员工备注、检查 | 管理系统 |
| 聊天格式化、私聊、加入/离开消息 | 聊天系统 |
| 营业时间、欢迎语、死亡时间、HRP 时间 | 服务器排班 |
| 永久死亡系统 | 死亡角色扮演 |
| 距离警告和命名区域 | 世界边界与区域 |
| 静默指令、平台、角色、骰子、自动取消白名单 | 员工工具 |
| 游戏内配置管理器 GUI | 配置管理器 GUI |
| 完整命令列表 | 命令 |
| 配置文件和数据存储 | 配置文件 |
依赖要求
| 依赖项 | 版本 | 端 | 必需 |
|---|---|---|---|
| Minecraft | 1.21.1 | 双方 | 是 |
| NeoForge | 21.1.219+ | 双方 | 是 |
| RpImmersion | 1.0.0 | 双方 | 可选 |
| LuckPerms | 任意版本 | 服务端 | 可选 |
| ImmersiveMessages | neoforge-1.21.1:1.0.18 | 客户端 | 可选 |
| TxniLib | neoforge-1.21.1:1.0.24 | 客户端 | 可选 |
如果在配置文件中任何地方使用了 IMMERSIVE 显示模式,则仅在客户端侧需要 ImmersiveMessages 和 TxniLib。服务端在没有它们的情况下也能正常运行。
安装步骤
- 从发布页面下载最新的
rpessentials-X.X.X.jar。 - 将 JAR 文件放入服务器的
mods/文件夹中。 - (可选)安装 LuckPerms 以基于前缀/后缀和用户组进行员工权限管理。
- 启动服务器,所有配置文件会自动生成于
config/rpessentials/目录下。 - 编辑后通过
/rpessentials config reload在游戏内重载,或重启服务器。
有关详细信息,请参阅 安装 Wiki 页面。
技术信息
| 字段 | 值 |
|---|---|
| Mod ID | rpessentials |
| Group ID | net.rp.rpessentials |
| 版本 | 5.0.0_beta |
| MC 版本 | 1.21.1 |
| NeoForge | 21.1.219+ |
| Java | 21 |
RpEssentials
Rp Essentials is a comprehensive server side utility mod built for immersive Roleplay servers running Minecraft 1.21.1 on NeoForge. It covers identity obfuscation, professions and licenses, moderation, chat formatting, server scheduling, Death RP, world border and zones, and more, all configurable in real time without restarts.
Current version: 5.0.1. Full changelog on Modrinth.
Full documentation, configuration reference and setup guides now live on the GitHub Wiki.
Generative AI Disclosure
Hi, here is all you need to know about AI in this project:
-
AI was NOT used to generate any visual assets
-
Every idea added to this mod come from my own little brain however I did use AI to code most of them. I started this mod for an RP server I had with other people because I needed some utilities for it, and I did not have the skills required for coding all of this. Today I'm learning to do most of the new features by myself but AI is still a good tool to help me code complex things. From my own perspective, AI is a great tool for coding and I will continue to use it if needed, but I will never ever use AI to generate visual assets.
-
That's pretty much the only things I had to say, have a great day!
Feature overview
| Feature | Wiki page |
|---|---|
| Name obfuscation, nicknames, nametags | Identity System |
| Professions, licenses, crafting/equipment restrictions | Profession & License System |
| Warns, mutes, staff notes, inspect | Moderation System |
| Chat formatting, private messages, join/leave | Chat System |
| Opening hours, welcome message, Death Hours, HRP Hours | Server Schedule |
| Permanent death system | Death RP |
| Distance warnings and named zones | World Border & Zones |
| Silent commands, platforms, roles, dice, auto unwhitelist | Staff Tools |
| In game Config Manager GUI | Config Manager GUI |
| Full command list | Commands |
| Config files and data storage | Configuration Files |
Requirements
| Dependency | Version | Side | Required |
|---|---|---|---|
| Minecraft | 1.21.1 | Both | Yes |
| NeoForge | 21.1.219+ | Both | Yes |
| RpImmersion | 1.0.0 | Both | Optional |
| LuckPerms | Any | Server | Optional |
| ImmersiveMessages | neoforge-1.21.1:1.0.18 | Client | Optional |
| TxniLib | neoforge-1.21.1:1.0.24 | Client | Optional |
ImmersiveMessages and TxniLib are only required client side if you use the IMMERSIVE display mode somewhere in the config. The server runs fine without them.
Installation
- Download the latest
rpessentials-X.X.X.jarfrom the releases page. - Place the JAR in your server's
mods/folder. - Optionally install LuckPerms for prefix/suffix and group based staff permissions.
- Start the server, all config files are generated automatically under
config/rpessentials/. - Reload in game with
/rpessentials config reloadafter editing, or restart the server.
See the Installation wiki page for details.
Technical Information
| Field | Value |
|---|---|
| Mod ID | rpessentials |
| Group ID | net.rp.rpessentials |
| Version | 5.0.0_beta |
| MC Version | 1.21.1 |
| NeoForge | 21.1.219+ |
| Java | 21 |
下载 RpEssentials
下载 RpEssentials
下载 RpEssentials
下载 RpEssentials
下载 RpEssentials
下载 RpEssentials
下载 RpEssentials
下载 RpEssentials
下载 RpEssentials
下载 RpEssentials
[6.0.0]
如果你很懒
所以,如果你比较懒,直接阅读这一节即可: 如果你是从 4.2.0 或 5.0.0(或 5.0.1)升级,你可以放心更新,你将获得大量新功能和错误修复! 主要新增的是优化、错误修复、HEXCode 颜色格式支持(几乎涵盖模组能支持的所有内容)、限制系统的改进(大量的改进)、更好的 GUI、大量新的管理功能(举报中心、Discord Webhook、玩家命令历史记录、统计部分改进、分区管理改进、配置 GUI 更易读且易用,以及更多更多功能!) 如果你想了解更多,变更日志仍然在下方!
破坏性更改
- 角色和权限合并:
rpessentials-core.toml中的Roles部分已移至Permissions System,staffTags/luckPermsStaffGroups已移除:现在成为工作人员仅来自于具有isStaff(或opLevelBypass)的角色。旧文件将在启动时自动更新(参见迁移说明)。 - 世界边界形状: 新的
worldBorderShape选项默认为SQUARE。现有服务器将从圆形限制切换为方形限制,其中worldBorderDistance是边长的一半。将其设置为CIRCLE以保持之前的行为。 - 网络:
ConfigGuiFilesPacket、SyncTooltipPacket、ManagePlayerPacket(新的临时封禁操作),名称标签数据包和历史记录数据包已更改或新增。服务端和客户端必须运行相同版本。
新增
-
物品标签和通配符: 在每一个限制列表中均接受
#namespace:tag和*,并在 GUI 中提供建议以及旋转的物品图标。 -
限制作用域: 在禁用列表上支持
item|dim=<dimension>和item|zone=<zone>。 -
多人游戏时的工具提示: 限制显示
✔(允许)、✘(禁用),对豁免的管理员显示✔ (exempt),当作用域限制不适用于你所在位置时显示~。 -
十六进制颜色和渐变: 聊天、昵称、消息、背景故事和许可证中支持
&#RRGGBB和<grad:#RRGGBB:#RRGGBB>text</grad>。 -
模糊选项:
blurStyle(OBFUSCATED、DASHES、HASHES、STARS)、blurCodes和nametagBlurMode(OFF、BLUR、HIDE)。 -
隐身模式: 对于能看到隐身玩家的玩家,进度奖励消息会标记为
[hidden];可选的虚假加入和离开消息(fakeJoinLeaveMessages、fakeMessageMark)。 -
命名区域: 支持
circle、square、rect和ellipse形状,进入和退出时执行zoneActions命令,以及带有粒子效果的/rpessentials zone show|hide|list。 -
死亡角色扮演: 历史记录中的角色档案,可选重置昵称、角色和职业,以及
/rpessentials deathrp revive。 -
私信监听: 通过登录通知选择加入。
-
聊天:
playerChatCodes限制非管理员玩家可以使用哪些格式化代码。 -
昵称:
nicknamesUnique、nicknameBlacklist和hideRealNames,用于/list和命令建议。 -
验证和备份:
/rpessentials config validate(也在启动时运行),/rpessentials config backup支持轮换 zip 备份。 -
时区:
timezone选项适用于模组中的所有日期。 -
/rp afk: 战斗后设有冷却时间和拒绝机制,当坐标改变时重新放置 AFK 平台。 -
公共 API:
LicenseGrantedEvent、LicenseRevokedEvent、ProfessionCheckEvent、DeathRpEvent和RpEssentialsAPI。 -
配置管理器: 按模组分组、按文件主题,以及扩展的注册 API。
-
消息:
messageSource(CONFIG-> 使用配置文件中的消息或MOD-> 使用模组预翻译的消息)、serverLanguage、位于data/rpessentials/messages/中的翻译文件,以及/rpessentials config exportlang。 -
空限制列表 现在会显示其功能的描述。
-
容器编辑器: 建议仅限于打开菜单的方块。
-
管理员消息: 几乎所有管理员和命令消息(
manage、zone、vanish、blurtab、staff、许可证、警告、静音、备注、死亡角色扮演、缺席、检查、日程安排、昵称、config、统计、帮助,以及 GUI 的服务器回复)均在rpessentials-messages.toml中声明,并在MOD模式下于data/rpessentials/messages/中进行翻译。在MOD模式下,如果缺少翻译,则回退到serverLanguage,然后是en_us,最后是 toml 值。 -
许可证:
rpessentials-professions.toml中的licenseIdDisplay选项(NAME_ONLY、NAME_AND_ID、ID_ONLY),用于显示许可证卡片上的职业信息。 -
隐身模式: 标签页
marker中的{level}占位符(例如&7[V{level}])。 -
无前缀的命令:
rpessentials-core.toml中的unprefixedStaffCommands和unprefixedRpCommands(默认关闭)允许你直接输入每个/rpessentials和/rp子命令(/warn、/nick、/license、/afk、/spawn...)。带前缀的命令仍然有效。已被 Minecraft 或其他模组使用的名称(如/help...)将被跳过,并记录在日志和/rpessentials config validate中。在配置重载时生效。新增/manage快捷方式。 -
/rp spawn: 传送至世界出生点或配置的坐标,具有冷却时间和战斗锁定(rpessentials-rp.toml的Spawn部分,默认关闭)。 -
额外命令:
afkCommands和spawnCommands在/rp afk和/rp spawn之后作为玩家运行(支持@s、~ ~ ~和{player})。 -
随处翻译: 不再有硬编码文本。每条消息都以接收者玩家的语言发送(在
MOD模式下),包括广播(公告、/rp commerce、/rp action、骰子、管理员广播、监听消息)、持续时间(“剩余 2 小时 30 分钟”、“永久”)、游戏时长、星期几、/colors、/schedule状态、config validate、登录通知和许可证物品。GUI 屏幕、限制工具提示和许可证卡片使用游戏语言(assets/rpessentials/lang)。 -
统计标签页: 玩家个人资料统计标签页还显示首次加入时间、最后登录和登出时间(带有“x 天前”)、收到的所有警告和静音、当前的缺席状态、临时许可证及其结束日期、RP 死亡状态和 RP 死亡次数、白名单、OP 等级、角色和 LuckPerms 组、隐身等级、登录次数(总计、最近 7 天和 30 天)、最近 7 天和 30 天的游戏时长,以及最新的 RP 昵称。这些行在服务器上以管理员的语言构建,并且标签页可滚动。
-
玩家历史:
history.json中每位玩家一个时间线(警告、移除警告、静音、解除静音、备注、管理操作、发放/撤销/过期的许可证、RP 死亡、昵称更改)。/rpessentials history <player> [page](对离线玩家也有效)、/rpessentials history purge,以及玩家个人资料 GUI 中的新历史标签页。rpessentials-moderation.toml的Player History部分:historyEnabled、historyRetention(每种类型的天数,-1= 永远,默认*=365、NOTE=-1、DEATH_RP=-1)和historyMaxPerPlayer。旧行在启动时和每隔一小时被移除。尊重隐身模式:由隐身管理员执行的操作,以及隐身/取消隐身操作,仅向 OP 等级可以看到该隐身等级的管理员显示(通过命令、GUI、统计)。 -
绘制界面: RpEssentials 的屏幕可以使用绘制的纹理(
assets/rpessentials/textures/gui/sprites/:背景、面板、按钮、列表行、标签页、文本字段、笔记行、分区标题、分隔线,支持九宫格缩放)。你可以使用每个屏幕右上角的按钮,或者在新客户端文件rpessentials-client.toml中的guiStyle在绘制界面和经典界面之间切换(默认为经典的LEGACY)。如果缺少纹理则保持经典外观,资源包可以替换这些纹理(主要意图如此,我尚未绘制任何内容,但文件已存在以备不时之需)。 -
掷骰子:
/roll接受表达式(d20、2d6+3、d100-10、<dice>+2)、优势与劣势(adv d20、dis d20)以及秘密投掷(/roll secret d20,仅对投掷者和工作人员可见)。详情显示在总数旁边(例如4 + 6 + 3)。rpessentials-rp.toml中新增Dice Rolls部分:allowExpressions、allowSecretRolls、maxDiceCount、maxDiceSides。 -
掷骰子 API:
DiceRollEvent.Pre(可取消,结果可被替换)和DiceRollEvent.Post(包含结果和受众),以及getRoll()(获取每个值、修正值、优势、秘密状态、表达式),加上RpEssentialsAPI.getDiceTypes、getDice、rollDice、rollDiceSilently、rollDiceDetailed和parseDice。 -
临时封禁:
manage <player> tempban <duration> [reason](支持3d、12h、30m、1d12h、2w),带有确认机制、取消白名单后的快速操作,以及在个人资料 GUI 中的临时封禁按钮(以天为单位)。玩家会在登录界面看到结束日期,且封禁会自动解除。 -
传送延迟:
spawnWarmupSeconds和afkWarmupSeconds(位于rpessentials-rp.toml的Teleport Warmup部分,默认为 0)会让玩家在不动的情况下等待,动作栏会显示倒计时。cancelOnMove和cancelOnDamage可以取消该延迟。冷却时间仅在传送发生后开始计算。 -
传送 API:
RpTeleportEvent(Warmup可取消且延迟可更改,Tick每刻用于动画,Cancelled,Pre可取消,Post),加上RpEssentialsAPI.teleport(...)以便其他模组也能使用相同的延迟传送功能。 -
排班例外:
rpessentials-schedule.toml中的scheduleExceptions(例如2026-12-25=CLOSED、2026-12-31=20:00-03:00)会在指定日期覆盖每周排班,包括跨夜时段。即将到来的排班将在/schedule中列出。 -
变量 API:
%rpessentials:<name>%变量(nick、name、display、role、role_group、vanished、vanish_level、professions、professions_ids、profession_count、warns、muted、playtime)可通过RpEssentialsAPI.resolvePlaceholders、getPlaceholder和registerPlaceholder访问,以及getDisplayName、getRole、getVanishLevel和getProfessionNames。 -
config validate: 还会报告不存在的维度(AFK、出生点、平台)、未知的声音,以及已被移除的职业所持有的许可证。结果将以查看者的语言显示。 -
举报: 玩家使用
/rp report <player> <reason>举报其他玩家(当unprefixedRpCommands开启时也可使用/report);系统会保存他们站立的位置。在线的工作人员会收到可点击的通知,加入的工作人员会被告知有多少举报等待处理。工作人员通过/rpessentials reports list|info|claim|close [note]|reopen|delete|tp或在新的个人资料 GUI 的“举报”选项卡中处理(处理、关闭并附带可选备注、重新打开、传送、删除)。举报者在举报被关闭时会收到通知。玩家列表中已举报的玩家旁边会显示[nR],并且新增了“已举报”过滤器。举报会出现在玩家历史中(类型为REPORT)。rpessentials-moderation.toml的Reports部分:enableReports、reportCooldownSeconds、reportMaxOpenPerPlayer、reportReasonMaxLength、reportNotifyStaffOnJoin、reportClosedRetentionDays。存储在reports.json中。 -
颜色调色板: 昵称、职业和角色卡片的调色板由小色块组成;工具提示会以对应颜色及其代码显示颜色名称。一个 "+" 色块会打开“我的颜色”,允许你添加带有名称和十六进制代码的颜色(实时预览)并删除它们;它们保存在
rpessentials-client.toml的customColors中,并在所有调色板中显示。即使某个十六进制颜色不在你的自定义颜色中,只要它已被某个昵称或职业使用,它就会出现在调色板中,因此保存后会保留该颜色。职业也接受十六进制颜色。 -
角色卡片: 在玩家个人资料 GUI 的“个人资料”选项卡中有一个“角色卡片”按钮,用于打开所选玩家的卡片(包括预置配置文件,这意味着可以在首次登录前准备好卡片)。玩家永远无法看到此卡片。字段包括:RP 名称、年龄、种族、语言(自由文本)、外貌、描述和背景故事,每个字段都可以关闭,此外还有自定义字段(格式为
customFields,id;Label;LINE或id;Label;TEXT)。多行字段会打开一个文本编辑器,支持自动换行、颜色调色板、加粗/斜体/下划线/删除线按钮以及实时预览;支持&代码、十六进制颜色、渐变和 Markdown(**bold**、*italic*、__underline__、~~strike~~)。RP 名称旁边的 ⇄ 按钮可将其设置为玩家的昵称(进行与/nick相同的检查,如果已经是则变灰)。更改会记录到玩家历史中(类型为SHEET)。rpessentials-rp.toml的Character Sheet部分:enableCharacterSheets、fieldName、fieldAge、fieldRace、fieldLanguages、fieldAppearance、fieldDescription、fieldLore、customFields、maxTextLength。存储在character-sheets.json中。API:RpEssentialsAPI.getCharacterSheet、setCharacterSheetField、registerCharacterSheetField和CharacterSheetChangedEvent。 -
职业编辑器中的限制警告: 对于没有任何效果或阻止所有人的条目,旁边会出现一个 ⚠ 按钮。在职业列表(制作、方块、物品、装备)中,未被全局禁止的允许条目不会有任何变化,因为所有人都已经可以执行:提示框会说明这一点(并列出匹配
*模式和#标签的项目),点击会将该条目添加到全局列表中并保存。在全局列表中,没有职业允许的条目将对除豁免员工之外的所有人进行阻止:提示框会列出哪些内容不被任何职业允许,点击后会打开一个职业列表,以便为其中一个职业允许它(立即保存)。作用域内的条目(|dim=,|zone=)被视为已覆盖。容器不会被检查。 -
每个选项都支持
/rpessentials config set:set <option> <value>或set <file> <option> <value>(core、chat、schedule、moderation、professions、messages、rp以及其他模组提供的文件)现在可以访问任何文件的任何选项,并提供选项名称和值(true / false、允许的单词、当前值)的建议。它遵循与配置管理器相同的路径:验证、保存以及刷新文件影响的内容。如果一个选项在一个文件中出现两次,则使用其部分写入(例如DeathRP.globalToggle.enableMessage),命令会列出这些选择。列表类型的选项在一行中输入,用;分隔。旧名称(如blur、proximity、deathRpDeathSound...)仍然有效。敏感选项仍需要敏感权限级别。 -
配置管理器搜索: 搜索字段会查看每个文件中的选项名称、注释和值;文件列表显示每个文件的匹配数量,且仅打开的文件会显示匹配的选项。
-
职业编辑器: 活动标签页(制作、方块、物品、装备)的条目会在标签下方列出,类似于全局限制,带有图标、⚠ 警告、模式内容和删除功能(随职业一起保存);管理按钮位于保存按钮上方。
-
模式内容: 点击限制编辑器中的
*模式或#标签条目,将列出其包含的所有内容。 -
Discord Webhook: 员工事件会被发布到 Discord 频道。将 webhook URL(频道设置 > 集成 > Webhooks)粘贴到
discordWebhookUrl(rpessentials-core.toml的Discord Webhook部分),并通过/rpessentials discord test进行测试。每种事件类型有一个选项:discordReports、discordWarns、discordMutes、discordManage(踢出、封禁、临时封禁、赦免等)、discordDeathRp、discordSchedule(开启和关闭,计划或强制)默认开启,discordLicenses和discordNotes默认关闭。消息按顺序在线程后台发送,尊重 Discord 的速率限制,不提及任何人,消失状态下的员工操作及消失操作永远不会发送,URL 也永远不会记录到日志中。这是一个敏感选项:只有能够编辑敏感选项的员工才能在配置管理器中看到它。文本位于rpessentials-messages.toml的Discord部分(MOD模式下使用serverLanguage)。
改进
- 配置管理器: 输入的值若不符合要求(如错误的词、非数字、超出范围、非
true/false),在输入时即显示为红色;当存在错误值(红色行,聊天栏提示消息)时,“应用”按钮将不执行任何操作。↺ 重置按钮和“丢弃”按钮需二次点击确认。悬停 ℹ 图标会显示该选项的注释说明,如同悬停其名称一样。 - 保存包含空必填字段(职业 ID 或名称、角色 ID)时,该字段会被红色边框高亮并在聊天栏中给出提示,而非无任何反应。
- 玩家档案: 玩家列表以
昵称 (真实姓名)格式显示,其中昵称保留其颜色,真实姓名为灰色;选中的玩家加粗显示。“统计”标签页显示“昵称历史”,当前使用的昵称后标注(current)。“举报”标签页不再与其他标签页间距过大(所有标签页均分剩余空间)。 /rp annonce: 标题、副标题和聊天格式现在支持引用发布公告的工作人员信息({nick}、{real}、{nick_real}、{player});默认格式现在包含{nick}(移除它即可隐藏名字)。- 玩家活动:
lastconnection.json现在记录首次登录时间(对于在此前加入的玩家,下次登录时将使用其存档文件的日期)、登录次数,以及最近 35 天每天的登录次数和在线时长。 - 分组保存: 数据文件每秒最多写入一次最新数据,而非每次更改都写入(此前完全重置时会重写
licenses.json约十次)。服务器关闭时,待处理的保存内容将被写入。 - 过期警告: 仅在玩家登录时清除该玩家本人的过期警告;全局清除操作在服务器启动和关闭时执行。
- 骰子: 骰子列表仅在加载时解析一次,或在配置更改后重新解析,而非每次投掷时都解析。
- 玩家名称: Minecraft 用户名被缓存在内存中,因此保存许可证、昵称和死亡角色扮演覆盖设置时,不再需要查询每个玩家的信息。
- Tab 列表模糊效果: 重构为基于每对玩家的独立状态,仅在实际名称发生变化时才发送数据包。
- 职业限制: 重载时编译一次,并按玩家缓存。
- LuckPerms: 前缀和后缀被缓存,即使未安装 LuckPerms 也不会产生异常。
- 配置刷新: 仅重新加载受编辑文件影响的配置部分。
- 名称标签: 登录时发送一个批处理数据包,移除重复的 mixin;注册自身名称标签,但仅在原版允许时显示(例如自由视角模式)。
- 持久化:
lastconnection.json定期写入、登出时写入、关机时写入,且日期以毫秒为单位存储。 - 聊天格式:
chatMessageFormat现在作为真正的后备格式,并澄清了相关配置注释。 - 配置管理器: 当没有可应用的更改时,“丢弃”和应用按钮将处于禁用状态。
修复
-
GUI 布局: 内容现在在右侧保持与左侧相同的内边距;标签页、管理操作行、许可证按钮、备注字段、平台选择以及 Config Manager 底部区域会根据窗口宽度和按钮数量自适应,而不再溢出(Pardon 按钮和 History 标签页曾超出面板,Config Manager 底部区域曾超出底部并可能与 Close 重叠)。按钮间距为 4 px。左侧列表尽可能多地显示符合窗口高度的行数;职业编辑器在有空间时将 ID 和名称字段并排显示,使用更多的颜色列,并将角色权限排列成列,以防止任何内容被底部按钮遮挡;在较短的窗口中,配置文件的昵称颜色会变为小色块(名称显示在工具提示中);Config Manager 文件列表可滚动(滚轮或箭头)。Config Manager 行在滚动列之前停止,该列现在显示滚动指示器,“No changes / Apply”文本是其按钮的标签。两个屏幕中的昵称和职业名称调色板相同,职业名称显示与昵称相同的彩色预览(包括十六进制和渐变)。所有 GUI 中的列表均使用 Minecraft 列表组件:History、Stats、Notes 和 Manage 标签页、玩家列表、职业和角色列表、全局限制列表、限制和容器子屏幕、Config Manager 文件列表及其条目(悬停在选项名称上以阅读其注释;↺ 当值不同于默认值时变为黄色)及其列表编辑器(平滑滚动、鼠标滚轮、原版滚动条;长行换行并缩进,每隔一行略微高亮);这些列表旧的 ▲▼ 箭头已移除。Player Profile 和 Profession Editor 的左侧列表填满高度,其底部字段/New 按钮与保存按钮对齐;其行均匀分布,使 ▼ 箭头正好位于该按钮上方。
-
Config 注释: 每个显示模式选项都列出其所有值(CHAT、ACTION_BAR、TITLE、IMMERSIVE、IMMERSIVE:<preset>),
forceState命名实际命令,licenseIdDisplay显示正确的默认值,scheduleExceptions解释每个接受的值(新的OPEN值:全天开放)。 -
Profile GUI: 通过 GUI 设置的昵称现在经过与
/nick相同的检查(已使用的昵称将被拒绝,并向工作人员发送消息)。 -
受限物品: 右键点击你无法使用的物品不再在你这边播放物品动画。
-
强制关闭通知: 工作人员登录警告指向不存在的命令(
/calendar opennow);现在显示/schedule forceopen和/schedule resetforcestate。 -
时间表: 当服务器在开放时间之前启动(或已过午夜)时,玩家在关闭时间不会被踢出。现在关闭总是在打开之后触发。
-
时间表: 跨夜会话(例如 22:00 到 02:00)被认为在午夜到其关闭时间之间是开放的,即使在前一天关闭的日子里也是如此。
-
网络: 来自任何客户端的错误配置保存数据包可能导致服务器内存耗尽。
-
启动: 拼写错误的 AFK 维度(例如包含大写字母)会在启动时导致服务器崩溃;
/rp afk和带有错误维度或坐标的工作人员平台不再抛出错误。 -
冷却时间: 断开连接并重新连接不再重置正在运行的冷却时间(
/rp commerce、/rp incognito、骰子、selfnick、afk、spawn)。 -
临时许可证: 临时许可证过期时,原版职业标签现在会被移除。
-
许可证撤销: 命令不再向每个操作员发送“Removed tag”消息。
-
保存: 许可证和预配置文件在被写入保存线程之前会被复制,这避免了罕见的保存错误;
mutes.json再次保留玩家名称。 -
GUI: 预配置文件不能再获得不存在职业许可证。
-
时间表摘要 仅在更改时记录。
-
静默命令 即使在
logToStaff禁用时仍记录到控制台。 -
Tab 列表模糊:
/blurtab whitelist|blacklist|alwaysvisible add|remove现在立即应用,而不是在配置重新加载后。 -
限制模式: 在
*模式中,每隔一个字符按原样匹配,因此包含$、+、(... 的 ID 不再破坏模式。 -
静音: 当
enableChatFormat关闭时,被静音的玩家可能会再次说话;无论聊天选项如何,现在首先检查静音状态,并且在其他模组(Discord 桥接等)转发之前丢弃被静音的消息。 -
昵称: 昵称是通过官方
PlayerEvent.NameFormat的玩家的显示名称,因此它保留玩家名称的悬停卡片和点击交互,以及死亡信息、进度和显示玩家名称的每个模组中的计分板团队格式。 -
容器限制: 仅拒绝打开容器;向受限箱子放置方块现在可以正常工作。
-
死亡 RP 历史记录清理: 它仅在每分钟检查恰好落在 3:00 时运行,并且当服务器延迟时可能错过一天;现在每天凌晨 3 点或之后立即运行一次。
-
定期任务: 其中一个任务(tab 模糊、世界边界、时间表...)中的错误会被记录,并且不再阻止其他任务或影响服务器刻。
-
数据安全: 工作人员备注、临时许可证、许可证审计日志、Death RP 历史记录和自动取消白名单历史记录在其文件无法读取时开始为空,下一次保存会覆盖它们,从而丢失其内容。与其他数据文件一样,无法读取的文件现在被移到一边(
.corrupt-<time>)并保留。 -
仅接受部分选项的选项(显示模式如
zoneMessageMode、hrpMessageMode、死亡角色扮演消息模式以及scheduleDeathHoursNotifyMode,加上forceState、nametagBlurMode、blurStyle、worldBorderShape、playerChatCodes、messageSource、licenseIdDisplay以及隐身标签列表的mode):文件中拼写错误的值(HIDDE)会保留在文件中而不会被替换,此时将使用默认值;Config Manager 中该行会标红(悬停可查看预期值);管理员加入服务器及重新加载配置后会在聊天框中收到提示,同时服务器日志和/rpessentials config validate命令也会列出该错误。Config Manager 和config set命令会拒绝无效值(zoneMessageMode现已接受TITLE和IMMERSIVE:<preset>)。 -
以文本形式显示的十六进制颜色代码 (
§#RRGGBB): 职业或昵称中的十六进制颜色曾在按钮、屏幕和聊天中显示为FF8800Forgeron。客户端现在会在所有地方正确渲染这些颜色;文件中用&编写的职业颜色同样有效。 -
配置值验证:
true/false类型的选项之前会拒绝其他任何输入(拼写错误会被当作false),现在会对每个选项的值进行规则检查(允许的词汇、列表校验等),Config Manager 中也包含此检查。 -
config set zoneMessageMode: 此前拒绝了该选项实际支持的TITLE和IMMERSIVE:<preset>值。 -
未保存更改: 当没有可保存的内容时,保存按钮(职业、角色、全局限制及其列表、Config Manager、个人资料应用、角色卡、文本编辑器)会变灰;当有未保存内容时,按钮文字会加粗。关闭职业编辑器、Config Manager、玩家个人资料、角色卡或文本编辑器时,若存在未保存的更改,需要再次点击确认(“丢弃?”)。在职业编辑器中选择其他职业、角色或“新建”,或在 Config Manager 中选择其他文件,或在个人资料中选择其他玩家时,若更改尚未保存,点击项会变成“丢弃更改?”,再次点击即可打开新选项。此前表单会在无警告的情况下直接替换。
-
侧边列表: 选中的职业、角色和配置文件名称会加粗显示。
-
滚动条: 行与滚动条之间留有少量间距。
-
文本编辑器: 字符计数曾重复显示两次。
-
Manage 和 History 标签页: 其列表在分隔线上方停止,而不是延伸到 Close 按钮后面。
-
Notes 标签页: “New note” 文本不再重叠显示在笔记字段上(之前是两次);字段及其按钮与 Close 按钮对齐,且具有相同的高度。报告关闭备注也采用相同的布局。
-
允许被全局禁止的条目: 职业选择变为带有确认按钮的复选列表。
-
配置尚未加载: 在服务器配置加载完成之前保存配置值(命令、日程安排、职业编辑器)会引发错误,而旧的检查机制未能捕获此问题。
技术细节
- 新增类:
CommandToggles、ClientRestrictionHandler、NameCache、HistoryManager、RequestPlayerHistoryPacket、PlayerHistoryPacket、TeleportWarmupManager、RpTeleportEvent、RpPlaceholders。MessagesConfig.formatExpiry、支持感知视线的formatDuration、PlaytimeManager.format、getDayName以及getTimeUntilNextEvent。移除了未使用的提示框和限制行构建器。 - 类:
TabBlur、TimeHelper、ServerLang、BackupManager、ConfigValidator、RpZoneCommands、RpEssentialsAPI、ClientTooltipRestrictions、SyncTooltipPacket、SyncNametagBatchPacket。 - 移除的 Mixins:
MixinEntityRenderer和MixinPlayerListAdvancement(已合并到现有代码中)。 - 包结构: 根包下的类已移至
core、util、lang、permission、gameplay、commands、network、client和items。api包未移动,但RpEssentialsAPI现在返回属于gameplay包的DiceManager类型。 - 配置访问:
Cfg.ready(spec...)和Cfg.get(value, fallback)替代了围绕配置读取的try/catch (IllegalStateException)块。 - 标签页模糊效果: 每个玩家的名字仅解析一次并由所有查看者共享;仅查看所有玩家的查看者只检查新玩家。
- 使用官方事件替代 Mixin:
MixinServerPlayer(昵称)->PlayerEvent.NameFormat,MixinServerGamePacketListenerImpl(聊天)->ServerChatEvent(在 HIGHEST 级别静音,在 LOWEST 级别进行格式化和距离处理,位于RpChatEvents),MixinServerPlayerGameMode(容器)-> 使用setUseBlock(FALSE)的RightClickBlock。日期格式化器按模式创建一次,而非为每条消息单独创建。 - 数据文件:
JsonStore(世界中的位置、UTF-8 读取、将不可读的文件移开、分组保存);AutoUnwhitelistHistory使用了它,并且JsonStore.read保护了此前未受保护的读取操作。 - 构建系统: ModDevGradle 2.0.148 替换了 NeoGradle 7.1.9(依赖项相同,
runs/client、runs/server和runs/gameTestServer文件夹相同,Parchment 映射位于parchment_minecraft_version/parchment_mappings_version);移除了未使用的 mixin 注解处理器。更新后请在 IntelliJ 中重新加载 Gradle 项目。 - 服务器刻: 周期性任务在
TickScheduler中声明(每行一个:周期、偏移量、名称);调度逻辑已移至RpEssentialsScheduleManager.tick。 - 命令: 大约 60 个手写的
config set子命令被ConfigSetCommand(一个通用命令)取代。 - 新增类:
JsonStore、ConfigRules、RpChatEvents、TickScheduler、SaveUi、CustomColorsScreen、CharacterSheetManager、CharacterSheetScreen、SheetTextEditorScreen、RpText、CharacterSheetChangedEvent、RequestCharacterSheetPacket、CharacterSheetPacket、SaveCharacterSheetPacket、ConfigSetCommand、RestrictionCoverage、DiscordWebhook、RpDiscordCommands、ReportManager、ReportService、RpReportCommands、RequestPlayerReportsPacket、PlayerReportsPacket、ReportActionPacket。OpenPlayerProfileGuiPacket携带每位玩家未处理的报告数量。
迁移说明
- 自动配置迁移(在启动时、读取文件之前执行,位于
config/rpessentials和defaultconfigs/rpessentials;每个更改的文件首先会被复制到<name>.bak-migration,且每次更改都会以[Migration]前缀写入服务器日志):roles、luckPermsSync和luckPermsImportAllGroups从Roles移至Permissions System。staffTags的每个名称(当useLuckPermsGroups为 true 时的luckPermsStaffGroups)通过同名角色获得isStaff状态:如果该角色存在则将其加入,否则创建一个名为name;name;isStaff的角色。相同的玩家保持工作人员状态。配合 LuckPerms 和luckPermsSync,创建的角色也会创建其对应的 LuckPerms 组。- 早于 4.2.0 版本的文件:
diceRollFormat和diceRollSpyFormat从 RP 文件移至消息文件。 <world>/serverconfig/rpessentials中的按世界覆盖配置不会被迁移:如果您使用了它们,请手动更新。
- 新选项会自动添加到现有配置文件中。在生产环境服务器更新前,请审查
worldBorderShape。 messageSource默认为CONFIG:现有的自定义消息配置将继续生效。- 以
item|dim=...或item|zone=...格式编写的条目仅由服务器强制执行。
个人备注
嘿!!!你知道的,我当时觉得“这个模组不错,但感觉不够精致”,所以我决定仔细检查其中的每一个细节并修正任何看起来不好的地方, 于是我们就迎来了这个修复并添加了许多所需工具和功能的新版本! 总之,这花了我不少时间,而且我得听着 TAF (The Aura Farmer) - Horror Skunx 的歌,毕竟我是个 Z 世代男孩……祝你们度过愉快的一天!
[5.0.1]
新增
- Config Manager(配置管理器):外部模组现在可以使用
ConfigInspector.register(id, displayName, color, class, spec, onApplied)注册自己的配置文件。已注册的文件会显示在内置文件旁边的文件面板中,并提供相同的编辑、范围验证和列表编辑器功能。 - Config Manager(配置管理器):每个文件都可以拥有自己的强调色(RGB)。该颜色将应用于文件按钮以及条目面板的强调线。未指定颜色的已注册文件将保留默认的金色。
- Config Manager(配置管理器):应用更改后,可选地运行一个服务器端回调函数,以便配套模组可以重新加载其缓存的数据。
变更
ConfigGuiFilesPacket现在为每个文件携带颜色信息。客户端和服务器都必须运行版本 5.0.1。
说明
- 7 个内置配置文件保持不变。
- RpImmersion 1.1.0 是首个使用该 API 的模组。
- 如果您不使用 RpImmersion,则无需此更新!
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧