狼规则
本模组深受我个人制作的《巨狼》和《新手狼伙伴》数据包的启发。所有功能均已完善,并作为可选功能继承自上述数据包。
Wolf Rules 是一款面向服务器的 Forge 和 Fabric 模组,让你能够精细控制已驯服和野生狼的行为。
它还包含可追踪的战斗召唤功能,允许指定的狼响应来自附近或未加载区块的呼叫,而无需永久加载区块或进行全地图实体搜索。
模组的设计遵循以下原则:
- 默认设置均为禁用或等同于原版行为。
- 你可以一次性配置规则,并通过共享的全局配置文件在多个世界/服务器会话中重复使用。
- 规则可通过配置文件、游戏内配置界面以及游戏内命令进行调整。
配置模型
- Forge 配置文件:
config/wolfrules-common.toml
- Fabric 配置文件:
config/wolfrules-common.json
- 命令根节点:
/wolfrules
- 配置命令根节点:
/wolfrules config ...
- 战斗召唤快捷键:适用于两种加载器,默认未绑定。
- 游戏内配置界面:Fabric 通过 Mod Menu 访问,Forge 通过内置的模组配置入口访问。
- 在多人游戏中,当服务器支持且玩家拥有权限时,配置界面可与服务器权威值同步,并允许远程编辑。
- 通过命令进行的配置更改会立即生效并保存,无需触发重载提示音。
- 外部文件编辑在数值实际发生变化时会触发重载提示音。
命令亮点
- 玩家命令:
/wolfrules sitall
/wolfrules standall
/wolfrules recall
/wolfrules battlesummon
/wolfrules retire <target>
- 管理员/作弊命令:
/wolfrules grantwolf [player] [is_baby]
/wolfrules wipeplayerdata [player]
/wolfrules loadedchunks
/wolfrules config ...
规则参考(点击展开)
驯化
taming.singleBoneToTame (布尔值, 默认: false)
强制在有效的野生狼骨头交互时实现单次喂食即成功驯化。
- 禁用值:
false
- 原版参考:原版每次喂食骨头的驯化成功率约为 33%。
- 备注:在分配所有权之前,仍会检查
taming.maxTamedWolvesLimit。
taming.maxTamedWolvesLimit (整数, 默认: 0)
每位玩家可驯服狼的数量上限。
- 禁用值:
0(无限制)
- 原版参考:原版没有针对每位玩家的狼数量上限。
- 备注:在驯化、新手赠送和管理员授予狼时强制执行。如果繁殖达到上限,幼崽仍会生成,但会作为野生(未驯服)状态存在。
taming.starterWolfCount (整数, 默认: 0)
自首次加入以来,每位玩家可获得的新手狼总数目标。
- 禁用值:
0
- 原版参考:原版没有新手狼赠送系统。
- 备注:在登录时以及当此值增加时,会补发缺失数量的狼。新手赠送生成的狼为幼年已驯服状态,并受
taming.maxTamedWolvesLimit 限制。
taming.puppiesAutoSit (布尔值, 默认: false)
自动使繁殖出生的幼年驯服狼坐下。
- 禁用值:
false
- 原版参考:原版不会强制幼年狼坐下。
- 备注:仅适用于繁殖所有权流程。它不会自动使新手赠送狼、管理员授予狼生成、重生狼或其他通用幼年狼加载/驯化路径中的狼坐下。
核心属性
core_stats.defaultMaxHealth (双精度浮点数, 默认: 0.0)
覆盖受管理(已驯服)狼的最大生命值。
- 禁用值:
0.0(使用原版已驯服狼最大生命值 20.0)
- 原版参考:野生狼最大生命值
8.0,已驯服狼最大生命值 20.0。
- 备注:当最大生命值降低时,当前生命值会被钳制;当配置中的最大生命值更改时,当前生命值会根据生命值百分比重新映射。
core_stats.defaultArmor (双精度浮点数, 默认: 0.0)
覆盖受管理狼的护甲属性。
- 禁用值:
0.0(使用原版 0.0)
- 原版参考:狼的护甲值为
0.0。
- 备注:与
defaultArmorToughness 和 survival.damageResistanceLevels 叠加。
core_stats.defaultArmorToughness (双精度浮点数, 默认: 0.0)
覆盖受管理狼的护甲韧性。
- 禁用值:
0.0(使用原版 0.0)
- 原版参考:狼的护甲韧性为
0.0。
- 备注:与
defaultArmor 和生存伤害减免规则协同工作。
core_stats.attackDamage (双精度浮点数, 默认: 0.0)
覆盖受管理狼的攻击伤害属性。
- 禁用值:
0.0(使用原版已驯服值 4.0)
- 原版参考:野生狼攻击伤害
2.0,已驯服狼 4.0。
- 备注:最终伤害仍会与目标的护甲/韧性/抗性规则相互作用。
core_stats.attackRate (整数, 默认: 0)
设置受管理狼的近战攻击间隔(以刻为单位)。
- 禁用值:
0(使用原版 20 刻 = 1.0 秒)
- 原版参考:已驯服狼的近战节奏约为 20 刻。
- 备注:较低的值会使攻击更快,并增加战斗负载。
core_stats.attackRange (双精度浮点数, 默认: 0.0)
覆盖自定义狼近战目标使用的近战射程。
- 禁用值:
0.0(使用原版行为)
- 原版参考:原版使用内部碰撞箱/射程逻辑。
- 备注:与
attackRate 和 attackDamage 配合使用。
core_stats.wolfBaseSpeed (双精度浮点数, 默认: 0.0)
覆盖受管理狼的基础移动速度。
- 禁用值:
0.0(使用原版基础速度 0.3)
- 原版参考:狼移动速度属性的基础值为
0.3。
- 说明:在驯服期间持续生效。如果禁用,狼将恢复为存储的基础速度。
core_stats.wolfStepHeight (double, 默认值: 0.0)
覆盖受管治狼的攀爬高度。
- 禁用值:
0.0(使用原版攀爬高度 0.6)
- 原版参考:狼的攀爬高度为
0.6。
- 说明:在驯服期间持续生效。如果禁用,狼将恢复为存储的基础攀爬高度。
生存
survival.selfHealingEnabled (boolean, 默认值: false)
启用受伤受管治狼的被动周期性治疗。
- 禁用值:
false
- 原版参考:原版狼没有周期性的自我治疗计时器。
- 说明:需要
survival.selfHealingRate > 0;每次脉冲治疗 1.0 点生命值。
survival.selfHealingRate (double, 默认值: 30.0)
自我治疗脉冲之间的间隔秒数(支持小数)。
- 就绪值:
30.0
- 原版参考:无原版等效项。
- 说明:仅在
selfHealingEnabled 为 true 时使用。0.0 禁用计时器。
survival.fireResistanceEnabled (boolean, 默认值: false)
取消受管治狼受到的火焰标签伤害并清除燃烧状态。
- 禁用值:
false
- 原版参考:原版狼不免疫火焰。
- 说明:如果启用了
allDamageInvulnerability,此设置实际上是多余的。
survival.damageResistanceLevels (integer, 默认值: 0)
针对非穿透伤害类型的伤害减免,每级约减少 20%。
- 禁用值:
0
- 原版参考:狼没有可配置的原版伤害抗性等级。
- 说明:与护甲/韧性叠加;对穿透抗性伤害源无效。
survival.allDamageInvulnerability (boolean, 默认值: false)
取消所有作用于受管治狼的伤害。
- 禁用值:
false
- 原版参考:原版中狼并非完全无敌。
- 说明:启用时会覆盖其他生存伤害修正。
survival.fallDamageMultiplier (double, 默认值: 1.0)
受管治狼受到的跌落伤害倍率。
- 禁用行为:无禁用哨兵值;使用
1.0 以等效于原版。
- 原版参考:
1.0 类似于原版。
- 说明:
0.0 取消跌落伤害。来自安全传送回退的单发跌落消除仍可取消单次跌落事件。
survival.wolfRespawnMode (enum, 默认值: no_respawn)
控制哪些死亡的驯服狼可以重生。
- 值:
no_respawn、only_starter_wolves、all_tamed_wolves
- 原版参考:没有自动狼重生系统。
- 说明:使用
fallenWolfRespawnDelaySeconds。在主人在线附近重生并恢复站立状态。
survival.fallenWolfRespawnDelaySeconds (double, 默认值: 60.0)
符合条件的狼的重生延迟秒数(支持小数)。
- 就绪值:
60.0
- 原版参考:无原版等效项。
- 说明:当主人离线时计时器暂停,在线时恢复。仅当
survival.wolfRespawnMode 不为 no_respawn 时有效;0.0 禁用定时延迟。
survival.seekOwnerWhenLowHealthPercent (double, 默认值: 0.0)
在此生命值百分比或以下时,狼停止交战并优先移动到主人身边。
- 禁用值:
0.0
- 原版参考:无原版阈值规则。
- 说明:与
lowHealthDisengagePercent 配合良好。
survival.lowHealthDisengagePercent (double, 默认值: 0.0)
在此生命值百分比或以下时,狼清除当前的战斗目标。
- 禁用值:
0.0
- 原版参考:无原版阈值规则。
- 说明:与寻找/自动目标的健康门控结合使用。
survival.autoTargetMinHealthPercent (double, 默认值: 0.0)
狼仅在高于此生命值百分比时进行自动锁定目标。
- 禁用值:
0.0
- 原版参考:无原版自动目标健康门控。
- 说明:影响自动获取行为,不影响手动直接目标分配。
survival.lowHealthGlowPercent (double, 默认值: 0.0)
为低生命值的驯服狼添加发光轮廓。
- 禁用值:
0.0
- 原版参考:无原版低生命值发光规则。
- 说明:
100 表示只要狼未满血就发光。
喂食
feeding.rottenFleshAutoEatEnabled (boolean, 默认值: false)
允许受伤的受管治狼自动拾取并食用腐肉。
- 禁用值:
false
- 原版参考:无原版掉落物品自动进食循环。
- 说明:仅在生命值低于最大值且支持的喂食值有效时才会进食。
feeding.rottenFleshHealAmount (double, 默认值: 4.0)
每食用一块腐肉恢复的生命值。
- 就绪值:
4.0
- 原版参考:无原版等效项。
- 说明:每次成功的进食动作消耗一个腐肉物品。仅在
feeding.rottenFleshAutoEatEnabled 为 true 时有效。
feeding.rottenFleshSearchRadius (double, 默认值: 1.5)
搜索掉落腐肉的半径。
- 就绪值:
1.5
- 原版参考:无原版对应项。
- 备注:仅考虑已加载的物品实体以及可拾取的腐肉。仅在
feeding.rottenFleshAutoEatEnabled 为 true 时生效。
feeding.rottenFleshEatCooldown (double, 默认值: 0.25)
自动进食动作之间的冷却时间(秒)(支持小数)。
- 就绪值:
0.25
- 原版参考:无原版对应项。
- 备注:冷却时间基于持久化狼数据按每只狼单独追踪。
0.0 表示绝对零冷却,且该设置仅在 feeding.rottenFleshAutoEatEnabled 为 true 时生效。
跟随
follow.followDistanceMin (double, 默认值: 0.0)
跟随的狼停止靠近的近距离阈值。
- 禁用值:
0.0(原版近距离阈值为 2.0)
- 原版参考:停止距离约为
2.0。
- 备注:如果最大值低于最小值,运行时会将最大值视为最小值。
follow.followDistanceMax (double, 默认值: 0.0)
跟随的狼开始靠近的远距离阈值。
- 禁用值:
0.0(原版远距离阈值为 10.0)
- 原版参考:开始距离约为
10.0。
- 备注:如果最大值低于最小值,运行时将使用最小值。
follow.teleportRange (double, 默认值: 0.0)
启用跟随传送回退机制的距离阈值。
- 禁用值:
0.0(原版阈值约为 12.0)
- 原版参考:传送回退阈值约为
12.0。
- 备注:有效的运行时值至少被限制在
followDistanceMax。
follow.temporaryCatchUpSpeedBoost (double, 默认值: 0.0)
狼落后于主人时的临时速度加成。
- 禁用值:
0.0
- 原版参考:无专用的临时追赶加速设置。
- 备注:在跟随间隙区域且在触发传送回退之前生效。
follow.followThroughTeleports (boolean, 默认值: false)
当主人在同一维度内传送时,重新同步已加载且站立的所属狼。
- 禁用值:
false
- 原版参考:狼可能会被留在后面。
- 备注:包含安全放置逻辑和回退处理。
follow.followThroughDimensions (enum, 默认值: vanilla)
当主人更换维度时,已加载且站立的所属狼的行为模式。
- 可选值:
vanilla, wolves_tp_with_you, sit
- 原版参考:原版无法可靠地将所有跟随狼进行维度转移。
- 备注:转移模式会检查附近已加载的狼(128 方块半径),并使用安全抵达机制及传送门冷却保护。
follow.preventWolfPortalTravel (boolean, 默认值: false)
阻止狼通过传送门机制改变维度。
- 禁用值:
false
- 原版参考:狼可以正常使用传送门。
- 备注:影响驯养狼和野生狼。
follow.chunkLoadingMode (enum, 默认值: no_wolves)
控制哪些驯养狼可以强制加载其当前所在区块。
- 可选值:
no_wolves, all_wolves, starter_wolves_only, blue_collared_wolves_only
- 原版参考:原版没有针对狼的区块强制加载功能。
- 备注:与
chunkLoadingIgnoreMode 配合工作,且加载票证会在世界数据中持久保存。
follow.chunkLoadingIgnoreMode (enum, 默认值: ignore_sitting_or_passengers)
用于过滤不参与区块加载资格的狼的条件。
- 可选值:
ignore_none, ignore_sitting, ignore_passengers, ignore_sitting_or_passengers
- 原版参考:无对应项。
- 备注:作为
chunkLoadingMode 的附加过滤器应用。
群体命令
pack_commands.sitStandAllCommandEnabled (boolean, 默认值: true)
启用 /wolfrules sitall 和 /wolfrules standall 命令。
- 禁用值:
false
- 原版参考:原版没有群体坐下/起立的命令。
- 备注:使用
commandRadius,仅限同一维度内已加载的狼,并支持排除黑项圈狼的选项。
pack_commands.recallCommandEnabled (boolean, 默认值: true)
启用 /wolfrules recall 命令。
- 禁用值:
false
- 原版参考:原版没有召回命令。
- 备注:召回目标为固定 256 方块范围内、已加载、站立且属于主人的同一维度内的狼(忽略
commandRadius 设置)。
pack_commands.commandRadius (double, 默认值: 0.0)
sitall 和 standall 命令使用的半径。
- 特殊值:
0.0 表示在同一维度内所有已加载的狼之间无限范围。
- 原版参考:无对应项。
- 备注:不影响召回半径。
pack_commands.blackCollarIgnoresMassCommands (boolean, 默认值: false)
黑项圈狼会被群体命令跳过。
- 禁用值:
false
- 原版参考:项圈颜色在原版中没有群体命令行为。
- 备注:被跳过的狼仍可通过直接交互进行手动控制。
碰撞
collision.noPushMode (enum, 默认值: disabled)
控制涉及受管狼的碰撞推挤抑制。
- 可选值:
disabled
player_to_wolf_only
wolf_to_wolf
wolf_to_wolf_and_player
wolf_to_all_entities
- 原版参考:推挤功能已启用。
- 备注:涉及玩家的模式会保留玩家主导的轻微推挤效果,以便狼仍能被玩家移动所推开。
主人存在性
owner_presence.sitWolvesOnOwnerLogout (boolean, 默认值: false)
当主人登出时,使已加载的、处于站立状态的、属于主人的狼坐下。
- 禁用值:
false
- 原版参考:没有强制登出坐下的行为。
- 备注:将这些狼标记为可选的登录后恢复状态。
owner_presence.restoreStandingWolvesOnOwnerLogin (布尔值, 默认: false)
恢复在主人登出时被强制坐下的狼的站立状态。
- 禁用值:
false
- 原版参考:没有原版的记忆/恢复流程。
- 备注:仅恢复由登出坐下规则标记的狼。
owner_presence.ownerLoginRestoreWindowSeconds (双精度浮点数, 默认: 30.0)
登录后的时间窗口内,如果区块加载延迟,标记的狼仍可自动恢复状态。
- 特殊值:
0.0 表示仅立即尝试恢复。
- 原版参考:无等效项。
- 备注:仅在启用登录时恢复时有效。
owner_presence.ownerDeathBehavior (枚举, 默认: vanilla)
主人死亡时对已加载狼的即时响应。
- 值:
vanilla(原版)、sit(坐下)、clear_target(清除目标)、teleport_to_respawned_owner(传送至重生后的主人)
- 原版参考:无可配置的切换模式。
- 备注:传送模式会在死亡时标记相关的已加载跟随者,并在可能时将它们传送到重生的主人身边。
战斗
combat.friendlyFireAvoidanceEnabled (布尔值, 默认: false)
防止主人造成的伤害伤害到所属的狼。
- 禁用值:
false
- 原版参考:主人造成的伤害可能会伤害驯化的狼。
- 备注:检查来源/直接来源的所有权,并在触发时清除狼的战斗目标。
combat.wolvesNeverAttackPlayers (布尔值, 默认: false)
防止驯化的狼针对或攻击玩家。
- 禁用值:
false
- 原版参考:原版中驯化的狼在正常情况下可以攻击玩家。
- 备注:即使其他战斗规则允许针对玩家,此设置也适用。
combat.wildWolvesNeverAngryAtPlayers (布尔值, 默认: false)
防止野生狼对玩家保持愤怒状态。
- 禁用值:
false
- 原版参考:野生狼可以对玩家生气。
- 备注:清除未驯化狼的玩家目标和持久愤怒状态。
combat.targetPriorityMode (枚举, 默认: vanilla)
存在多个有效目标时的优先级策略。
- 值:
vanilla(原版)、owner_attacker_first(优先攻击主人的敌人)、closest_to_wolf_first(优先选择离狼最近的)、closest_to_owner_first(优先选择离主人最近的)、lowest_health_first(优先选择血量最低的)
- 原版参考:没有显式的可配置模式。
- 备注:用于运行时目标重新选择,并与多样化的目标分布相结合。
combat.diverseTargetDistributionEnabled (布尔值, 默认: false)
鼓励狼群分散攻击多个目标。
- 禁用值:
false
- 原版参考:狼群通常会自然地堆积在一个目标上。
- 备注:在评分中添加焦点惩罚,使得已经被聚焦的目标吸引力降低。
combat.battleSummonOrderEnabled (布尔值, 默认: true)
启用来自 /wolfrules battlesummon 命令和战斗召唤按键绑定的手动战斗召唤指令。
- 禁用值:
false
- 原版参考:没有原版的战斗召唤指令或狼群集结命令。
- 备注:仅控制手动指令。当此选项禁用时,来自
combat.autoBattleSummonHealthPercent 的自动召唤仍使用相同的跟踪召唤系统。
combat.battleSummonMaxCount (整数, 默认: 5)
一次召唤中可以响应的符合条件的战斗就绪狼的最大数量。
- 就绪值:
5
- 原版参考:无原版等效项。
- 备注:适用于手动和自动战斗召唤。系统首先选择最多此数量的已跟踪符合条件狼,并受
safety_caps.battleSummonMaxCount(默认 64)硬性限制。
combat.battleSummonDesignationMode (枚举, 默认: white_collar)
控制如何指定狼为战斗就绪状态。
- 值:
white_collar(白项圈)、starter_wolves_only(仅限初始狼)、all_wolves(所有狼)
- 原版参考:没有原版的战斗就绪指定系统。
- 备注:
white_collar 意味着主人通过将狼的项圈染成白色来指定它。召唤系统保留一个持久化的跟踪狼索引,以便它可以使用临时目标区块票从卸载的区块中提取仅选定的狼,而不是持续加载区块或进行全局实体扫描。
combat.autoBattleSummonHealthPercent (双精度浮点数, 默认: 0.0)
当主人受到伤害后生命值降至或低于此百分比时,自动触发战斗召唤。
- 禁用值:
0.0
- 原版参考:没有原版的自动集结触发器。
- 备注:
100.0 意味着任何伤害都可以触发召唤,而 0.0 禁用自动战斗召唤。使用与手动召唤相同的召唤池、指定规则和内部每秒每个主人一次的服务器冷却时间。
combat.autoEngageEntityList (列表, 默认: 空)
允许站立的驯化狼自动交战获取目标的实体类型。
- 禁用值:空列表
[]
- 原版参考:无可配置的自动交战目标列表。
- 备注:与
combat.wolvesAutoEngageZombies 合并;仍受健康门槛、禁止目标规则、黑名单以及原版 wantsToAttack 检查的限制。
- 命令别名:
/wolfrules config combat auto_engage list
/wolfrules config combat auto_engage add_entity <entity_type>
/wolfrules config combat auto_engage remove_entity <entity_type>
/wolfrules config combat auto_engage clear
combat.wolvesAutoEngageZombies (布尔值, 默认: false)
允许站立的家养狼自动获取附近的僵尸类目标。
- 禁用值:
false
- 原版参考:无专用的僵尸自动交战开关。
- 备注:与健康门槛、僵尸村民排除、目标优先级模式以及自动交战列表配合使用。
combat.protectedEntityBlacklist (列表, 默认: 空)
家养狼的硬目标黑名单。
- 禁用值:空列表
[]
- 原版参考:无等效列表。
- 备注:阻止对列表中实体类型的目标获取/保持以及攻击尝试。
- 命令别名:
/wolfrules config combat target_blacklist list
/wolfrules config combat target_blacklist add_entity <entity_type>
/wolfrules config combat target_blacklist remove_entity <entity_type>
/wolfrules config combat target_blacklist clear
combat.wolvesNeverTargetZombieVillagers (布尔值, 默认: false)
阻止家养狼攻击僵尸村民。
- 禁用值:
false
- 原版参考:无专用开关。
- 备注:防止对僵尸村民进行目标获取和保持行为。
combat.creeperTargetOwnerRetaliationOnly (布尔值, 默认: false)
仅当主人最近攻击过该特定苦力怕时,才允许苦力怕作为目标。
- 禁用值:
false
- 原版参考:狼默认会避开苦力怕。
- 备注:使用短暂的主人命中窗口和精确的苦力怕身份检查。
combat.combatLeashMaxDistance (双精度浮点数, 默认: 0.0)
战斗期间狼脱离前主人的最大距离。
- 禁用值:
0.0
- 原版参考:无可配置的战斗牵引绳主人距离限制。
- 备注:有助于防止远距离追逐漂移。
额外狼匹工具
/wolfrules retire [target]
无需管理员配置更改即可将你自己的家养狼恢复为野生状态。
- 如果省略参数,目标默认为你准星指向的狼。
- 你可以使用选择器如
@e[type=wolf,limit=1,sort=nearest]。
- 起始狼受到保护,无法退役。
- 退役会清除 Wolf Rules 的狼端运行时/持久化数据,以便从群系系统中干净移除。
/wolfrules battlesummon
解除就坐状态并将备战就绪的狼召唤至你身边,包括在卸载区块中追踪的狼。
- 玩家命令。
- 受
combat.battleSummonOrderEnabled、combat.battleSummonMaxCount 和 combat.battleSummonDesignationMode 限制。
- 对应的按键绑定会发出相同的命令,且默认未绑定。
- 使用持久化的已追踪狼快照加上临时的目标区块加载,而不是持续加载区块或大规模实体搜索。
- 与自动战斗召唤共享 1 秒的内部服务器冷却时间。
/wolfrules loadedchunks
列出服务器上当前激活的由狼驱动的区块强制加载条目。
- 管理员/作弊命令。
- 用于验证
follow.chunkLoadingMode 和 follow.chunkLoadingIgnoreMode。
- 输出包括维度、区块位置、狼的身份以及所有者身份(如有)。
/wolfrules grantwolf [player] [is_baby]
管理员授予命令,用于在目标玩家附近生成一只家养狼。
- 如果省略玩家参数,目标默认为你自己。
- 受
taming.maxTamedWolvesLimit 限制。
- 可选的
is_baby 标志会生成一只幼年狼,但通过授予创建的狼不被视为 taming.puppiesAutoSit 中的繁殖幼崽。
/wolfrules wipeplayerdata [player]
清除用于起始狼授予追踪的持久化 Wolf Rules 玩家数据。
- 管理员/作弊命令。
- 如果省略玩家参数,目标默认为你自己。
- 用于重新测试首次加入时的起始狼流程及起始狼授予进度。
Wolf Rules
This mod is heavily inspired by my own Greater Wolves and Starter Wolf Companion datapacks. All features have been perfected, and inherited from them as optional features in this mod.
Wolf Rules is a server-first mod for Forge and Fabric that gives you fine control over tamed and wild wolf behavior.
It also includes tracked battle summons, letting designated wolves answer a call from nearby or unloaded chunks without permanent chunk loading or world-wide entity searches.
The mod is designed so that:
- Defaults are disabled or vanilla-equivalent.
- You can configure rules once and reuse them across worlds/server sessions with the shared common config file.
- Rules are adjustable from config files, the in-game config screen, and in-game commands.
Configuration Model
- Forge config file:
config/wolfrules-common.toml
- Fabric config file:
config/wolfrules-common.json
- Command root:
/wolfrules
- Config command root:
/wolfrules config ...
- Battle summon keybind: available on both loaders and unbound by default.
- In-game config screen: available through Mod Menu on Fabric and the built-in mod config screen entry on Forge.
- On multiplayer, the config screen can sync with server-authoritative values and allow remote edits when the server supports it and the player has permission.
- Command-driven config changes apply live and save without the reload ding.
- External file edits can trigger the reload ding when values actually change.
Command Highlights
- Player commands:
/wolfrules sitall
/wolfrules standall
/wolfrules recall
/wolfrules battlesummon
/wolfrules retire <target>
- Admin/cheats commands:
/wolfrules grantwolf [player] [is_baby]
/wolfrules wipeplayerdata [player]
/wolfrules loadedchunks
/wolfrules config ...
Rule Reference (Click To Expand)
Taming
taming.singleBoneToTame (boolean, default: false)
Forces one-bone tame success on valid wild-wolf bone interaction.
- Disabled value:
false
- Vanilla reference: vanilla taming is about 33 percent success per bone.
- Notes: still checks
taming.maxTamedWolvesLimit before ownership assignment.
taming.maxTamedWolvesLimit (integer, default: 0)
Per-player tamed wolf ownership cap.
- Disabled value:
0 (unlimited)
- Vanilla reference: vanilla has no per-player wolf cap.
- Notes: enforced on taming, starter grants, and admin grantwolf. If breeding hits cap, puppy still spawns but as wild (untamed).
taming.starterWolfCount (integer, default: 0)
Target total starter wolves granted per player since first join.
- Disabled value:
0
- Vanilla reference: vanilla has no starter-wolf grant system.
- Notes: grants the missing amount on login and when this value increases. Starter grants spawn as baby tamed wolves and respect
taming.maxTamedWolvesLimit.
taming.puppiesAutoSit (boolean, default: false)
Auto-sits breeding-born tamed puppies.
- Disabled value:
false
- Vanilla reference: vanilla does not force-sit puppies.
- Notes: applies only to the breeding ownership flow. It does not auto-sit starter-grant wolves, admin grantwolf spawns, respawned wolves, or other generic baby-wolf load/tame paths.
Core Stats
core_stats.defaultMaxHealth (double, default: 0.0)
Overrides max health for managed (tamed) wolves.
- Disabled value:
0.0 (uses vanilla tamed max health 20.0)
- Vanilla reference: wild wolf max health
8.0, tamed wolf max health 20.0.
- Notes: on max-health decrease, health is clamped; on config max-health changes, current health is remapped by health percent.
core_stats.defaultArmor (double, default: 0.0)
Overrides armor attribute for managed wolves.
- Disabled value:
0.0 (uses vanilla 0.0)
- Vanilla reference: wolf armor is
0.0.
- Notes: stacks with
defaultArmorToughness and survival.damageResistanceLevels.
core_stats.defaultArmorToughness (double, default: 0.0)
Overrides armor toughness for managed wolves.
- Disabled value:
0.0 (uses vanilla 0.0)
- Vanilla reference: wolf armor toughness is
0.0.
- Notes: works together with
defaultArmor and survival damage reduction rules.
core_stats.attackDamage (double, default: 0.0)
Overrides attack damage attribute for managed wolves.
- Disabled value:
0.0 (uses vanilla tamed value 4.0)
- Vanilla reference: wild wolf attack damage
2.0, tamed wolf 4.0.
- Notes: final damage still interacts with target armor/toughness/resistance rules.
core_stats.attackRate (integer, default: 0)
Sets melee attack interval for managed wolves in ticks.
- Disabled value:
0 (uses vanilla 20 ticks = 1.0 second)
- Vanilla reference: tamed wolf melee cadence is about 20 ticks.
- Notes: lower values attack faster and increase combat workload.
core_stats.attackRange (double, default: 0.0)
Overrides melee reach used by the custom wolf melee goal.
- Disabled value:
0.0 (uses vanilla behavior)
- Vanilla reference: vanilla uses internal hitbox/reach logic.
- Notes: works with
attackRate and attackDamage.
core_stats.wolfBaseSpeed (double, default: 0.0)
Overrides base movement speed for managed wolves.
- Disabled value:
0.0 (uses vanilla base speed 0.3)
- Vanilla reference: wolf movement speed attribute base is
0.3.
- Notes: continuously applied while tamed. If disabled, wolf returns to stored baseline speed.
core_stats.wolfStepHeight (double, default: 0.0)
Overrides step height for managed wolves.
- Disabled value:
0.0 (uses vanilla step height 0.6)
- Vanilla reference: wolf step height is
0.6.
- Notes: continuously applied while tamed. If disabled, wolf returns to stored baseline step height.
Survival
survival.selfHealingEnabled (boolean, default: false)
Enables passive periodic healing for injured managed wolves.
- Disabled value:
false
- Vanilla reference: vanilla wolves have no periodic self-heal timer.
- Notes: requires
survival.selfHealingRate > 0; heals 1.0 health per pulse.
survival.selfHealingRate (double, default: 30.0)
Seconds between self-heal pulses (decimal supported).
- Ready value:
30.0
- Vanilla reference: no vanilla equivalent.
- Notes: only used when
selfHealingEnabled is true. 0.0 disables the timer.
survival.fireResistanceEnabled (boolean, default: false)
Cancels fire-tagged damage and clears burning on managed wolves.
- Disabled value:
false
- Vanilla reference: vanilla wolves are not fire immune.
- Notes: if
allDamageInvulnerability is enabled, this setting is effectively redundant.
survival.damageResistanceLevels (integer, default: 0)
Incoming damage reduction at about 20 percent per level for non-bypass damage types.
- Disabled value:
0
- Vanilla reference: no configurable vanilla damage resistance level for wolves.
- Notes: stacks with armor/toughness; ignored by bypass-resistance damage sources.
survival.allDamageInvulnerability (boolean, default: false)
Cancels all incoming damage to managed wolves.
- Disabled value:
false
- Vanilla reference: wolves are not fully invulnerable in vanilla.
- Notes: overrides other survival damage modifiers while enabled.
survival.fallDamageMultiplier (double, default: 1.0)
Multiplier for incoming fall damage on managed wolves.
- Disable behavior: no disable sentinel; use
1.0 for vanilla-equivalent.
- Vanilla reference:
1.0 is vanilla-like.
- Notes:
0.0 cancels fall damage. One-shot fall negation from safe teleport fallback can still cancel an individual fall event.
survival.wolfRespawnMode (enum, default: no_respawn)
Controls which dead tamed wolves can respawn.
- Values:
no_respawn, only_starter_wolves, all_tamed_wolves
- Vanilla reference: no automatic wolf respawn system.
- Notes: uses
fallenWolfRespawnDelaySeconds. Respawns near online owner and return standing.
survival.fallenWolfRespawnDelaySeconds (double, default: 60.0)
Respawn delay in seconds for eligible wolves (decimal supported).
- Ready value:
60.0
- Vanilla reference: no vanilla equivalent.
- Notes: timer pauses while owner is offline and resumes when online. Only matters when
survival.wolfRespawnMode is not no_respawn; 0.0 disables the timed delay.
survival.seekOwnerWhenLowHealthPercent (double, default: 0.0)
At or below this health percent, wolf disengages and prioritizes moving to owner.
- Disabled value:
0.0
- Vanilla reference: no vanilla threshold rule.
- Notes: pairs well with
lowHealthDisengagePercent.
survival.lowHealthDisengagePercent (double, default: 0.0)
At or below this health percent, wolf clears current combat target.
- Disabled value:
0.0
- Vanilla reference: no vanilla threshold rule.
- Notes: combines with seek/auto-target health gating.
survival.autoTargetMinHealthPercent (double, default: 0.0)
Wolf auto-targeting only occurs while above this health percent.
- Disabled value:
0.0
- Vanilla reference: no vanilla auto-target health gate.
- Notes: affects auto-acquire behavior, not manual direct target assignment.
survival.lowHealthGlowPercent (double, default: 0.0)
Adds glowing outline to low-health tamed wolves.
- Disabled value:
0.0
- Vanilla reference: no vanilla low-health glow rule.
- Notes:
100 means glow whenever wolf is below full health.
Feeding
feeding.rottenFleshAutoEatEnabled (boolean, default: false)
Allows injured managed wolves to auto-consume dropped rotten flesh.
- Disabled value:
false
- Vanilla reference: no vanilla dropped-item auto-eat loop.
- Notes: only eats when health is below max and supporting feeding values are valid.
feeding.rottenFleshHealAmount (double, default: 4.0)
Health restored per rotten flesh consumed.
- Ready value:
4.0
- Vanilla reference: no vanilla equivalent.
- Notes: one rotten flesh item is consumed per successful eat action. Only matters when
feeding.rottenFleshAutoEatEnabled is true.
feeding.rottenFleshSearchRadius (double, default: 1.5)
Search radius for dropped rotten flesh.
- Ready value:
1.5
- Vanilla reference: no vanilla equivalent.
- Notes: only considers loaded item entities and pickup-eligible rotten flesh. Only matters when
feeding.rottenFleshAutoEatEnabled is true.
feeding.rottenFleshEatCooldown (double, default: 0.25)
Cooldown in seconds between auto-eat actions (decimal supported).
- Ready value:
0.25
- Vanilla reference: no vanilla equivalent.
- Notes: cooldown is tracked per wolf in persistent wolf data.
0.0 means literal zero cooldown, and the setting only matters when feeding.rottenFleshAutoEatEnabled is true.
Follow
follow.followDistanceMin (double, default: 0.0)
Near distance where following wolves can stop closing in.
- Disabled value:
0.0 (vanilla near distance 2.0)
- Vanilla reference: stop distance about
2.0.
- Notes: if max is lower than min, runtime treats max as min.
follow.followDistanceMax (double, default: 0.0)
Far distance where following wolves start closing in.
- Disabled value:
0.0 (vanilla far distance 10.0)
- Vanilla reference: start distance about
10.0.
- Notes: if max is lower than min, runtime uses min.
follow.teleportRange (double, default: 0.0)
Distance where follow teleport fallback is used.
- Disabled value:
0.0 (vanilla threshold about 12.0)
- Vanilla reference: teleport fallback around
12.0.
- Notes: effective runtime value is clamped to at least
followDistanceMax.
follow.temporaryCatchUpSpeedBoost (double, default: 0.0)
Temporary speed bonus while wolf is behind owner.
- Disabled value:
0.0
- Vanilla reference: no dedicated temporary catch-up boost setting.
- Notes: active in follow gap zone before teleport fallback.
follow.followThroughTeleports (boolean, default: false)
Resyncs loaded, standing owned wolves when owner teleports in the same dimension.
- Disabled value:
false
- Vanilla reference: wolves can be left behind.
- Notes: includes safe-placement logic and fallback handling.
follow.followThroughDimensions (enum, default: vanilla)
Behavior for loaded, standing owned wolves when owner changes dimension.
- Values:
vanilla, wolves_tp_with_you, sit
- Vanilla reference: no reliable vanilla transfer for all follower wolves.
- Notes: transfer mode checks nearby loaded wolves (128 block radius) and uses safe arrival + portal cooldown protections.
follow.preventWolfPortalTravel (boolean, default: false)
Prevents wolves from changing dimension through portal mechanics.
- Disabled value:
false
- Vanilla reference: wolves can use portals normally.
- Notes: affects both tamed and wild wolves.
follow.chunkLoadingMode (enum, default: no_wolves)
Controls which tamed wolves can force-load their current chunk.
- Values:
no_wolves, all_wolves, starter_wolves_only, blue_collared_wolves_only
- Vanilla reference: no wolf-specific chunk forcing in vanilla.
- Notes: works with
chunkLoadingIgnoreMode, and tickets are persisted in world data.
follow.chunkLoadingIgnoreMode (enum, default: ignore_sitting_or_passengers)
Filter for wolves ignored by chunk loading eligibility.
- Values:
ignore_none, ignore_sitting, ignore_passengers, ignore_sitting_or_passengers
- Vanilla reference: no equivalent.
- Notes: applies as additional filter on top of
chunkLoadingMode.
Pack Commands
pack_commands.sitStandAllCommandEnabled (boolean, default: true)
Enables /wolfrules sitall and /wolfrules standall.
- Disabled value:
false
- Vanilla reference: no vanilla pack sit/stand command.
- Notes: uses
commandRadius, same-dimension loaded wolves, and black-collar exclusion option.
pack_commands.recallCommandEnabled (boolean, default: true)
Enables /wolfrules recall.
- Disabled value:
false
- Vanilla reference: no vanilla recall command.
- Notes: recall targets standing, loaded, same-dimension owned wolves within fixed 256 blocks (ignores
commandRadius).
pack_commands.commandRadius (double, default: 0.0)
Radius used by sitall and standall.
- Special value:
0.0 means unlimited across loaded wolves in same dimension.
- Vanilla reference: no equivalent.
- Notes: does not affect recall radius.
pack_commands.blackCollarIgnoresMassCommands (boolean, default: false)
Black-collared wolves are skipped by mass pack commands.
- Disabled value:
false
- Vanilla reference: collar color has no vanilla pack-command behavior.
- Notes: skipped wolves remain manually controllable by direct interaction.
Collision
collision.noPushMode (enum, default: disabled)
Controls collision push suppression involving managed wolves.
- Values:
disabled
player_to_wolf_only
wolf_to_wolf
wolf_to_wolf_and_player
wolf_to_all_entities
- Vanilla reference: pushing is enabled.
- Notes: player-involved modes keep player-dominant nudging so wolves can still be moved aside by player movement.
Owner Presence
owner_presence.sitWolvesOnOwnerLogout (boolean, default: false)
Force-sits loaded standing owned wolves when owner logs out.
- Disabled value:
false
- Vanilla reference: no forced logout sit behavior.
- Notes: marks these wolves for optional post-login restore.
owner_presence.restoreStandingWolvesOnOwnerLogin (boolean, default: false)
Restores standing state for wolves that were force-sat on owner logout.
- Disabled value:
false
- Vanilla reference: no vanilla memory/restore flow.
- Notes: only restores wolves marked by the logout-sit rule.
owner_presence.ownerLoginRestoreWindowSeconds (double, default: 30.0)
Time window after login where marked wolves can still auto-restore if chunks load late.
- Special value:
0.0 means immediate restore attempt only.
- Vanilla reference: no equivalent.
- Notes: used only when restore-on-login is enabled.
owner_presence.ownerDeathBehavior (enum, default: vanilla)
Immediate loaded-wolf response to owner death.
- Values:
vanilla, sit, clear_target, teleport_to_respawned_owner
- Vanilla reference: no configurable mode switch.
- Notes: teleport mode marks relevant loaded followers on death, then moves them to respawned owner when possible.
Combat
combat.friendlyFireAvoidanceEnabled (boolean, default: false)
Prevents owner-caused damage to owned wolves.
- Disabled value:
false
- Vanilla reference: owner-caused damage can hurt tamed wolves.
- Notes: checks source/direct source ownership and clears wolf combat target when triggered.
combat.wolvesNeverAttackPlayers (boolean, default: false)
Prevents tamed wolves from targeting or damaging players.
- Disabled value:
false
- Vanilla reference: vanilla tamed wolves can attack players in normal contexts.
- Notes: applies even if other combat rules would otherwise allow player targeting.
combat.wildWolvesNeverAngryAtPlayers (boolean, default: false)
Prevents wild wolves from maintaining anger against players.
- Disabled value:
false
- Vanilla reference: wild wolves can anger at players.
- Notes: clears player target and persistent anger state for untamed wolves.
combat.targetPriorityMode (enum, default: vanilla)
Priority strategy when multiple valid targets exist.
- Values:
vanilla, owner_attacker_first, closest_to_wolf_first, closest_to_owner_first, lowest_health_first
- Vanilla reference: no explicit configurable mode.
- Notes: used by runtime target reselection and combines with diverse target distribution.
combat.diverseTargetDistributionEnabled (boolean, default: false)
Encourages packs to split across multiple targets.
- Disabled value:
false
- Vanilla reference: packs often naturally pile one target.
- Notes: adds a focus penalty in scoring so already-focused targets become less attractive.
combat.battleSummonOrderEnabled (boolean, default: true)
Enables manual battle summon orders from /wolfrules battlesummon and the battle summon keybind.
- Disabled value:
false
- Vanilla reference: no vanilla battle summon order or wolf rally command.
- Notes: controls only manual orders. Auto summons from
combat.autoBattleSummonHealthPercent still use the same tracked summon system even when this is disabled.
combat.battleSummonMaxCount (integer, default: 5)
Maximum number of eligible battle-ready wolves that can answer one summon.
- Ready value:
5
- Vanilla reference: no vanilla equivalent.
- Notes: applies to both manual and auto battle summons. The system selects up to this many tracked eligible wolves first and is hard-capped by
safety_caps.battleSummonMaxCount (default 64).
combat.battleSummonDesignationMode (enum, default: white_collar)
Controls how wolves are designated as battle-ready.
- Values:
white_collar, starter_wolves_only, all_wolves
- Vanilla reference: no vanilla battle-ready designation system.
- Notes:
white_collar means the owner designates a wolf by dyeing its collar white. The summon system keeps a persisted tracked-wolf index so it can pull only selected wolves from unloaded chunks using temporary targeted chunk tickets instead of constant chunk loading or world-wide entity scans.
combat.autoBattleSummonHealthPercent (double, default: 0.0)
Automatically triggers battle summons when owner health falls to or below this percent after taking damage.
- Disabled value:
0.0
- Vanilla reference: no vanilla auto-rally trigger.
- Notes:
100.0 means any damage can trigger a summon, while 0.0 disables auto battle summons. Uses the same summon pool, designation rules, and internal 1-second per-owner server cooldown as manual summons.
combat.autoEngageEntityList (list, default: empty)
Entity types allowed for auto-engage acquisition by standing tamed wolves.
- Disable value: empty list
[]
- Vanilla reference: no configurable auto-engage list.
- Notes: unioned with
combat.wolvesAutoEngageZombies; still respects health gates, disallowed-target rules, blacklist, and vanilla wantsToAttack checks.
- Command alias:
/wolfrules config combat auto_engage list
/wolfrules config combat auto_engage add_entity <entity_type>
/wolfrules config combat auto_engage remove_entity <entity_type>
/wolfrules config combat auto_engage clear
combat.wolvesAutoEngageZombies (boolean, default: false)
Allows standing tamed wolves to auto-acquire nearby zombie-family targets.
- Disabled value:
false
- Vanilla reference: no dedicated zombie auto-engage toggle.
- Notes: works with health gates, zombie-villager exclusion, target priority mode, and auto-engage list.
combat.protectedEntityBlacklist (list, default: empty)
Hard target blacklist for tamed wolves.
- Disable value: empty list
[]
- Vanilla reference: no equivalent list.
- Notes: blocks target acquire/keep and outgoing attack attempts for listed entity types.
- Command alias:
/wolfrules config combat target_blacklist list
/wolfrules config combat target_blacklist add_entity <entity_type>
/wolfrules config combat target_blacklist remove_entity <entity_type>
/wolfrules config combat target_blacklist clear
combat.wolvesNeverTargetZombieVillagers (boolean, default: false)
Blocks zombie villager targeting by tamed wolves.
- Disabled value:
false
- Vanilla reference: no dedicated toggle.
- Notes: prevents acquire and keep behavior for zombie villagers.
combat.creeperTargetOwnerRetaliationOnly (boolean, default: false)
Allows creeper targeting only when owner recently attacked that exact creeper.
- Disabled value:
false
- Vanilla reference: wolves avoid creepers by default.
- Notes: uses short owner-hit window and exact creeper identity check.
combat.combatLeashMaxDistance (double, default: 0.0)
Max owner distance during combat before wolf disengages.
- Disabled value:
0.0
- Vanilla reference: no configurable owner-distance combat leash.
- Notes: helps prevent long-distance chase drift.
Extra Wolf Utility
/wolfrules retire [target]
Converts your own tamed wolf back to wild without admin config changes.
- If omitted, target defaults to the wolf in your crosshair.
- You can use selectors like
@e[type=wolf,limit=1,sort=nearest].
- Starter wolves are protected and cannot be retired.
- Retire clears Wolf Rules wolf-side runtime/persistent data for clean removal from pack systems.
/wolfrules battlesummon
Unsits and calls battle-ready wolves to you, including wolves tracked in unloaded chunks.
- Player command.
- Respects
combat.battleSummonOrderEnabled, combat.battleSummonMaxCount, and combat.battleSummonDesignationMode.
- The matching keybind issues this same command and is unbound by default.
- Uses persisted tracked-wolf snapshots plus temporary targeted chunk loading instead of constant chunk loading or mass entity searching.
- Shares a 1-second internal server cooldown with auto battle summons.
/wolfrules loadedchunks
Lists wolf-driven chunk-force entries currently active on the server.
- Admin/cheats command.
- Useful for verifying
follow.chunkLoadingMode and follow.chunkLoadingIgnoreMode.
- Output includes dimension, chunk position, wolf identity, and owner identity when available.
/wolfrules grantwolf [player] [is_baby]
Admin grant command for spawning a tamed wolf near a target player.
- If player is omitted, target defaults to yourself.
- Respects
taming.maxTamedWolvesLimit.
- Optional
is_baby flag spawns a baby wolf, but grant-created wolves are not treated as breeding puppies for taming.puppiesAutoSit.
/wolfrules wipeplayerdata [player]
Clears persisted Wolf Rules player data used for starter-grant tracking.
- Admin/cheats command.
- If player is omitted, target defaults to yourself.
- Useful for retesting first-join starter wolf flows and starter grant progression.
评论 0
登录后参与评分
还没有评论,来抢沙发吧