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