# Hand Bone Mappings

Open the hand bone mappings and assign a skeletal mesh that uses the skeleton the player will use.

<figure><img src="https://lh7-us.googleusercontent.com/6BBNAWHEJ_Fy0vyZxgxyBdT7Ut59nrx-93e0Fag2y_fejKorV54crzxTwA0P2Vs1Q_WvD-BJdjRyK0Z-5KKDIfoQfpj5O0NrIL1GMejkmdzMbNip4xsWVq5rE0aHhfKUDGCGYRETfDb0zywujWIlrg" alt=""><figcaption></figcaption></figure>

Next press the button Auto-fill Bone Mappings.

<figure><img src="https://lh7-us.googleusercontent.com/yvTeQeVh9gXRDoVwOH-SJ6411eKK26xkPq5Qn2Dr8MTqC-5RCKP33bnqtxG-mAEiA5KbWvyaXZglg30dzxaPgAtS4nVuOv_08K33E0qJSkA7vuui9xFDRb9aJI1OghQwhzt7jjhbl46EtooVfUJQXg" alt=""><figcaption></figcaption></figure>

This will attempt to auto-fill all the bone mappings for the specified skeleton. Review the bones assigned to each entry in the LeftHand and RightHand maps under the bone mappings category.

<figure><img src="https://lh7-us.googleusercontent.com/bhRbuO111sYQpr5GK29IscH0-ckoFWv_77PBRTdZbWA3fREMXG0sN4PWvA3wEKPghjl2OVxjPfMBvlu3cCxPXp8pshLDILfysCO8ywJYpPGg8g9sSNsDT2Lt7LjzcJ_1WSnnnvIIhlsIr64QU0RbQA" alt=""><figcaption></figcaption></figure>

If the bones assigned are not correct make the necessary changes. In the case of this particular skeleton the wrist bones were wrong and the grip bone was completely missing.

<figure><img src="https://lh7-us.googleusercontent.com/PByEm2NwQGmz2pnzo3nzGBVgFp3vn7XpoEaBE-BF8FRgvdS1DAz8PmJPj-F_vbDHLhdt9I2wjfYNLR1Pjeyb-Jugvg4FHblfvE4XcuBrvjh8OejXnBkceO_xDjq0tYJs3-yt8iBDdK3Fyw3aHDFwTg" alt=""><figcaption></figcaption></figure>

The fingertips are necessary for the hands to work correctly while gripping objects. This particular skeleton does not come with fingertips bones, to remedy this, create sockets and position them where the finger tips are.

<figure><img src="https://lh7-us.googleusercontent.com/Agi5C2LMxkazDsb4LG1RgpYYniIU4mJkRqQnV-K_bWqEI3xgyd-9Qa_7tV-OSdUmaOqk2vHXqPZZ4qckTYA9mqT4BI0LtDs6-DqMI-cre_ZJzkseZSVnh-6LhMZRAIhXJGurcZQldOP-pOPUa0J2Aw" alt=""><figcaption></figcaption></figure>

Back in the hand bone mappings assign the fingertips sockets.

<figure><img src="https://lh7-us.googleusercontent.com/vjZ68jY3O89aWIFj6nxIFUA4kP7c_nBoJCwIXuPbj_ZdKKYQ9GAZiR5nzYa9F4YaznxY9AfktTJK49rWwHVozql0L2DG1qMadK4eMxpObt6GgnD2bBpmrbuGzDbUR6cv5oBBcIfFQuzc4CuuPgpMcg" alt=""><figcaption></figcaption></figure>

After assigning all the bones, there may still be bones that are not assigned and are completely missing from the skeleton. These usually are the Index0, Middle0, Ring0, Pinky0 bones. If this is the case press the button Auto-fill excluded bones and the hand bone mappings asset will automatically add all the unmapped bones to the array of excluded bones.

<figure><img src="https://lh7-us.googleusercontent.com/eHCkRpzaJiry62uFXlrNtJqg04YYLjewW1FXGqphwLOjKRk1ZnhzTuZmrbHRwPTxPHVY9S_G4y48rxN5iWZAi-5GPd1FyXxHmexIjfeKpUtqhtPtjD4yStFRjVVs5YphdL5nqX36LLlUqnXBc9OQiA" alt=""><figcaption></figcaption></figure>

Every skeleton will come with different relative bone transforms compared to what the OpenXR hand tracking expects. This particular skeleton for instance comes with hand bones relative transforms which differ from the OpenXR standard and can be seen by the hand fingers being twisted.&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/pH9OGAOpDcIqw6aOZQWrWuiNu_vUJdLSmK3PTw3aKtoNywNdZUXzO2kBpPx-IpuS2N8c_lifTxzcWzMB3WMkXcZSWH034FODKV2OzjyFYHzacDPq7C47yorP0NtASb7flTffU7k_IMMlVX6VanEarw" alt=""><figcaption></figcaption></figure>

To fix this the hand bone mappings asset allows to specify extra bone rotations to apply on all the hand bones or to specified bones. These values can be provided by changing the properties Left/RightBoneRotations or Left/RightOverrideBoneRotations under the category BoneRotations.

<figure><img src="https://lh7-us.googleusercontent.com/FBVptqKm-NOuF4C8vwarOOUe8W2ti1rm0zlt1EttQJxtLbwKaYiyD8L_a7suKzqnYojBtbmK_Y70yQt9lxu_jZQLvUtsEoAOtEe92-3MrHJv_0TmGCX8eqlNKP2r0Ym0ndnxjgst7OL1zGRcvs7cTw" alt=""><figcaption></figcaption></figure>

For this skeleton the values that fixed the hands are as shown in the following screenshot.

<figure><img src="https://lh7-us.googleusercontent.com/bXO_ospcdfr5fGE_8ylgwvvZi56l7bVNbaloORJPLuwqa6_R-vS2WZBF1LjUtI5hAk92lhLMvsxx2bfNmGsRnHaUSWnqkBy0aWc1ukoLuSihWMuanmWGTTYRQUHJd9HNa56URdHB7iqLuCIjtffT3g" alt=""><figcaption></figcaption></figure>

To better preview the changes being made press space bar to switch between an open/close hand pose.

<figure><img src="https://lh7-us.googleusercontent.com/3wt3CU_cPVqfR0svBHfMRDrgzDSZSTC4SJh0GFX4IuivVS8CCBpsDfmikcwdf5WLIEY2nxkVNW9RxnwJY3IAkw07zvTBWjlplaYVH5QorrFrYLzjv8Az0nc56LqYqzAgjBN-d5mxKYO-EJpmfXQsHA" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.existent.com/documentation/v0.0.2/guides/customising-player-avatar/mappings/hand-bone-mappings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
