路径指数

路径指数

一个适用于 NeoForge 1.21.1 的轻量级路径/道路模组。靠近道路或路径时移动速度会提升；离开后速度恢复。

我做这个模组的初衷是，既能建造装饰性路径，又能获得速度加成。不同于仅在玩家直接站在路径方块上时才加速，本模组会检测附近一定范围内的路径方块是否相互连接。只要周围存在相互连接的路径方块，你就能获得速度加成——即便你并没有站在路径方块上。

原理说明

• 不必站在方块上。 效果范围是在路径周围投影出的数格宽的带状区域，因此稍微偏离或有小缺口都没关系。稀疏的路径同样有效。
• 离开时也有宽容度。 离开路径后的半秒内速度加成仍然保持，因此擦过效果区边缘不会导致加速效果频繁闪断。
• 单块方块无效。 单独一个路径方块不会产生效果。在检测半径内放置第二个路径方块，效果区域就会形成。方块之间无需直接接触，因此散落的踏脚石也能生效。
• 等级很重要。 原版土径为 1 级。模组内置 4 个等级，升级方式是在原位置上对路径进行升级，而非合成不同的方块。
• 右键点击路径即可升级。 小麦可将土径升到 2 级，砖块可将其升到 3 级，混凝土粉末可升到 4 级。用锹右键可将其降级。具体物品对应何种升级可在配置中修改。
• 升级不会改变方块外观。 路径就是路径。什么方块算作路径由整合包决定，而非本模组决定，因此你可以将配置指向任意方块。
• 一切皆可配置。 包括等级数量、每级提供的加成、哪些方块算作路径、哪些方块会压制效果区域，以及哪些物品进行升级。
• 道路也可能变得危险。 敌对生物同样能获得加成（效果按比例缩减），因此灯光明亮的道路是快速通道，而昏暗无光的道路则成了僵尸的高速公路。村民和其他少数生物被排除在外以保证游戏体验。

升级路径

使用配置好的升级物品右键点击任意路径方块，即可将其提升一级。默认配置如下：

物品	将路径从	升级到
小麦	1 级（原版土径）	2 级
砖块	2 级	3 级
任意混凝土粉末	3 级	4 级

升级物品只对其对应配置的等级生效，因此用小麦对砖路无效。将 upgradeItemAlwaysWorks 设为 true 后，任意升级物品可以将任意路径提升一级。

配置

键名	默认值	描述
enabled	true	效果区域的总开关。
pathLevels	["1|1.10", "2|1.18", "3|1.28", "4|1.40"]	等级阶梯，每个条目为 level|speedMultiplier。添加条目可增加更多等级，最多 16 级。
blocksAcross	2.0	投影带状区域的宽度，以方块为单位。增大此值可扩大效果半径。
detectionRadius	6.0	标记点之间仍然能构成路径段的最大距离。
markerRadius	0（自动）	单个路径方块自身影响的范围，与两个方块之间的带状区域相独立。0 时跟随 blocksAcross/2。支持小数。如果站在路径斜对角时感觉效果消失，建议调高到 1.8——这样能覆盖一个方块的对角距离。代价是更多的方块读取。
blocksInRadiusToBePath	2	在效果区域形成之前，detectionRadius 内需要存在的路径方块数量。这是半径内的计数，而非邻接判定。设为 1 时，单个方块即可构成路径。
gradientFactor	4.0	两个等级之间过渡的距离。0 = 硬边界。
verticalTolerance	2	脚部与标记点之间允许的最大 Y 轴差值。
fieldGraceTicks	10	离开路径后速度加成保持的时间，以 tick 为单位（20 tick = 1 秒）。可避免擦过效果区边缘时加速效果反复闪断。0 则离开瞬间效果消失，即 1.0 版的行为。
recheckTicks	4	每位玩家检查的频率（每秒 5 次）。
applyToMobs	true	非玩家实体是否也获得效果区域加成。
mobBonusScale	0.5	生物获得加成效果的百分比。
mobRecheckTicks	15	生物的检查间隔比玩家更长。
mountRiddenBonus	0.10	符合条件的坐骑在路径上被骑乘时的额外速度加成（+10%），叠加在等级加成之上。哪些坐骑符合条件由 path_mountable 实体类型标签决定。
blocks.extraPathBlocks	[]	额外的路径标记。格式为 "blockId|level"，或 "#tag|level" 以指定整个方块标签。
blocks.extraNegateBlocks	[]	额外的压制效果区域的方块。格式为 "blockId" 或 "#tag"。
upgrades.pathUpgrades	["minecraft:wheat|1", "minecraft:brick|2", "#c:concrete_powders|3"]	格式为 "itemId|fromLevel"，或 "#tag|fromLevel"。
upgrades.upgradeItemAlwaysWorks	false	设为 true 时，任意升级物品可将任意路径提升一级。
upgrades.consumeUpgradeItem	true	升级时是否消耗一个物品。
upgrades.shovelResetsPath	true	用锹右键点击本模组的路径可将其降回土径。