Quiet Walk

A Minecraft 1.20.1 Forge mod that brings CS2-style movement mechanics to Minecraft.

Features

• Sprint completely disabled — sprint is always off, regardless of keybinds
• Normal walk = CS2 running speed — default 1.3x vanilla walk speed (configurable)
• Ctrl = quiet walk — silent footsteps, speed at 52% of running (configurable)
• Shift = crouch — CS2 crouch speed, 34% of running (configurable)
• Silent footsteps — no footstep sounds while sneaking or quiet walking
• TaCZ gun accuracy boost — 50% less spread while sneaking (configurable)
• TaCZ gun pose — gun stays straight (no tilt) while sneaking
• PresenceFootsteps compatible — silently cancels PF footstep generation

Requirements

• Minecraft 1.20.1
• Forge 47.x
• Java 17

Optional Dependencies

• TaCZ (Timeless and Classics Zero) — for gun accuracy and pose features
• PresenceFootsteps — for footstep sound compatibility

Configuration

All settings are in config/quietwalk-common.toml (auto-generated after first launch, on both client and server):

[general]
    # Normal walk speed multiplier (CS2 running speed). 1.3 = old sprint speed.
    # Range: 0.1 ~ 3.0
    normal_speed_factor = 1.3

    # Quiet walk speed multiplier (Ctrl). 0.52 = CS2 silent walk, relative to running speed.
    # Range: 0.05 ~ 1.0
    slow_walk_factor = 0.52

    # Sneak speed multiplier (Shift). 0.34 = CS2 crouch speed, relative to running speed.
    # Range: 0.0 ~ 1.0
    sneak_speed_factor = 0.34

    # Only slow down while pressing WASD.
    require_movement_input = true

    # Silence footsteps while sneaking (Shift).
    silent_sneak = true

    # Silence footsteps while quiet walking (Ctrl).
    silent_quiet_walk = true

    # TaCZ bullet spread multiplier while sneaking. 0.5 = half spread.
    # Range: 0.0 ~ 1.0
    sneak_accuracy_factor = 0.5

    # Keep gun pose straight (no tilt) while sneaking. Only affects TaCZ.
    sneak_keep_gun_pose = true

    # Print debug messages to the log.
    show_debug = false

Speed Calculation

Speed modifiers use MULTIPLY_TOTAL (multiplicative stacking). The vanilla sneak slowdown is cancelled via Mixin.

Installation

• Client: install like any Forge mod (put jar in mods/ folder)
• Server: can be installed on server too — prevents errors and ensures sound cancellation & projectile spread work consistently

License

CC BY 4.0

Quiet Walk

一个 Minecraft 1.20.1 Forge 模组，为 Minecraft 带来 CS2 风格的运动机制。

特性

• 完全禁用疾跑 — 疾跑始终关闭，无论按键绑定如何
• 普通行走 = CS2 奔跑速度 — 默认是原版行走速度的 1.3 倍（可配置）
• Ctrl = 静步走 — 无声脚步，速度为奔跑速度的 52%（可配置）
• Shift = 蹲伏 — CS2 蹲伏速度，为奔跑速度的 34%（可配置）
• 无声脚步 — 潜行或静步走时不会发出脚步声
• TaCZ 枪械精准度增强 — 潜行时散布减少 50%（可配置）
• TaCZ 枪械持枪姿势 — 潜行时枪械保持笔直（无倾斜）
• 兼容 PresenceFootsteps — 静默取消 PF 的脚步声生成

需求

• Minecraft 1.20.1
• Forge 47.x
• Java 17

可选依赖

• TaCZ（Timeless and Classics Zero） — 提供枪械精准度和持枪姿势功能
• PresenceFootsteps — 提供脚步声兼容支持

配置

所有设置均在 config/quietwalk-common.toml 中（首次启动后自动生成，客户端和服务端均有）：

[general]
    # 普通行走速度倍率（CS2 奔跑速度）。1.3 = 旧的疾跑速度。
    # 范围：0.1 ~ 3.0
    normal_speed_factor = 1.3

    # 静步走速度倍率（Ctrl）。0.52 = CS2 静步走，相对于奔跑速度。
    # 范围：0.05 ~ 1.0
    slow_walk_factor = 0.52

    # 潜行速度倍率（Shift）。0.34 = CS2 蹲伏速度，相对于奔跑速度。
    # 范围：0.0 ~ 1.0
    sneak_speed_factor = 0.34

    # 仅当按下 WASD 时才减速。
    require_movement_input = true

    # 潜行时（Shift）静音脚步声。
    silent_sneak = true

    # 静步走时（Ctrl）静音脚步声。
    silent_quiet_walk = true

    # 潜行时 TaCZ 子弹散布倍率。0.5 = 散布减半。
    # 范围：0.0 ~ 1.0
    sneak_accuracy_factor = 0.5

    # 潜行时保持枪械姿势笔直（无倾斜）。仅影响 TaCZ。
    sneak_keep_gun_pose = true

    # 向日志输出调试信息。
    show_debug = false

速度计算

速度修饰器使用 MULTIPLY_TOTAL（乘法叠加）。原版潜行减速已通过 Mixin 取消。

安装

• 客户端：像普通 Forge 模组一样安装（将 jar 文件放入 mods/ 文件夹）
• 服务端：也可在服务端安装 — 可防止错误，并确保声音取消和弹丸散布正常生效

许可证

CC BY 4.0