Playermodel Shapekey Eye Animations

If you liked this item, please rate it up on Steam Workshop page.

Author: RhoBoat

Last revision: 5 Aug, 2025 at 19:23 UTC

File size: 1.76 KB

On Steam Workshop

Description:

A very simple script that adds flex (shapekey) based eye animations to compatible playermodels. This method of eye animation is most often utilized on stylized models, but should work for realistic models as well. Overall this method is much simpler to setup compared to source engine shader based eyes.

For Developers

If you wish to utilize this addon, you must author shapekeys that move the eyes up, down, left and right as shown in the youtube video. Each shape key must be named to its corresponding direction. For example, the shape key that moves the eyes down should be name either look_down or lookdown. The names must be all lower case. You may use either string pattern, but you must stick to that pattern. No mixing and matching lookdown with look_up for instance.

Shapekey names should be as follows:

  • lookup
  • lookdown
  • lookright
  • lookleft

or alternatively as:

  • look_up
  • look_down
  • look_right
  • look_left

I allowed for both patterns to accommodate existing models while also working with the DMX model format, which reads shapekeys with underscores as corrective, and non-editable in game.

If you run into any bugs, please provide a description of the bug as well as any applicable error messages.

Known Issues

If you override the named shapekeys used in this script using PAC3, the animation will be disabled. This is due to PAC3 automatically overriding any modified shapekeys, even if the outfit itself is removed. Restarting your session is enough to resolve this.

Tags: anime playermodel pm script animation flex eyes