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