幸存者军火库 · 玩法教程与指引
数据来源：Java 版模组 jar 文件（sa_lib=sa_core、sa_essentials=sa_combat/sa_survival、sa_decor）中的 lang/zh_cn.json、data/**/recipes、data/**/tags、data/**/advancements、data/**/curios、mods.toml 等。
中文名以 jar 内 zh_cn.json 为准；单位换算 20 tick = 1 秒。
一、模组构成与依赖
| 模块 |
游戏内名称 |
对应 jar |
主要玩法内容 |
必需依赖 |
软依赖（可选） |
| sa_core |
幸存者军火库：核心 |
sa_lib-forge-1.20.1-1.0.1.jar |
材料、工具、拆解箱、回收机、发电机、电力、绳索、火柴盒 |
forge / minecraft |
— |
| sa_combat |
幸存者军火库：基础包 |
sa_essentials-forge-1.20.1-1.0.0.jar |
军火台、武器、改装/升级、弹药、投掷物、防具、防弹板、草药、医疗、背包、服饰 |
sa_core、geckolib、curios |
tacz（枪械联动） |
| sa_decor |
幸存者军火库：战利品与装饰 |
sa_decor-forge-1.20.1-1.0.3.jar |
装饰工作台、装饰方块、电力设施、门禁/挂锁、战利品箱、空投、载具、屋顶、路障 |
sa_core、geckolib |
sa_combat、lootr、tacz、jei |
| （外部） |
Legendary Survival Overhaul |
— |
口渴、体温、身体部位伤害等硬核生存数值 |
— |
非必需，装了之后 sa_core 的水瓶/脏水瓶与草药会自动接入 |
二、玩法总循环
| 阶段 |
玩家目标 |
关键系统 |
产出 |
| 1. 搜刮 |
在城市/建筑里捡垃圾、撬门、开箱 |
散落拾取物、战利品箱、挂锁/钥匙、门禁卡 |
废料、材料、钞票、蓝图 |
| 2. 拆解 |
把没用的物品变成材料 |
拆解箱（手动）、回收机（耗电） |
金属废料、废料粒、电子废料、塑料、皮、线… |
| 3. 供电 |
为回收机与装饰设施提供 FE |
固体燃料发电机、汽油发电机+手册 |
FE 电力 |
| 4. 制造 |
做工具、武器、防具、医疗、装饰 |
原版合成格、军火台、装饰工作台 |
成品装备与建材 |
| 5. 强化 |
提升战斗力 |
蓝图解锁、改装、升级、防弹板、修理套件 |
高阶武器与防具 |
| 6. 生存 |
维持饥渴、体温、血量、止血 |
食物、草药、医疗、防化服/消防服 |
持续存活 |
| 7. 基地 |
建造与装饰据点 |
装饰工作台、电力电缆、车库门、门禁 |
安全据点 |
三、开局推荐流程
| 步骤 |
目标 |
具体操作 |
产出 |
| 1 |
取得第一批废料 |
徒手/普通工具破坏铁制物品、收集垃圾 |
金属废料、废料粒 |
| 2 |
做基础工具 |
原版合成格：螺丝刀、钳子、羊角锤、锯子 |
装配工具 |
| 3 |
造拆解箱 |
合成格 3×3：金属废料×4 + 碎木料×3 |
拆解箱，开始批量回收 |
| 4 |
造军火台 |
合成格 3×3：金属板×2 + 螺丝 + 工作台 + 铁锭×3 |
武器/防具制造中心 |
| 5 |
造固体燃料发电机 |
金属板×2 + 绝缘铜线 + 电子废料×2 + 熔炉 + 铁块×2 + 红石 |
低功率 FE |
| 6 |
造回收机 |
金属废料等材料合成 |
自动化回收（40 FE/t） |
| 7 |
学发电机手册 |
读手册 3 章 + 实践训练 |
解锁汽油发电机使用权 |
| 8 |
找蓝图 |
战利品箱、空投、商人 |
解锁高阶配方 |
| 9 |
造装饰工作台 |
用金属板/螺丝等 |
建造据点（60+ 存储 / 80+ 功能 / 200+ 装饰方块） |
| 10 |
通电与安防 |
铺电缆、装保险丝盒、车库门、门禁读卡器 |
完整据点 |
四、核心系统详解
4.1 拆解与回收
| 设备 |
中文名 |
需要电力 |
机制 |
操作与备注 |
| sa_core:salvage_bin |
拆解箱（回收箱） |
否 |
手动投料，按配方成功率判定并累积进度 |
把兼容物品放进去 → 达到满级即可领取；回收率偏低，适合起步 |
| sa_core:recycler |
回收机 |
是（40 FE/t） |
将支持的物品回收为材料 |
支持漏斗自动化，适合规模化处理 |
| 工作现场 |
锯子 / 金属锯 |
否 |
锯切配方：把方块锯回木板 |
台阶/楼梯/门/栅栏等均可回炉 |
| 工作现场 |
羊角锤 |
否 |
锻打金属板 |
铁锭 → 金属板 |
拆解产物类型（salvage_type）：钻石粒、电子废料、燧石、金粒、皮革、金属废料、下界合金粒、下界合金碎片、塑料、废料粒、线、空。
成功率与进度由配方的高级产物决定（如铁砧 100% 直接满级、下界合金装备 50% / 2 级）。
4.2 电力系统
| 设备 |
中文名 |
作用 |
操作要点 |
| sa_core:solid_fuel_generator |
固体燃料发电机 |
烧固体熔炉燃料产生 FE |
低功率输出；不需要发电机手册 |
| sa_core:generator |
汽油发电机 |
仅靠汽油驱动，高功率输出 |
需要完成发电机手册训练才能操作 |
| sa_core:jerry_can |
油桶 |
携带液体燃料 |
右键液体源收集；右键继续收集；Shift+右键倒出；不可存熔岩、不可混合液体 |
| sa_core:gasoline |
汽油（流体） |
汽油发电机/电锯燃料 |
用汽油桶装取 |
| sa_decor:cable |
电缆 |
连接电源与用电设备 |
每段最长 16 格；用 sa_core 钳子可切断并回收 |
| sa_decor:fuse_box |
保险丝盒 |
储电/供电枢纽 |
显示 FE；可激活/停用 |
| sa_decor:electrical_box / electrical_outlet |
电箱 / 插座 |
配电 |
作为电缆端点 |
| sa_decor:wire_connector |
电线连接器 |
布线节点 |
配合电缆使用 |
| sa_decor:light_switch |
电灯开关 |
控制一组灯具 |
手持开关潜行+右键灯具绑定；放置后最大范围 24 格；潜行+右键空气清除 |
| sa_decor:fuel_pump |
油泵 |
输出液体燃料 |
需要电力；显示油箱 mB |
| sa_decor:work_light / lamp_block / double_flourecent_lamp |
工作灯 / 灯具 / 双管荧光灯 |
照明 |
部分含闪烁变体 |
4.3 发电机手册训练（sa_core:generator_manual）
| 阶段 |
章节 |
内容 |
完成条件 |
| 理论 |
燃料系统 |
只使用有效液体燃料，启动前检查油箱，勿混液 |
完成单词搜索小游戏 |
| 理论 |
安全 |
通风、维护前关机、妥善处理燃料 |
找出 3 个不安全操作 |
| 理论 |
启动步骤 |
检查连接 → 检查燃料 → 打开发电机 → 监控输出 |
按正确顺序排序 |
| 实践 |
实践训练 |
带着手册到汽油发电机处右键检查 |
完成后获得「合格操作员」，之后每台汽油发电机均可正常操作 |
提示：理论未完成时机器会提示「请先完成发电机手册训练」；完成后提示「你已经知道如何使用汽油发电机」。
4.4 军火台（sa_combat:arsenal_table）
| 页签 |
名称 |
内容 |
说明 |
| 合成 |
Crafting |
制造武器、弹药、防具、维修套件、装甲板、投掷物、防化服 |
部分配方需要蓝图 |
| 改装 |
Modifier |
给已有武器加装件（带刺/锯刃/电击套件/瞄准镜/消音器…） |
消耗武器零件+材料；可「移除改装」还原外观 |
| 升级 |
Upgrade |
消耗材料提升武器属性 |
见下表 |
| 其他 |
Miscellaneous |
武器零件、弩箭、维修套件、装甲板、手雷、地雷、C4 等 |
兜底分类 |
| 槽位类型 |
说明 |
| 改装栏位 |
武器的加装件槽，显示为「改装：…」或「空改装栏位」 |
| 升级栏位 |
属性升级槽，显示为「已安装升级」或「空升级栏位」 |
| 能力栏位 |
武器/蓝图附加能力槽，显示为「空能力栏位」 |
| 升级属性 |
数值 |
级数 |
材料趋势 |
| 伤害（Damage） |
提升武器基础伤害 |
5 级 |
武器零件 → 灰烬钢锭 / 钻石粒 / 下界合金粒 |
| 攻速（Attack Speed） |
提升攻击速度 |
5 级 |
同上逐级递进 |
| 暴击（Critical） |
提升暴击几率 |
5 级 |
同上 |
| 攻击距离（Reach） |
提升攻击距离 |
5 级 |
同上 |
| 军火台界面信息 |
含义 |
| 武器状态 |
展示「基础属性 / 升级加成 / 最终属性」三段 |
| 蓝图：已解锁 / 需要蓝图 |
该配方是否需要蓝图以及是否已解锁 |
| 仅显示可合成的 / 显示全部 |
过滤有材料的配方 |
| 材料 / 花费 |
展示配方消耗 |
| 结果 / 产出 |
展示产物 |
4.5 蓝图（Blueprint）
| 项目 |
说明 |
| 物品 |
sa_combat:blueprint，名称为「<武器名> 蓝图」 |
| 属性 |
含稀有度（rarity）、蓝图 ID、解锁配方列表、命中效果（on_hit）、能力（abilities） |
| 空白蓝图 |
可通过数据包 / NBT 自定义，未定义时显示「未知解锁」 |
| 需要蓝图的典型配方 |
地雷、C4、猎刀、武士刀、战术弩、复合弓、电锯剑、拳刃、简易巨斧、双头消防斧锤、残忍者、露西尔、破伤风之王、警用盾牌等 |
| 获取 |
战利品箱、补给空投、商人交易、敌对生物掉落等 |
4.6 防具与防弹板
| 项目 |
说明 |
| 防弹背心 |
如黑色战术背心、警用背心、保护伞背心；装备于 Curios 提供护甲防护 |
| 防弹板 |
I / II / III 三级，需先装备背心；右键准备/安装，Shift+点击完成安装 |
| 兼容性 |
背心只接受其允许等级区间的防弹板，装错会提示「这件背心接受 X-Y 级的防弹板」 |
| 修复 |
装板可恢复防弹防护点数；已装满会提示「防弹板已经装满了」 |
| 废料护甲 |
简易护甲，略弱于铁 |
| 防化服（简易） |
全套奖励：免疫中毒与凋零 |
| 消防服 |
钻石级护甲防护；整套奖励：防火与抗性 |
| 保护伞制服 / 警服 |
消防员级 / 均衡型护甲防护 |
4.7 生存状态
| 状态 |
来源 |
影响 |
应对 |
| 流血（Bleeding） |
受击 |
持续伤害 |
绷带、消毒绷带、止血类道具（将流血等级降低 1 级） |
| 电击（Electric Shock） |
电击类攻击/陷阱 |
麻痹+伤害 |
等待消退 / 医疗 |
| 中毒（Poison） |
中毒源 |
持续掉血 |
蓝色系草药、解毒类物品（移除中毒） |
| 饥饿 |
常规 |
掉血 |
食物 |
| 口渴 |
LSO |
脱水 |
水瓶、可饮用液体（脏水瓶会致饥饿） |
| 体温 |
LSO |
过冷/过热 |
服装、火源、庇护所 |
| 身体部位伤害 |
LSO |
部位失能 |
草药/医疗品带 LSO 治疗数据（分次缓慢治疗） |
「不适合饮用」提示见 item.sa_core.not_safe_to_drink；脏水瓶饮用可能引起饥饿。
4.8 医疗物品
| 物品 |
中文名 |
作用 |
备注 |
| sa_combat:bandage |
绷带 |
治疗 / 止血 |
绷带可进一步消毒 |
| sa_combat:bandage_sterilized |
消毒绷带 |
止血并抗感染 |
用酒精或消毒剂处理绷带 |
| sa_combat:plaster |
石膏 |
固定 / 治疗 |
用布料或抹布+医用胶制作 |
| sa_combat:splint |
夹板 |
骨折类处理 |
用管道胶带或抹布制作 |
| sa_combat:first_aid_kit |
急救包 |
综合治疗 |
消耗品 |
| sa_combat:first_aid_spray |
急救喷雾 |
快速治疗 |
消耗品 |
| sa_combat:blood_bag / blood_bag_empty |
血袋 / 空血袋 |
补血 |
填充血袋会消耗自身生命值（「填充消耗 X 颗心」）；太虚弱时无法装满 |
| sa_combat:injectors |
注射器 |
注射类治疗 |
有专属使用动画 |
| sa_combat:alcohol_wipes |
酒精棉 |
清洁医用布 |
用布料或抹布 + 酒精制作 |
| sa_core:antiseptic |
消毒剂 |
消毒/抗感染 |
可消毒绷带 |
| sa_core:rubbing_alcohol |
外用酒精 |
消毒原料 |
不适合饮用 |
| sa_core:medical_adhesive |
医用胶 |
制作医疗品 |
— |
| sa_core:sterilized_rags |
消毒抹布 |
治疗/清洁 |
使用后返还脏抹布 |
通用提示图标：恢复 X 颗心、止住流血、治疗中毒、抵抗感染、移除负面效果。
4.9 草药系统
| 类别 |
物品 |
使用方式 |
使用时长 |
效果（amplifier / 时长） |
解毒 |
合成 |
| 生药草 |
绿色药草 |
咀嚼 EAT（也可放置/种植） |
60t |
再生 I · 60t + LSO 治疗 1.5 |
否 |
野采 / 击杀敌对生物掉落 |
| 生药草 |
红色药草 |
咀嚼 EAT |
60t |
饱和 I · 40t |
否 |
同上 |
| 生药草 |
蓝色药草 |
咀嚼 EAT |
60t |
再生 I · 40t |
否 |
同上 |
| 生药草 |
黄色药草 |
咀嚼 EAT |
60t |
吸收 I · 100t |
否 |
同上 |
| 捣碎 |
捣碎的绿色药草 |
食用 EAT |
32t |
再生 I · 100t + LSO 治疗 1.5 |
否 |
研钵 + 绿色药草 |
| 捣碎 |
捣碎的红色药草 |
食用 EAT |
32t |
饱和 I · 60t |
否 |
研钵 + 红色药草 |
| 捣碎 |
捣碎的蓝色药草 |
食用 EAT |
32t |
仅解毒 |
是 |
研钵 + 蓝色药草 |
| 捣碎 |
捣碎的黄色药草 |
食用 EAT |
32t |
吸收 I · 200t |
否 |
研钵 + 黄色药草 |
| 混合 |
绿+绿 / 绿+红 / 绿+蓝 / 绿+黄 / 红+蓝 等 |
饮用 DRINK |
32t |
再生 I~II + 饱和/吸收，含 LSO 分次治疗 |
蓝系含解毒 |
管子 + 2 个捣碎药草 |
| 混合 |
三色混合（GGG/GGR/GGY/GGB/GYB/GRY/GRB） |
饮用 DRINK |
32t |
再生 III、吸收 III，治疗值更高 |
蓝系含解毒 |
管子 + 3 个捣碎药草；或「已混合 + 捣碎」追加 |
| 掉落权重（敌对生物被玩家击杀） |
掉落物 |
| < 0.55 |
绿色药草 |
| 0.55 ~ 0.80 |
蓝色药草 |
| 0.80 ~ 0.95 |
黄色药草 |
| ≥ 0.95 |
红色药草 |
4.10 背包与服饰（Curios）
| Curios 栏位 |
中文 |
可放物品 |
| back |
背部 |
各类背包 |
| body |
身体 |
战术背心、消防服胸甲等 |
| chest |
胸部 |
防弹背心、警用背心 |
| head |
头部 |
头盔、防化头罩 |
| legs / pants |
腿部 / 裤子 |
护腿、防化裤 |
| boots |
脚部 |
靴子、防化靴 |
| 背包操作 |
说明 |
| 右键 |
打开背包界面 |
| Shift + 右键 |
装备到背部栏 |
| Ctrl + 右键（物品栏中） |
快速更换背包 |
| 扩容 |
可升级容量，达到上限时提示「这个背包已经完全扩容」 |
| 类型 |
皮革背包、垃圾袋、小背包、远足背包、军用背包、旅行袋、挎包 |
| 其他 |
说明 |
| 塑料袋 |
Bundle 式储存 |
| 午餐袋 |
便携食物容器 |
| 火柴盒 |
点燃方块和火焰（20 点耐久，脚本实现） |
| 绳索 |
可放置可攀爬；潜行+右键向下延伸；落上可防摔落伤害 |
4.11 装饰工作台（sa_decor）
| 配方大类 |
内容 |
主要给料 |
规模 |
| STORAGE 存储 |
容器、货架、箱柜 |
金属板 / 螺丝 / 纸板 / 木板 |
约 60+ 方块 |
| FUNCTIONAL 功能 |
灯、开关、电箱、车库门、消防栓等 |
金属板 / 电子废料 / 绝缘铜缆 / 红石 |
约 80+ 方块 |
| DECOR 装饰 |
建材、家具、标牌、门 |
木板 / 金属板 / 砾石 / 混凝土 / 砖 |
约 200+ 方块 |
| MISC 杂项 |
兜底与特殊件 |
金属废料×4 + 螺丝×4 |
少量 |
| 附加规则 |
说明 |
| 自动染色 |
带颜色关键词的配方自动追加对应染料 |
| 自动工具 |
用到螺丝/钉子/金属管/线材时自动附加对应工具（螺丝刀/羊角锤/扳手/钳子），只耗耐久不消耗 |
| 产出数量 |
围栏 8、线材 4、表面方块 4、衍生形状 2–4、屋顶顶板 2 |
| 界面 |
仅显示有可用材料的配方；显示「花费」 |
| 例外（不可在工作台合成） |
战利品专用（收银机/消防栓/冰箱/油泵/微波炉/变压器/炉灶/空投/售货机）、破损/闪烁/熄灭状态变体、换色变体、部分道具/围挡/锁/睡袋等 |
| 独立物品 |
连接工具（塑料板×2 + 电子废料 + 红石×2 + 绝缘铜缆 + 螺丝刀，耗耐久） |
4.12 世界交互与安全系统
| 系统 |
物品/方块 |
操作要点 |
| 战利品箱 |
战利品箱魔杖 loot_crate_wand |
右键空气打开配置选择器；右键容器标记；Shift+右键标记为锁定；受保护的箱子需 Shift 才能破坏 |
| 结构门禁工具 |
structure_access_tool（创造工具） |
机械：挂锁 → 散落钥匙；电子：读卡器 → 门/读卡器/散落门禁卡；Shift+点击完成；Shift+右键空气清除 |
| 挂锁与钥匙 |
key、挂锁 |
挂锁只能装在侧面；所有者可配新钥匙；无主挂锁仅创造/管理员可配置；用撬锁器解除 |
| 门禁卡 |
keycard + 门禁读卡器 |
未编程卡需先登记；读卡器需连接到门；刷卡显示「允许访问 / 拒绝访问」 |
| 散落拾取物 |
loose_pickup |
靠近后按提示捡起（散落钥匙/门禁卡） |
| 车库门 |
garage_door / small_garage_door |
放在净空 5×4 开口底部中央；右键门或轨道开关；红石信号开、移除信号关 |
| 屋顶 |
camouflaged_roof |
需使用完整实心方块作为迷彩 |
| 路障 |
路障建造 |
主手锤子、副手废木料、背包带钉子；右键逐阶段建造；R 切换普通/大型 |
| 旋转魔杖 |
rotation_wand |
对装饰做 yaw/pitch/roll 视觉旋转 |
| 墙钟 |
wall_clock |
显示当前时间 |
| 饮水机 |
drinking_fountain |
饮水 |
| 躺尸 |
lying_corpse |
尸体装饰 |
| 售货机付款 |
open_pass |
需要付款，付款不足会提示 |
4.13 载具
| 类别 |
变体 |
说明 |
| 轿车/皮卡/警车/面包车/救护车 |
各含完好与破损变体（共 15 种） |
作为方块实体载具装饰，可开关门、有碰撞箱 |
4.14 经济与补给
| 渠道 |
说明 |
| 商人 |
会按坐标/维度抵达，一段时间后离开；用钞票交易蓝图与物资 |
| 钞票 / 一捆钞票 |
货币；成捆钞票可分解 |
| 补给空投 |
会预告「空投将在 X 秒后到达」，落地后打开获取物资；无安全降落点会中止 |
| 战利品箱 |
城市建筑内的锁定容器，需开锁或撬锁 |
五、操作 / 快捷键对照
| 操作 |
用途 |
| 右键 |
使用物品 / 打开界面 / 交互方块 |
| Shift + 右键 |
二次功能（装备背包、清空连接、启动电锯、倒出液体、标记锁定等） |
| Ctrl + 右键 |
快速更换背包（物品栏中） |
| 按住右键 |
持续动作（投掷、电锯锯切、弩拉弓等） |
| Shift + 左键 |
切换弩弹药 |
| 按住 Shift |
查看物品扩展说明 / 升级详情 |
| R |
路障建造时切换普通/大型 |
| 打开背包界面键 |
key.sa_combat.open_backpack_gui |
| 装填射钉枪键 |
key.sa_combat.reload_nail_gun |
六、关键材料速查
| 材料 |
用途方向 |
| 金属废料 / 废料粒 |
基础金属、拆解产物 |
| 金属板 / 小金属板 |
军火台、装饰工作台主力材料 |
| 螺丝 / 钉子 / 回形针 |
装配件（配套螺丝刀/羊角锤/钳子） |
| 电线 / 铜线 / 绝缘铜缆 |
电子与电力 |
| 电子废料 / 电池 |
电子设备、遥控引爆器 |
| 橡胶 / 塑料 / 塑料板 |
绝缘、防化服 |
| 布料 / 抹布 / 皮革条 / 破布 |
医疗与服饰 |
| 凯夫拉 / 凯夫拉线 |
高级防具、战术弩箭 |
| 灰烬钢锭 / 灰烬钢棒 / 灰烬钢粒 |
高级武器与升级 |
| 钻石粒 / 下界合金粒 |
顶级升级材料 |
| 硫磺 / 硫磺粉 / 木炭粉 |
火药相关 |
| 武器零件 |
改装、升级、装甲板的通用件 |
| 汽油（流体） |
汽油发电机、电锯 |
七、进阶路线建议
| 阶段 |
推荐目标 |
说明 |
| 前期 |
拆解箱 + 军火台 + 木/废料武器 |
用最廉价材料建立回收循环 |
| 前期 |
固体燃料发电机 + 回收机 |
把回收从手动升级为自动 |
| 中期 |
学完发电机手册 → 汽油发电机 |
高功率供电，支撑大基地 |
| 中期 |
蓝图武器 + 改装 + 第一条升级 |
优先「伤害」与「攻速」 |
| 中期 |
防弹背心 + 防弹板 I/II |
显著提升生存能力 |
| 中后期 |
灰烬钢系列武器/工具 |
材料来自回收与合成链 |
| 中后期 |
装饰工作台 + 电缆 + 门禁系统 |
建立可防御据点 |
| 后期 |
防弹板 III + 4 条满级升级 + 顶级蓝图武器 |
战斗力封顶 |
| 后期 |
消防服 / 保护伞制服 / 防化服全套 |
针对环境与状态抗性 |
八、与基岩版移植的对应关系（本项目）
| Java 模组系统 |
基岩版（本项目）现状 |
备注 |
| sa_core 材料/工具 |
已导入行为包/资源包（部分） |
见《幸存者军火库-物品总表》 |
| 食物 / 草药 |
食物已导入；草药尚未导入 |
草药属性见《幸存者军火库-草药属性表》 |
| 军火台与武器系统 |
未导入 |
见《幸存者军火库武器数据》 |
| 装饰方块 |
部分导入（救护车等） |
见《幸存者军火库-方块总表》《装饰方块分类表》 |
| 拆解箱/回收机/发电机 |
未导入 |
无对应 block_entity 实现 |
详细物品/方块清单以根目录各「总表」为准；本文件只描述玩法与操作流程。
