Sodium渲染引擎中DrawContext.drawSpriteStretched方法的动画激活问题解析

在Minecraft模组开发中，Sodium作为一款高性能渲染引擎，其优化机制有时会与开发者预期产生差异。近期发现一个典型问题：当使用DrawContext的drawSpriteStretched方法绘制精灵时，若游戏设置中启用了"仅动画显示可见纹理"选项，精灵动画将无法正常播放，除非该精灵同时被其他系统使用。

问题现象 开发者在使用Blocks.NETHER_PORTAL的粒子精灵纹理进行全屏绘制时发现：当世界中不存在下界方块时，绘制的纹理保持静态；而当存在该方块时，纹理才显示动画效果。这直接证明了纹理动画系统仅对"活跃"精灵生效。

技术原理 Sodium通过SpriteUtil.markSpriteActive机制跟踪纹理使用状态，其优化策略是：

1. 只对当前帧被标记为活跃的纹理应用动画更新
2. 标准渲染路径会自动标记使用到的纹理
3. 但DrawContext的直接绘制方法未包含标记逻辑

解决方案 修复方案简单而优雅：在drawSpriteStretched调用后手动标记精灵活跃状态。核心代码实现为：

context.drawSpriteStretched(...);
SpriteUtil.INSTANCE.markSpriteActive(sprite);

影响范围 该问题影响所有需要动态纹理效果的场景，特别是：

• 自定义UI动画元素
• 特殊效果渲染
• 需要复用原版方块/物品纹理的模组界面

最佳实践 对于模组开发者建议：

1. 直接绘制动态纹理时始终补充标记调用
2. 对于性能敏感场景可缓存标记结果
3. 考虑纹理生命周期管理

该修复已随Sodium 0.6.13版本发布，建议开发者及时更新以获得完整的纹理动画支持。理解这一机制有助于开发者更好地利用Sodium的渲染管线，同时避免类似的优化陷阱。