mcsow
mcsow 是一款 Minecraft 模组,尽可能忠实且干净地在 Minecraft 中实现了 Warsow/Warfork 的移动机制。
它完全替换了原版玩家运动——通过 mixin 取消 travel() 并直接运行 Warsow 的 gs_pmove.c 物理引擎——从而在 Minecraft 中实现真实的空中侧滑、兔子跳、冲刺和蹬墙跳。
关于数值的说明
物理 公式 是对 Warsow 的忠实移植,但部分 常量 经过有意调整,以适应 Minecraft 的比例和方块网格,而非 1:1 照搬:
- 冲刺比 Warfork 中略强,经过调优,一次冲刺大约能越过半个方块——这在与 Minecraft 地形对抗时感觉更合适。
- 加入了蹲跳(这不是 Warsow 的机制),以水平速度换取高度,让你能精确地落在方块上并处理不规则地形。
- 重力/跳跃基准故意不同于 Warsow(为适应 Minecraft 手感而缩放),空中侧滑增益采用子步进计算,以弥补 Minecraft 20 tps 的限制。
- 移动尊重 Minecraft 的 修饰符 ——加速、灵魂疾行、跳跃提升、迅捷潜行、疾跑以及移动速度属性都会对物理效果进行缩放。
大多数这些参数都可以在游戏中调整(参见配置)。
依赖项
- Fabric Loader ≥ 0.16.0
- Fabric API
- Minecraft 1.21.11
- Mod Menu (可选) ——用于游戏内配置界面
控制键
- 移动 / 跳跃 / 潜行 — 你正常的 Minecraft 按键
- 冲刺 / 特殊动作 — 默认为
R(可在控制设置中重新绑定)。用于地面冲刺和空中蹬墙跳。
移动技巧
- Quake 侧滑 — 按住前进 + 一个侧滑键,并转动鼠标,使你的准星与速度方向夹角约为 80°,以获得速度加成。
- Source 侧滑 — 按住单个侧滑键,并向该方向转动鼠标以加速。
- 空中操控 — 按住前进并转动鼠标,可以在不损失速度的情况下弯曲轨迹(急转弯会损失少量速度)。
- 兔子跳 — 连续跳跃以保存和积累动量;只有当你真正在地面上时才会受到地面摩擦力的影响。
- 冲刺 — 在地面上轻按特殊动作键进行冲刺;方向跟随你的移动键,如果未按住任何键则跟随摄像机视角。
- 冲刺转向 — 在空中释放所有移动键,并在按住特殊动作键的情况下落地:你的速度向量会旋转至指向摄像机所看的方向(将动量重定向到新方向)。
- 蹬墙跳 — 在空中紧贴墙壁并按下特殊动作键,从墙壁弹开(这也算作一次冲刺)。
- 蹲跳 — 潜行时跳跃,将大部分水平速度转换为高度(非常适合不规则地形;高速时会将你向上发射)。
- 动量保存 — 你的实际速度在创造模式飞行和鞘翅滑翔过程中都会被追踪,因此当你停止飞行或着陆滑翔时不会立即失去所有速度。
配置
config/mcsow.json — {"enabled": true} 用于开启/关闭模组的移动功能。
- 安装 Mod Menu 后,可以从模组列表打开配置界面来调整移动常量(空气加速度、冲刺高度、蹬墙跳高度、蹲跳比例、重力、子步数等)。每个值都有悬停文本解释其作用及对移动的影响。
构建
./gradlew build # jar → build/libs/
./buildvio.sh # 构建并将 jar 复制到 PrismLauncher 的“Mod Testing”实例中
- 工具链: Loom 1.14.10, Gradle 9.6.1, JDK 21 运行时, Java 17 模组目标, yarn
1.21.11+build.6.
许可证
LGPL-3.0-or-later — 详见 LICENSE (LGPLv3) 和 COPYING (GPLv3,LGPLv3 基于此扩展)。
mcsow
mcsow is a Minecraft mod that implements Warsow/Warfork movement in Minecraft as faithfully and cleanly as possible.
It replaces vanilla player motion entirely — cancelling travel() in a mixin and running a direct port of Warsow's gs_pmove.c physics — so you get real air-strafing, bunnyhopping, dashing, and walljumping in Minecraft.
A note on the values
The physics formulas are a faithful port of Warsow's, but some constants were deliberately retuned to fit Minecraft's scale and block grid rather than copied 1:1:
- Dash is a touch stronger than in Warfork, tuned so a dash clears roughly half a block — enough to feel right against Minecraft's terrain.
- Crouch-jumping was added (not a Warsow mechanic) to trade horizontal speed for height, so you can pop precisely onto blocks and handle awkward terrain.
- Gravity/jump baseline is intentionally non-Warsow (scaled for Minecraft feel), and air-strafe gain is sub-stepped to make up for Minecraft's 20 tps.
- Movement respects Minecraft modifiers — Speed, Soul Speed, Jump Boost, Swift Sneak, sprint, and the movement-speed attribute all scale the physics.
Most of these are tunable in-game (see Configuration).
Dependencies
- Fabric Loader ≥ 0.16.0
- Fabric API
- Minecraft 1.21.11
- Mod Menu (optional) — for the in-game configuration screen
Controls
- Movement / jump / sneak — your normal Minecraft keys
- Dash / Special —
R by default (rebindable in Controls). Used for dashing on the ground and walljumping in the air.
Movement tech
- Quake strafing — hold forward + a strafe key and turn the mouse so your aim is ~80° off your velocity to gain speed.
- Source strafing — hold a single strafe key and turn the mouse that way to accelerate.
- Air control — hold forward and turn the mouse to curve your trajectory without losing speed (sharp turns bleed a little).
- Bunnyhopping — chain jumps to preserve and build momentum; ground friction only bites when you're actually on the ground.
- Dash — tap Special on the ground to dash; direction follows your movement keys, or the camera if none are held.
- Dash turning — release every movement key mid-air and land with Special held: your velocity vector rotates to point where the camera is looking (redirect your momentum in a new direction).
- Walljump — in the air, hug a wall and press Special to launch away from it (also counts as a dash).
- Crouch-jump — jump while sneaking to convert most of your horizontal speed into height (great for awkward terrain; at high speed it launches you upward).
- Momentum preservation — your real velocity is tracked through creative flight and elytra, so you don't lose all your speed the moment you stop flying or land a glide.
Configuration
config/mcsow.json — {"enabled": true} toggles the mod's movement on/off.
- With Mod Menu installed, open the config screen from the mods list to tune the movement constants (air acceleration, dash height, walljump height, crouch-jump ratio, gravity, sub-steps, …). Each value has hover text explaining what it does and how it affects movement.
Building
./gradlew build # jar → build/libs/
./buildvio.sh # build + copy the jar into the PrismLauncher "Mod Testing" instance
- Toolchain: Loom 1.14.10, Gradle 9.6.1, JDK 21 runtime, Java 17 mod target, yarn
1.21.11+build.6.
License
LGPL-3.0-or-later — see LICENSE (LGPLv3) and COPYING (GPLv3, which LGPLv3 extends).
评论 0
登录后参与评分
还没有评论,来抢沙发吧