这是《长夜环海》的全部源码,作为开源工程放出来。
一句话介绍:一夜十六件事,十三座岛,七盏灯,七份证词。一个以故事为核心、用玩法讲故事的开放世界文游。
技术栈:原生 HTML 加 Canvas 2D,零框架、零依赖、零外部素材。整个作品就是一个 HTML 文件,四百多 KB,海面、岛屿、灯塔、人物、灯谱全部由代码绘制,没有一张图片、没有一个音频文件。
怎么跑起来:
npm run dev 起本地预览,地址是 127.0.0.1:5173
npm run build 产出 dist/
npm run validate 发布前自检
build 只做复制,不做打包和压缩——改源码即改成品,省掉了构建这一层的心智负担。
源码结构(全部在 src/index.html 里,约八千六百行):
世界层:4800×3200 的海图,十三座岛的轮廓用多边形定义,能不能上岸靠多边形判定加离岸距离,船搁浅会自动退回水面。
渲染层:单主循环,按像素预算自动降档,海面渐变做了缓存,镜头外的岛直接剔除。帧率不够时先降分辨率再降细节。
玩法层:十三种岛戏各自独立——掷骰、听钟、对棋、辨灯语、拼碎瓷、押黑市之类——共用同一套「开桌、结算、记录胜利」的接口,加一种新玩法只需要写一个函数再登记一次。
叙事层:十三段旧事、九章海史、三种结局。海史按旧事进度逐章解锁,门槛写在数据里的 need 字段,不是硬编码的分支;结局的三问只改「名字怎么处理」,不改玩法。
面板层:七个分页共用一套渲染函数和一套互斥状态,避免几个浮层同时叠在一起。
想拿走做自己的作品,建议从这三处下手:
一,换掉 ISLANDS 里的岛名、坐标和旧事文本,世界立刻变成你的。
二,十三种岛戏是独立函数,可以只留你喜欢的几种,其余从 MGAMES 里摘掉即可。
三,海史的解锁门槛在 HIST 每个条目的 need 字段里,想松想紧改数字就行。
一点说明:这是我第一次做这种尺寸的东西,代码里有很明显的赶工痕迹——单文件、没有模块化、有些函数偏长。放出来主要是给人拆着看,不敢说自己工程化做得好。二次创作、改造、拿去当模板都欢迎,转载或者商用请先跟我说一声。
如果发现 bug,或者有更干净的写法,欢迎在帖子里直接指出,我一条条改。
协议是 协议。
加载中