SQDCLib

模组

· 作者 FlameBlingStar

关于对话、故事、状态和任务的库

2 本站下载 0 关注 更新于 5 天前

最新 3.0.1-video · 1.21.1 · NeoForge

一键开服(送7天)

SQDCLib 是用于 Minecraft NeoForge 的叙事冒险库。它不会添加新的生物、方块或装备,而是为冒险类模组提供四项基础能力:状态追踪、任务系统、对话系统和过场动画系统。该库基于 Java 21 开发,采用 MIT 许可证。

构建冒险模组时,最难的部分通常不是战斗或地图设计,而是那些无法回避的辅助工作。玩家的选择保存在哪里?界面如何得知任务已推进?分支对话逻辑被重写过多少次?谁会在过场动画中途安排任务完成?每个新项目都在重复编写同一个半成品框架,而每个模组最终都拥有自己的版本。SQDCLib 将这些核心关注点提取为一个可单独或部分使用的依赖项。这四个模块彼此解耦,支持仅使用其中某一个。

状态层

玩家状态与世界状态分别存储。玩家状态会自动同步给对应所有者,并在死亡后保留。世界状态在所有维度间共享,且在客户端为只读,以防止意外修改。提供统一的查询 API,使得条件检查无需关心标志位是存储在玩家还是世界中。

条件表达式

支持七种可嵌套的条件类型。任务目标、对话选项和过场动画分支共用一个评估器。条件也会在客户端运行。玩家状态自动同步,世界状态则通过专用的镜像数据包进行同步。

任务层

任务在数据包中定义,支持主线与支线任务、前置条件、可见性条件、目标、开始动作和完成动作。目标没有独立的“已完成”状态。是否完成由其实时计算的条件决定,因此条件和进度不会脱节。任务仅有四种状态:锁定、可用、进行中、已完成。

对话层

对话以服务器权威为准。客户端仅负责绘制界面并回传选择结果。分支选项可按条件过滤,不符合条件的选项永远不会发送给客户端,从而防止伪造。支持节点动作、自动跳转和循环保护。对话期间游戏不会暂停,玩家可通过 Esc 键退出。

过场动画层

支持关键帧摄像机、时间轴事件、淡入淡出、字幕、黑边(letterbox)和移动锁定。时间以刻(ticks)为单位计量,并提供多种缓动选项;旋转插值取最短路径。摄像机接管使用 Mixin,可能与其它修改摄像机位置的模组冲突。仅改变视角角度的模组不受影响。

跨层组合

可在对话中间插入过场动画,或在过场动画中途启动对话,在任务完成时推进故事阶段,根据任务进度显示特定选项。所有这些操作在数据包的 JSON 中只需一行代码。四个模块通过 StoryBridge 回调连接。状态层不依赖于上层模块,当对应模块缺失时,相关动作变为空操作(no-ops),因此不会出现崩溃。

集成

SQDCLib 不依赖任何第三方内容模组,仅使用官方 NeoForge API。内置三个示例数据包和调试命令,可用于冒烟测试。本库面向正在开发 NeoForge 叙事冒险模组、RPG 模组、任务模组或剧情模组的开发者。同样完全支持仅使用状态层。

构建后会得到 sqdclib jar 文件。将其放入 libs 目录,并在你自己的模组中声明依赖。具体集成步骤请参阅仓库。仓库位于 GitHub 上的 mornfire/sqdclib。需要安装与目标 NeoForge 版本兼容的 JDK。

冒险模组最难的部分通常不是玩法本身,而是那些无法避免的辅助工作。SQDCLib 将这些工作整合到一个依赖项中,让开发者能够专注于内容创作。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源