Kyokalith

插件

· 作者 TinyYana

无需改动世界生成的反 X 射线作弊:隐藏矿石在首次暴露前均为诱饵——无需任何数据包技巧或区块扫描,即可有效防范 X 射线、自由视角和种子地图作弊。

0 本站下载 0 关注 更新于 2 个月前

最新 1.5.0 · 26.2 · Bukkit / Folia

一键开服(送7天)

Kyokalith

繁體中文

永不触碰世界生成的反 X-Ray 作弊手段。 原版矿物的生成方式与以往完全一致——无需混淆数据包,无需擦除并重新生成矿物,无需扫描区块。任何被实心方块完全包裹的矿物都被视为诱饵:X-Ray、自由视角(freecam)和种子地图工具都能看到它们,但该方块是否真实只有在首次通过挖掘暴露时才会被判定。

作弊者会径直挖向他们透过墙壁看到的矿物——并击中其基岩块;而诚实玩家在洞穴壁上看到的矿物,始终是真实的。

专为 Lycohinya 生存服务器构建(并在该服务器上经过实战测试)。反 X-Ray 核心完全通用——任何 Spigot/Paper 26.2 服务器均可独立运行 Kyokalith。第二个功能(通过 OreCheckTriggerEvent 提供符合条件的矿物检查令牌)是供其他插件集成的可选接口;若未安装监听器,它将保持静默。

实际工作原理

传统的反 X-Ray 方案通常走两条路之一,各有代价:数据包混淆(会被自由视角击败且消耗 CPU)或擦除矿物并由你自己重新生成(需要扫描区块,严重降低 TPS)。Kyokalith 选择了第三条路:

  1. 世界生成不受影响。 原版矿物保留在生成时的位置。在生成时已经暴露的矿物(如洞穴壁、峡谷面)是真实的,永远不会被修改。
  2. 完全埋藏的矿物是诱饵。 它们存在于世界文件中,X-Ray 也能看到它们,但它们无法透露矿物的实际位置。
  3. 唯一的触发条件是“一个方块消失了”。 玩家挖掘、爆炸、火焰、活塞等事件发生后,在一刻钟后,Kyokalith 会检查每个被移除方块的六个面邻居。
  4. 仅处理首次暴露的邻居。 如果一个方块此前已有其他开放面(即已被看见),则它不会被处理。这条规则同时避免了两种失败模式:玩家在墙上盯着看的矿物绝不会凭空出现,且玩家已经看过的真实矿物也绝不会消失。
  5. 判定真实性。 确定性函数 f(salt, world, epoch, x, y, z, base block, dimension) 决定结果:命中 → 诱饵变为真实矿物(或普通基岩块变成矿物);未命中 → 诱饵恢复为基岩块(石头 / 深板岩 / 下界岩)。由于该方块尚未发送给任何客户端,诚实玩家根本看不到任何变化。

每次事件的开销由常数界定:移除的方块数 × 6。无扫描、无计划扫描任务、无 ChunkLoadEvent 工作。

当前的诱饵模型取代了早期基于扫描的方法(v1.0 之前的 "v0.3" 版本),后者通过数据包擦除矿物并通过扫描区块重新生成——强制加载 121 个区块导致 TPS 降至 18.9。删除整个扫描管线将其恢复至 20.1。任何“顺便扫描几个区块”的想法在此插件中都是绝对的红线。

被覆盖的矿物永远不会被重新解析

由玩家放置的方块(包括积雪/结冰形成、实体放置以及活塞目标位置)被标记为脏数据(dirty)。脏数据方块永远不会被实体化,且移除脏数据方块不会解析其邻居。

理由:如果有什么东西藏在玩家放置的方块下面,那它在被覆盖前必定已经暴露过。此规则同时阻止了“覆盖诱饵,再挖开以跳过解析”的漏洞,并保证“覆盖真实矿物,稍后挖开,它依然存在”。活塞拉走最后一个覆盖方块也算作移除——你不能用活塞窥探未解析的诱饵。

要求

服务器 Spigot 或 Paper 26.2(针对 Spigot API 编译;在生产环境中于 Paper 上运行)
Java 25
硬依赖 无
软依赖 NatureRevive(区块再生桥接,仅在存在时通过反射加载)

Kotlin 标准库和 SQLite 驱动程序由 Bukkit 库加载器在启动时下载——不打包进 jar 文件。

安装

  1. 将 Kyokalith-<version>.jar 放入 plugins/ 目录并启动服务器。
  2. 会自动生成包含所有 11 种矿物类型(包括下界矿物)的默认 config.yml——开箱即用。
  3. 首次启动会在 plugins/Kyokalith/kyokalith.db 中创建包含随机 salt 的文件。

⚠ 一旦生成,切勿删除数据库或重置 salt。 salt 是将真实矿物位置与世界种子解耦的关键;重置它会重新滚动整个世界中的所有未暴露矿脉。

升级

配置升级是自动的:新键会在启动时合并到现有的 config.yml 中并赋予默认值;你的现有值永远不会被覆盖。值得注意的是,locale 默认为 en——如果你想要其他语言,请设置 locale: zh_TW(或你自己的语言文件)。

命令

/kyokalith(别名 /kyo)。每个子命令都需要 kyokalith.admin 权限。

子命令 参数 功能 适用对象
stats – 矿物类型计数、符合条件的方块计数、挂起的区块、NatureRevive 桥接状态 控制台可用
inspect <x> <y> <z> [world] 转储指定坐标的 epoch、方块、脏数据/挂起标志以及矿脉函数结果 控制台可用
preview [radius] 或 <radius> <x> <y> <z> [world] 暴力扫描立方体区域,报告命中次数及最多 12 个示例坐标 仅限玩家
sample volume [radius] 同上扫描,仅报告 命中数 / 扫描数 仅限玩家
resolve <x> <y> <z> [world] 重新运行指定坐标的首次暴露解析(f 是确定性的,可安全重复运行) 控制台可用
suspend <cx> <cz> <reason...> 挂起某区块内的实体化过程 仅限玩家
resume <cx> <cz> 解除挂起 仅限玩家
markeligible [x y z] QA 工具:标记方块为脏数据并为其写入符合条件的令牌 仅限玩家
giveeligible <player> <oreType> <1-64> QA 工具:给予携带 PDC 令牌的矿物堆栈 控制台可用

preview(预览)/ sample(样本)半径被限制在 1..24 之间 —— 这两项是故意设置的暴力计算例外,仅限管理员使用,且永远不会出现在热路径(hot path)中。

权限

节点 默认值 效果
kyokalith.admin op 所有 /kyo 子命令
kyokalith.bypass false 持有者的挖掘不消耗检查代币,且不触发 OreCheckTriggerEvent。注意:伪装矿石解析仍然会运行 —— 这仅跳过检查路径

非生存模式(创造/旁观者/冒险)也永远不会消耗代币。

配置

config.yml 包含三个区块:locale(语言)、database(文件名、脏写回间隔),以及 ores(数据驱动的矿石定义 —— 添加一种矿石类型无需修改代码)。

你最常调整的选项是每个矿石的 cell_chance / density / preferred_y —— 这三个参数 literally 是你服务器经济的“水龙头”。完整的字段参考、命中概率公式以及红线说明请参见 docs/CONFIG.md。

没有 /kyo reload 命令;配置文件仅在 onEnable 时读取一次。

消息 / 语言

管理员命令的输出完全可定制。内置语言包:en、zh_TW。在 config.yml 中设置 locale,然后编辑 plugins/Kyokalith/lang/ 下的文件 —— 你删除的键将回退到内置文本。要添加你自己的语言,请将 lang/en.yml 复制为 lang/<name>.yml,进行翻译,并设置 locale: <name>。

面向开发者

Kyokalith 仅暴露一个集成点:OreCheckTriggerEvent —— 当处于生存模式的玩家挖掘由 Kyokalith 自身生成或追踪的矿石时同步触发。该事件可取消,其 drops 列表可重写。

管理员发放的矿石、WorldEdit 粘贴的矿石以及商店购买的矿石不携带代币,且永远不会触发此事件。精准采集会将代币转移到 ItemStack(PDC)上;放置该方块会将代币存入数据库 —— 因此一块矿石可以被交易、移动并重新挖掘,但会恰好消耗一次检查。

@EventHandler
fun onOreCheck(event: OreCheckTriggerEvent) {
    if ((1..20).random() < 15) return          // 检查失败:保留掉落物 = 原版掉落
    val bonus = event.drops.firstOrNull()?.clone() ?: return
    event.drops.add(bonus)                     // 检查通过:额外增加一件掉落物
}

事件契约、字段、确切的掉落物重写语义,以及反直觉的“取消 ≠ 无掉落”规则详见 docs/API.md。

构建

./gradlew build      # 编译 + 单元测试 + jar
./gradlew test       # 仅单元测试(矿脉功能、注册表、存储、消息)
./gradlew runServer  # 本地 Paper 26.2 测试服务器

plugin.yml 中 libraries: 里的 Kotlin 版本必须与 gradle/libs.versions.toml 匹配,否则你编译时使用的标准库和运行时加载的标准库将是不同的构建版本。

数据

单个 SQLite 文件 plugins/Kyokalith/kyokalith.db(WAL 模式)。存储 salt、每个区块的 epochs、脏位置、已放置的合格矿石以及挂起的区块。架构详情见 docs/API.md。

许可证

TinyYana Universal Software License (TYUSL) 1.0 —— 可免费使用、修改、集成和再分发,包括用于商业服务器;未经书面许可,你不得出售插件本身或将其重新打包为付费产品/服务。

TinyYana · tinyyana.com

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源