用 Unity Multiplayer Services…

当需要用 Unity Multiplayer Services 实现玩家实时连接、分组与交互（拓扑选择、匹配、发现、托管、会话制玩法）时，按此流程组织文档与 API 选择。

适用场景

解决思路

1. 以 Unity Multiplayer Sessions SDK 的精选文档地图（https://docs.unity.com/en-us/mps-sdk/llms.txt）作为主题、API 和指南的权威来源，优先于记忆；用它确定「有哪些文档」，用本技能的引用确定「如何应用 SDK」（Sessions 优先）；绝不要向用户提及 llms.txt 这个文件名；若该地图不可达（网络或工具问题），则以本技能的 markdown 引用加上工作区中已安装的包（Package Manager / 源码）作为具体细节的事实来源。
2. 按任务选择引用顺序：涉及拓扑、发现、匹配流程、Netcode 对齐、API 选择时，依次阅读 references/entrypoints.md（概览表、方法签名、选项表、过滤/排序枚举、QuickJoinOptions.Timeout、错误）→ references/implementation-fit.md → references/examples.md（获取面向用户的措辞）→ 遵循「Priority: Multiplayer Sessions first」→ references/workflows-prerequisites.md 获取更多细节。
3. 涉及专用游戏服务器（Unity.Services.Multiplayer.Server）时，阅读 references/dgs-entrypoint.md（IMultiplayerServerService、UNITY_SERVER / asmdef 约束、仅服务器端扩展）。
4. 仅在主 API 不足或用户明确要求底层服务客户端时，才阅读 references/underlying-services.md。
5. 当任务是在「选择」拓扑、发现、匹配流程或 Netcode 对齐（而不仅是调用 API）时，通过 references/implementation-fit.md 的流程（对话 → 项目 → 少量针对性提问）来支撑建议。
6. 主路径：基于 Unity.Services.Multiplayer，使用 IMultiplayerService / MultiplayerService.Instance 和 ISession 实现（接口概览见 references/entrypoints.md）；组合流程需与 llms.txt 保持一致。
7. 面向用户的文本：计划、权衡和澄清问题不得把 Lobby、Matchmaker、Relay 或 Multiplayer Sessions 拆分为独立命名的产品，除非用户自己这样做了——规则见 references/implementation-fit.md 中的「User-facing questions and explanations」，示例见 references/examples.md；代码、编辑和技术引用可按需使用真实的类型与命名空间名。
8. 底层客户端（Unity.Services.Lobbies、Unity.Services.Matchmaker、Unity.Services.Relay）仅在以下情况使用：(1) 检查 references/entrypoints.md 后确认目标无法通过主 API 达成，或 (2) 用户明确要求这些命名空间或产品；不要默认实现到那一层。
9. 只从本入口点读取资源；链接仅位于本技能文件夹下一层（没有 references/index.md 或 README 中心页）。
10. 按需查阅各引用文件：implementation-fit.md（从对话到项目再到用户提问的落地建议、面向用户的语言规则、需求维度：拓扑、发现、韧性、平台、网络栈）；examples.md（澄清问题与面向用户解释的前后对比示例，非代码）；entrypoints.md（IMultiplayerService、ISession、概览与能力表、方法签名、选项表（默认值、限制）、过滤/排序枚举、会话/网络/主机流程、错误、编辑器组件）；dgs-entrypoint.md（专用服务器：Unity.Services.Multiplayer.Server、IMultiplayerServerService、MultiplayerServerService / GetMultiplayerServerService、MatchmakerServerExtensions、UNITY_SERVER 与 asmdef 约束；共享的 SessionOptions 细节交由 entrypoints 说明）；workflows-prerequisites.md（按工作流列出包与云前置条件表）；underlying-services.md（回退命名空间与 IUnityServices 访问器；仅代理使用，非默认路径）。

适用边界 · 注意事项

• 不适用于排行榜、云存档或不涉及玩家间实时连接的后端功能——这些属于 build-live-game 技能。
• 当目标可通过主 API（Unity.Services.Multiplayer 的 IMultiplayerService / ISession）达成时，不要默认使用底层客户端（Lobbies、Matchmaker、Relay）。
• 不要向用户提及 llms.txt 文件名，也不要把 Lobby、Matchmaker、Relay、Multiplayer Sessions 作为独立产品向用户表述（除非用户自己这样做了）。