为什么值得关注

该插件通过在相邻格子间插值生物精灵图，使移动看起来更流畅，同时保留游戏的模拟完整性，显著提升视觉体验。

适合谁使用

寻求更流畅视觉效果的《矮人要塞》玩家
DFHack插件用户和爱好者
关注纯渲染增强的模组制作者
《矮人要塞》主播或内容创作者

典型使用场景

改善游戏过程中生物移动的美观度
制作更平滑的堡垒时间流逝或录制视频
在不影响模拟的情况下增强单位移动的视觉反馈
作为轻量级视觉模组集成到基于DFHack的模组包中

项目优势

纯渲染：不影响寻路、存档或游戏逻辑
通过DFHack控制台命令即可简单安装
采用MIT开源许可，允许修改和再分发
包含动画管理器的测试目标

使用前须知

ABI特定，需要精确匹配DF和DFHack版本
仅支持SDL 2D渲染器（不支持OpenGL等其他后端）
预构建二进制仅支持《矮人要塞》53.15和DFHack 53.15-r2

README 快速开始

DF Smooth Movement

Smooth, render-only creature movement for Dwarf Fortress through DFHack.

The plugin interpolates matching creature sprites between adjacent tiles. It does not change unit positions, pathfinding, simulation ticks, saves, or gameplay state.

Compatibility

The current prebuilt release supports:

Dwarf Fortress 53.15
DFHack 53.15-r2
Linux or Windows x86-64
the SDL 2D renderer

DFHack C++ plugins are ABI-specific. Do not install the prebuilt binary on a different DFHack or Dwarf Fortress version. Rebuild from source instead.

Install

Download the release archive for your operating system and exact DFHack version.
Extract it into the Dwarf Fortress installation directory. The resulting plugin must be:
- Linux: hack/plugins/smooth-movement.plug.so
- Windows: hack/plugins/smooth-movement.plug.dll
Start Dwarf Fortress through DFHack.
Run these commands in the DFHack console:

load smooth-movement
enable smooth-movement

Check or disable the plugin with:

smooth-movement
disable smooth-movement

The status command prints the plugin version and whether it is enabled.

Build

Check out the matching DFHack source release and clone this repository under plugins/external/df-smooth-movement. Add this line to plugins/external/CMakeLists.txt:

add_subdirectory(df-smooth-movement)

Configure DFHack normally, then build:

cmake --build /path/to/dfhack-build --target smooth-movement

Windows builds require the MSVC 2022 toolchain used by DFHack. From Linux, the official DFHack Docker build environment can cross-compile the plugin with build/build-win64-from-linux.sh.

The plugin uses a vmethod interpose, so its CMake target links to DFHack's Lua library as required by the DFHack build system.

The animation manager has a dependency-free test target:

cmake --build /path/to/dfhack-build --target smooth-movement-test
/path/to/dfhack-build/plugins/external/df-smooth-movement/smooth-movement-test

Behavior

Movement uses a 100 ms smoothstep interpolation.
Camera movement, zoom, Z-level changes, resize, and viewport changes reset interpolation for one frame.
Ambiguous movements between identical sprites snap to the destination.
Main creature sprites crossing fire snap instead of being replayed over an unsafe layer reconstruction.
UI and

项目描述

Smooth visual creature movement for Dwarf Fortress via DFHack

df-smooth-movement