--- title: "OP.GG Champion Build Builder 創作指南" description: "AI 助理和瀏覽器代理的創作、原始Markdown、驗證和恢復參考。" language: zh-tw canonical: https://op.gg/zh-tw/lol/user-guides/help --- # OP.GG Champion Build Builder 創作指南 > 針對 AI 助手和瀏覽器代理的說明，解釋或操作 OP.GG Champion Build Builder。 這是目前編輯器的 繁體中文 機器可讀指南。 - 標準 HTML: https://op.gg/zh-tw/lol/user-guides/help - Markdown 網址: https://op.gg/zh-tw/lol/user-guides/help.md - 新增攻略網址: https://op.gg/zh-tw/lol/user-guides/new - 攻略列表網址: https://op.gg/zh-tw/lol/user-guides ## 選擇創作模式 - 預設使用表單編輯器。 - 僅在使用者請求來源格式或大型文字編輯需要直接控制時才使用原始Markdown。 - 在載入範例或取代內容之前，請檢查現有草稿和自動儲存狀態。 - 發布前，一定要先檢查預覽與其驗證狀態。 ## 身份驗證和草稿持久性 - 草稿保存在目前瀏覽器中，而不是您的帳戶。 - 相同的草稿不會自動出現在另一個瀏覽器或其他裝置上。 - 成功發布後，這份攻略的草稿會從此瀏覽器清除。 - Raw Markdown是直接編輯文檔結構的高級模式。 - 如果原始來源有問題，您可能無法返回表單模式，直到修復診斷。 - Summoner Card是固定內容，不能直接在原Markdown編輯。 - 不要直接操作 localStorage，也不要繞過發布所需的驗證。 ## 使用表單編輯器建立出裝 1. 開啟上方列出的正確新增攻略網址。 2. 檢查現有的瀏覽器草稿是否已恢復並驗證自動儲存狀態。 3. 設定英雄、頭銜、位置和版本。 4. 根據要求添加目的或自訂標籤以及可選的 Summoner Card。 5. 使用 + 新增區塊 或 / 指令加入必要區塊。 6. 填寫每個區塊，然後依照閱讀order排列區塊。 7. 開啟預覽並檢查每個驗證問題以及產生的公共文件。 8. 只有在使用者要求的範圍內，且驗證與登入都成功後才發布。 ## 支援的區塊類型 | 面向使用者的名稱 | 標準類型 | Raw指令 | | --- | --- | --- | | 文字 | `text` | `CommonMark paragraph` | | 標題 1 | `heading1` | `##` | | 標題 2 | `heading2` | `###` | | 裝備出裝 | `ItemBuild` | `opgg lol ItemBuild` | | 符文配置 | `RuneBuild` | `opgg lol RuneBuild` | | 經典符文出裝 | `ClassicRuneBuild` | `opgg lol ClassicRuneBuild 1` | | 經典精通出裝 | `ClassicMasteryBuild` | `opgg lol ClassicMasteryBuild 1` | | 技能order | `SkillOrder` | `opgg lol SkillOrder` | | 召喚師spells | `SummonerSpells` | `opgg lol SummonerSpells` | | 等級列表 | `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 # Ahri mid 出裝 --- 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`) - 使用時: 分享起始、鞋子、核心和情境裝備選擇 - 使用者介面路徑: + 新增區塊 → 裝備出裝，或在空白段落輸入 / 並選擇 裝備出裝。 - Raw指令: `opgg lol ItemBuild` - order 中的序列化字段: `starter, boots, core, situational` - 創作要求: 使用包含正項 ID 的序列化器相容數組 - 成功狀態: 四個裝備組依序列化順序呈現 - 常見故障: 非陣列的必填欄位會使 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: [] ``` ```` ### 符文配置 (`RuneBuild`) - 使用時: 共享符文路徑、選定的符文和能力碎片 - 使用者介面路徑: + 新增區塊 → 符文配置，或在空白段落輸入 / 並選擇 符文配置。 - 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 符文頁面 - 使用者介面路徑: + 新增區塊 → 經典符文出裝，或在空白段落輸入 / 並選擇 經典符文出裝。 - Raw指令: `opgg lol ClassicRuneBuild 1` - order 中的序列化字段: `ruleset, slots` - 創作要求: 使用 CLASSIC_1 規則集，其中 slot-和-rune ID 對不超過 30 個；每個 slot 必須是 1 到 30 之間的唯一整數，每個 rune ID 類型匹配正整數，並且每個符文必須與其 §39§§§5 - 成功狀態: 每個選定的經典符文都會以其匹配類型的slot進行渲染 - 常見故障: 不支援的規則集、重複 slot、指定到不相容 slot 類型的 rune，或未知的 JADE rune 會阻止發布 序列化器產生的有效範例: ````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`) - 使用時: 共享經典掌握樹分配 - 使用者介面路徑: + 新增區塊 → 經典精通出裝，或在空白段落輸入 / 並選擇 經典精通出裝。 - Raw指令: `opgg lol ClassicMasteryBuild 1` - order 中的序列化字段: `ruleset, ranks` - 創作要求: 使用CLASSIC_1規則集，其中mastery-ID-and-rank對不超過60個；每個積極的mastery ID可以出現一次，rank必須是1到5的整數，並且不得超過每個掌握的最大rank，必須滿足先決條件，總分不得超過30分 - 成功狀態: 經典掌握樹中選定的第ranks渲染 - 常見故障: 不支援的規則集、重複 mastery、無效 rank，或未知的 JADE mastery 會阻止發布 序列化器產生的有效範例: ````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 - 使用者介面路徑: + 新增區塊 → 技能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`) - 使用時: 推薦一對召喚師技能 - 使用者介面路徑: + 新增區塊 → 召喚師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 ``` ```` ### 等級列表 (`TierList`) - 使用時: rank在標記行中加入英雄、裝備或符文素材 - 使用者介面路徑: + 新增區塊 → 等級列表，或在空白段落輸入 / 並選擇 等級列表。 - 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 中呈現 - 常見故障: 未知列舉、顏色 ID、重複素材，或空的排序區域會阻止發布 序列化器產生的有效範例: ````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路線 - 使用者介面路徑: + 新增區塊 → 叢林路線規劃器，或在空白段落輸入 / 並選擇 叢林路線規劃器。 - 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`) - 使用時: 顯示支援的外部頁面作為預覽 - 使用者介面路徑: + 新增區塊 → 連結預覽，或在空白段落輸入 / 並選擇 連結預覽。 - 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 比賽中的一名參賽者 - 使用者介面路徑: + 新增區塊 → 比賽記錄，或在空白段落輸入 / 並選擇 比賽記錄。 - 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 視頻 - 使用者介面路徑: + 新增區塊 → 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` | 沒有路線有兩次或多次訪問，或輸入的到達時間不會增加。 | 完成一條路線並確定其到達時間order。 | | `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-tw/lol/user-guides/help - 編輯器所部署的解析器與序列化器，才是原始語法的最終權威。 - 本文件說明的是撰寫工具；不提供依版本推薦的出裝。