68747470733a2f2f6d656469612e67697068792e636f6d2f6d656469612f5534536948727879417a59716d4a36354c792f67697068792e676966 gif


The package is available on npm: three-plain-animator To install the latest stable version type this in your project's root directory:

npm i three-plain-animator


There are two main classes to work with:

  • plain-animator
  • plain-singular-animator

The first one is for continuous animations like walking. The second one is for animation that should play only once and then stop on the last frame of animation.


This is a simple example with Homer Simpson animation gif for reference. I assume that creating a basic scene using threejs is not a part of this example. So I will show only unnecessary code just to not mess around.

I converted gif to sprite and uploaded this on imgur.

The first step is to create texture just like every texture using threejs.

const texturePath = '

const spriteTexture = new THREE.TextureLoader().load(texturePath)

Next step is about creating the animator object:

const animator = new PlainAnimator(spriteTexture, 4, 4, 10, 15);

These magic numbers are the follows: |value| description | |--|--| | 4 | number of frames horizontally | | 4 | number of frames vertically | | 10 | total number of frames | | 15 | frames per second (fps) |

Then the finall texture could be get using init() method:

const texture = animator.init();

To animate texture it's required to animate texture in the main loop of rendering


Full code:

const texturePath = '

const spriteTexture = new THREE.TextureLoader().load(texturePath)

const animator = new PlainAnimator(spriteTexture, 4, 4, 10, 15);

const texture = animator.init();

const geometry = new THREE.PlaneGeometry(512, 512);

const material = new THREE.MeshBasicMaterial({ map: texture, transparent: true });

let mesh = new THREE.Mesh(geometry, material)

There is working code on stackblitz with this example:


The package requires threejs library r103


The package supports TypeScript and it also contains typescript definitions.

Future work & TODO

  1. More examples
  2. GIF files support
  3. Tests

Feel free to ask any questions. Post on GitHub or write to me: email