🎛️ 动画模式

Legacy 模式 G=1~5

Pixel-metadata 模式 G=6~50 推荐

精灵图左上角像素(0,0)编码动画参数，支持任意网格。

案例: allay_gif.png

像素(0,0) = RGBA(8, 64, 64, 3)
  → speed=8, frameW=64, frameH=64, tier=3(慢)
  → 网格: 256/64=4列, 256/64=4行 = 16帧
  → 实际速度: GameTime × 1000 × 8

🖼️ 精灵图素材展示

Legacy 精灵图 (2×2)

fire_sprite.png

G=1

water_sprite.png

G=2

lightning_sprite.png

G=3

heartbeat_sprite.png

G=4

rainbow_sprite.png

G=5

Pixel-metadata 测试 (4×4)

fire_gif.png

G=6 16帧

water_gif.png

G=7 16帧

rainbow_gif.png

G=8 16帧

heart_gif.png

G=11 16帧

NPC 动画素材

allay_gif.png

G=9 :allay:

antique_gif.png

G=10 :antique:

blacksmith_1_gif.png

G=12 :blacksmith:

golden_allay_gif.png

G=13 :golden_allay:

cemetery_gif.png

G=14 :cemetery:

copper_golem_gif.png

G=15 :copper_golem:

decompose_gif.png

G=16 :decompose:

prop_gif.png

G=17 :prop:

reclaim_gif.png

G=18 :reclaim:

toporigin_gif.png

G=19 :toporigin:

📖 制作教程

教程 A: 从 GIF 制作精灵图

方法 1: 转换工具 (推荐)

python tools/gif_to_sprite.py npc_walk.gif npc_walk_gif.png
python tools/gif_to_sprite.py npc_walk.gif npc_walk_gif.png --speed 12 --tier 2
python tools/gif_to_sprite.py --verify allay_gif.png

方法 2: 手动 Python

from PIL import Image

gif = Image.open("my_animation.gif")
frames = []
try:
    while True:
        frames.append(gif.copy().convert("RGBA"))
        gif.seek(gif.tell() + 1)
except EOFError: pass

FRAME_SIZE = 64
resized = [f.resize((FRAME_SIZE, FRAME_SIZE), Image.LANCZOS) for f in frames]

sprite = Image.new("RGBA", (256, 256), (0, 0, 0, 0))
for i in range(16):
    frame = resized[i % len(resized)]
    col, row = i % 4, i // 4
    sprite.paste(frame, (col * FRAME_SIZE, row * FRAME_SIZE))

# 嵌入元数据: R=速度, G=帧宽, B=帧高, A=档位
sprite.putpixel((0, 0), (8, 64, 64, 3))
sprite.save("my_animation_gif.png")

教程 B: 添加新动画 (wizard, G=20)

# Step 1: G=20 → hex(20)=14 → 颜色 #fd1400
# Step 2: 制作精灵图
python tools/gif_to_sprite.py wizard.gif wizard_gif.png --speed 8 --tier 3
# Step 3: 放到 textures/font/anim/wizard_gif.png

# Step 4: animated_images.yml
images:
  minecraft:wizard_gif:
    height: 48
    ascent: 42
    font: minecraft:default
    file: minecraft:font/anim/wizard_gif.png

templates:
  minecraft:anim_emoji/wizard:
    content: <!shadow><color:#fd1400><image:minecraft:wizard_gif></color></!shadow>

emoji:
  minecraft:gif_wizard:
    content: <!shadow><color:#fd1400><image:minecraft:wizard_gif></color></!shadow>
    image: minecraft:wizard_gif
    permission: emoji.gif.wizard
    keywords:
      - ':wizard:'

💻 着色器详解

顶点着色器 rendertype_text.vsh

ivec3 iColor = ivec3(Color.rgb * 255.0 + 0.5);

if (iColor.r == 253 && iColor.b == 0 && iColor.g >= 1 && iColor.g <= 50) {
    ivec2 atlasSize = textureSize(Sampler0, 0);
    float aw = float(atlasSize.x);
    float ah = float(atlasSize.y);
    int vid = gl_VertexID % 4;
    bool isRight  = (vid >= 2);
    bool isBottom = (vid == 1 || vid == 2);
}

// Pixel-metadata (G >= 6)
float tryW = 256.0;
float cw = tryW / aw, ch = 256.0 / ah;
float uMin = UV0.x - (isRight ? cw : 0.0);
float vMin = UV0.y - (isBottom ? ch : 0.0);
ivec2 tlPx = ivec2(uMin * aw + 0.5, vMin * ah + 0.5);
vec4 meta = texelFetch(Sampler0, tlPx, 0) * 255.0;

float frameW = floor(meta.g + 0.5);
float frameH = floor(meta.b + 0.5);
float speed  = floor(meta.r + 0.5);
float speedMul = 1000.0; // A=3→1000, A=2→500, A=1→300

int gridCols = int(charPixW / frameW);
int totalFrames = gridCols * int(256.0 / frameH);
int frame = int(mod(GameTime * speedMul * speed, float(totalFrames)));

float fcol = float(frame % gridCols);
float frow = float(frame / gridCols);
texCoord0 = vec2(
    uMin + (fcol + (isRight ? 1.0 : 0.0)) * frameW/aw,
    vMin + (frow + (isBottom ? 1.0 : 0.0)) * frameH/ah
);

// Legacy (G=1..5) 固定 2×2, 4帧
float fps = 1.0;
if (iColor.g == 1) fps = 1.5;
if (iColor.g == 2) fps = 1.0;
if (iColor.g == 3) fps = 2.0;
if (iColor.g == 4) fps = 0.8;
if (iColor.g == 5) fps = 1.2;

int frame = int(mod(GameTime * 1200.0 * fps, 4.0));
float col = mod(float(frame), 2.0);
float row = floor(float(frame) / 2.0);

// 动画字符: 不乘 Color (标记色会变红)
vertexColor = texelFetch(Sampler2, UV2 / 16, 0);

// 非动画字符: 原版
vertexColor = Color * texelFetch(Sampler2, UV2 / 16, 0);
texCoord0 = UV0;

片段着色器 rendertype_text.fsh

// 100% 原版
vec4 color = texture(Sampler0, texCoord0) * vertexColor * ColorModulator;
if (color.a < 0.1) discard;
fragColor = linear_fog(color, vertexDistance, FogStart, FogEnd, FogColor);

rendertype_text.json

// uniforms 必须包含 GameTime
{ "name": "GameTime", "type": "float", "count": 1, "values": [ 0.0 ] }

⚙️ animated_images.yml

# 1. images: 注册图片
images:
  minecraft:allay_gif:
    height: 48
    ascent: 42
    font: minecraft:default
    file: minecraft:font/anim/allay_gif.png

# 2. templates: MiniMessage 模板
templates:
  minecraft:anim_emoji/allay:
    content: <!shadow><color:#fd0900><image:minecraft:allay_gif></color></!shadow>

# 3. emoji: 聊天触发
emoji:
  minecraft:gif_allay:
    content: <!shadow><color:#fd0900><image:minecraft:allay_gif></color></!shadow>
    image: minecraft:allay_gif
    permission: emoji.gif.allay
    keywords:
      - ':allay:'

🛠️ 精灵图编辑器

两种方式创建动画精灵图，自动生成配置文件并打包成 ZIP 下载。

配置参数

生成与下载

📋 速查与 FAQ

颜色编码速查表

# G → 颜色代码: #fd + hex(G, 2位) + 00
G=20 → #fd1400   G=30 → #fd1e00   G=50 → #fd3200

速度参考

常见问题