https://github.com/appgurueu/character_anim

Minetest mod implementing character animations
https://github.com/appgurueu/character_anim

animations character minetest mod

Last synced: about 2 months ago
JSON representation

Minetest mod implementing character animations

• Host: GitHub
• URL: https://github.com/appgurueu/character_anim
• Owner: appgurueu
• Created: 2020-09-20T15:29:03.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-11-18T17:06:16.000Z (about 1 year ago)
• Last Synced: 2023-11-19T12:34:27.090Z (about 1 year ago)
• Topics: animations, character, minetest, mod
• Language: Lua
• Homepage:
• Size: 603 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.md

Awesome Lists containing this project

README

        
# Character Animations (`character_anim`)

Animates the character. Resembles [`playeranim`](https://github.com/minetest-mods/playeranim) and [`headanim`](https://github.com/LoneWolfHT/headanim).

## About

Depends on [`modlib`](https://github.com/appgurueu/modlib). Code written by Lars Mueller aka LMD or appguru(eu) and licensed under the MIT license.

## Screenshot

![Image](screenshot.png)

## Links

* [GitHub](https://github.com/appgurueu/character_anim) - sources, issue tracking, contributing

* [Discord](https://discordapp.com/invite/ysP74by) - discussion, chatting

* [Minetest Forum](https://forum.minetest.net/viewtopic.php?f=9&t=25385) - (more organized) discussion

* [ContentDB](https://content.minetest.net/packages/LMD/character_anim) - releases (cloning from GitHub is recommended)

## Features

* Animates head, right arm & body

* Support for arbitrary player models, as long as `Head`, `Arm_Right` & `Body` bones exist

  * If any of these bones do not exist, it will still try to animate the remaining bones

* Advantages over `playeranim`:

  * Extracts exact animations and bone positions from b3d models at runtime (no complex installation)

  * Also animates attached players (with restrictions on angles)

* Advantages over `headanim`:

  * Provides compatibility back until Minetest 0.4.x (as opposed to `headanim` supporting only 5.3+)

  * Head angles are clamped, head can tilt sideways

  * Animates right arm & body as well

## Configuration

### `default`

#### `arm_right`

##### `radius`

Right arm spin radius

* Type: number

* Default: `10`

* >= `-180`

* <= `180`

##### `speed`

Right arm spin speed

* Type: number

* Default: `1000`

* > `0`

* <= `10000`

##### `yaw`

###### `max`

Right arm yaw (max)

* Type: number

* Default: `160`

* >= `-180`

* <= `180`

###### `min`

Right arm yaw (min)

* Type: number

* Default: `-30`

* >= `-180`

* <= `180`

#### `body`

##### `turn_speed`

Body turn speed

* Type: number

* Default: `0.2`

* > `0`

* <= `1000`

#### `head`

##### `pitch`

###### `max`

Head pitch (max)

* Type: number

* Default: `80`

* >= `-180`

* <= `180`

###### `min`

Head pitch (min)

* Type: number

* Default: `-60`

* >= `-180`

* <= `180`

##### `yaw`

###### `max`

Head yaw (max)

* Type: number

* Default: `90`

* >= `-180`

* <= `180`

###### `min`

Head yaw (min)

* Type: number

* Default: `-90`

* >= `-180`

* <= `180`

##### `yaw_restricted`

###### `max`

Head yaw restricted (max)

* Type: number

* Default: `45`

* >= `-180`

* <= `180`

###### `min`

Head yaw restricted (min)

* Type: number

* Default: `0`

* >= `-180`

* <= `180`

##### `yaw_restriction`

Head yaw restriction

* Type: number

* Default: `60`

* >= `-180`

* <= `180`

### `models`

Other models, same format as `default` model

## API

Minetest's `player:set_bone_position` is overridden so that it still works as expected.

### `character_anim.set_bone_override(player, bonename, position, rotation)`

The signature resembles that of `set_bone_position`. `bonename` must be a string. The following additional features are provided:

* Using it like `set_bone_position` by setting `rotation` and `position` to non-`nil` values and using `""` to set the root bone

* *Setting only the bone position* by setting `rotation` to `nil` - bone rotation will then be model-animation-determined

* *Setting only the bone rotation* by setting `position` to `nil` - bone position will then be model-animation-determined

* *Clearing the override* by setting both `rotation` and `position` to `nil` ("unset_bone_position")