--- title: "OP.GG Champion Build Builder 创作指南" description: "AI 助手和浏览器代理的创作、原始Markdown、验证和恢复参考。" language: zh-cn canonical: https://op.gg/zh-cn/lol/user-guides/help --- # OP.GG Champion Build Builder 创作指南 > 针对 AI 助手和浏览器代理的说明，解释或操作 OP.GG Champion Build Builder。 这是当前出装器的简体中文机器可读指南。 - 规范 HTML: https://op.gg/zh-cn/lol/user-guides/help - Markdown 地址: https://op.gg/zh-cn/lol/user-guides/help.md - 新建攻略地址: https://op.gg/zh-cn/lol/user-guides/new - 攻略列表地址: https://op.gg/zh-cn/lol/user-guides ## 选择创作模式 - 默认使用表单编辑器。 - 仅当用户请求源格式或大型文本编辑需要直接控制时才使用原始Markdown。 - 在加载示例或替换内容之前，请检查现有草稿和自动保存状态。 - 在发布之前始终检查预览及其验证状态。 ## 登录验证和草稿持久性 - 草稿保存在当前浏览器中，而不是您的帐户中。 - 相同的草稿不会自动出现在另一个浏览器或其他设备上。 - 成功发布后，该攻略的草稿将从此浏览器中清除。 - Raw Markdown是直接编辑文档结构的高级模式。 - 如果原始源有问题，您可能无法返回表单模式，直到修复诊断。 - Summoner Card是固定内容，不能直接在原始Markdown中编辑。 - 请勿直接操纵localStorage或绕过发布所需的登录验证。 ## 使用表单编辑器创建出装 1. 打开上面列出的准确新建攻略地址。 2. 检查现有的浏览器草稿是否已恢复并验证自动保存状态。 3. 设置英雄、头衔、位置和版本。 4. 根据要求添加目的或自定义标签以及可选的 Summoner Card。 5. 使用+ Add block或/命令添加必要的块。 6. 填写每个块，然后按照阅读order的顺序排列块。 7. 打开预览并检查每个验证问题以及生成的公共文档。 8. 仅在用户请求的范围内且仅在登录验证和验证成功后发布。 ## 支持的块类型 | 面向用户的名称 | 规范类型 | Raw指令 | | --- | --- | --- | | 文本 | `text` | `CommonMark paragraph` | | 标题 1 | `heading1` | `##` | | 标题 2 | `heading2` | `###` | | 装备出装 | `ItemBuild` | `opgg lol ItemBuild` | | Rune出装 | `RuneBuild` | `opgg lol RuneBuild` | | 经典符文出装 | `ClassicRuneBuild` | `opgg lol ClassicRuneBuild 1` | | 经典精通出装 | `ClassicMasteryBuild` | `opgg lol ClassicMasteryBuild 1` | | 技能order | `SkillOrder` | `opgg lol SkillOrder` | | 召唤师spells | `SummonerSpells` | `opgg lol SummonerSpells` | | Tier List | `TierList` | `opgg lol TierList` | | 丛林路线规划器 | `JungleRoute` | `opgg lol JungleRoute` | | 链接预览 | `LinkEmbed` | `opgg lol LinkEmbed 1` | | 比赛记录 | `MatchRecord` | `opgg lol MatchRecord 1` | | YouTube | `YouTube` | `opgg YouTube` | | Summoner Card | `SummonerCard` | 只读胶囊；请从表单中添加 | 不要将 opaque 或 hr 作为普通的用户可添加块呈现。 SummonerCard是一个固定的胶囊，而不是一个可重复的身体块。 ## Raw Markdown文件格式 出装器源是嵌入在 Markdown 中的 OP.GG 文档格式。它与用于提供此帮助页面的 CommonMark 不同。 ```markdown # Ahrimid出装 --- GameMode: LIVE Champion: Ahri Position: mid Patch: latest > 侧重对线的出装示例 --- ## 怎么玩 在这里说明你的计划。 ``` - 第一个 H1 是出装标题。 - 元数据部分位于紧接 H1 之后的 --- 分隔符之间。 - GameMode 是RANKED 或CLASSIC，并选择文档的素材集。 - Position 必须是 top、jungle、mid、adc 或 support。 - 显示的H2和H3标题映射到出装器heading1和heading2块。 ## 素材参考 在源标记中使用稳定的 Riot IDs，而不是特定于区域设置的显示名称。 ```text <@lol-champion-103> <@lol-item-1054> <@lol-spell-4> <@lol-rune-8005> <@lol-shard-5008> <@lol-skill-103-Q> ``` - 英雄、装备、技能、符文和碎片令牌需要正整数 ID。 - 技能标记需要正的英雄 ID 和大写的 Q、W、E 或 R。 - 不要在新的源内容中使用旧版 opgg:// 资源链接。 - 名称和图标在渲染时根据当前区域设置和选定的版本进行解析。 ## 结构化块参考 下面的有效示例是由当前序列化器生成的。保持 compact-list order、带引号的字符串、数字 ID 和大写 enum 不变。 ### 装备出装 (`ItemBuild`) - 使用时: 分享起始、鞋子、核心和情景装备选择 - 用户界面路径: + Add block → 装备出装，或在空段落中输入/，然后选择装备出装。 - Raw指令: `opgg lol ItemBuild` - order 中的序列化字段: `starter, boots, core, situational` - 创作要求: 使用包含正 item IDs 的串行器兼容数组 - 成功状态: 四个装备组在其序列化的order中呈现 - 常见故障: 非数组的必填字段会使 fence 无效；非正数 ID 或显示名称可能无法解析为素材 序列化器生成的有效示例: ````markdown ```opgg lol ItemBuild latest starter: [1054] boots: [3020] core: [6655,3089] situational: [] ``` ```` 常见无效示例: ````markdown ```opgg lol ItemBuild latest starter: 1054 boots: [] core: [] situational: [] ``` ```` ### Rune出装 (`RuneBuild`) - 使用时: 共享符文路径、选定的符文和属性碎片 - 用户界面路径: + Add block → Rune出装，或在空段落中输入/，然后选择Rune出装。 - Raw指令: `opgg lol RuneBuild` - order 中的序列化字段: `primaryStyle, secondaryStyle, primaryRunes, secondaryRunes, shards` - 创作要求: 保留序列化器生成的数字路径 enums 和正符文或碎片 ID - 成功状态: 路径、符文选择和碎片都会渲染 - 常见故障: 必需的符文列表不是数组，会使 fence 无效；非规范样式或引用可能无法按预期呈现 序列化器生成的有效示例: ````markdown ```opgg lol RuneBuild latest primaryStyle: 8000 secondaryStyle: 8100 primaryRunes: [8005,8009,9103,8014] secondaryRunes: [8126,8141] shards: [5008,5010,5001] ``` ```` 常见无效示例: ````markdown ```opgg lol RuneBuild latest primaryStyle: 8000 secondaryStyle: 8100 primaryRunes: 8005 secondaryRunes: [] shards: [] ``` ```` ### 经典符文出装 (`ClassicRuneBuild`) - 使用时: 共享经典 30-slot 符文页面 - 用户界面路径: + Add block → 经典符文出装，或在空段落中输入/，然后选择经典符文出装。 - Raw指令: `opgg lol ClassicRuneBuild 1` - order 中的序列化字段: `ruleset, slots` - 创作要求: 使用 CLASSIC_1 规则集，其中 slot-和-rune ID 对不超过 30 个；每个 slot 必须是 1 到 30 之间的唯一整数，每个 rune ID 必须是正整数，并且每个符文必须与其 slot 类型匹配 - 成功状态: 每个选定的经典符文都会以其匹配类型的slot进行渲染 - 常见故障: 不受支持的规则集、重复的slot、分配给不兼容的slot类型的符文或未知的JADE符文块发布 序列化器生成的有效示例: ````markdown ```opgg lol ClassicRuneBuild 1 ruleset: CLASSIC_1 slots: [[1,775253],[10,775317]] ``` ```` 常见无效示例: ````markdown ```opgg lol ClassicRuneBuild 1 ruleset: CLASSIC_1 slots: [[1,5273],[1,5317]] ``` ```` ### 经典精通出装 (`ClassicMasteryBuild`) - 使用时: 共享经典掌握树分配 - 用户界面路径: + Add block → 经典精通出装，或在空段落中输入/，然后选择经典精通出装。 - Raw指令: `opgg lol ClassicMasteryBuild 1` - order 中的序列化字段: `ruleset, ranks` - 创作要求: 使用CLASSIC_1规则集，其中mastery-ID-and-rank对不超过60个；每个积极的mastery ID可以出现一次，rank必须是1到5的整数，并且不得超过每个掌握的最大rank，必须满足先决条件，总分不得超过30分 - 成功状态: 经典掌握树中选定的第ranks渲染 - 常见故障: 不受支持的规则集、重复的掌握、无效的rank或未知的JADE掌握会阻止发布 序列化器生成的有效示例: ````markdown ```opgg lol ClassicMasteryBuild 1 ruleset: CLASSIC_1 ranks: [[512,4],[514,2]] ``` ```` 常见无效示例: ````markdown ```opgg lol ClassicMasteryBuild 1 ruleset: CLASSIC_1 ranks: [[511,1],[511,4]] ``` ```` ### 技能order (`SkillOrder`) - 使用时: 展示技能priority和逐级order - 用户界面路径: + Add block → 技能order，或在空段落中输入/，然后选择技能order。 - Raw指令: `opgg lol SkillOrder` - order 中的序列化字段: `priority, order` - 创作要求: priority和order只能包含Q、W、E和R - 成功状态: priority和序列渲染在保存的order中 - 常见故障: 未知的技能密钥会使fence无效 序列化器生成的有效示例: ````markdown ```opgg lol SkillOrder latest priority: [Q,E,W,R] order: [Q,E,W,Q,Q,R] ``` ```` 常见无效示例: ````markdown ```opgg lol SkillOrder latest priority: [Q,X,W,R] order: [Q,X] ``` ```` ### 召唤师spells (`SummonerSpells`) - 使用时: 推荐一对召唤师技能 - 用户界面路径: + Add block → 召唤师spells，或在空段落中输入/，然后选择召唤师spells。 - Raw指令: `opgg lol SummonerSpells` - order 中的序列化字段: `spells` - 创作要求: 使用正整数拼写 ID 数组 - 成功状态: 所选技能对渲染 - 常见故障: 不是数组的 spells 值会使 fence 无效；非正数 ID 或显示名称可能无法解析为 spells 序列化器生成的有效示例: ````markdown ```opgg lol SummonerSpells latest spells: [4,12] ``` ```` 常见无效示例: ````markdown ```opgg lol SummonerSpells latest spells: 4 ``` ```` ### Tier List (`TierList`) - 使用时: rank在标记行中添加英雄、装备或符文素材 - 用户界面路径: + Add block → Tier List，或在空段落中输入/，然后选择Tier List。 - Raw指令: `opgg lol TierList` - order 中的序列化字段: `schemaVersion, segment, assetType, preset, rows, unranked, ```, ## Synergy, > Teamfight impact, ```opgg lol TierList latest, schemaVersion, segment, index, ```, ### Best, Reliable pairings, ```opgg lol TierList latest, schemaVersion, segment, index, ```, ### Good, ```opgg lol TierList latest, schemaVersion, segment` - 创作要求: 至少一项有效素材必须放置在一个层中 - 成功状态: 行、调色板 ID、描述和 ranked 资源在 order 中呈现 - 常见故障: 未知的 enum、颜色 ID、重复资源或空的 rank 区域会阻止发布 序列化器生成的有效示例: ````markdown ```opgg lol TierList latest schemaVersion: 1 segment: START assetType: CHAMPION preset: SYNERGY rows: [[1,[79]],[4,[75]]] unranked: [] ``` ## Synergy > Teamfight impact ```opgg lol TierList latest schemaVersion: 1 segment: ROW index: 0 ``` ### Best Reliable pairings ```opgg lol TierList latest schemaVersion: 1 segment: ROW index: 1 ``` ### Good ```opgg lol TierList latest schemaVersion: 1 segment: END ``` ```` 常见无效示例: ````markdown ```opgg lol TierList latest schemaVersion: 1 segment: START assetType: CHAMPION preset: CUSTOM rows: [[99,[103]],[2,[]]] unranked: [] ``` ## Matchups ```opgg lol TierList latest schemaVersion: 1 segment: ROW index: 0 ``` ### S ```opgg lol TierList latest schemaVersion: 1 segment: ROW index: 1 ``` ### A ```opgg lol TierList latest schemaVersion: 1 segment: END ``` ```` ### 丛林路线规划器 (`JungleRoute`) - 使用时: 描述和比较jungle路线 - 用户界面路径: + Add block → 丛林路线规划器，或在空段落中输入/，然后选择丛林路线规划器。 - Raw指令: `opgg lol JungleRoute` - order 中的序列化字段: `map, title, plans` - 创作要求: 至少一项计划需要两次或多次访问；输入的到达时间必须严格递增 - 成功状态: ordered 路线出现在小地图和访问列表上 - 常见故障: 输入的到达时间不增加会使路线不完整 序列化器生成的有效示例: ````markdown ```opgg lol JungleRoute latest map: 1 title: "Blue-side opening" plans: [[PLAN_A,"Primary route",[[5,CLEAR,95],[4,CLEAR,120]]],[PLAN_B,"Alternative route",[]]] ``` ```` 常见无效示例: ````markdown ```opgg lol JungleRoute latest map: 1 title: "Opening" plans: [[PLAN_A,"Primary",[[5,CLEAR,120,""],[4,CLEAR,95,""]]],[PLAN_B,"Alternative",[]]] ``` ```` ### 链接预览 (`LinkEmbed`) - 使用时: 显示支持的外部页面作为预览 - 用户界面路径: + Add block → 链接预览，或在空段落中输入/，然后选择链接预览。 - Raw指令: `opgg lol LinkEmbed 1` - order 中的序列化字段: `url` - 创作要求: 使用一个语法上有效的绝对 http 或 https URL - 成功状态: 预期的链接预览解析 - 常见故障: 不安全或格式错误的 URL 会使 fence 无效；单独确认已解决的预览 序列化器生成的有效示例: ````markdown ```opgg lol LinkEmbed 1 url: "http://www.op.gg/" ``` ```` 常见无效示例: ````markdown ```opgg lol LinkEmbed 1 url: "javascript:alert(1)" ``` ```` ### 比赛记录 (`MatchRecord`) - 使用时: 引用特定 OP.GG 比赛中的一名参赛者 - 用户界面路径: + Add block → 比赛记录，或在空段落中输入/，然后选择比赛记录。 - Raw指令: `opgg lol MatchRecord 1` - order 中的序列化字段: `match` - 创作要求: 区域、game ID、正时间戳和 participant ID 从 1 through 32 必须有效 - 成功状态: 预期的球员和比赛记录负载 - 常见故障: 不受支持的区域、格式错误的game ID、时间戳或participant ID会使fence无效 序列化器生成的有效示例: ````markdown ```opgg lol MatchRecord 1 match: [KR,"KR_1234567890",1785141570000,4] ``` ```` 常见无效示例: ````markdown ```opgg lol MatchRecord 1 match: [KR,"KR_1234567890",1785141570000,0] ``` ```` ### YouTube (`YouTube`) - 使用时: 嵌入一​​个相关的 YouTube 视频 - 用户界面路径: + Add block → YouTube，或在空段落中输入/，然后选择YouTube。 - Raw指令: `opgg YouTube` - order 中的序列化字段: `videoId` - 创作要求: 使用受支持的 YouTube 视频 ID - 成功状态: 预期的视频播放器加载 - 常见故障: 无效或不受支持的视频 ID 会阻止发布 序列化器生成的有效示例: ````markdown ```opgg YouTube videoId: M7lc1UVf-VE ``` ```` 常见无效示例: ````markdown ```opgg YouTube videoId: not-a-video-id ``` ```` ## 预览和发布验证 将这些代码视为内部标识符。向用户解释恢复操作，不要只暴露代码本身。 | 内码 | 意义 | 恢复方式 | | --- | --- | --- | | `EMPTY_TITLE` | 出装标题为空。 | 输入标题。 | | `EMPTY_BODY` | 没有可发布的正文内容。 | 添加文本或支持的块。 | | `EMPTY_TIER_LIST` | Tier List没有 ranked 素材。 | 将至少一项素材移至某一层。 | | `INCOMPLETE_JUNGLE_ROUTE` | 没有路线有两次或多次访问，或者输入的到达时间不会增加。 | 完成一条路线，并修正其到达时间顺序。 | | `INCOMPATIBLE_GAME_MODE_BLOCK` | 块在文档的选定游戏模式中不可用。 | 更改 GameMode 或将该块替换为该模式支持的块。 | | `INVALID_CLASSIC_BUILD` | 经典符文slot或掌握分配违反了经典规则。 | 对于经典符文，将每个符文与其 slot 类型相匹配。对于经典精通，请将每个rank保持在该精通的最大值内，满足先决条件，并分配不超过30点。 | | `INVALID_MATCH_RECORD_FENCE` | MatchRecord 引用无效。 | 粘贴有效的第 OP.GG 匹配链接并再次解析。 | | `INVALID_LINK_EMBED_FENCE` | LinkEmbed 引用无效。 | 使用受支持格式的有效URL。 | | `INVALID_YOUTUBE_FENCE` | YouTube 引用无效。 | 使用受支持的 YouTube URL 或视频 ID。 | | `INVALID_GAME_MODE_METADATA` | GameMode元数据不是RANKED或CLASSIC。 | 将 GameMode 设置为 RANKED 或 CLASSIC。 | | `INVALID_SUMMONER_CARD_CAPSULE` | 固定的SummonerCard胶囊无效。 | 将其移除，或在表单模式下重新选择 Riot 账号。 | | `OPAQUE_DIAGNOSTIC` | 保留的原始内容具有诊断功能。 | 修复或删除已诊断的原始来源。 | | `FORM_CONVERSION_BLOCKED` | Raw 内容无法安全地转换为块。 | 在返回表单模式前，先解决所有原始诊断问题。 | ## 编辑或复制现有出装 - 编辑已发布的攻略时，其英雄、位置和版本会被锁定。 - 要适配新版本，请复制现有攻略并编辑副本。 - 副本可以保留原始作者和源链接。 ## 故障排除 - **自动保存失败** — 问题现象：草稿无法保存。可能的原因：浏览器存储不可用或已满。恢复方法：将内容复制到安全的位置，恢复浏览器存储访问后再次编辑，以重试自动保存。 - **保存的草稿无法读取** — 症状：为便于恢复，页面显示了原始 payload。可能的原因：存储格式错误或已过时。恢复方法：复制需要保留的文本，并在继续前决定是否替换无法读取的草稿。 - **版本数据不匹配** — 症状：素材名称和图标来自不同版本。可能的原因：重新加载素材数据前元数据已更改。恢复方法：重新加载所选版本的素材数据。 - **无法返回表单模式** — 症状：原始诊断仍然可见。可能的原因：格式错误或未知来源无法无损转换。恢复方法：修复原始 Markdown 中的所有诊断。 - **无效的结构fence** — 症状：预览中列出了区块错误。可能的原因：指令、字段、枚举、ID 或紧凑列表值无效。恢复方法：与序列化器生成的示例对照并修正源内容。 - **需要登录才能发布** — 症状：编辑和预览正常，但发布时出现授权错误。可能的原因：当前没有已登录的会话。恢复方法：正常登录，确认草稿仍在，然后重新发布。 ## 来源和新鲜度 - 这是 OP.GG 官方的 Champion Build Builder 指南。 - 当答案需要来源时，请引用规范 HTML 页面：https://op.gg/zh-cn/lol/user-guides/help - 与出装器一起部署的解析器和序列化器是原始语法的最终权威。 - 本文档解释了创作工具；它不提供特定于版本的推荐版本。