Cobblemon Ultra-Beasts

Cobblemon Ultra-Beasts

主世界中会撕开稀有的虫洞。穿过其中一个，你就会降落到究极空间，一个虚空维度，里面有一座为其建造的结构，其中等待着一只究极异兽。抓住它，或者空手而归——无论哪种方式，当你回来时虫洞都会消失。

支持 Fabric 和 NeoForge，Minecraft 1.21.1，Cobblemon 1.8.4。

运作方式

虫洞可以出现在主世界中任意玩家附近，出现时机由你控制的计时器和随机判定决定。它会以监守者的音波冲击宣告自己的到来，从天空中坠落，将碎片卷入一个坍缩的漩涡，最终稳定成一个你可以走进去的传送门。它持续一分钟，然后关闭。

走进去，你就会被带到究极空间。十座结构之一会在你周围建造起来，它的究极异兽被放置在内部，一个出口传送门会在布局的固定位置打开。你离开前的主世界位置会被保存。

要回来，走出口传送门或掉入虚空。两条路线都会把你送回你原本站立的确切位置，而结构会在你身后被拆除。

该维度的规则

一次只能有一名玩家。只要你身处其中，究极空间就会被占用，在此期间服务器上任何地方都不会生成新的虫洞。占用状态在断线后仍会保留五分钟，所以崩溃不会让你损失这次机会——但如果你没有及时回来，名额就会被释放，你将在下次登录时被送回家。

在那里没有人会死。维度内所有伤害都会被取消。没有摔落伤害，没有窒息，长时间狩猎也不会饿死。

不能建造或破坏任何东西。结构会保持生成时的原样。

究极异兽不会移动、无法被击中，也永远不会消失。它是用来捕捉的，不是用剑去战斗的——Cobblemon 对战会正常进行。

十座结构

每只究极异兽都有自己的竞技场，拥有各自的生成点、玩家到达点和出口传送门位置：

Nihilego · Kartana · Blacephalon · Pheromosa · Buzzwole · Guzzlord · Celesteela · Xurkitree · Poipole · Stakataka

你每次旅行获得哪一座是随机的。

进度

第二项会分别追踪每个物种，所以会随着你的进度逐步填充。

命令

如果已经有人身处究极空间，wormhole spawn 将拒绝执行——每次只能有一名玩家进入的规则同样适用于管理员。

wormhole clear 是紧急按钮：它会移除所有虫洞和传送门，将究极空间内的玩家送回他们的进入地点，拆除结构并释放占用状态。

配置

首次启动时，会在 config/cobblemon_ultrabeast/main.json 创建配置文件：

{
  "WORMHOLE_SPAWN_CHANCE": 2000,
  "TRY_SPAWN_INTERVAL": 400
}

TRY_SPAWN_INTERVAL 表示服务器每隔多少刻尝试生成一次虫洞。400 刻即 20 秒。

WORMHOLE_SPAWN_CHANCE 是生成概率的分母：2000 表示每次尝试时有 1/2000 的概率生成。按默认设置，单名玩家持续在线时，平均约每 11 小时会出现一个虫洞——这是有意设定的稀有概率。已有配置文件会保留其中的数值；默认值仅适用于新建的配置文件。

想要测试？将生成概率设为 1 并重新加载配置，下一个间隔就会生成虫洞。超出范围的数值会被限制在有效范围内，不会导致游戏崩溃，修正后的数值也会写回文件。

运行 /ultrabeasts reload 即可应用更改，无需重启。

从 4.0 或更早版本升级？首次启动时，旧版 config/ultrabeasts.json 会自动迁移到新位置，并重命名为 ultrabeasts.json.migrated。

客户端设置

每位玩家也会有自己的 config/cobblemon_ultrabeast/client.json，该文件仅由其本地游戏读取：

{
  "ENCOUNTER_CINEMATIC": true
}

将 ENCOUNTER_CINEMATIC 设为 false，即可跳过进入究极空间时的动画，改为短暂的黑屏淡入效果。每次进入时都会重新读取该设置，因此无需重启。

安装

1. 为 Minecraft 1.21.1 安装 Cobblemon 1.8.4 或更高版本。
2. 安装适用于你所用加载器的 Kotlin 桥接组件——Fabric 使用 Fabric Language Kotlin，NeoForge 使用 Kotlin for Forge。Cobblemon 需要此组件。
3. 将与你所用加载器相匹配的 Ultra-Beasts jar 文件放入 mods/。
4. 启动游戏。

依赖

关于世界警告的说明

由于该模组添加了自定义维度，Minecraft 会将单人游戏世界标记为使用了“实验性设置”，并在加载时显示确认界面。这是任何维度模组都会出现的正常提示，可以放心确认。需要注意的是，这类世界无法上传到 Realms。

服务器说明

究极空间的状态保存在世界存档中，因此重启不会导致玩家被困：结构、出口传送门以及当前占用状态都会保留。如果有人身处究极空间时出口传送门意外消失——例如区块卸载，或有人误用了 /kill——它会在一秒内自动恢复。究极异兽也是如此。

虫洞检查经过了限频处理，并且只要有人身处究极空间就会提前结束，因此对游戏刻循环的开销可以忽略不计。

构建

./gradlew build

Jar 文件会生成在 fabric/build/libs/ 和 neoforge/build/libs/ 中。-dev 和 -sources 的 jar 是构建产物；请发布不带这些后缀的普通版本。

标准的 Architectury 多加载器布局：共享代码位于 common/，加载器特定接线位于 fabric/ 和 neoforge/。项目使用 access widener 来访问少量原版展示实体方法，并在 NeoForge 侧以 access transformer 的形式镜像——如果你要扩展生成动画，这两个文件需要保持同步。

问题反馈

Bug 报告和建议请前往 问题追踪器。请附上你的加载器、你的 config/cobblemon_ultrabeast/main.json，以及服务端日志而非仅客户端日志——这个模组的大部分内容运行在服务端。