[{"data":1,"prerenderedAt":1544},["ShallowReactive",2],{"navigation_docs":3,"-snowygems-compat":60,"-snowygems-compat-surround":1539},[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":35,"body":62,"description":1530,"extension":1531,"links":1532,"meta":1533,"navigation":1534,"path":36,"seo":1535,"stem":37,"__hash__":1538},"docs\u002F1.snowygems\u002F5.compat.md",{"type":63,"value":64,"toc":1509},"minimark",[65,68,77,80,85,88,95,98,116,118,121,132,135,160,171,173,176,179,183,275,333,336,615,619,685,689,762,764,767,780,787,906,922,944,946,949,958,1006,1098,1101,1110,1112,1115,1118,1230,1232,1235,1238,1287,1290,1293,1302,1344,1350,1352,1356,1359,1401,1408,1414,1430,1432,1435,1440,1448,1453,1458,1463,1466,1505],[66,67,35],"h1",{"id":35},[69,70,71,72,76],"p",{},"SnowyGems 支持 1.21.4 及以上的全部版本，包括 1.21.5 ~ 1.21.11 与 26.x。",[73,74,75],"strong",{},"同一份配置可以直接发到不同版本的子服","，高版本内容在低版本上自动跳过。",[78,79],"hr",{},[81,82,84],"h2",{"id":83},"实现原理不猜版本只问服务端","实现原理：不猜版本，只问服务端",[69,86,87],{},"大多数插件用「如果版本 ≥ X 就支持 Y」的写法，问题是每出一个新版本都要更新插件，而且 Mojang 从 2026 年改用「年份.次版本」命名（26.1、26.2）后，版本号比较很容易出错。",[69,89,90,91,94],{},"SnowyGems 的做法是",[73,92,93],{},"启动时读服务端的注册表","，把当前实际存在的属性、附魔、药水效果、物品读成一份快照，之后所有查询都基于这份快照。",[69,96,97],{},"这带来三个直接好处：",[99,100,101,107,111],"card-group",{},[102,103,106],"card",{"icon":104,"title":105},"i-lucide-zap","新版本自动支持","服务端加了什么新属性\u002F附魔\u002F效果，插件立刻就能用，不需要等插件更新。",[102,108,110],{"icon":58,"title":109},"低版本优雅降级","配置里写了当前版本没有的内容，只跳过那一条并记日志，其他宝石照常工作。",[102,112,115],{"icon":113,"title":114},"i-lucide-package-plus","数据包内容也认","你用数据包自定义的附魔\u002F属性同样在注册表里，插件一样能识别。",[78,117],{},[81,119,120],{"id":120},"查看当前版本支持什么",[122,123,128],"pre",{"className":124,"code":126,"language":127},[125],"language-text","\u002Fsgem compat        # 简报\n\u002Fsgem compat all    # 完整清单 + 配置自检明细\n","text",[129,130,126],"code",{"__ignoreMap":131},"",[69,133,134],{},"输出包含：",[136,137,138,142,145,151,154,157],"ul",{},[139,140,141],"li",{},"服务端实现与版本",[139,143,144],{},"注册表规模（属性\u002F附魔\u002F效果\u002F物品各多少项）",[139,146,147,150],{},[129,148,149],{},"AttributeModifier"," 用的是新 API 还是旧 API",[139,152,153],{},"逐项能力探测结果（支持 \u002F 当前版本没有 + 需要什么版本）",[139,155,156],{},"功能模块启停状态",[139,158,159],{},"配置自检结果",[69,161,162,163,166,167,170],{},"启动时也会打印简报，可以在 ",[129,164,165],{},"config.yml"," 里用 ",[129,168,169],{},"Compat.ReportOnStartup: false"," 关掉（仍可用命令随时查看）。",[78,172],{},[81,174,175],{"id":175},"各版本新增内容一览",[69,177,178],{},"插件已把这些内容纳入探测清单，配置里可以直接写：",[180,181,182],"h3",{"id":182},"物品",[184,185,186,202],"table",{},[187,188,189],"thead",{},[190,191,192,196,199],"tr",{},[193,194,195],"th",{},"内容",[193,197,198],{},"引入版本",[193,200,201],{},"配置里怎么写",[203,204,205,219,236,249,262],"tbody",{},[190,206,207,211,214],{},[208,209,210],"td",{},"锤 MACE",[208,212,213],{},"1.21",[208,215,216],{},[129,217,218],{},"Require: [MACE]",[190,220,221,224,227],{},[208,222,223],{},"矛 SPEAR",[208,225,226],{},"1.21.11",[208,228,229,232,233],{},[129,230,231],{},"Require: [SPEAR]","、",[129,234,235],{},"~onHit:SPEAR",[190,237,238,241,244],{},[208,239,240],{},"铜盔甲 \u002F 铜工具",[208,242,243],{},"1.21.9",[208,245,246],{},[129,247,248],{},"Require: [COPPER_*]",[190,250,251,254,257],{},[208,252,253],{},"狼铠 WOLF_ARMOR",[208,255,256],{},"1.20.5",[208,258,259],{},[129,260,261],{},"Require: [WOLF_ARMOR]",[190,263,264,267,270],{},[208,265,266],{},"刷子 BRUSH",[208,268,269],{},"1.20",[208,271,272],{},[129,273,274],{},"Require: [BRUSH]",[276,277,279,318],"alert",{"icon":278},"i-lucide-info",[69,280,281,284,285,288,289,232,292,232,295,232,298,232,301,232,304,232,307,310,311,313,314,317],{},[73,282,283],{},"矛是分材质命名的物品","，不存在单一的 ",[129,286,287],{},"SPEAR"," 材质——实际是 ",[129,290,291],{},"WOODEN_SPEAR",[129,293,294],{},"STONE_SPEAR",[129,296,297],{},"COPPER_SPEAR",[129,299,300],{},"IRON_SPEAR",[129,302,303],{},"GOLDEN_SPEAR",[129,305,306],{},"DIAMOND_SPEAR",[129,308,309],{},"NETHERITE_SPEAR"," 七种。配置里写分类关键字 ",[129,312,287],{}," 即可匹配全部材质，不需要逐个列出；插件靠 ",[129,315,316],{},"_SPEAR"," 后缀识别，所以将来新增材质的矛也会自动纳入。",[69,319,320,321,232,324,232,327,232,330,332],{},"矛既能近战也能投掷，因此同时落在 ",[129,322,323],{},"WEAPON",[129,325,326],{},"MELEE",[129,328,329],{},"RANGED",[129,331,287],{}," 四个分类里。",[180,334,335],{"id":335},"属性",[184,337,338,349],{},[187,339,340],{},[190,341,342,344,346],{},[193,343,335],{},[193,345,198],{},[193,347,348],{},"简写",[203,350,351,369,384,402,417,431,446,461,476,492,506,520,534,548,562,577,591,603],{},[190,352,353,359,361],{},[208,354,355,358],{},[129,356,357],{},"scale"," 体型",[208,360,256],{},[208,362,363,365,366],{},[129,364,357],{}," \u002F ",[129,367,368],{},"size",[190,370,371,377,379],{},[208,372,373,376],{},[129,374,375],{},"block_interaction_range"," 方块交互距离",[208,378,256],{},[208,380,381],{},[129,382,383],{},"block_reach",[190,385,386,392,394],{},[208,387,388,391],{},[129,389,390],{},"entity_interaction_range"," 实体交互距离",[208,393,256],{},[208,395,396,365,399],{},[129,397,398],{},"attack_reach",[129,400,401],{},"entity_reach",[190,403,404,410,412],{},[208,405,406,409],{},[129,407,408],{},"jump_strength"," 跳跃力",[208,411,256],{},[208,413,414],{},[129,415,416],{},"jump",[190,418,419,425,427],{},[208,420,421,424],{},[129,422,423],{},"gravity"," 重力",[208,426,256],{},[208,428,429],{},[129,430,423],{},[190,432,433,439,441],{},[208,434,435,438],{},[129,436,437],{},"max_absorption"," 吸收上限",[208,440,256],{},[208,442,443],{},[129,444,445],{},"absorption",[190,447,448,454,456],{},[208,449,450,453],{},[129,451,452],{},"safe_fall_distance"," 安全落地距离",[208,455,256],{},[208,457,458],{},[129,459,460],{},"safe_fall",[190,462,463,469,471],{},[208,464,465,468],{},[129,466,467],{},"fall_damage_multiplier"," 落地伤害倍率",[208,470,256],{},[208,472,473],{},[129,474,475],{},"fall_damage",[190,477,478,484,487],{},[208,479,480,483],{},[129,481,482],{},"submerged_mining_speed"," 水下挖掘速度",[208,485,486],{},"1.21.2",[208,488,489],{},[129,490,491],{},"water_mining",[190,493,494,500,502],{},[208,495,496,499],{},[129,497,498],{},"mining_efficiency"," 挖掘效率",[208,501,486],{},[208,503,504],{},[129,505,498],{},[190,507,508,514,516],{},[208,509,510,513],{},[129,511,512],{},"movement_efficiency"," 移动效率",[208,515,486],{},[208,517,518],{},[129,519,512],{},[190,521,522,528,530],{},[208,523,524,527],{},[129,525,526],{},"burning_time"," 燃烧时长",[208,529,486],{},[208,531,532],{},[129,533,526],{},[190,535,536,542,544],{},[208,537,538,541],{},[129,539,540],{},"oxygen_bonus"," 氧气加成",[208,543,486],{},[208,545,546],{},[129,547,540],{},[190,549,550,556,558],{},[208,551,552,555],{},[129,553,554],{},"sneaking_speed"," 潜行速度",[208,557,486],{},[208,559,560],{},[129,561,554],{},[190,563,564,570,572],{},[208,565,566,569],{},[129,567,568],{},"sweeping_damage_ratio"," 横扫伤害比",[208,571,213],{},[208,573,574],{},[129,575,576],{},"sweeping",[190,578,579,585,588],{},[208,580,581,584],{},[129,582,583],{},"waypoint_transmit_range"," 路径点广播",[208,586,587],{},"26.x",[208,589,590],{},"同名",[190,592,593,599,601],{},[208,594,595,598],{},[129,596,597],{},"waypoint_receive_range"," 路径点接收",[208,600,587],{},[208,602,590],{},[190,604,605,611,613],{},[208,606,607,610],{},[129,608,609],{},"camera_distance"," 视角距离",[208,612,587],{},[208,614,590],{},[180,616,618],{"id":617},"附魔版本专属","附魔（版本专属）",[184,620,621,633],{},[187,622,623],{},[190,624,625,628,630],{},[193,626,627],{},"附魔",[193,629,198],{},[193,631,632],{},"只能附在",[203,634,635,648,660,672],{},[190,636,637,643,645],{},[208,638,639,642],{},[129,640,641],{},"density"," 密度",[208,644,213],{},[208,646,647],{},"锤",[190,649,650,656,658],{},[208,651,652,655],{},[129,653,654],{},"breach"," 穿透",[208,657,213],{},[208,659,647],{},[190,661,662,668,670],{},[208,663,664,667],{},[129,665,666],{},"wind_burst"," 风爆",[208,669,213],{},[208,671,647],{},[190,673,674,680,682],{},[208,675,676,679],{},[129,677,678],{},"lunge"," 突进",[208,681,226],{},[208,683,684],{},"矛",[180,686,688],{"id":687},"药水效果试炼密室","药水效果（试炼密室）",[184,690,691,700],{},[187,692,693],{},[190,694,695,698],{},[193,696,697],{},"效果",[193,699,198],{},[203,701,702,712,722,732,742,752],{},[190,703,704,710],{},[208,705,706,709],{},[129,707,708],{},"oozing"," 渗浆",[208,711,213],{},[190,713,714,720],{},[208,715,716,719],{},[129,717,718],{},"infested"," 寄生",[208,721,213],{},[190,723,724,730],{},[208,725,726,729],{},[129,727,728],{},"weaving"," 盘丝",[208,731,213],{},[190,733,734,740],{},[208,735,736,739],{},[129,737,738],{},"wind_charged"," 蓄风",[208,741,213],{},[190,743,744,750],{},[208,745,746,749],{},[129,747,748],{},"trial_omen"," 试炼预兆",[208,751,213],{},[190,753,754,760],{},[208,755,756,759],{},[129,757,758],{},"raid_omen"," 袭击预兆",[208,761,213],{},[78,763],{},[81,765,766],{"id":766},"旧名兼容",[69,768,769,770,232,773,232,776,779],{},"1.20.5 起 Mojang 把附魔、药水效果、属性都从静态常量改成了注册表，旧名（",[129,771,772],{},"DURABILITY",[129,774,775],{},"DAMAGE_RESISTANCE",[129,777,778],{},"GENERIC_MAX_HEALTH","）在新版本已经不存在。",[69,781,782,783,786],{},"插件内置了旧名 → 新键的映射表，",[73,784,785],{},"老配置不用改","：",[184,788,789,799],{},[187,790,791],{},[190,792,793,796],{},[193,794,795],{},"你写的",[193,797,798],{},"实际解析成",[203,800,801,812,824,836,848,859,871,883,895],{},[190,802,803,807],{},[208,804,805],{},[129,806,772],{},[208,808,809],{},[129,810,811],{},"unbreaking",[190,813,814,819],{},[208,815,816],{},[129,817,818],{},"DAMAGE_ALL",[208,820,821],{},[129,822,823],{},"sharpness",[190,825,826,831],{},[208,827,828],{},[129,829,830],{},"LOOT_BONUS_BLOCKS",[208,832,833],{},[129,834,835],{},"fortune",[190,837,838,843],{},[208,839,840],{},[129,841,842],{},"ARROW_INFINITE",[208,844,845],{},[129,846,847],{},"infinity",[190,849,850,854],{},[208,851,852],{},[129,853,775],{},[208,855,856],{},[129,857,858],{},"resistance",[190,860,861,866],{},[208,862,863],{},[129,864,865],{},"FAST_DIGGING",[208,867,868],{},[129,869,870],{},"haste",[190,872,873,878],{},[208,874,875],{},[129,876,877],{},"INCREASE_DAMAGE",[208,879,880],{},[129,881,882],{},"strength",[190,884,885,890],{},[208,886,887],{},[129,888,889],{},"JUMP",[208,891,892],{},[129,893,894],{},"jump_boost",[190,896,897,901],{},[208,898,899],{},[129,900,778],{},[208,902,903],{},[129,904,905],{},"max_health",[69,907,908,909,912,913,232,915,918,919,921],{},"三种写法都能用：项目简写（",[129,910,911],{},"health","）、现代注册表键（",[129,914,905],{},[129,916,917],{},"minecraft:scale","）、旧 Bukkit 常量名（",[129,920,778],{},"）。",[276,923,925,926,929,930,232,932,232,934,936,937,232,940,943],{"icon":924},"i-lucide-lightbulb","新写配置建议直接用",[73,927,928],{},"现代注册表键","（小写下划线，如 ",[129,931,811],{},[129,933,823],{},[129,935,858],{},"），和游戏内 ",[129,938,939],{},"\u002Fenchant",[129,941,942],{},"\u002Feffect"," 的补全一致，不容易记错。",[78,945],{},[81,947,948],{"id":948},"功能模块开关",[69,950,951,953,954,957],{},[129,952,165],{}," 的 ",[129,955,956],{},"Compat.Modules"," 下有 7 个模块，每个可取三种值：",[184,959,960,970],{},[187,961,962],{},[190,963,964,967],{},[193,965,966],{},"值",[193,968,969],{},"含义",[203,971,972,986,996],{},[190,973,974,979],{},[208,975,976],{},[129,977,978],{},"auto",[208,980,981,982,985],{},"由服务端注册表决定：有就启用，没有就停用（",[73,983,984],{},"默认，推荐","）",[190,987,988,993],{},[208,989,990],{},[129,991,992],{},"true",[208,994,995],{},"强制启用。注册表里没有时相关配置会报「跳过」",[190,997,998,1003],{},[208,999,1000],{},[129,1001,1002],{},"false",[208,1004,1005],{},"强制停用。即使服务端支持也不启用",[184,1007,1008,1018],{},[187,1009,1010],{},[190,1011,1012,1015],{},[193,1013,1014],{},"模块",[193,1016,1017],{},"管辖内容",[203,1019,1020,1030,1048,1058,1068,1078,1088],{},[190,1021,1022,1027],{},[208,1023,1024],{},[129,1025,1026],{},"Mace",[208,1028,1029],{},"锤及其专属附魔（密度\u002F穿透\u002F风爆）",[190,1031,1032,1037],{},[208,1033,1034],{},[129,1035,1036],{},"Spear",[208,1038,1039,1040,232,1042,365,1044,1047],{},"矛（全部材质的分类匹配）、专属附魔「突进」",[129,1041,678],{},[129,1043,235],{},[129,1045,1046],{},"~onLaunch:SPEAR"," 触发",[190,1049,1050,1055],{},[208,1051,1052],{},[129,1053,1054],{},"CopperEquipment",[208,1056,1057],{},"铜盔甲与铜工具纳入 ARMOR \u002F TOOL 分类",[190,1059,1060,1065],{},[208,1061,1062],{},[129,1063,1064],{},"ModernAttributes",[208,1066,1067],{},"1.20.5+ 新属性（scale、交互距离、重力等）",[190,1069,1070,1075],{},[208,1071,1072],{},[129,1073,1074],{},"MiningAttributes",[208,1076,1077],{},"1.21.2+ 挖掘与移动类属性",[190,1079,1080,1085],{},[208,1081,1082],{},[129,1083,1084],{},"TrialEffects",[208,1086,1087],{},"1.21+ 试炼密室药水效果",[190,1089,1090,1095],{},[208,1091,1092],{},[129,1093,1094],{},"WaypointAttributes",[208,1096,1097],{},"26.x 路径点属性",[69,1099,1100],{},"模块停用后，它管辖的属性\u002F附魔\u002F效果\u002F物品在查询时一律返回「不存在」，上层按既有的「跳过并提示」路径处理。",[276,1102,1103,1106,1107,1109],{"icon":278},[73,1104,1105],{},"平时不需要动这些开关。"," ",[129,1108,978],{}," 已经能正确处理绝大多数情况。手动改的场景只有一个：混服。",[78,1111],{},[81,1113,1114],{"id":1114},"混服策略",[69,1116,1117],{},"如果你有多个不同版本的子服，共用同一份配置：",[1119,1120,1121,1128,1131,1134,1142,1200,1207,1211],"steps",{},[180,1122,1124,1125,1127],{"id":1123},"保持-auto推荐","保持 ",[129,1126,978],{},"（推荐）",[69,1129,1130],{},"什么都不用改。高版本子服自动启用新内容，低版本子服自动跳过。代价是低版本控制台会有「N 处内容当前版本不支持，已跳过」的提示。",[180,1132,1133],{"id":1133},"低版本子服手动关掉高版本模块",[69,1135,1136,1137,1139,1140,786],{},"如果嫌那条提示烦，在低版本子服的 ",[129,1138,165],{}," 里把对应模块设为 ",[129,1141,1002],{},[122,1143,1147],{"className":1144,"code":1145,"language":1146,"meta":131,"style":131},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Compat:\n  Modules:\n    Spear: false              # 这个子服是 1.21.4，没有矛\n    WaypointAttributes: false # 也没有 26.x 的路径点属性\n","yaml",[129,1148,1149,1162,1170,1187],{"__ignoreMap":131},[1150,1151,1154,1158],"span",{"class":1152,"line":1153},"line",1,[1150,1155,1157],{"class":1156},"swJcz","Compat",[1150,1159,1161],{"class":1160},"sMK4o",":\n",[1150,1163,1165,1168],{"class":1152,"line":1164},2,[1150,1166,1167],{"class":1156},"  Modules",[1150,1169,1161],{"class":1160},[1150,1171,1173,1176,1179,1183],{"class":1152,"line":1172},3,[1150,1174,1175],{"class":1156},"    Spear",[1150,1177,1178],{"class":1160},":",[1150,1180,1182],{"class":1181},"sfNiH"," false",[1150,1184,1186],{"class":1185},"sHwdD","              # 这个子服是 1.21.4，没有矛\n",[1150,1188,1190,1193,1195,1197],{"class":1152,"line":1189},4,[1150,1191,1192],{"class":1156},"    WaypointAttributes",[1150,1194,1178],{"class":1160},[1150,1196,1182],{"class":1181},[1150,1198,1199],{"class":1185}," # 也没有 26.x 的路径点属性\n",[69,1201,1202,1203,1206],{},"这样 ",[129,1204,1205],{},"Require: [WEAPON]"," 在这个子服上就不会把矛算进去，配置自检也不再提示它们。",[180,1208,1210],{"id":1209},"上线前用-strict-自检","上线前用 strict 自检",[69,1212,1213,1214,1217,1218,1221,1222,1225,1226,1229],{},"正式服上线前把 ",[129,1215,1216],{},"OnMissingFeature"," 改成 ",[129,1219,1220],{},"strict","，重载一次，控制台会用醒目的错误级别列出所有",[73,1223,1224],{},"真正写错","的条目。确认干净后再改回 ",[129,1227,1228],{},"skip","。",[78,1231],{},[81,1233,1234],{"id":1234},"配置自检的两类问题",[69,1236,1237],{},"自检会区分两种情况，这个区分很重要：",[184,1239,1240,1253],{},[187,1241,1242],{},[190,1243,1244,1247,1250],{},[193,1245,1246],{},"类型",[193,1248,1249],{},"例子",[193,1251,1252],{},"处理",[203,1254,1255,1270],{},[190,1256,1257,1262,1267],{},[208,1258,1259],{},[73,1260,1261],{},"版本不支持",[208,1263,1264,1265],{},"1.21.4 上写了 ",[129,1266,231],{},[208,1268,1269],{},"正常状态，只记 Debug 日志 + 一行概要",[190,1271,1272,1277,1284],{},[208,1273,1274],{},[73,1275,1276],{},"写错了",[208,1278,1279,1280,1283],{},"写了 ",[129,1281,1282],{},"Enchant{name=sharpnes}","（拼错）",[208,1285,1286],{},"任何版本都不会生效，明确报出来",[276,1288,1289],{"icon":924},"不做这个区分的后果是：内置的新版本示例宝石会在 1.21.4 上刷出几十条「错误」，服主看几次就再也不看这个报告了——真正的拼写错误也就被淹没了。",[69,1291,1292],{},"判据是模块归属表：归某个版本模块管的键算「版本不支持」，其余算「写错了」。写错的条目会带上拼写建议（如「你是不是想写: sharpness」）。",[69,1294,1295,1297,1298,1301],{},[129,1296,1216],{}," 三个级别的差异",[73,1299,1300],{},"只影响「写错了」这一类","的输出方式：",[184,1303,1304,1314],{},[187,1305,1306],{},[190,1307,1308,1311],{},[193,1309,1310],{},"级别",[193,1312,1313],{},"行为",[203,1315,1316,1325,1335],{},[190,1317,1318,1322],{},[208,1319,1320],{},[129,1321,1228],{},[208,1323,1324],{},"一行概要 + Debug 明细（默认）",[190,1326,1327,1332],{},[208,1328,1329],{},[129,1330,1331],{},"warn",[208,1333,1334],{},"用 WARNING 级别逐条输出",[190,1336,1337,1341],{},[208,1338,1339],{},[129,1340,1220],{},[208,1342,1343],{},"用 SEVERE 级别逐条输出",[69,1345,1346,1347,1229],{},"三种级别都",[73,1348,1349],{},"不会阻止插件启动",[78,1351],{},[81,1353,1355],{"id":1354},"attributemodifier-的-api-差异","AttributeModifier 的 API 差异",[69,1357,1358],{},"这是插件里唯一真正需要按版本分支的地方，插件已经处理好，写在这里供参考：",[184,1360,1361,1371],{},[187,1362,1363],{},[190,1364,1365,1368],{},[193,1366,1367],{},"版本",[193,1369,1370],{},"构造函数",[203,1372,1373,1383,1393],{},[190,1374,1375,1378],{},[208,1376,1377],{},"1.20.4 及以前",[208,1379,1380],{},[129,1381,1382],{},"AttributeModifier(UUID, String, double, Operation, EquipmentSlot)",[190,1384,1385,1388],{},[208,1386,1387],{},"1.20.5 起",[208,1389,1390],{},[129,1391,1392],{},"AttributeModifier(NamespacedKey, double, Operation, EquipmentSlotGroup)",[190,1394,1395,1398],{},[208,1396,1397],{},"1.21.9 前后",[208,1399,1400],{},"部分服务端实现开始移除旧构造",[69,1402,1403,1404,1407],{},"插件优先用新 API，用反射探测可用性并缓存结果。清理旧修饰符时",[73,1405,1406],{},"同时按 NamespacedKey 和 UUID 两种身份匹配","——因为玩家的装备可能是在插件用旧 API 的版本上镶嵌的，服务器升级后如果只按新 key 清理，旧修饰符会永久残留并持续叠加。",[69,1409,1410,1413],{},[129,1411,1412],{},"\u002Fsgem compat"," 会显示当前用的是哪套 API。",[69,1415,1416,1419,1420,232,1423,232,1426,1429],{},[129,1417,1418],{},"slot"," 的槽位组语义（",[129,1421,1422],{},"any",[129,1424,1425],{},"armor",[129,1427,1428],{},"any_hand","）是 1.20.5+ 才有的。在只支持旧 API 的服务端上，这几个值会退化成主手。",[78,1431],{},[81,1433,1434],{"id":1434},"常见问题",[69,1436,1437],{},[73,1438,1439],{},"升级服务端版本后要做什么？",[69,1441,1442,1443,1445,1446,1229],{},"理论上什么都不用做。跑一次 ",[129,1444,1412],{}," 确认新版本能力被识别到即可。如果之前手动关过模块，记得把它们改回 ",[129,1447,978],{},[69,1449,1450],{},[73,1451,1452],{},"降级服务端版本后呢？",[69,1454,1455,1456,1229],{},"同样什么都不用做，高版本内容会自动跳过。想让控制台干净些，把对应模块设为 ",[129,1457,1002],{},[69,1459,1460],{},[73,1461,1462],{},"为什么我的新属性宝石没效果？",[69,1464,1465],{},"按顺序检查：",[1467,1468,1469,1475,1480,1498],"ol",{},[139,1470,1471,1474],{},[129,1472,1473],{},"\u002Fsgem compat all"," 确认这个属性在你的版本上存在",[139,1476,1477,1478],{},"确认没有手动把对应模块设成 ",[129,1479,1002],{},[139,1481,1482,1483,1486,1487,1490,1491,1494,1495,985],{},"检查 ",[129,1484,1485],{},"limit"," 和 ",[129,1488,1489],{},"var"," 是否",[73,1492,1493],{},"同号","（这是最常见的原因，见",[1496,1497,21],"a",{"href":22},[139,1499,1500,1501,1504],{},"开 ",[129,1502,1503],{},"\u002Fsgem debug Reward"," 看这条 Rewards 的实际执行结果",[1506,1507,1508],"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 .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}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);}",{"title":131,"searchDepth":1164,"depth":1164,"links":1510},[1511,1512,1513,1519,1520,1521,1527,1528,1529],{"id":83,"depth":1164,"text":84},{"id":120,"depth":1164,"text":120},{"id":175,"depth":1164,"text":175,"children":1514},[1515,1516,1517,1518],{"id":182,"depth":1172,"text":182},{"id":335,"depth":1172,"text":335},{"id":617,"depth":1172,"text":618},{"id":687,"depth":1172,"text":688},{"id":766,"depth":1164,"text":766},{"id":948,"depth":1164,"text":948},{"id":1114,"depth":1164,"text":1114,"children":1522},[1523,1525,1526],{"id":1123,"depth":1172,"text":1524},"保持 auto（推荐）",{"id":1133,"depth":1172,"text":1133},{"id":1209,"depth":1172,"text":1210},{"id":1234,"depth":1164,"text":1234},{"id":1354,"depth":1164,"text":1355},{"id":1434,"depth":1164,"text":1434},"SnowyGems 如何在 1.21.4 到 26.x 之间通用：注册表探测原理、版本模块开关、混服配置策略。","md",null,{},{"icon":38},{"title":1536,"description":1537},"SnowyGems 多版本兼容说明","服主视角的多版本兼容指南：为什么同一份配置能跨版本使用、模块开关怎么调、混服怎么配。","f3ddn_CS6h7cexZCTZdcCafIaRZ2D41rpC01a9BDzng",[1540,1542],{"title":30,"path":31,"stem":32,"description":1541,"icon":33,"children":-1},"gui\u002F 目录下工作台菜单的字符网格布局、五种槽位类型、宝石分类限制与实战示例。",{"title":40,"path":41,"stem":42,"description":1543,"icon":43,"children":-1},"「宝石点了没反应」的系统排查路径、调试日志用法、以及全部已知的配置陷阱。",1785558357487]