Skip to content

Plush Resources

Moth edited this page Aug 9, 2026 · 1 revision

Plush Resources

Butterfly plushes use normal Minecraft block and item resources.

They do not require GeckoLib models or animations.

Recommended Resource Structure

For a plush named:

glow_moth_plush

the recommended resources are:

assets/<modid>/blockstates/glow_moth_plush.json
assets/<modid>/models/block/glow_moth_plush.json
assets/<modid>/models/item/glow_moth_plush.json
assets/<modid>/items/glow_moth_plush.json
assets/<modid>/textures/block/glow_moth_plush.png
assets/<modid>/sounds.json
assets/<modid>/sounds/glow_moth_plush_honk.ogg

data/<modid>/loot_table/blocks/glow_moth_plush.json
data/<modid>/recipe/glow_moth_plush.json

All of these should use the same plush ID.

Blockstate

The blockstate file belongs at:

assets/<modid>/blockstates/<plush>.json

Example:

assets/example_mod/blockstates/glow_moth_plush.json

This should point Minecraft to the plush's block model.

Block Model

The placed plush uses a normal block model:

assets/<modid>/models/block/<plush>.json

Its texture normally belongs at:

assets/<modid>/textures/block/<plush>.png

Butterfly plushes use normal block-model lighting and support cutout textures.

Item Model

Minecraft 1.21.11 uses both an item definition and an item model.

You should provide:

assets/<modid>/items/<plush>.json

and:

assets/<modid>/models/item/<plush>.json

The item model can reference the same model or appearance used by the placed plush.

Plush Sound

The default plush sound ID follows:

<modid>:<plush_path>_honk

For example:

example_mod:glow_moth_plush_honk

The sound file would normally be:

assets/example_mod/sounds/glow_moth_plush_honk.ogg

It must also be defined in:

assets/example_mod/sounds.json

Custom Plush Sounds

A plush can override its normal sound ID with:

.sound("custom_honk")

When using a custom sound, make sure the ID used by the plush matches the entry in your sound resources.

Loot Table

If the plush should drop itself when broken, provide a block loot table under:

data/<modid>/loot_table/blocks/<plush>.json

Example:

data/example_mod/loot_table/blocks/glow_moth_plush.json

Recipe

If the plush is craftable, its recipe can be placed under:

data/<modid>/recipe/<plush>.json

Example:

data/example_mod/recipe/glow_moth_plush.json

Troubleshooting

If the plush's sound works but its model is missing, make sure all of these use the exact same plush ID:

assets/<modid>/blockstates/<plush>.json
assets/<modid>/models/block/<plush>.json
assets/<modid>/models/item/<plush>.json
assets/<modid>/items/<plush>.json
assets/<modid>/textures/block/<plush>.png

If the plush has no sound, check:

assets/<modid>/sounds.json
assets/<modid>/sounds/<plush>_honk.ogg

Also check .sound(...) if the plush overrides its default sound.

Related Pages

Clone this wiki locally