Texture Problems

The most common issue: you generated a resource pack, uploaded it to your server, but textures don’t appear in-game.

1. Resource Pack Not Applied Client-Side

Symptom: All custom items show as default Minecraft items (e.g., paper).

Solution:

• Make sure the resource pack is being sent to clients. Server-side installation alone is not enough.
• For ItemsAdder: Run /iazip to generate the resource pack, then configure your hosting method (self-host, Dropbox, etc.)
• For Oraxen: Run /oraxen reload all — Oraxen auto-hosts the pack
• For Nexo: Run /nexo reload — Nexo handles pack distribution
• For CraftEngine: Check settings.yml for the resource pack hosting configuration

Tip: Ask a player to check if they received a “Server Resource Pack” prompt when joining.

2. Wrong Directory Structure

Symptom: Pack is applied but specific textures are missing or show as purple/black.

Solution:

1. Extract the generated ZIP and verify the folder structure matches your plugin’s expected paths
2. Common correct structures:

ItemsAdder:

contents/
  your_namespace/
    textures/
      item/
        your_item.png
    models/
      item/
        your_item.json

Nexo / Oraxen:

pack/
  assets/
    your_namespace/
      textures/
        item/
          your_item.png
      models/
        item/
          your_item.json

CraftEngine:

assets/
  your_namespace/
    textures/
      your_item.png
    models/
      your_item.json

3. Make sure file names are lowercase with no spaces (use underscores instead)

3. Texture Dimensions

Symptom: Texture appears stretched, squished, or as a single color.

Solution:

• Textures must be square and a power of 2 in size: 16x16, 32x32, 64x64, or 128x128
• The recommended size is 16x16 for standard items
• For armor textures, the required dimensions depend on the part (typically 64x32 or 64x64)
• Check that your PNG is not corrupted — re-export it from your image editor

4. Transparency Issues

Symptom: Transparent areas in your texture appear as white or black in-game.

Solution:

• Ensure your PNG uses alpha transparency, not a white background
• Save as PNG-32 (with alpha channel), not PNG-8
• Some image editors (like MS Paint) do not support transparency — use GIMP, Photoshop, or paint.net instead

5. Cache Issues

Symptom: Old texture still showing after updating.

Solution:

• Client-side: Press F3+T in Minecraft to reload textures, or disconnect and rejoin
• Server-side: Run the plugin’s reload command
• ItemsAdder: Delete the old pack from plugins/ItemsAdder/output/ before running /iazip
• Clear your browser cache on LK Creator if re-generating

6. Plugin Reload Commands

After uploading a new resource pack, always reload: