让服务器稳定运行，让新的玩法与工具落地。
我们负责浙江大学 Minecraft 立方社的服务器维护、插件开发与网站建设。GitHub 是代码与任务协作的平台，Wiki 用于项目介绍、资源导航和信息公开。
维护服务部署、管理面板与网络转发，并整理开发和运维经验，方便成员协作与交接。
服务器运维指南| 项目 | 主要用途 | 入口 |
|---|---|---|
| 个人主页 · mczjuPersonalPage | 用户中心前端，提供登录注册、ZJU 认证、Minecraft 角色管理、皮肤与披风衣橱、账户设置。冰船战绩等数据展示是后续拓展方向。 | 访问网站 · 代码与开发说明 |
| MC 用户服务 · mczju-user-service | 支撑个人主页的后端，负责用户与角色资料、邮箱及学信网验证，并提供 OAuth2 / OIDC 和 Yggdrasil 相关接口。 | 代码与部署说明 |
| 社团官网 · mczju-web | 使用 WordPress 展示社团、服务器与活动信息。仓库用于反馈问题和安排任务；页面设计与内容维护也欢迎没有代码基础的同学参与。目前处于无人维护状态。 | 访问官网 · 任务仓库 |
| MCZJU Wiki | 共同维护玩法介绍、教程、历史记录与部门资料，当前使用 Wiki.js；旧的 Docsify 文档保留为参考入口。 | Wiki 首页 · 编辑须知 · 旧文档仓库 |
| 项目 | 主要用途 | 入口 |
|---|---|---|
| MCZJUGameCore · MGC | 小游戏开发框架，处理等待大厅、房间、游戏生命周期、队伍、独立玩家档案、菜单与排行榜等公共逻辑，让开发者专注于玩法。 | 项目仓库 · 最简示例 |
| 具体小游戏 | 基于 MGC 持续开发和维护不同玩法，例如卡牌对局、多人反应游戏与 PvE 挑战。 | 邪恶冥刻：方块造物 · 史莱姆陷阱 · 怪物竞技场 等 |
已上线游戏的规则和游玩入口见 小游戏世界。
欢迎所有对开发小游戏感兴趣的同学参与我们的开发制作，如何上传插件、连接小游戏世界的控制台，可以问Yikuni。
| 项目 | 主要用途 | 入口 |
|---|---|---|
| MCZJUCore | 主服基础功能，集中维护服务器提示、玩家列表展示、管理员便捷命令与特殊物品保护等能力。 | 项目仓库 |
| MCZJUinfernalMobs | 炒鸡怪系统，为生物增加等级和技能词条，并提供区域规则、奖励掉落、保底与击杀统计。 | 项目仓库 · 玩法介绍 |
| MCZJUItemCreator / MCZJUMagicItems | 分别负责定制物品的定义与生成，以及特殊道具和套装效果，支撑炒鸡奖励等玩法。 | 物品生成 · 魔法道具 |
| ActionMenu | 通过虚拟容器 GUI 构建商店和功能菜单，配置交易、点击命令与动态价格，并向其他插件提供菜单接口。 | 插件本体 · 公开 API |
| MCZJUIceBoat | 管理冰船练习与比赛流程、检查点、成绩、排行榜和玩家外观设置，为冰船地图与活动提供支持。 | 项目仓库 · 冰船介绍 |
其他插件与配套工具统一收录在 自研插件总览。配置和使用细节以各项目 README 为准。
mczju-infra-docs · 运维文档 汇总服务器维护、插件开发与测试、网站管理和多人协作资料。遇到具体问题，可以从下面的 QA 直接进入对应文档。
部分 GitHub 仓库、文档和看板需要使用有访问权限的组织成员账号登录。若登录后仍显示 404，请联系Yikuni获取mczju-ops团队权限。
先浏览 运维文档首页，了解资料结构；再读 多人合作开发指南，了解分支、提交与 PR 的协作方式。当前工作方向见 工作计划与提案区。
部分文档可能存在过时的状态，开始工作前请现在大群或运维部群中确认。
参考多人合作开发指南。
如果你用Agent进行开发，也可以在完成代码后，告诉Agent：帮我提交代码到新分支并提pr。
然后你再等仓库主要维护者通过你的pr即可。
插件开发指南 按经验提供阅读路线：
不论你是否加入了运维部，我们都欢迎你来进行小游戏的开发。
推荐使用 MGC，先看 小游戏插件开发流程 和 最简示例，需要菜单、排行榜等能力时查阅 进阶指南。
MGC有codex的skill，也可以用agent辅助小游戏的开发。
先确保使用了MGC作为底层依赖，并能在自己本地的测试服跑通。第一次开发时，建议在运维部群里分享测试结果 ，并将代码上传到团队的github仓库中，先通过各种安全性确认的检查，再联系Yikuni获取上传文件到服务器和连接控制台的方法，并获得一个小游戏的op号权限。
先读 Portainer 管理面板指南，了解如何进入 MC 控制台、如何重启、查看日志；排查运行情况时可结合对应容器的日志。
对于超级管理员，找不到目标服务时，参考 管理面板中的应用程序说明。
本问题仅个人主页的管理员需要查看。
查阅 个人主页和验证系统运维手册，其中收录人工处理学信网验证、皮肤与披风维护、如何允许玩家有多个账号、账号找回等管理员操作。
社团活动、建筑展示与视频记录：MCZJU Bilibili。