🧩插件 X PRISON CORE 2026.3.10.4

2026.3.10.4​

2026.3.9.2​

X-Prison 2026.3.7.0 — 自我检查可在游戏外部读取（2026-09-02）更新

API 发布。玩家不会改变任何设置，配置也不会被修改——这只是为了让仪表盘插件（以及你编写的任何插件）能够读取X-Prison已经知道的内容。

三个自我检查不再被困在聊天
/xprison的线索、/xprison的生命值和/xprison权限里，各自计算出有用的东西，然后打印到聊天中，其他任何东西都无法访问。这三者现在都已对外扩展开放：

• 配置的 linter ——附魔争夺同一个 GUI 槽位，附魔用不存在的货币定价，空的辅助镐，百分比不满的地雷，或者没有传送点的地雷。
• 启动警告摘要——插件启用时收集的警告，保持在主机滚动过后仍能阅读。
• 权限目录——X-Prison 检查的每个节点都会用简单的英语描述，由插件自身的常量生成，因此没有文档说明就无法添加节点。

仪表盘的新配置健康页面也用这个方法，显示的和 /xprison lint 一样的发现，无需玩家在游戏内运行即可。

自动排名提升、自动声望和自动重生可以为离线玩家
更改。2026.3.6.2引入的三个每位玩家切换选项存储在玩家对象上，因此只能在该玩家在线时读取或更改。现在它们也通过UUID工作，玩家不在时直接从XPrison_PlayerPreferences读取。

游戏内路径保持不变，速度也不变慢：自动排名检定依然在每次运行时从内存读取，和之前完全一样。

对于插件开发者
X-PrisonAPI 新增两个可选内容：

XPrisonAPI.getInstance（）.getDiagnosticsApi（）;lint 发现、启动警告、权限
XPrisonAPI.getInstance（）.getPlayerPreferencesApi（）;自动排档 / 自动声望 / 自动重生
这两种都是默认方法，会在旧核上抛出UnsupportedOperationException，因此针对该版本编译的插件仍会加载到旧核上——如果你支持两者，请谨慎调用。lintConfiguration（） 必须从主线程调用;偏好设置API记录了哪些读取可以接触数据库。

任何模块或插件都可以在同一偏好设置表中存储自己的开关开关，并且会自动出现在 /toggles 中。

镐子等级可以通过API再次
设置。XPrisonPickaxeLevelsAPI.setPickaxeLevel（player， item， level）返回void，意思是“这会编辑你通过的物品”。但事实并非如此：升级会重建镐——它会将关卡写入物品的NBT，重新生成显示名称并重新应用附魔背景——并交还一个新的物品堆栈。API 丢弃了这个结果，所以该层级被应用到一个栈上，但栈立即被丢弃。

结果是每个 API 调用者都默默失败。游戏内命令不受影响，因为它们直接使用管理器并保留归还物品;只有插件和仪表盘能做到。这和2026.3.1.9修复的镐头皮肤bug形状相同，只是在另一个地方。

有两件事发生了变化：

• setPickaxeLevel 现在会把重建后的物品重新存储回它找到原物品的库存槽，这样现有的插件就能在不重新编译的情况下开始工作。
• 新的withPickaxeLevel会返回重建的物品，对于持有尚未进入库存的镐的调用者——这是上述写回无法帮助的，因为没有写入槽。

准备镐子后发放：
ItemStack镐 = 新物品堆叠（Material.DIAMOND_PICKAXE）;
镐 = api.getPickaxeLevelsApi（）.withPickaxeLevel（player， pickaxe， 25）;
player.getInventory（）.addItem（镐）;
withPickaxeLevel 是默认方法，会在较旧的核心上抛出 UnsupportedOperationException，因此基于该版本编译的插件仍能加载到较旧的核心上。没有修改现有的签名，因此无需重新编译任何附加元件。参见开发者API。

如果你用插件或仪表盘的镐头创建器制作镐头，这个版本才是真正让关卡卡牢固的版本。

没有修改现有的签名，因此无需重新编译任何附加元件。参见开发者API。

2026.3.0.0 - 数据包（虚拟）方块支持

X-Prison 现在支持虚拟的、基于数据包的矿石方块——这些方块只存在于玩家的客户端和内存存储中，从不出现在服务器世界里。当安装了数据包开采插件（X-PrivateMines 的数据包模式）后，整个开采流程——自动卖出带访客税、镐子经验和方块计数器、所有区域附魔（爆炸、分层、核弹、激光束）、炸弹、任务、幸运方块和财富——对虚拟方块的作用和真实方块完全一样。

虚拟方块 API - 新的 dev.drawethree.xprison.api.virtualblocks 包允许数据包开采插件注册提供者；核心通过它来解析和移除虚拟方块。附魔插件作者可以通过 VirtualBlockProviders 支持数据包开采——见《创建自定义附魔》。

EffectiveBlocks 辅助工具会解析方块的有效类型（真实方块或虚拟方块），并将移除操作路由到提供者，所以所有开采功能都识别虚拟方块。

当没有安装数据包开采插件时，行为不会改变——每条新代码路径都经过快速空操作保护，所以现有服务器不会受影响。

我们对公共API做了一些修改，核心现已适配