Gestures

Gestures Folder Logic

Every folder opened under the gestures folder is considered a namespace. These namespace folders contain an gestures file and the gestures .yml file.

Gesture Creation

1. Create the namespace folder

2. Copy the files in the default namespace and move them to your own namespace.

3. Open the .bbmodel file, go to the Animate section, and press the + button at the top.

4. Enter the name of the animation in the Name field, then select the loop mode. As the names suggest, you will be selecting the animation's repeat mode. Then press Confirm.

5. Then, click on the adjacent body parts and press the + button on the Rotation, Position, and Scale sections below to create your animation.

6. After completing your animations, save the file and open the .yml file.

Introducing Gestures to the Plugin

Wave:
  name: Wave
  permission: luxgestures.gestures.Wave
  font: 
  movement: false
  moveSpeed: 0
  animations:
    idle: luxgestures.gestures.Wave

You can see an example gesture configuration above. In the animations section, enter the name of the namespace folder in the first field, the name of the .bbmodel file in the second field, and the name of the animation you created in the last field.

To change the start and end animations for an animation, specify the start and end animations in the animations: section to display different animations at the start and end.

animations:
    start: luxgestures.gestures.Wave_Start
    idle: luxgestures.gestures.Wave
    end: luxgestures.gestures.Wave_End

Creating Gesture Icons

Pause the animation at the desired position and angle, set the View mode to Solid in the section shown in the photo below, then press the Screenshot Model button and save the resulting image.

Go to your texture pack and open the textures/gesture/gestures.png file in your photo editing application. (Aseprite is recommended)

As you can see in the photo above, you will place your animation image in each 32x32 area, shrinking it so that a maximum of 8 fit side by side.

After setting your animation icons, save your file and go to the fonts folder.

Open one file starting with gesture_row_. All the icons are the same anyway.

Each row and column here corresponds to an image, and all adjacent ones represent 32x32 areas. Accordingly, copy the letter corresponding to where you placed the icon and paste it into the font section.

Placing an item in the gesture's hands or head

Defining vanilla items in gesture

equipment:
    rightHand: "DIAMOND_SWORD"
    leftHand: "SHIELD"
    helmet: "NETHERITE_HELMET"

Defining custom items in gesture

We support Nexo, ItemsAdder, Oraxen, and CraftEngine plugins for custom items.

equipment:
    rightHand: "custom:lux_sword"
    leftHand: "custom:lux_shield"
    helmet: "custom:zeus_helmet"

Bones Logic

player_root
├── hip
│   └── chest
│       ├── head
│       │   ├── helmet ········ The model's hat or helmet
│       │
│       ├── backpack ··········· The model backpack
│       │
│       ├── left_arm
│       │   └── left_forearm
│       │       └── left_item
│       │
│       └── right_arm
│           └── right_forearm
│               └── right_item
├── right_leg
│   └── right_foreleg
├── left_leg
│   ├── left_foreleg
│   └── balloon ··············· The position of the model's balloon leash
│      
├── particle_0 ················ The model particle
└── effects ··················· Model effects (effects such as sounds)