Animated Gif Texture Support|动画GIF纹理支持

Animated Gif Texture Support

Use .gif images directly as textures in Barotrauma Made for Blue Archive什亭之匣A.R.O.N.A去创造独属于我们的奇迹吧（普拉娜.阿罗娜）

---

1. What is this

Barotrauma can use GIF files. Whatever .gif image you reference in XML will be loaded by the game and played as an animation.

This mod lets the game use GIF. It was originally prepared for another one of my mods, but it can just as well be used by other mods as a dependency.

So there is no need to slice sprite sheets, no need to export PNGs frame by frame, and no need to change any drawing code. As long as what you reference is a .gif, it will animate.

---

2. Features

• Use .gif directly as a texture - the entire sprite sheet workflow is gone

• Supports every key GIF89a feature: global/local palettes, transparency, disposal 0/1/2/3, interlacing, infinite looping

• Works for any other mod's XML that uses GIF, including effect textures, weapon textures, character textures and creature textures

• No interference with non-GIF textures whatsoever

• If loading or playback fails, the file is silently skipped

---

3. How to use

Anything in the game that references a gif will work. The following is only an example:

<sprite texture="%ModDir%/your.gif" sourcerect="0,0,width,height" compress="false" />

Two things to keep in mind:

• compress="false" is required. With compression enabled the engine converts the texture to DXT5, which cannot have its pixels rewritten per frame. This mod detects the format mismatch and silently skips the file.

• sourcerect must be the GIF's real width and height. For a 320x320 image, write

0,0,320,320

.

---

4. Requirements

LuaCsForBarotrauma (Lua) is required.

This is a C# script mod and needs Lua to compile and load it. Without Lua installed, the mod will not take effect.

---

5. For other mods / for everyone

This mod is not tied to any content. The patch hooks the global texture loading entry point, so:

• Any mod that references a .gif gets animated playback

• Building your own mod, or just putting an animated picture on your sub - it works the same way

---

Prepared for Blue Archive什亭之匣A.R.O.N.A去创造独属于我们的奇迹吧（普拉娜.阿罗娜）

Blue Archive什亭之匣A.R.O.N.A去创造独属于我们的奇迹吧（普拉娜.阿罗娜）