[{"data":1,"prerenderedAt":1399},["ShallowReactive",2],{"navigation_docs":3,"-snowygems-troubleshooting":60,"-snowygems-troubleshooting-surround":1394},[4],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":59},"SnowyGems","i-lucide-gem","\u002Fsnowygems","1.snowygems",[10,15,20,24,29,34,39,44,49,54],{"title":11,"path":12,"stem":13,"icon":14},"安装与快速上手","\u002Fsnowygems\u002Fgetting-started","1.snowygems\u002F1.getting-started","i-lucide-rocket",{"title":16,"path":17,"stem":18,"icon":19},"版本更新与公告","\u002Fsnowygems\u002Fupdate","1.snowygems\u002F10.update","i-lucide-bell-ring",{"title":21,"path":22,"stem":23,"icon":6},"宝石配置","\u002Fsnowygems\u002Fgems","1.snowygems\u002F2.gems",{"title":25,"path":26,"stem":27,"icon":28},"技能与 BUFF","\u002Fsnowygems\u002Fskills","1.snowygems\u002F3.skills","i-lucide-sparkles",{"title":30,"path":31,"stem":32,"icon":33},"菜单配置","\u002Fsnowygems\u002Fmenus","1.snowygems\u002F4.menus","i-lucide-layout-grid",{"title":35,"path":36,"stem":37,"icon":38},"多版本兼容","\u002Fsnowygems\u002Fcompat","1.snowygems\u002F5.compat","i-lucide-git-compare",{"title":40,"path":41,"stem":42,"icon":43},"排错与调试","\u002Fsnowygems\u002Ftroubleshooting","1.snowygems\u002F6.troubleshooting","i-lucide-wrench",{"title":45,"path":46,"stem":47,"icon":48},"汉化与文案自定义","\u002Fsnowygems\u002Flanguage","1.snowygems\u002F7.language","i-lucide-languages",{"title":50,"path":51,"stem":52,"icon":53},"查看与拆卸宝石","\u002Fsnowygems\u002Fdismantle","1.snowygems\u002F8.dismantle","i-lucide-unplug",{"title":55,"path":56,"stem":57,"icon":58},"权限节点","\u002Fsnowygems\u002Fpermissions","1.snowygems\u002F9.permissions","i-lucide-shield-check",false,{"id":61,"title":40,"body":62,"description":1385,"extension":1386,"links":1387,"meta":1388,"navigation":1389,"path":41,"seo":1390,"stem":42,"__hash__":1393},"docs\u002F1.snowygems\u002F6.troubleshooting.md",{"type":63,"value":64,"toc":1351},"minimark",[65,68,77,80,84,130,132,136,142,375,382,429,437,439,442,445,449,455,461,494,508,512,517,528,536,540,545,573,578,582,587,602,606,611,647,654,658,663,676,684,689,739,743,765,769,778,791,801,828,833,837,842,855,857,865,872,929,932,934,937,943,1021,1038,1040,1043,1047,1054,1075,1079,1084,1088,1095,1099,1105,1109,1119,1121,1124,1127,1236,1253,1255,1258,1263,1269,1272,1308,1310,1313,1316,1336,1347],[66,67,40],"h1",{"id":40},[69,70,71,72,76],"p",{},"宝石类插件最难排查的问题是",[73,74,75],"strong",{},"静默失效","：镶嵌成功了，也没报错，但装备上什么都没变。本页按「先看什么、再看什么」的顺序整理排查路径。",[78,79],"hr",{},[81,82,83],"h2",{"id":83},"排查三步",[85,86,87,91,102,105,109,115,118,121,127],"steps",{},[88,89,90],"h3",{"id":90},"跑配置自检",[92,93,98],"pre",{"className":94,"code":96,"language":97},[95],"language-text","\u002Fsgem reload\n\u002Fsgem compat all\n","text",[99,100,96],"code",{"__ignoreMap":101},"",[69,103,104],{},"自检会列出所有「写错的条目」（含拼写建议）和「当前版本不支持所以跳过的条目」。大部分问题在这一步就能定位。",[88,106,108],{"id":107},"开对应的-debug-tag","开对应的 debug tag",[92,110,113],{"className":111,"code":112,"language":97},[95],"\u002Fsgem debug Reward,GemManager      # 镶嵌相关\n\u002Fsgem debug Skill,SkillExec        # 技能相关\n\u002Fsgem debug Menu,Workbench         # 菜单相关\n\u002Fsgem debug Buff                   # 常驻 BUFF\n",[99,114,112],{"__ignoreMap":101},[69,116,117],{},"日志会打印每一步的判定过程和结果，包括「为什么这条没生效」。",[88,119,120],{"id":120},"看完关掉",[92,122,125],{"className":123,"code":124,"language":97},[95],"\u002Fsgem debug all      # 恢复输出全部 tag\n\u002Fsgem debug          # 切换总开关\n",[99,126,124],{"__ignoreMap":101},[69,128,129],{},"日志量很大，排查完记得关。",[78,131],{},[81,133,135],{"id":134},"debug-tag-清单","debug tag 清单",[69,137,138,141],{},[99,139,140],{},"\u002Fsgem debug \u003Ctag>[,\u003Ctag>]"," 可只看指定范围。",[143,144,145,158],"table",{},[146,147,148],"thead",{},[149,150,151,155],"tr",{},[152,153,154],"th",{},"tag",[152,156,157],{},"覆盖范围",[159,160,161,172,182,195,205,215,225,245,255,265,275,285,295,305,315,325,335,345,355,365],"tbody",{},[149,162,163,169],{},[164,165,166],"td",{},[99,167,168],{},"Registry",[164,170,171],{},"配置文件加载（宝石\u002F菜单\u002F技能）",[149,173,174,179],{},[164,175,176],{},[99,177,178],{},"Compat",[164,180,181],{},"版本兼容层：注册表快照、物品分类、能力探测",[149,183,184,189],{},[164,185,186],{},[99,187,188],{},"Command",[164,190,191,194],{},[99,192,193],{},"\u002Fsgem"," 各子命令",[149,196,197,202],{},[164,198,199],{},[99,200,201],{},"Menu",[164,203,204],{},"工作台菜单的点击\u002F拖拽\u002F关闭\u002F镶嵌",[149,206,207,212],{},[164,208,209],{},[99,210,211],{},"Workbench",[164,213,214],{},"菜单的打开与图标渲染",[149,216,217,222],{},[164,218,219],{},[99,220,221],{},"Embed",[164,223,224],{},"内置镶嵌台的放入\u002F校验\u002F镶嵌",[149,226,227,232],{},[164,228,229],{},[99,230,231],{},"GUI",[164,233,234,237,238,237,241,244],{},[99,235,236],{},"\u002Fsgem view","、",[99,239,240],{},"\u002Fsgem inspect",[99,242,243],{},"\u002Fsgem dismantle"," 三个面板",[149,246,247,252],{},[164,248,249],{},[99,250,251],{},"GemUse",[164,253,254],{},"右键\u002F食用直接使用宝石",[149,256,257,262],{},[164,258,259],{},[99,260,261],{},"Protect",[164,263,264],{},"宝石防放置保护",[149,266,267,272],{},[164,268,269],{},[99,270,271],{},"GemManager",[164,273,274],{},"镶嵌\u002F拆除\u002F给予的核心逻辑",[149,276,277,282],{},[164,278,279],{},[99,280,281],{},"Dismantle",[164,283,284],{},"拆卸宝石的扣费与损坏判定",[149,286,287,292],{},[164,288,289],{},[99,290,291],{},"ItemFactory",[164,293,294],{},"宝石物品构建与 NBT 读写",[149,296,297,302],{},[164,298,299],{},[99,300,301],{},"Reward",[164,303,304],{},"奖励函数执行",[149,306,307,312],{},[164,308,309],{},[99,310,311],{},"Skill",[164,313,314],{},"技能触发判定",[149,316,317,322],{},[164,318,319],{},[99,320,321],{},"SkillExec",[164,323,324],{},"技能函数执行",[149,326,327,332],{},[164,328,329],{},[99,330,331],{},"Buff",[164,333,334],{},"BUFF 定时引擎",[149,336,337,342],{},[164,338,339],{},[99,340,341],{},"Points",[164,343,344],{},"点券账户",[149,346,347,352],{},[164,348,349],{},[99,350,351],{},"Money",[164,353,354],{},"Vault 经济",[149,356,357,362],{},[164,358,359],{},[99,360,361],{},"PlayerPoints",[164,363,364],{},"PlayerPoints 对接过程",[149,366,367,372],{},[164,368,369],{},[99,370,371],{},"Update",[164,373,374],{},"版本更新检测与公告拉取",[69,376,377,378,381],{},"也可以在 ",[99,379,380],{},"config.yml"," 里持久化：",[92,383,387],{"className":384,"code":385,"language":386,"meta":101,"style":101},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Debug: true\nDebugTags: [Reward, GemManager]\n","yaml",[99,388,389,406],{"__ignoreMap":101},[390,391,394,398,402],"span",{"class":392,"line":393},"line",1,[390,395,397],{"class":396},"swJcz","Debug",[390,399,401],{"class":400},"sMK4o",":",[390,403,405],{"class":404},"sfNiH"," true\n",[390,407,409,412,414,417,420,423,426],{"class":392,"line":408},2,[390,410,411],{"class":396},"DebugTags",[390,413,401],{"class":400},[390,415,416],{"class":400}," [",[390,418,301],{"class":419},"sfazB",[390,421,422],{"class":400},",",[390,424,425],{"class":419}," GemManager",[390,427,428],{"class":400},"]\n",[430,431,433,434,436],"alert",{"icon":432},"i-lucide-lightbulb","BUFF 引擎每秒跑一次，",[99,435,331],{}," tag 会疯狂刷屏。插件对重复内容做了去重（同样的内容不重复输出），但换个装备或换个玩家就会再打一次。排查完立刻关掉。",[78,438],{},[81,440,441],{"id":441},"静默失效的常见原因",[69,443,444],{},"按遇到频率排序。",[88,446,448],{"id":447},"_1-attribute-的-limit-与-var-方向不同号","1. Attribute 的 limit 与 var 方向不同号",[69,450,451,454],{},[73,452,453],{},"症状","：属性宝石镶嵌「成功」，提示也发了，但装备属性没变。",[69,456,457,460],{},[99,458,459],{},"limit"," 是「能加到的极限值」，不是「加多少次」。减法必须配负 limit：",[92,462,464],{"className":384,"code":463,"language":386,"meta":101,"style":101},"# 错：第一次算出 -0.1，被 coerce 夹回 0.3 以内，等于没变化\n- Attribute{name=scale;operation=0;slot=any;var=v-0.1;limit=0.3}\n# 对\n- Attribute{name=scale;operation=0;slot=any;var=v-0.1;limit=-0.3}\n",[99,465,466,472,480,486],{"__ignoreMap":101},[390,467,468],{"class":392,"line":393},[390,469,471],{"class":470},"sHwdD","# 错：第一次算出 -0.1，被 coerce 夹回 0.3 以内，等于没变化\n",[390,473,474,477],{"class":392,"line":408},[390,475,476],{"class":400},"-",[390,478,479],{"class":419}," Attribute{name=scale;operation=0;slot=any;var=v-0.1;limit=0.3}\n",[390,481,483],{"class":392,"line":482},3,[390,484,485],{"class":470},"# 对\n",[390,487,489,491],{"class":392,"line":488},4,[390,490,476],{"class":400},[390,492,493],{"class":419}," Attribute{name=scale;operation=0;slot=any;var=v-0.1;limit=-0.3}\n",[69,495,496,499,500,503,504,507],{},[73,497,498],{},"排查","：",[99,501,502],{},"\u002Fsgem debug Reward","，日志会打印 ",[99,505,506],{},"Attribute(scale) 未生效: 已叠加值=0.0 已达上限或无变化(limit=0.3)","。",[88,509,511],{"id":510},"_2-buff-宝石与-buff-定义的标记不一致","2. BUFF 宝石与 BUFF 定义的标记不一致",[69,513,514,516],{},[73,515,453],{},"：BUFF 宝石镶嵌成功，装备 lore 上也有那行字，但没有任何效果。",[69,518,519,520,523,524,527],{},"宝石 ",[99,521,522],{},"LoreAdd{lore=...}"," 写的文本必须和 BUFF 定义的 ",[99,525,526],{},"Lore:"," 一致（去色后比较）。",[69,529,530,499,532,535],{},[73,531,498],{},[99,533,534],{},"\u002Fsgem debug Buff","，如果日志里从来没有「命中 BUFF 定义」，就是标记对不上。",[88,537,539],{"id":538},"_3-技能行漏写触发标记","3. 技能行漏写触发标记",[69,541,542,544],{},[73,543,453],{},"：技能完全不触发。",[92,546,548],{"className":384,"code":547,"language":386,"meta":101,"style":101},"# 错：没有 ~onUse，永远不会被触发\n- Blink{distance=32} @Forward\n# 对\n- Blink{distance=32} ~onUse @Forward\n",[99,549,550,555,562,566],{"__ignoreMap":101},[390,551,552],{"class":392,"line":393},[390,553,554],{"class":470},"# 错：没有 ~onUse，永远不会被触发\n",[390,556,557,559],{"class":392,"line":408},[390,558,476],{"class":400},[390,560,561],{"class":419}," Blink{distance=32} @Forward\n",[390,563,564],{"class":392,"line":482},[390,565,485],{"class":470},[390,567,568,570],{"class":392,"line":488},[390,569,476],{"class":400},[390,571,572],{"class":419}," Blink{distance=32} ~onUse @Forward\n",[69,574,575,577],{},[73,576,498],{},"：配置自检会直接报「这一行没有写触发标记，永远不会被触发」。",[88,579,581],{"id":580},"_4-技能定义没写-lore","4. 技能定义没写 Lore",[69,583,584,586],{},[73,585,453],{},"：装备拿在手里，技能不触发。",[69,588,589,590,593,594,597,598,601],{},"技能靠装备 lore 文本绑定。",[99,591,592],{},"Lore"," 留空的定义不会被任何装备触发（只能作为 ",[99,595,596],{},"Switch"," 的目标形态或被 ",[99,599,600],{},"Reward{}"," 嵌套调用）。",[88,603,605],{"id":604},"_5-playergem-用了作用于物品的奖励","5. PlayerGem 用了作用于物品的奖励",[69,607,608,610],{},[73,609,453],{},"：右键饮用\u002F使用后，提示发了但没效果。",[69,612,613,616,617,237,620,237,623,237,626,629,630,237,633,237,636,237,639,237,641,237,644,507],{},[99,614,615],{},"PlayerGem"," 没有目标物品，不能用 ",[99,618,619],{},"Attribute",[99,621,622],{},"Enchant",[99,624,625],{},"LoreAdd",[99,627,628],{},"Unbreakable"," 等。只能用 ",[99,631,632],{},"MaxHealth",[99,634,635],{},"ExpLevel",[99,637,638],{},"Point",[99,640,351],{},[99,642,643],{},"ItemGive",[99,645,646],{},"ItemTake",[69,648,649,499,651,653],{},[73,650,498],{},[99,652,502],{},"，日志会打印「本次操作没有目标物品」。",[88,655,657],{"id":656},"_6-用了当前版本不存在的内容","6. 用了当前版本不存在的内容",[69,659,660,662],{},[73,661,453],{},"：某些宝石在 A 服正常，在 B 服无效。",[69,664,665,499,667,670,671,675],{},[73,666,498],{},[99,668,669],{},"\u002Fsgem compat"," 对比两个服的能力清单。这属于",[672,673,674],"a",{"href":36},"正常行为","，不是 bug。",[88,677,679,680,683],{"id":678},"_7-lore-引用的标记与自身-lore-不一致","7. ",[99,681,682],{},"$LORE:"," 引用的标记与自身 Lore 不一致",[69,685,686,688],{},[73,687,453],{},"：可叠加等级的 BUFF 等级永远是 1，不涨。",[92,690,692],{"className":384,"code":691,"language":386,"meta":101,"style":101},"抗性提升:\n  Lore: \"&6&l[&c&lBUFF&6&l] &b&l抗性提升 \"\n  Skills:\n    # $LORE: 里必须写去色后的形式，且和上面 Lore 一致\n    - Potion{type=resistance;level=$LORE:[BUFF] 抗性提升?1$} ~onTimer\n",[99,693,694,702,718,725,730],{"__ignoreMap":101},[390,695,696,699],{"class":392,"line":393},[390,697,698],{"class":396},"抗性提升",[390,700,701],{"class":400},":\n",[390,703,704,707,709,712,715],{"class":392,"line":408},[390,705,706],{"class":396},"  Lore",[390,708,401],{"class":400},[390,710,711],{"class":400}," \"",[390,713,714],{"class":419},"&6&l[&c&lBUFF&6&l] &b&l抗性提升 ",[390,716,717],{"class":400},"\"\n",[390,719,720,723],{"class":392,"line":482},[390,721,722],{"class":396},"  Skills",[390,724,701],{"class":400},[390,726,727],{"class":392,"line":488},[390,728,729],{"class":470},"    # $LORE: 里必须写去色后的形式，且和上面 Lore 一致\n",[390,731,733,736],{"class":392,"line":732},5,[390,734,735],{"class":400},"    -",[390,737,738],{"class":419}," Potion{type=resistance;level=$LORE:[BUFF] 抗性提升?1$} ~onTimer\n",[88,740,742],{"id":741},"_8-改了配置没重载","8. 改了配置没重载",[69,744,745,746,749,750,237,752,237,755,237,758,761,762,507],{},"只有 ",[99,747,748],{},"lang.yml"," 是热重载的（保存即生效）。",[99,751,380],{},[99,753,754],{},"gems\u002F",[99,756,757],{},"skills\u002F",[99,759,760],{},"gui\u002F"," 都需要 ",[99,763,764],{},"\u002Fsgem reload",[88,766,768],{"id":767},"_9-拆卸后-buff-的-lore-标记还在","9. 拆卸后 BUFF 的 lore 标记还在",[69,770,771,773,774,777],{},[73,772,453],{},"：拆掉 BUFF 宝石后，装备上的 ",[99,775,776],{},"[BUFF] xxx"," 那行字还在，BUFF 效果也还生效。",[69,779,780,781,783,784,783,787,790],{},"这是预期行为。拆卸会撤销属性与附魔，但 lore 类奖励（",[99,782,625],{}," \u002F ",[99,785,786],{},"LoreVar",[99,788,789],{},"Name","）不自动撤销——玩家可能在中间镶过别的宝石改动过 lore，自动撤销容易误删。",[69,792,793,796,797,800],{},[73,794,795],{},"处理","：在宝石里用 ",[99,798,799],{},"$onRemove"," 显式清除：",[92,802,804],{"className":384,"code":803,"language":386,"meta":101,"style":101},"Rewards:\n  - LoreAdd{lore=&6&l[&c&lBUFF&6&l] &b&l发光}\n  - LoreReplace{old=&6&l[&c&lBUFF&6&l] &b&l发光;new=} $onRemove\n",[99,805,806,813,821],{"__ignoreMap":101},[390,807,808,811],{"class":392,"line":393},[390,809,810],{"class":396},"Rewards",[390,812,701],{"class":400},[390,814,815,818],{"class":392,"line":408},[390,816,817],{"class":400},"  -",[390,819,820],{"class":419}," LoreAdd{lore=&6&l[&c&lBUFF&6&l] &b&l发光}\n",[390,822,823,825],{"class":392,"line":482},[390,824,817],{"class":400},[390,826,827],{"class":419}," LoreReplace{old=&6&l[&c&lBUFF&6&l] &b&l发光;new=} $onRemove\n",[69,829,830,831,507],{},"详见",[672,832,50],{"href":51},[88,834,836],{"id":835},"_10-玩家用不了某个命令","10. 玩家用不了某个命令",[69,838,839,841],{},[73,840,453],{},"：提示没有权限。",[69,843,844,845,848,849,852,853,507],{},"每个子命令都有独立权限节点。先确认 ",[99,846,847],{},"snowygems.command","（主命令基础权限）没被显式设为 ",[99,850,851],{},"false","——它被否定后所有子命令都失效。详见",[672,854,55],{"href":56},[78,856],{},[81,858,860,861,864],{"id":859},"不生效但不是-bug-的情况","不生效但",[73,862,863],{},"不是"," bug 的情况",[69,866,867,868,871],{},"这几种「没变化」是插件的",[73,869,870],{},"有意设计","，避免玩家白吃宝石：",[143,873,874,884],{},[146,875,876],{},[149,877,878,881],{},[152,879,880],{},"场景",[152,882,883],{},"行为",[159,885,886,896,904,914,921],{},[149,887,888,893],{},[164,889,890,891],{},"属性已达 ",[99,892,459],{},[164,894,895],{},"视为未生效，宝石不消耗",[149,897,898,901],{},[164,899,900],{},"附魔已经是目标等级",[164,902,903],{},"视为未生效",[149,905,906,912],{},[164,907,908,911],{},[99,909,910],{},"level=0"," 但物品本来就没这个附魔",[164,913,903],{},[149,915,916,919],{},[164,917,918],{},"耐久已满还用修复宝石",[164,920,903],{},[149,922,923,926],{},[164,924,925],{},"生命已满还用治疗技能",[164,927,928],{},"返回 false",[69,930,931],{},"日志里会明确写「视为未生效」，不用怀疑是坏了。",[78,933],{},[81,935,936],{"id":936},"已知的不生效字段",[69,938,939,940,499],{},"以下字段会被解析，但代码里没有任何地方读取它们做判断——",[73,941,942],{},"写了不起作用",[143,944,945,958],{},[146,946,947],{},[149,948,949,952,955],{},[152,950,951],{},"位置",[152,953,954],{},"字段",[152,956,957],{},"说明",[159,959,960,975,987,999],{},[149,961,962,964,968],{},[164,963,21],{},[164,965,966],{},[99,967,221],{},[164,969,970,971,974],{},"不限制镶嵌数量，也不影响拆卸。示例里写 ",[99,972,973],{},"Embed: 1"," 只是占位",[149,976,977,979,984],{},[164,978,30],{},[164,980,981],{},[99,982,983],{},"Page",[164,985,986],{},"没有翻页功能",[149,988,989,991,996],{},[164,990,30],{},[164,992,993],{},[99,994,995],{},"Locations",[164,997,998],{},"没有「在世界坐标放置工作台」的功能",[149,1000,1001,1003,1008],{},[164,1002,21],{},[164,1004,1005],{},[99,1006,1007],{},"RemoveTip",[164,1009,1010,1011,1013,1014,1017,1018,1020],{},"拆卸提示当前走 ",[99,1012,748],{}," 的 ",[99,1015,1016],{},"dismantle.*","，宝石级的 ",[99,1019,1007],{}," 仅在部分路径生效",[69,1022,1023,1024,237,1027,237,1030,1033,1034,1037],{},"菜单类型里的 ",[99,1025,1026],{},"PAGE_PREV",[99,1028,1029],{},"PAGE_NEXT",[99,1031,1032],{},"PAGE_TIP"," 同理——它们和 ",[99,1035,1036],{},"TIP"," 的行为完全一样（纯装饰），是为将来的翻页功能预留的名字。",[78,1039],{},[81,1041,1042],{"id":1042},"报错日志怎么读",[88,1044,1046],{"id":1045},"配置自检发现-n-处写错的条目","「配置自检发现 N 处写错的条目」",[69,1048,1049,1050,1053],{},"后面跟着 ",[99,1051,1052],{},"[文件.yml -> 宝石ID] 函数{参数} -> 原因","。想看完整明细：",[1055,1056,1057,1063],"ul",{},[1058,1059,1060],"li",{},[99,1061,1062],{},"\u002Fsgem compat all",[1058,1064,1065,1066,1013,1068,1071,1072],{},"或把 ",[99,1067,380],{},[99,1069,1070],{},"Compat.OnMissingFeature"," 改成 ",[99,1073,1074],{},"warn",[88,1076,1078],{"id":1077},"配置中有-n-处内容当前版本不支持已跳过","「配置中有 N 处内容当前版本不支持，已跳过」",[69,1080,1081,1082,507],{},"正常提示，不是错误。想看是哪些，用 ",[99,1083,1062],{},[88,1085,1087],{"id":1086},"未注册的技能函数-xxx-你是不是想写-yyy","「未注册的技能函数: XXX —— 你是不是想写: YYY?」",[69,1089,1090,1091,1094],{},"函数名拼错了，按建议改。全部函数用 ",[99,1092,1093],{},"\u002Fsgem skills"," 查。",[88,1096,1098],{"id":1097},"require-条目-xxx-既不是当前版本的物品名也不是可用的分类关键字","「Require 条目 'XXX' 既不是当前版本的物品名，也不是可用的分类关键字」",[69,1100,1101,1102,1104],{},"分类关键字拼错。可用分类清单在同一条日志的括号里，也可用 ",[99,1103,1062],{}," 查看。",[88,1106,1108],{"id":1107},"附魔-xxx-不在当前版本的注册表中","「附魔 XXX 不在当前版本的注册表中」",[69,1110,1111,1112,237,1115,1118],{},"用现代命名空间 ID（小写下划线，如 ",[99,1113,1114],{},"unbreaking",[99,1116,1117],{},"sharpness","），或确认这个附魔需要更高版本。",[78,1120],{},[81,1122,1123],{"id":1123},"数据存在哪里",[69,1125,1126],{},"排查数据丢失问题时可能需要：",[143,1128,1129,1138],{},[146,1130,1131],{},[149,1132,1133,1136],{},[152,1134,1135],{},"数据",[152,1137,951],{},[159,1139,1140,1154,1165,1175,1185,1195,1206,1216,1226],{},[149,1141,1142,1145],{},[164,1143,1144],{},"宝石身份标记",[164,1146,1147,1148,237,1151],{},"物品 NBT：",[99,1149,1150],{},"SnowyGemsGemId",[99,1152,1153],{},"SnowyGemsGemType",[149,1155,1156,1159],{},[164,1157,1158],{},"装备上已镶嵌的宝石列表",[164,1160,1147,1161,1164],{},[99,1162,1163],{},"SnowyGemsAppliedGems","（拆卸就是从这个列表里摘除）",[149,1166,1167,1170],{},[164,1168,1169],{},"装备原生属性已固化的标记",[164,1171,1147,1172],{},[99,1173,1174],{},"SnowyGemsDefaultsKept",[149,1176,1177,1180],{},[164,1178,1179],{},"属性叠加值",[164,1181,1147,1182],{},[99,1183,1184],{},"SnowyGemsAttr_\u003C属性名>",[149,1186,1187,1190],{},[164,1188,1189],{},"LoreVar 的数值",[164,1191,1147,1192],{},[99,1193,1194],{},"SnowyGemsLoreVar_\u003C哈希>",[149,1196,1197,1200],{},[164,1198,1199],{},"附魔切换记住的等级",[164,1201,1202,1203],{},"物品 PDC：",[99,1204,1205],{},"snowygems:ench_\u003C附魔键>",[149,1207,1208,1211],{},[164,1209,1210],{},"形态切换状态",[164,1212,1202,1213],{},[99,1214,1215],{},"snowygems:switch_mode",[149,1217,1218,1221],{},[164,1219,1220],{},"属性修饰符身份",[164,1222,1223],{},[99,1224,1225],{},"NamespacedKey(\"snowygems\", \"attr_\u003C属性名>\")",[149,1227,1228,1231],{},[164,1229,1230],{},"内置点券",[164,1232,1233],{},[99,1234,1235],{},"plugins\u002FSnowyGems\u002Fdata\u002Fpoints.yml",[430,1237,1240,1247],{"icon":1238,"type":1239},"i-lucide-triangle-alert","warning",[69,1241,1242,1243,1246],{},"数据全在",[73,1244,1245],{},"物品身上","，不在数据库里。这意味着：物品被其他插件重建（某些「物品修复」「跨服同步」插件会丢 NBT）、放进展示框、或者被合成消耗，宝石数据就没了。",[69,1248,1249,1250,1252],{},"插件已经拦截了「把宝石当方块放置」和「把宝石塞进展示框」两种最常见的丢失场景（",[99,1251,261],{}," tag），但无法拦住所有第三方插件的行为。",[78,1254],{},[81,1256,1257],{"id":1257},"性能问题",[69,1259,1260,1262],{},[73,1261,453],{},"：在线人数多时 TPS 下降。",[69,1264,1265,1266,1268],{},"BUFF 引擎每秒对每个在线玩家扫 6 个物品槽 × 所有带 ",[99,1267,592],{}," 的技能定义。定义数量大（几百个）叠加高在线人数会有可观开销。",[69,1270,1271],{},"排查与缓解：",[1273,1274,1275,1284,1287,1297],"ol",{},[1058,1276,1277,1279,1280,1283],{},[99,1278,764],{}," 后看控制台的「已加载 N 个技能\u002FBUFF 定义，带 Lore 标记可触发的共 M 个」——",[99,1281,1282],{},"M"," 才是每秒参与扫描的数量",[1058,1285,1286],{},"删掉不用的 BUFF 定义，别留着",[1058,1288,1289,1290,1293,1294],{},"一次性效果用事件触发标记（",[99,1291,1292],{},"~onUse"," 等），不要用 ",[99,1295,1296],{},"~onTimer",[1058,1298,1299,1300,1303,1304,1307],{},"避免 ",[99,1301,1302],{},"Repeat"," 配很短的 ",[99,1305,1306],{},"interval"," 用在高频触发的技能上",[78,1309],{},[81,1311,1312],{"id":1312},"求助时请提供",[69,1314,1315],{},"如果自己排查不出来，提供这些信息能大幅加快定位：",[1273,1317,1318,1323,1330,1333],{},[1058,1319,1320,1322],{},[99,1321,1062],{}," 的完整输出",[1058,1324,1325,1326,1329],{},"开对应 tag 后",[73,1327,1328],{},"完整操作一次","的日志（不要只截结尾）",[1058,1331,1332],{},"相关宝石\u002F技能的配置片段",[1058,1334,1335],{},"服务端版本与实现（Paper\u002FLeaves\u002FPurpur + 具体版本号）",[430,1337,1338,1339,1342,1343,1346],{"icon":1238,"type":1239},"只贴异常堆栈的尾部通常看不出问题。要贴 ",[99,1340,1341],{},"logs\u002Flatest.log"," 里带 ",[99,1344,1345],{},"Caused by:"," 的完整段落。",[1348,1349,1350],"style",{},"html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":101,"searchDepth":408,"depth":408,"links":1352},[1353,1358,1359,1372,1374,1375,1382,1383,1384],{"id":83,"depth":408,"text":83,"children":1354},[1355,1356,1357],{"id":90,"depth":482,"text":90},{"id":107,"depth":482,"text":108},{"id":120,"depth":482,"text":120},{"id":134,"depth":408,"text":135},{"id":441,"depth":408,"text":441,"children":1360},[1361,1362,1363,1364,1365,1366,1367,1369,1370,1371],{"id":447,"depth":482,"text":448},{"id":510,"depth":482,"text":511},{"id":538,"depth":482,"text":539},{"id":580,"depth":482,"text":581},{"id":604,"depth":482,"text":605},{"id":656,"depth":482,"text":657},{"id":678,"depth":482,"text":1368},"7. $LORE: 引用的标记与自身 Lore 不一致",{"id":741,"depth":482,"text":742},{"id":767,"depth":482,"text":768},{"id":835,"depth":482,"text":836},{"id":859,"depth":408,"text":1373},"不生效但不是 bug 的情况",{"id":936,"depth":408,"text":936},{"id":1042,"depth":408,"text":1042,"children":1376},[1377,1378,1379,1380,1381],{"id":1045,"depth":482,"text":1046},{"id":1077,"depth":482,"text":1078},{"id":1086,"depth":482,"text":1087},{"id":1097,"depth":482,"text":1098},{"id":1107,"depth":482,"text":1108},{"id":1123,"depth":408,"text":1123},{"id":1257,"depth":408,"text":1257},{"id":1312,"depth":408,"text":1312},"「宝石点了没反应」的系统排查路径、调试日志用法、以及全部已知的配置陷阱。","md",null,{},{"icon":43},{"title":1391,"description":1392},"SnowyGems 排错手册","服主视角的排错指南：debug 日志 tag、配置自检、以及静默失效的常见原因清单。","ex-C10XKIgm1HlaMHReMkT_sRQAiff4O2PD4uJOgVJE",[1395,1397],{"title":35,"path":36,"stem":37,"description":1396,"icon":38,"children":-1},"SnowyGems 如何在 1.21.4 到 26.x 之间通用：注册表探测原理、版本模块开关、混服配置策略。",{"title":45,"path":46,"stem":47,"description":1398,"icon":48,"children":-1},"lang.yml 的结构、占位符、发送方式前缀，以及把插件改成任意语言或任意风格的方法。",1785558357863]