加载中
本项目为叙事互动作品开源工程。玩家可在北宋大地图上漫游、观看水浒相关剧情、收集人物与事件图鉴,并可选进行阵前卡牌对垒。
一、技术栈
构建工具为 Vite,开发语言为 TypeScript,画面渲染使用 PixiJS 8。运行时以全屏 Canvas 呈现,转场效果、云雾大地图与界面交互等均在引擎内完成。
这个作品用PixiJS的原因是想在作品中增加更多vfx特效,观察一下ai的表现。在初期开发中ai没自己下PixiJS开发使用的skill时,制作难度巨大,ai对PixiJS的理解有很大偏差,在有了skill后,不会有很大的问题。但是相较于React来说,使用PixiJS开发难度会高的多。
总结:没有特殊需求的话还是React更友好。
二、玩法概览
大地图漫游:在云雾笼罩的北宋地图上移动、选点,进入对应往事。
剧情观史:按地点与篇章阅读水浒相关叙事段落。
图鉴收集:汇总已见证的好汉与事件。
阵前对垒(可选):以卡牌形式与据点对手交锋。
三、二次创作指引
本仓库适合在保留框架的前提下替换内容与素材。
剧情文案:修改 src/data/stories.ts
地点与世界结构:修改 src/data/world.ts
好汉名录:修改 src/data/heroes.ts
对垒卡牌与相关数据:修改 src/data/card-duel/
立绘、地图、界面图:替换 assets/art/ 下对应文件
背景音乐与音效:替换 assets/audio/ 下对应文件
替换素材时请尽量保持原有路径与文件名,以免改动加载逻辑。
四、本地开发
执行 npm install 安装依赖后,运行 npm run dev,按终端提示在浏览器中打开本地地址即可预览。
五、构建与发布
执行 npm run build,产物输出至工程根目录 dist/,入口为 dist/index.html。构建完成后,可按幻光文游社区的作品发布流程提交正式版或试玩版。
常用命令:npm run dev 启动本地开发;npm run build 构建正式产物;npm run validate 执行类型检查。
六、目录结构(摘要)
src/:源码,含场景、界面、特效、进度与对垒逻辑
assets/:美术与音频等静态资源
public/:需原样拷贝的少量静态文件(如 favicon)
package.json:工程配置与脚本
更细的模块划分与修改建议见工程内 AGENTS.md。
协议是 协议。
1. src/:游戏源码 2. assets/:立绘、地图、音频等资源 3. public/:favicon 等静态文件 4. scripts/:辅助脚本 5. artgen/、docs/、shots/:参考图与文档 6. package.json、README.md、AGENTS.md、Vite/TS 配置等
请打开 lumi.66rpg.com 回帖
加载中