中秋博饼 Godot

项目介绍

《中秋博饼》是一款由原作者开发的、以厦门和闽南地区中秋传统“博饼”为主题的 3D 休闲模拟游戏。传统活动中，亲友围坐在一起，将六枚骰子投入瓷碗，根据骰面组合决定奖项；最高奖称为“状元”，寄托着博得好彩头的节日愿望。

本仓库是该产品的 Godot 4 开源版本，延续 Unity 版本的玩法、视觉资源、音频和配置。项目包含六骰物理投掷、奖项结算、单局十投、历史最高分、开奖记录、规则界面和重玩闭环，方便参与者和 Coding Agent 继续维护与二次开发。

产品公开页面：

• TapTap：中秋博饼
• App Store：中秋博饼3D

开发环境

项目支持 macOS 和 Windows，要求 Godot 4.7 stable。不要求额外安装命令行任务工具或版本管理工具。

• macOS：Godot 标准路径通常为 /Applications/Godot.app/Contents/MacOS/Godot。
• Windows：将 GODOT 环境变量设置为 Godot EXE 的完整路径，或将 godot 加入 PATH。

首次检查、运行、打开编辑器和测试命令见 docs/development.md，运行态测试和人工验收步骤见 docs/testing.md。仓库中的 justfile 仅提供可选快捷命令，不属于环境前置条件。

参与贡献

提交代码或准备版本发布前，请阅读 CONTRIBUTING.md。项目使用中文 Conventional Commits，并在根目录 CHANGELOG.md 维护版本变化；发布版本使用 v<major>.<minor>.<patch> annotated tag。

目录约定

assets/       可复用美术与音频资源
scenes/       场景与场景级脚本
scripts/      运行时逻辑，按 domain 组织
tests/        无头可运行的确定性检查
docs/         开发流程、测试说明、资源索引和发布规范

详细协作规则和测试入口见 AGENTS.md。

许可证

版权所有 © 2026 Xiamen So Funny Technology Co., Ltd.

本项目仅对原创源代码授予 Mozilla Public License 2.0 授权，适用范围为 scripts/、场景脚本、测试脚本及文件中明确标注为 MPL 2.0 的代码文件。

assets/ 下的模型、贴图、UI、音频、HDR 和材质资源，以及场景文件、项目配置、文档和其他非代码内容，不包含在 MPL 2.0 授权范围内，均由项目作者保留全部权利。 资产目录和权利边界见 ASSET_LICENSES.md。 未经作者另行书面许可，不得复制、修改、再分发或用于商业用途。

Godot 4.7 作为外部开发工具使用，不包含在本仓库中。开源发布前请确认许可证文件、资产权利说明和项目引用完整有效。