扩展与兼容模组
自 v0.5.0 起,Cultivation 与其说是一个模组,不如说更是一块地基。另一个插件可以替换整条进阶阶梯、改写每一条消息的措辞、添加一个可选种族,或注册新的功法 —— 而其余一切照常在其之上运作。
兼容是如何做到的
Cultivation 暴露了四个对玩家而言要紧的扩展点。扩展想用哪个便挑哪个,不必全都接管。
替换阶梯
模组供给自己的等级、名号与曲线。Cultivation 不再读取自己的境界,转而读取那个模组的数字。
改写全部措辞
聊天、状态栏、菜单、物品名与提示框都可以重新命名,而不改动任何一项行为。
添加种族
新种族与人族、魔族、神族并列出现在种族菜单中,并带有自己的解锁境界、加成与阴气偏向。
添加功法
第三方功法注册进内置功法所用的同一个开放注册表,并带有自己的境界门槛、灵气消耗与冷却。
扩展运行期间,你原本的 Cultivation 进度绝不会被覆写。它原封不动地垫在下面,因此移除那个扩展就会径直把你原来的境界还给你。扩展所说的「你算作哪个境界」,从不会被写进你的存档。
已知扩展
十一个扩展与 Cultivation 出自同一作者。其中十个在宝阁发售:两个免费,其余随 Cultivation 订阅附赠,且除玉简之外,它们也都可以单独买断。SoulRings 仍在开发中。每一个都要求 Hytale Update 7 服务器上的 Cultivation v0.11.0 或更高版本。
| 扩展 | 内容 | 费用 |
|---|---|---|
| 修真:玉简 · Jade Slip | 十套为每一处菜单重新上色的配色、更明亮的气息、十三面宗门旗号、十一个称号与七篇典籍。纯为外观。 | 订阅 |
| 修真:圣体 · Sacred Bodies | 十六种圣体与八种特殊体质,出生时一次掷定;另有天命所钟,一份可被夺走的季度气运。会改动平衡。 | 订阅或一次性买断 |
| 修真:天火 · Heavenly Flames | 二十二种有排名的活焰。吞噬其一,它便一直燃烧,直至有更强者将其取代。 | 订阅或一次性买断 |
| 修真:逆行 · REVERSE | 凡尘倒退:一份可选的存档,在其中杀戮、囤积与取胜会把你向下拖,而清贫、布施与落败反倒将你托起。 | 订阅或一次性买断 |
| 修真:职业 · Classes | 六大职业,各有一棵技能树、一门专属功法与一个精通称号。 | 订阅或一次性买断 |
| 修真:九死一生 · Hardcore Tribulation | 渡劫失败会耗去硬核性命;性命耗尽,道基崩裂,或境界被打落。 | 订阅或一次性买断 |
| 修真:橡皮鸭 · Rubber Duck | 一条玩笑性质的第十一道,克制所有元素,凭一只木雕鸭认领。 | 订阅或一次性买断 |
| 修真:渡劫天问 · Tribulation Karaoke | 渡劫途中上天会向你发问;把答案打回去,方能挺过。 | 订阅或一次性买断 |
| 修真:房东 · Landlord | 把洞府的灵泉租给一位房客,换取一份分成,关系闹僵时再将其驱逐。 | 免费 |
| 修真:蜗族秘境 · Snail Realm | 蜗族:迟缓、耐心,而在彻底静止时最快。 | 免费 |
| SoulRings · 斗罗大陆 | 把整条阶梯重塑为斗罗大陆的那一套。开发中,尚未发布。 | 暂未开放 |
Mermaids 是同一作者的另一款独立模组,下文另有介绍。若想深入了解其余任何一个,请点进它的链接。
展示接口能做什么的扩展
其中四个值得细看,因为它们各自倚重不同的扩展点。
一次彻底的重塑,把仙侠的阶梯换成了斗罗的那一套 —— 武魂、从被斩杀的魂兽身上吸收的魂环,以及一条 1–100 的曲线,取代了七大境界与二十八个子阶段。
它用进阶钩子替换阶梯,用主题钩子改写模组的用词,注册自己的功法,并向 Cultivation 的管理配置编辑器中添加自己的分节。宗门、阵法、洞府、斗法、炼丹、灵兽与天赋树,全都原封不动地继续在其之上运作 —— 而这正是 0.5.0 接口所为之打造的场景。见 SoulRings。
它尚未发布:没有下载,也没有商店条目,Cultivation 自己的信息页上将其标注为敬请期待。开发中的版本是 v0.1.0。
开发中同一作者把人鱼族注册为一个可选的 Cultivation 种族。它与内置三族并列出现在 /cultivation race 中,带有自己的解锁境界、属性加成与阴气偏向,且走的是与人族、魔族、神族完全相同的代码路径。
付费扩展,随 Cultivation 订阅一并附赠:十套配色,为每一处菜单、HUD 与天赋树重新上色(八套购入,两套须凭本事赢得);另有更明亮的气息、再添十三面宗门旗号、十一个装饰性称号与七篇典籍。
它纯为外观 —— 其中没有任何一样会改动修炼进度、平衡,或任何玩家能做的事,未装此扩展的服务器所玩的是一模一样的游戏。见玉简。
纯外观订阅同一作者付费扩展,可随 Cultivation 订阅取得,亦可单独买断。修士与生俱来的稀有体质。十六种圣体与八种可叠加的特殊体质,皆于玩家首次登录时掷定,此后终身相随 —— 并会重定灵气、伤害、蓄力时长、仪式与气息。自 v0.3.0 起,它还带有天命所钟:每季一份、会在玩家之间易手的气运。
与玉简不同,此扩展并非纯外观,故装之前值得先知其所为:大约每四十名修士中才有一人生具圣体,而每一种圣体、每一种特殊体质与每一项概率皆可单独关闭。它全然建于 0.7.4 所加入的常驻修正注册表之上。见圣体。
会改动平衡订阅或一次性买断同一作者安装方式与 Cultivation 相同 —— 把 jar 放进服务器的 mods\ 文件夹。Cultivation 也必须装上;扩展是在其之上延伸,而非取而代之。同一时刻只能有一个模组替换进阶阶梯。
购买之物直达游戏内
0.8.0 新增。凡在 xianxia.dev/store 的宝阁购得之物,如今在任何运行 Cultivation 的服务器上都会生效,并自带一个装饰称号。
v0.10.3 这不仅限于一次性、名称绑定的购买。有效的家族订阅,以及单独买断的扩展,都以同样的方式抵达游戏 —— 化作一个宝阁称号。不同的只是购买本身的账号绑定规则;是否在游戏内生效则并无区别。
它如何运作,以及它不做什么:
- 模组默认每 6 小时(
Check-Interval-Hours)从https://xianxia.dev/api/get/entitlements/读取一份公开的账号 ID 名单。 - 绝不会送出任何关于你服务器的信息。 它只是读取一份静态名单;没有遥测、没有服务器标识,也没有玩家名单反向传出。
- 退款会自行撤销权益,因为该账号自此不再出现在名单上。
- 它是失败即放行的。服务器离线、端点不可达或响应格式有误,都会让所有人保持原状。
WebStoreConfig.json 中的 Web-Store-Enabled 一行即可整体关闭。管理员可用 /cultivation store status 查看,或用 /cultivation store recheck 强制提前读取(有频率限制,并可用 Allow-Recheck-Command 关闭)。
权益通过与 Cultivation 自家商品完全相同的公开接口注册 —— CultivationAPI.registerStoreBenefit(StoreBenefit.builder("myMod:store:crown", "my-mod-crown")...)。你的扩展只需指明商品键,以及可选的一个待解锁称号;取回、缓存与撤销都由共用的同步逻辑代劳。见注册表。
网络商店是 0.8.0 中接入 /cultivation admin 游戏内编辑器的两个板块之一(另一个是飞升)。
兼容性说明
v0.11.0 Cultivation v0.11.0,以及与它同日发布的所有官方扩展(Jade Slip 0.4.0、Sacred Bodies 0.4.0、Heavenly Flames 0.3.0、REVERSE 0.2.0、Landlord 0.2.0、Classes 0.2.0、Hardcore Tribulation 0.2.0、Rubber Duck 0.2.0、Snail Realm 0.2.0、Tribulation Karaoke 0.2.0,SoulRings 仍在开发中,为 0.1.0),都要求 Hytale Update 7 服务器,无法在 Update 6 上运行。Update 6 服务器请继续使用它们各自的上一版本。版本表见兼容性。
| 情形 | 会发生什么 |
|---|---|
| 你移除了一个进阶扩展 | 你回到安装它之前所处的 Cultivation 境界。什么都没有被覆写。 |
| 两个扩展都想替换阶梯 | 只有一个能持有那个钩子。请一次只运行一个。 |
| 某个扩展只改写了部分措辞 | 它没改写的部分保留 Cultivation 自己的用词 —— 并且在 Cultivation 所提供的每一种语言下都仍是翻译好的。 |
| 你看到本站未曾记载的设置 | 它们属于某个扩展。任何模组都可以向 /cultivation admin 配置编辑器添加自己的分节。 |
| 某个语言包试图覆盖 Cultivation 的文本 | 它会被悄然丢弃。引擎合并语言文件是先到先得,而 Cultivation 自己的资源包总是先加载 —— 这恰恰正是主题钩子存在的理由。 |
编写你自己的扩展
上述一切皆为公开接口,并附有完整的线程规则文档。请从接口总览开始,然后:
- 编写扩展 —— 替换阶梯、改写用词,以及添加你自己的管理配置分节。
- 注册表 —— 添加种族、功法及其他开放注册表条目。
- 事件 —— 分布于 53 个类的 377 个事件,含前置与后置,涵盖模组中几乎每一项机制。
- 接口参考 —— 门面方法及其约定。
若你做了一个能与 Cultivation 配合的模组,并希望列在此处,请通过 CurseForge 页面与我们联系。