现代伙伴

现代伙伴 (NeoForge 1.21.1)

现代伙伴是 人类伙伴 的 NeoForge 1.21.1 移植版和重塑版，采用全新品牌形象，新增灵魂宝石、召唤法杖、自定义武器、可选魔法伙伴、枪械专家，以及更深入的伙伴成长系统。

招募人类追随者，为他们装备，塑造他们的个性，带领你日益壮大的队伍闯荡世界。

模组内容

• 十四个核心职业： 骑士、先锋、斧卫、狂战士、斥候、弓箭手、弩手、兽王、牧师、炼金术师、唤雷者、火焰法师、雷电法师和死灵法师。
• 可选魔法职业： 当安装 Iron's Spellbooks 或 Ars Nouveau 时，会额外提供九个伙伴职业：法师、术士、术士、女巫、老巫婆、冰霜法师、德鲁伊、幻术师和战斗法师。
• 枪械专家 (TacZ)： 稀有的可选枪械伙伴专精于手枪、冲锋枪、步枪、霰弹枪、狙击枪、机枪或重型武器。
• 生成宝石： 所有伙伴刷怪蛋都使用职业配色宝石外观，同时保留标准刷怪蛋行为。
• 灵魂宝石： 使用伙伴转移器可将伙伴的身份、属性、装备和物品栏以物品形式保存。
• 自定义武器： 可使用原版材料制作匕首、棍棒、战锤、长矛、法杖和长柄刀，在支持的情况下还可制作青铜变体。
• RPG属性和升级： 力量、敏捷、智力和耐力会影响战斗、速度、经验获取、生命值、防御和击退抗性。
• 无等级上限： 伙伴可以无限升级，除了实际服务器性能外，队伍规模没有硬性限制。
• 自定义名称和皮肤： 伙伴使用扩展的男性和女性名称库，包含中世纪和奇幻风格名称。使用 /companionskin "名称" URL 来指定 HTTP(S) 皮肤。
• 295个内置皮肤： 完整的男性/女性内置皮肤集可用于随机伙伴外观。
• 个性和日志： 伙伴拥有特质、背景故事、士气、羁绊、年龄、最喜爱的食物和持续的旅程统计。
• 伙伴语音： 五名性别匹配的配音演员提供问候、确认、拒绝、战斗喊话、痛苦、死亡、闲置和工作完成提示。语音播放可配置，重复提示会被抑制。
• Curios 和精良背包： 可选支持添加 Curios 槽位、渲染饰品、背包存储以及原生背包升级/设置。
• 伙伴资源： 体力支持疾跑和近战节奏。魔法伙伴还使用魔力值。
• 酿造： 制作可重复使用的容器，并酿造生命、再生、体力、魔力、 rejuvenation 和护盾药水。
• 生活职业： 伐木工、猎人、矿工、渔夫和厨师可以搜索、旅行、工作、收集、交付和恢复工作。职业是实验性的，默认隐藏。
• 安全控制： 每个伙伴都有村民和 PvP 保护控制，默认设置为安全。

近期更新

• 新增可配置的警报排除项、驯服食物/资源列表、手动狩猎目标、低生命值食物阈值、体力消耗、语音模式/音量、自动装备和基于半径的传送皮带。
• 新增 Epic Fight 战斗/渲染兼容性，包括伙伴武器能力和 TacZ 枪械姿势移交。
• 新增 TacZ 枪械专家，具有原生枪械、弹药、装填和分类特定装备行为。
• 新增可恢复的职业目标、交付箱、工作状态报告、安全工作行为和任务法杖。
• 新增装饰性护甲存储和逐槽位装备渲染控制，而不改变功能性护甲。

世界生成与刷新

• 伙伴建筑会生成在主世界中。
• 每个生成的建筑恰好产生一名居民。
• 结构放置分布在整个世界，并且可以配置。
• 使用 /locate structure #modern_companions:companion_houses 找到最近的伙伴结构。
• 使用 /place structure modern_companions:<id> 来放置特定结构。

职业详情

• 骑士： 使用剑、棍棒和长矛的平衡型近战战士。
• 先锋： 持盾坦克，拥有弹射物保护、抗性支援、额外生命值和怪物嘲讽。
• 斧卫： 重型斧战士，专为强力近战攻击而设计。
• 狂战士： 生命值降低时获得攻击力提升，并能横扫附近的敌人。
• 斥候： 快速散兵，拥有更高的移动力、跳跃力、摔落保护，以及背刺伤害加成。
• 弓箭手： 远程弓箭专家，自动装备弓箭。
• 弩手： 使用 1.21 版装填、冷却和视线机制的弩专家。
• 兽王： 拥有可成长的动物伙伴的远程战士。
• 牧师： 治疗盟友并对亡灵造成额外伤害的支援战士。
• 炼金术师： 对盟友使用有益药水，对敌人使用有害效果。
• 唤雷者： 使用三叉戟战斗的战士，可以召唤闪电并在命中后获得强化。
• 火焰法师： 使用精准、不引燃的火球和更重的爆炸攻击。
• 雷电法师： 使用单体闪电和风暴强化的连锁攻击。
• 死灵法师： 发射凋灵之首并召唤临时的友方凋灵骷髅。

可选魔法伙伴

可选的魔法伙伴使用已加载模组的实际法术系统，而不是用自定义后备攻击来替代它们。

• 法师： 召唤魔法武器并控制其存在时间。
• 术士： 元素进攻型施法者。
• 术士： 黑暗魔法专家。
• 女巫： 巫术、诅咒和战场控制。
• 老巫婆： 强大的减益和伤害施法者。
• 冰霜法师： 冰霜主题的控制和伤害魔法。
• 德鲁伊： 自然主题的魔法支援和攻击。
• 幻术师： 欺骗和远程法术专家。
• 战斗法师： 使用魔法攻击的近战战士。

当所需的可选模组未安装时，魔法伙伴、召唤宝石、结构及相关内容将不会出现。

枪械专家 (TacZ)

TacZ 枪械专家被永久分配到一种枪械类别，并且只能装备兼容的枪械。

支持的专精：

• 手枪
• 冲锋枪
• 步枪
• 霰弹枪
• 狙击枪
• 机枪
• 重型

专家使用 TacZ 的原生射击、弹药、装填和武器行为。仅当安装 TacZ 时，相应的召唤宝石才可用。

玩法介绍

1. 寻找： 在主世界定位一个伙伴结构。
2. 招募： 使用伙伴要求的精确食物和资源物品右键点击未驯服的伙伴。
3. 驯服： 满足两个要求的物品堆叠，即可解锁该伙伴及其物品栏。
4. 指挥： 使用伙伴界面选择跟随、巡逻、守卫、警报、狩猎、疾跑、拾取、清理、释放和半径控制。
5. 装备： 通过伙伴的物品栏给伙伴装备护甲、武器、工具、盾牌、火把或灯笼。
6. 成长： 伙伴通过击杀获得经验，并在升级时变得更强。
7. 恢复： 喂食受伤的伙伴，使用有益药水，或使用复活卷轴复活倒下的已驯服伙伴。
8. 集结： 使用召唤法杖召回当前位置维度中的所有存活伙伴和兽王宠物。

跟随的伙伴使用其保存的半径进行游荡和召回。半径值范围为 2 到 128 格。

驯服与维护

每个未驯服的伙伴会请求两堆特定的食物或资源。

• 资源等级权重为：70% 常见、25% 罕见、5% 稀有。
• 在玩家到达下界和海洋地区之前，这些地区的资源不可用。
• 最终资源需求在首次互动时确定，然后被保存。
• 空手互动会产生伙伴对话。
• 给予错误的食物会产生伙伴的不同反应。
• 伙伴可以吃熟食、蔬菜、水果、蜂蜜、附魔金苹果和有益药水。
• 伙伴会记住它们最喜爱的食物，喂食该食物会获得更好的羁绊和士气奖励。
• 设置 companion.lowHealthFoodThreshold（范围 0.0 到 1.0）来控制伙伴何时进食或请求食物。默认值为 0.5。

物品栏与装备

每个伙伴拥有：

• 一个 7x9 的个人物品栏。
• 专属的头盔、胸甲、护腿、靴子、主手和副手槽位。
• 一个 3D 物品栏预览。
• 自动护甲和武器选择。
• 从伙伴物品栏自动装备装备的可选功能（默认禁用）。
• 独立的装饰性护甲槽位，带有逐槽位可见性开关；装饰品改变外观而不替换功能性装备。
• 重新登录、捕获和重新部署后装备仍然保留。
• 仅限主人的村民和 PvP 安全控制。

装备规则防止伙伴拿起不合适的物品：

• 主手：工具和武器。
• 副手：盾牌、火把和灯笼。
• 手动装备的物品受到保护，不会被自动替换。

伙伴资源与药水

每个伙伴默认拥有 100 点体力。疾跑和成功的近战攻击会消耗体力。当体力为零时，疾跑会暂停，近战攻击使用较慢的节奏。

魔法伙伴还拥有 100 点魔力。法术消耗仅在法术成功施放后扣除。

五种可重复使用的容器形状支持六种药水类型：

• 生命药水： 立即恢复生命值。
• 再生药水： 随时间推移持续治疗。
• 体力药水： 恢复伙伴体力。
• 魔力药水： 恢复伙伴魔力。
• 恢复药水： 随时间推移恢复生命值、体力和魔力。
• 护盾药水： 提供临时护甲。

酿造配方可在 JEI 中查看，使用后的药水会返还匹配的空容器。

药水配方

制作五种可重复使用的空容器之一，用水瓶填充，然后与下界疣一起酿造，以制作匹配的空容器。在酿造台中加入列出的材料以完成药水。

每种药水使用后都会返还匹配的空容器。生命药水立即恢复，再生药水随时间治愈，体力/魔力药水恢复相应的伙伴资源，恢复药水随时间恢复全部三种资源，护盾药水提供临时护甲。

体力配置

• companion.staminaEnabled：设置为 false 以完全禁用体力系统。
• companion.sprintStaminaCost：每疾跑刻消耗的体力。默认值： 1。
• companion.meleeStaminaCost：每次成功近战命中消耗的体力。默认值： 8。

两个消耗设置都接受 0 到 100 之间的值。值为 0 表示禁用该单独消耗。

当体力被禁用时，伙伴保持满体力池，继续正常疾跑和攻击，并且 Jade 体力条会被隐藏。魔法伙伴的魔力仍然有效。

Curios 和精良背包

这两个集成都是可选的。

Curios

• 安装 Curios 后，伙伴会暴露 Curios 槽位。
• 每个伙伴都可以单独开关 Curio 渲染。
• 所有 TacZ 枪械专家都支持相同的 Curios 集成。

精良背包

在伙伴的 Curios 背部槽位中装备一个精良背包。

• 拾取的物品会先插入背包，然后再进入伙伴的正常物品栏。
• 背包按钮会打开精良背包的原生存储界面。
• 背包升级和设置仍然可用。
• 伙伴被捕获和重新部署时，背包装备仍然保留。

个性、士气、羁绊与日志

日志显示：

• 特质及其效果。
• 背景故事。
• 士气描述。
• 羁绊等级和经验值。
• 击杀数和重大击杀数。
• 复活次数。
• 与主人一起行走的距离。
• 首次招募日期。
• 伙伴年龄。
• 最喜爱的食物。

伙伴通常从 18 到 35 岁开始，并会随时间在视觉上变老。旧版本遗留的伙伴会一次性获得缺失的个性数据，而不会重复随机生成。

日志编辑菜单支持：

• 名称
• 年龄
• 简介
• 皮肤 URL

名称、年龄和简介的更新受主人验证并持久保留。皮肤编辑使用 HTTP(S) URL。

特质效果

• 勇敢： 更多伤害，跟随更紧密。
• 谨慎： 更大的跟随距离和较慢的移动速度。
• 守护者： 额外护甲。
• 鲁莽： 更快的移动速度和更紧密的跟随。
• 坚定： 击退抗性。
• 疾步： 提高移动和跟随速度。
• 贪食： 通过喂食获得更多羁绊经验值。
• 自律： 获得更多经验值并减少士气损失。
• 幸运： 有机会复制一次击杀掉落物。
• 夜猫子： 夜间获得伤害和速度加成。
• 日佑： 白天获得伤害和速度加成。
• 搞笑者： 减少士气损失。
• 忧郁： 士气低落时受到轻微伤害惩罚。
• 忠诚： 额外护甲和羁绊经验值。

物品与合成

武器

现代伙伴为每种自定义武器和材料组合添加了原版风格的配方。当安装兼容的青铜模组时，会出现青铜变体。

伙伴转移器

仅限主人的伙伴转移器将伙伴存储为发光的物品，同时保留其身份、UUID、物品栏、装备、属性和个性。

灵魂宝石

灵魂宝石通过伙伴转移器保存伙伴的灵魂，并允许之后重新部署。

召唤法杖

召唤法杖将当前维度中的所有存活伙伴和兽王宠物召回至主人附近的安全位置。

任务法杖

任务法杖将工作的伙伴与交付容器链接。使用法杖右键点击你拥有的伙伴，然后潜行右键点击一个容器。伙伴会将工作产出运送到那里，并且在职业支持时可以从那里提取原材料。

生成宝石

所有伙伴刷怪蛋都使用职业配色宝石外观，并可在现代伙伴创造模式标签页中找到。生存模式获取方式交由整合包作者和数据包处理。

复活卷轴

已驯服的伙伴会掉落包含其保存的属性、装备、物品栏和个性数据的复活卷轴。

副手持有一个下界之星激活卷轴，然后将其使用在方块或流体表面上，即可在该位置重新生成伙伴。

复活数据中会清除有害效果和可选的辐射，这样复活的伙伴不会立即重蹈导致死亡的覆辙。

属性附魔

赋能、灵巧、启迪和活力 通过伙伴护甲增加力量、敏捷、智力和耐力加成。

可使用 I–III 级。

附魔书可能出现在地牢、废弃矿井、要塞图书馆、神殿、埋藏的宝藏和沉船的战利品中。

职业

职业系统目前处于实验阶段，默认在玩家界面中禁用。在 config/modern_companions-common.toml 的 [jobs] 下设置 showJobsButton = true 以显示职业按钮。职业类别目前有意从原生配置界面中隐藏。

可用职业：

• 伐木工： 寻找成熟的自然树木，用斧头砍伐，收集原木，并在可能的情况下重新种植。
• 猎人： 使用剑、斧头、弓或弩追踪配置的狩猎目标并收集结果。
• 矿工： 勘察工作区域，使用镐安全地挖掘到配置的矿石目标。
• 渔夫： 寻找水域，使用钓鱼竿钓鱼并收集渔获。
• 厨师： 使用生食、烹饪配方和附近的营火、灵魂营火、熔炉或烟熏炉。熔炉和烟熏炉需要燃料。

要使用职业，请在职业界面中分配职业，给伙伴所需的工具，并使用任务法杖绑定交付容器。工作 控制开始或暂停职业。工作阶段和等待原因显示在工作面板中；战斗、路线受阻、物品栏已满和箱子不可用都会保留职业检查点以供稍后恢复。

配置

打开 模组 → 现代伙伴 → 配置 以获取玩家面向的设置。专用服务器使用通用的服务器配置。以下值是出厂默认值和可接受的范围。

世界生成

键	默认值	说明
averageHouseSeparation	20	伙伴房屋之间的平均区块间距；最小值为 11。

伙伴

键	默认值	说明
friendlyFireCompanions	false	允许伙伴互相伤害。
friendlyFirePlayer	true	允许伙伴伤害其主人。
fallDamage	true	允许摔落伤害。
spawnArmor	true	给新生成的伙伴随机护甲。
spawnWeapon	true	给新生成的伙伴一件武器。
autoEquip	false	自动从伙伴物品栏中装备合适的装备。
teleportLeash	false	当跟随的伙伴超出其选定半径 5 格时，将其传送到安全地点。
baseHealth	20	生成变化之前的基础生命值；最小值为 5。
lowHealthFood	true	允许伙伴在生命值低时进食和请求食物。
lowHealthFoodThreshold	0.5	低生命值食物行为的生命值阈值； 0.0–1.0。
staminaEnabled	true	启用体力系统。
sprintStaminaCost	1	每疾跑刻消耗的体力； 0–100，其中 0 禁用疾跑消耗。
meleeStaminaCost	8	每次成功近战命中消耗的体力； 0–100，其中 0 禁用近战消耗。
creeperWarning	true	警告并避开附近的苦力怕。
voiceMode	FULL	FULL 播放所有提示音， LIMITED 仅保留痛苦/死亡/闲置提示音， OFF 禁用自定义伙伴声音。
voiceVolume	80	自定义语音音量百分比； 0–100。

驯服、狩猎和警报

列表使用注册表 ID。物品列表接受如 minecraft:bread 的 ID；实体列表接受如 minecraft:goat 的 ID。Java 类名无效。

键	默认值	说明
allFoods	见下方默认值	伙伴可以请求、选择为最喜爱并用于治疗的食物。
extraHealConsumables	见下方默认值	伙伴可以吃但绝不会在驯服中请求的治疗物品；可以为空。
commonResourceItems	见下方默认值	常见驯服资源池。
uncommonResourceItems	见下方默认值	罕见驯服资源池。
rareResourceItems	见下方默认值	稀有驯服资源池。
huntMobs	见下方默认值	手动狩猎控制目标的实体 ID；可以为空。
excludedMobs	minecraft:creeper	从警报瞄准中排除的实体 ID；可以为空。否则，警报会识别已注册的怪物实体。现有配置会一次性添加苦力怕默认值。

creeperDefaultMigrated 是内部迁移标记，不应编辑。

默认列表：

allFoods = minecraft:cookie, minecraft:bread, minecraft:melon_slice, minecraft:apple, minecraft:sweet_berries, minecraft:carrot, minecraft:baked_potato, minecraft:cooked_salmon, minecraft:cooked_cod, minecraft:cooked_mutton, minecraft:cooked_porkchop, minecraft:cooked_beef, minecraft:cooked_chicken, minecraft:pumpkin_pie, minecraft:glow_berries, minecraft:potato, minecraft:beetroot, minecraft:dried_kelp, minecraft:cooked_rabbit
extraHealConsumables = minecraft:golden_apple, minecraft:enchanted_golden_apple, minecraft:golden_carrot, minecraft:honey_bottle, minecraft:mushroom_stew, minecraft:beetroot_soup, minecraft:rabbit_stew
commonResourceItems = minecraft:coal, minecraft:charcoal, minecraft:copper_ingot, minecraft:iron_ingot, minecraft:redstone, minecraft:lapis_lazuli, minecraft:flint, minecraft:clay_ball, minecraft:string, minecraft:leather, minecraft:bone, minecraft:feather
uncommonResourceItems = minecraft:gold_ingot, minecraft:amethyst_shard, minecraft:slime_ball, minecraft:gunpowder, minecraft:glowstone_dust, minecraft:prismarine_shard, minecraft:prismarine_crystals, minecraft:ender_pearl, minecraft:obsidian
rareResourceItems = minecraft:diamond, minecraft:emerald, minecraft:blaze_rod, minecraft:magma_cream
huntMobs = minecraft:chicken, minecraft:cow, minecraft:pig, minecraft:rabbit, minecraft:sheep, minecraft:goat

警报也可以通过 data/modern_companions/tags/entity_type/alert_unsafe.json 由整合包作者扩展。更高优先级的数据包可以使用 "replace": true 在 /reload 之前提供完整的安全策略。

个性

键	默认值	范围 / 说明
traitsEnabled	true	启用主要和次要出生特质。
secondaryTraitChance	40	次要特质的百分比几率； 0–100。
bondEnabled	true	启用羁绊/忠诚度。
moraleEnabled	true	启用士气及其微小的性能效果。
bondTickInterval	1200	在主人附近获得被动羁绊经验值的间隔刻数；最小值为 20。
bondTimeXp	5	每个被动间隔的羁绊经验值； 0–10000。
bondFeedXp	15	喂食时获得的羁绊经验值； 0–10000。
bondResurrectXp	80	复活时获得的羁绊经验值； 0–100000。
moraleFeedDelta	0.05	喂食时的士气变化； -1.0–1.0。
moraleNearDeathDelta	-0.07	濒死后士气变化； -1.0–1.0。
moraleResurrectDelta	-0.1	复活后士气变化； -1.0–1.0。
moraleBondLevelDelta	0.05	羁绊升级时的士气变化； -1.0–1.0。
luckyExtraDropChance	0.05	幸运特质额外掉落几率； 0.0–1.0（默认 5%）。

职业

职业设置在通用 TOML 中可用，但在职业功能处于实验阶段时从原生编辑器中隐藏。

键	默认值	范围 / 说明
lumberjackEnabled	true	启用伐木工行为。
lumberjackRadius	10	最小搜索半径； 4–64。伙伴半径可将其工作范围扩展到最多 128 格。
hunterEnabled	true	启用猎人行为。
hunterRadius	20	狩猎扫描半径； 6–64。
minerEnabled	true	启用矿工行为。
minerRadius	8	最小矿石搜索半径； 4–32。伙伴半径可将其工作范围扩展到最多 128 格。
minerAllowBlocks	[]	可选的方块 ID 白名单；空则使用默认的矿石标签。
minerDenyBlocks	minecraft:chest, minecraft:spawner	方块 ID 黑名单。
fisherEnabled	true	启用渔夫行为。
fisherRadius	10	水域搜索半径； 4–32。
chefEnabled	true	启用厨师行为。
chefRadius	8	热源搜索半径； 3–24。
assignedChestsChunkload	false	保持已分配的交付箱所在区块加载。
showJobsButton	false	在伙伴界面中显示职业按钮。

可选模组兼容性

所有集成都为可选，除非在需求中列出。依赖缺失模组的内容不会被注册。

模组	集成内容
Iron's Spellbooks	启用魔法伙伴及其原生法术 API。
Ars Nouveau	启用魔法伙伴及其原生法术 API。安装任一魔法模组即可获得九个可选魔法角色；两者可以同时使用。
TacZ	添加枪械专家、类别匹配的枪械和弹药、原生射击/装填行为以及匹配的召唤宝石。
Curios	添加伙伴 Curios 槽位、饰品渲染和逐槽位渲染开关。
精良背包	为装备在伙伴 Curios 背部槽位的背包添加原生背包界面、升级、设置和拾取插入。需要 Curios。
Epic Fight	添加骨架渲染器、移动、近战时序、命中逻辑和武器招式，同时保留伙伴职业、体力、装备和安全规则。内置武器系列包括匹配的 Epic Fight 能力。TacZ 枪支暂时使用 TacZ 的原生姿势；存放在仓库中的枪不会禁用 Epic Fight 近战。
Jade	在 HUD 中显示伙伴属性和体力/魔力条。
WTHIT	在 WTHIT 提示框中显示伙伴数据。
JEI	将自定义容器酿造步骤添加到 JEI 的酿造类别中。现代伙伴不提供专门的 REI 插件。
Better Combat	防止现代伙伴武器重复处理自定义攻击距离。
青铜武器提供者	当存在 bronze 模组 ID 时，注册青铜匕首、棍棒、战锤、长矛、法杖和长柄刀变体。
通用机械	当伙伴复活时清除通用机械的实体辐射。

当存在 Epic Fight 的可选 Epic Fight x Curios Compat 层时，也会检测到它，以便 Curios 饰品可以保持附着在 Epic Fight 伙伴渲染器上。

整合包作者可以通过 data/modern_companions/tags/entity_type/alert_unsafe.json 扩展不安全的实体 ID。更高优先级的数据包可以设置 "replace": true 在 /reload 之前提供完整的安全策略。

TacZ 伙伴枪械姿势包括一个仅限伙伴使用的 Epic Fight x TacZ Compat 改编版，由 ImperialArchitects 制作，遵循 MIT 许可证。版权所有 (c) 2026 ImperialArchitects。特此免费授予获得本软件副本及相关文档文件（“软件”）的任何人使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，前提是包含该版权声明和许可声明。本软件按“现状”提供，不提供任何形式的明示或暗示担保。

需求

• Minecraft 1.21.1
• NeoForge 21.1.219 或更新版本
• Java 21

鸣谢

• 人类伙伴 — justinwon777
• 基础武器 — Khazoda

带上你的小队，让他们吃饱，并带着你的伙伴们参与每一次冒险。