Back to mods
Animated Items project artwork

Modrinth · Minecraft mod

Animated Items

Turn any item into a 3D animated GeckoLib model with just a resource pack: first person animations, your skin on the arms, camera moves, combos and keybinds. Client side.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Animated Items release matches 26.2 NeoForge?

Updated last month
Best match for your filters 1.1.0
Game version 26.2
Loader NeoForge

Animated Items 1.1.0 targets 26.2 with NeoForge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is Animated Items required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

Client Optional
Dedicated server Optional
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source marks this as usable on both the client and server.

What else does Animated Items 1.1.0 need?

1.1.0 on 26.2 NeoForge. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Animated Items without breaking your instance.

Built for Animated Items 1.1.0 on 26.2 NeoForge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.1.0. It targets 26.2 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.1.0. It opens that exact file at the source.

About this project

What does Animated Items add?

Animated Items

Fabric 1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2
NeoForge 1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2
Forge 1.20.1 · 1.20.4

Requires GeckoLib (and Fabric API on Fabric). Client side only.


Turn any item into a 3D animated model with nothing but a resource pack.

Animated Items swaps items with a matching custom_model_data for GeckoLib models made in Blockbench, with first person animations, your own skin on the arms and a camera that moves with the animation.

Nothing is needed on the server, and players without the mod just see the normal item. The same resource pack works on every version, from 1.20.1 to 26.2.

Features

  • Automatic animations: idle, walk, run, sneak, jump, fall, swim, crawl, climb, glide, riptide, sleep and hurt, picked from what you're doing
  • Keybind actions: play animations with any key or mouse button, with cooldowns, held (looping) actions and random animations
  • Combos: chain attacks with next (attack1 → attack2 → attack3)
  • Your skin on the arms: right_arm / left_arm bones are drawn with your own skin in first person
  • Animated camera: a camera bone moves your view on top of where you're looking
  • Sounds and commands: play a sound when an action starts, run commands when it starts or ends
  • Cancel vanilla keys: block the vanilla attack, use or drop while an action plays
  • Hide the other hand: visible_offhand hides the off hand, its item and its arm pose, great for two handed weapons
  • Per view visibility: show an animation only in first person, only in the hotbar, or both (also for animations played by command)
  • Models on command: put any model of your pack on your hand with /animated_items model set <model>, whatever you're holding

Getting started

The first time you start the game, AnimatedItemsExample.zip shows up in your resourcepacks folder (it's not turned on). Turn it on and run /animated_items model set punch_global, then open the zip to see how a pack is made.

Making an animated item

Pack layout:

assets/minecraft/
  animated_items/death_scythe.json          the item config
  geo/death_scythe.geo.json                 Blockbench GeckoLib model
  animations/death_scythe.animation.json    Blockbench GeckoLib animations
  textures/animated_items/death_scythe.png  texture

animated_items/death_scythe.json:

{
  "item": "netherite_sword",
  "custom_model_data": 66,
  "model": "geo/death_scythe.geo.json",
  "texture": "animated_items/death_scythe",
  "animations": "animations/death_scythe.animation.json",
  "item_hotbar_model": false,
  "visible_offhand": false,
  "actions": [
    {
      "id": "attack1",
      "keybind": "key.attack",
      "animation": "attack1",
      "next": "attack2",
      "chain_window_ticks": 5,
      "sound": "item.trident.throw;vol:60;pitch:1.2"
    },
    {
      "id": "attack2",
      "keybind": "key.attack",
      "animation": "attack2",
      "cooldown_ticks": 20
    },
    {
      "id": "inspect",
      "keybind": "key.keyboard.g",
      "animation": "inspect",
      "held": true,
      "cancel_keybind": true,
      "visible_thirdperson": false
    },
    {
      "id": "special",
      "keybind": "key.keyboard.r",
      "random_animation": "spin, slam",
      "cooldown_ticks": 100,
      "command_onstart": "effect give @s speed 3 1",
      "command_onfinish": "particle minecraft:explosion ~ ~1 ~"
    }
  ]
}

Item options

Option What it does
item The item it replaces (netherite_sword, minecraft:bow, modded items too). Leave it out for models only used with model set
custom_model_data Which stacks of that item get the model
model / texture / animations Paths to your Blockbench files
item_hotbar_model false keeps the normal item icon in the hotbar and inventory
visible_offhand false hides your other hand while holding it
actions Keybind animations (below)

Action options

Option What it does
id / keybind Name of the action and the key that plays it (key.attack, key.use, key.keyboard.g, key.mouse.middle...)
animation / random_animation The animation to play, or a random one from a list
held Loops while the key is held
cooldown_ticks Wait before it can play again
next / chain_window_ticks Combo into another action on the next press
sound Sound with optional volume and pitch
command_onstart / command_onfinish Commands sent to the server
cancel_keybind Blocks the vanilla attack/use/drop of that key
visible_thirdperson / visible_on_hotbar / visible_offhand Per action visibility, also used when the animation is played by command
parent Vanilla model shown in third person while it plays (e.g. item/crossbow)

Name your animations idle, walk, run, sneak, jump... and they play by themselves.

Get the item in game:

1.20.1 - 1.20.4:  /give @s netherite_sword{CustomModelData:66}
1.21.1:           /give @s netherite_sword[custom_model_data=66]
1.21.4 and up:    /give @s netherite_sword[custom_model_data={floats:[66]}]

Commands

  • /animated_items model set <model>: put any model of your pack on your hand with its actions, whatever you hold (autocompletes every model)
  • /animated_items model remove <model>: take it off
  • /animated_items trigger <model|item> <animation>: play an animation on that model or on the item you're holding

Servers

With the AnimatedItemsPlugin (Paper/Spigot), servers can play animations for players with selectors and tags, like @a[tag=boss] or tag:vip.

API for other mods

AnimatedItemsApi.setStandaloneModel("punch_global");
AnimatedItemsApi.playOnStandaloneModel("punch_global", "attack1");
AnimatedItemsApi.clearStandaloneModel();

AnimatedItemsApi.playOnHeldItem("minecraft:netherite_sword", "attack1");
AnimatedItemsApi.isAnimated(stack);
AnimatedItemsApi.modelOf(stack);
AnimatedItemsApi.animations("death_scythe");
AnimatedItemsApi.currentAnimation();
AnimatedItemsApi.stopAnimation();

AnimatedItemsEvents.onAction((model, action, animation) -> ...);
AnimatedItemsEvents.onFinished((model, action, animation) -> ...);
AnimatedItemsEvents.onReload(() -> ...);
  • Models: setStandaloneModel puts any model of the loaded packs on the player's hand with its actions, the same as /animated_items model set; models() lists every model and activeStandaloneModel() tells which one is on
  • Playing animations: playOnHeldItem and playOnStandaloneModel work like /animated_items trigger, and keep the visibility settings of the action that uses that animation
  • Reading items: isAnimated, modelOf and animations tell if a stack has an animated model, which one, and what animations it has
  • Events: onAction / onFinished when an animation starts or ends (from a key, a command or the API), and onReload when the packs are loaded again
  • Same everywhere: com.cotii.animateditems.api is identical on Fabric, Forge and NeoForge, from 1.20.1 to 26.2

Project description from Modrinth.

Pick your setup

Animated Items by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

26 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Animated Items versions and loaders

1 of 19 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.