如何给OpenMMO贡献代码CLA签署与CI检查新手完整指南【免费下载链接】OpenMMO项目地址: https://gitcode.com/GitHub_Trending/open/OpenMMOOpenMMO 是一个用 Rust 构建、AI 智能体与人类玩家平等游玩的开源 3D MMORPG。新手给 OpenMMO 贡献代码时最容易卡住的两关是CLA 签署首个 PR 必须完成和CI 检查Rust 前端多组检查。本文带你从拉取仓库、选任务、本地自查到提交 PR 并签署 CLA一次走通整个贡献流程。认识OpenMMO你的代码会改到哪OpenMMO 是一个 Cargo Workspace 两个 Svelte 前端的应用结构贡献前先知道各模块职责选任务会快很多模块技术栈说明server/Rust Tokio WebSocket游戏服务器权威战斗逻辑、世界状态client/Svelte TypeScript Three.js玩家浏览器客户端agent-client/RustAI 智能体客户端与人类走同一套协议shared/Rust编译为 WASM服务器、客户端、智能体共享的纯逻辑代码第一步克隆仓库并跑通本地环境git clone https://gitcode.com/GitHub_Trending/open/OpenMMO cd OpenMMO环境要求Rust Cargo、Node.js npmLinux 上还需要flockutil-linux提供用于串行化 WASM 构建。关键一步——二进制资源3D 模型、音乐、音效不在 git 里先拉取一次bash tools/fetch-assets.sh然后在client/下执行npm install。完整步骤见 README.md 的 Development Setup 章节。⚠️ 地形数据需要本地烘焙约 73 GB 磁盘占用。如果你只改前端 UI 或 agent-client可以先跳过但涉及世界渲染的功能验证必须烘焙否则世界会是黑的。选任务先翻 TODO 待办清单再看进行中的 PR选错任务是新手最常见的浪费doc/TODO.md是维护者的 backlog也是最想要的工作来源——列表更新很快动手前先对照当前代码确认条目还没被做掉动手前检查开放的 PR多位贡献者并行开发一个任务可能在一天之内被别人认领较大的改动新系统、UI、设计决策建议先开一个 issue 描述方案再动手写代码。CI 会跑的 3 组检查推送前本地自查一遍CI 配置在 .github/workflows/ci.yml每个 PR 都会自动运行。提前在本地跑同样的命令可以省掉一轮推送—失败—修复的往返① Rust在仓库根目录cargo fmt --all --check cargo clippy --workspace --all-targets --locked -- -D warnings cargo test --workspace --locked-D warnings表示任何警告都会导致 CI 失败这是新手 PR 最常见的挂法。② Client在client/目录npm run build:wasm # WASM 绑定 生成数据必需见下方说明 npm test # vitest 单元测试 npm run check # svelte-check tsc npm run lint # eslint npm run format:check # prettier可用 npm run format 自动修复③ Dashboard在dashboard/目录npm ci后依次跑check/lint/test/build只在你改了 dashboard/ 时才需要关心。一个容易踩的坑WASM 产物不存入 git。修改了shared/里的 Rust 代码后必须重新npm run build:wasmCI 也会先构建再跑客户端检查。第一个 PR 的必过关卡CLA 签署流程首次提交 PR 时机器人会自动留言要求你签署 贡献者许可协议。流程很短但必须先签才能合并打开 CLA.md 通读条款核心是你授予维护者对贡献内容的版权与专利许可以保护你自己和项目的用户在 PR 评论区原样输入下面这句话机器人靠精确匹配识别I have read the CLA Document and I hereby sign the CLA机器人会在cla-signatures分支记录你的签名CLA 检查变绿即可等待合并。机器人逻辑见 .github/workflows/cla.yml——如果状态一直不更新可以再评论recheck触发复查。PR 规范来自 CONTRIBUTING.md分支名短小、kebab-case如fix-chip-through-floorcommit message 用祈使句、说明意图与现有历史风格一致PR 描述写清楚改了什么、怎么测的任务来自 TODO 清单时引用对应条目特殊提醒二进制资产走另一条路3D 模型、音乐、音效不进 git托管在外部数据集并由 assets.lock 锁定版本只有client/public下的图标等图片是直接进 PR 的。如果要提交二进制资产请按 doc/ASSETS.md 的数据集 PR 流程走并在doc/assets/对应文件中记录资源来源与许可证。常见问题速答PR 卡在 CLA 检查不动检查评论是否一字不差或补一条recheck评论。clippy 挂了但我本地没报错本地确认用的是--locked和-D warnings与 CI 完全一致。改了 shared/ 客户端没反应忘了npm run build:wasm。不知道做什么回到 doc/TODO.md 挑一个未勾选项先确认没有人在做。关键文件速查文件用途CONTRIBUTING.md贡献指南选任务、CI 检查、PR 规范CLA.md贡献者许可协议全文doc/TODO.md维护者的任务 backlog.github/workflows/ci.ymlCI 检查配置.github/workflows/cla.ymlCLA 签署机器人配置doc/ASSETS.md二进制资产贡献流程doc/devlog/README.md开发日志了解项目演进上下文照着选任务 → 本地跑通 CI 同款检查 → 提交 PR → 签署 CLA四步走你的第一个 OpenMMO PR 就能顺利合并。【免费下载链接】OpenMMO项目地址: https://gitcode.com/GitHub_Trending/open/OpenMMO创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
企业数字化 ERP 产品动态
相关推荐
STM32 ADC+DMA压力采集实战:XGZP6847A高精度采样方案 1. 为什么压力采集项目里ADC加DMA是绕不开的组合做过压力变送器、液位检测或者气路监控的朋友应该都有体会,传感器输出的模拟信号本身并不难读,难的是持续、稳定、不丢点地把数据搬进内存。XGZP6847A 这颗压力传感器在工业现场和消费类设备里出镜率很高&… · 2026/9/20 22:29:49
Java直接运行YOLOv5/v7/v8 ONNX模型实现视频目标检测 简介:本资源是一套面向Java开发者与计算机视觉初学者的跨语言目标检测集成方案,解决Java生态中难以直接调用YOLO系列深度学习模型的工程痛点。方案通过Java与Python协同架构,实现对YOLOv5/v7/v8 ONNX模型的视频流实时检测,支持RTS… · 2026/9/20 22:29:49
Python复现往复密封热弹流润滑仿真:从方程到代码 简介:面向机械工程领域研究人员与技术人员,这份Python实现完整复现了往复活塞杆密封件在瞬态工况下的热弹流润滑仿真,解析了论文中的核心建模思路。代码涵盖瞬态雷诺方程的有限差分求解、温度与压力对润滑油粘度的指数修正、Mooney-Rivlin超弹… · 2026/9/20 22:29:49
enzyme ShallowWrapper.instance() 详解:获取 React 组件实例的正确姿势 enzyme ShallowWrapper.instance() 详解:获取 React 组件实例的正确姿势 【免费下载链接】enzyme JavaScript Testing utilities for React 项目地址: https://gitcode.com/gh_mirrors/en/enzyme
本篇指南聚焦 enzyme 中 ShallowWrapper.instance() 方法&… · 2026/9/20 23:15:03
Podman 仓库中的 codescan common.Builder 深度解析:扫描状态、去重策略与嵌入继承机制 Podman 仓库中的 codescan common.Builder 深度解析:扫描状态、去重策略与嵌入继承机制 【免费下载链接】podman Podman: A tool for managing OCI containers and pods. 项目地址: https://gitcode.com/gh_mirrors/po/podman
本文是 go-openapi/codescan 库… · 2026/9/20 23:15:03
轻量级AI编程智能体pi:核心架构、技能扩展与终端实战 搞了这么久命令行工具,能让我愿意持续用下去的其实不多。pi算一个。一开始听到这个名字,我还以为是某个玩具项目,结果真正上手之后发现,它在 AI 编程智能体这个方向上做得相当克制且务实。这个工具不是要取代你的 IDE,… · 2026/9/20 23:15:03
Power BI Desktop简体中文环境构建实操手册 1. 这不是“点几下就能装好”的软件——Power BI Desktop 简体中文版的真实安装逻辑Power BI Desktop 简体中文下载与安装步骤,表面看只是个“找官网→点下载→双击运行→下一步→完成”的流程,但实际操作中,90%以上的新手会在第3步卡住&… · 2026/9/20 23:15:03
linux离线安装docker、运行容器、离线安装docker-compose 1 下载压缩包
https://download.docker.com/linux/static/stable/x86_64/ 2 安装
#解压
tar -zxvf docker-27.5.0.tgz
#复制
cp docker/* /usr/bin3 配置docker服务
#配置docker服务(没有docker.service的话创建一个)
vi /etc/systemd/system/docker.servicedocker.servi… · 2026/9/20 23:15:03
DPCM编码解码的MATLAB实现与性能分析:从预测编码原理到量化实践 简介:这是一份关于DPCM编码器与DPCM解码器MATLAB实现的完整技术文档,适合通信工程、数字信号处理等专业的课程设计或科研入门者使用,用于理解预测编码原理、Simulink仿真建模及系统性能评估。资源为单个Word文档,体积约233KB&… · 2026/9/20 23:14:03
Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化 直接铺开项目本身吧。这几个月我一直在折腾一件事:用Flutter给OpenHarmony做一款游戏集合类的App,说白了就是把若干小游戏塞进一个壳里,用统一入口分发。这个方向本身不算新鲜,真正让我花了不少心思的,是首页那堆游戏卡… · 2026/9/20 0:00:41
Word表格编号全攻略:从列表编号到题注交叉引用 写Word文档,最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事:今天在表后面多加了两个空白行,明天给客户交稿前发现整个章节的编号全部错位,光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技… · 2026/9/20 0:00:41
从第一个站到第二个站:独立开发者的静态网站选型与落地实践 1. 项目概述1.1 核心需求解析做独立开发者这几年,说实话,第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年,流量惨淡、功能臃肿、代码自己都懒得看第二遍之后,我才慢慢琢磨明白一个道理:第一个网站是练手&… · 2026/9/20 0:00:41
Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化 直接铺开项目本身吧。这几个月我一直在折腾一件事:用Flutter给OpenHarmony做一款游戏集合类的App,说白了就是把若干小游戏塞进一个壳里,用统一入口分发。这个方向本身不算新鲜,真正让我花了不少心思的,是首页那堆游戏卡… · 2026/9/20 0:00:41
Word表格编号全攻略:从列表编号到题注交叉引用 写Word文档,最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事:今天在表后面多加了两个空白行,明天给客户交稿前发现整个章节的编号全部错位,光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技… · 2026/9/20 0:00:41
从第一个站到第二个站:独立开发者的静态网站选型与落地实践 1. 项目概述1.1 核心需求解析做独立开发者这几年,说实话,第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年,流量惨淡、功能臃肿、代码自己都懒得看第二遍之后,我才慢慢琢磨明白一个道理:第一个网站是练手&… · 2026/9/20 0:00:41