Three.js 动漫3D交互小游戏 messenger-copy

「12-Three.js 动漫3D交互小游戏 漫游 ※※※」

链接：https://pan.quark.cn/s/58ef0ca0b6ad

一个非官方的学习仓库，用于复刻《Messenger》（作者 abeto）的资源、着色器与场景结构，仅作本地学习与技术研究使用。

免责声明：这不是原版游戏。本项目为 AI 辅助下的本地重构学习项目。所有原创美术、音频与设计版权均归原作者及其团队所有，详见 ATTRIBUTION.md。

---

项目简介

本项目是一个基于 SvelteKit + Three.js​ 的预览工程，包含以下特性：

• ✅ 三种场景模式：Intro（开场） / Gameplay（玩法） / NPC

• ✅ 从 reference/messenger.abeto.co/ 下载并整理的参考资源

• ✅ 移植并简化的 GLSL 材质、Draco 加载器支持

• ✅ 后期处理效果实验（Post-processing）

---

许可证说明

内容	许可
仓库代码（src/、scripts、配置文件）	MIT
参考资源（reference/、static/messenger）	归属原《Messenger》项目，未经授权请勿二次分发​

---

快速开始

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

然后在浏览器中打开：http://localhost:5173

---

参考资源工具

# 从 bundle 中发现资产 URL
pnpm reference:discover

# 下载缺失的参考文件
pnpm reference:download

# 从 JS bundle 中提取 GLSL 着色器代码
pnpm reference:shaders

参考资源目录：reference/messenger.abeto.co/

---

技术栈

• 前端框架：SvelteKit 2 / Svelte 5

• 3D 引擎：Three.js r184

• 语言：TypeScript

• 样式：Tailwind CSS

• 测试：Vitest

• 包管理：pnpm + pnpm Workspace

---

目录结构速览

.
├── src/                  # 主源码（场景、组件、逻辑）
├── reference/             # 原始游戏参考资源（仅学习用）
├── scripts/              # 资源处理脚本
├── static/               # 静态资源（含部分参考素材）
├── .vscode/              # VS Code 配置
├── vite.config.ts        # Vite 构建配置
├── tsconfig.json         # TypeScript 配置
├── package.json          # 项目元数据与脚本
├── AGENTS.md             # AI Agent 相关说明
├── ATTRIBUTION.md        # 第三方资源归属声明
└── LICENSE               # MIT 许可证

---

注意事项

• 本仓库不包含原版游戏的可运行版本

• 请勿将 reference/ 或 static/messenger/ 中的资源用于商业用途或公开分发

• 若原作者或版权方有异议，请联系删除相关内容

---

欢迎 Star / Fork 用于学习交流 🚀

如有改进建议，欢迎提交 PR 或 Issue。