# Translate

A detailed explanation of controls and interface functions are described in the section [State Machine Builder User Interface](https://docs.google.com/document/d/1-o5qSv4zTkzj7YSmRTkV4zezFq7lwU00FyTy0kw1l1U/edit#bookmark=id.6vu41emx3478).

1. Within the edit Simulation section of the HyperSkill Desktop application, navigate to the State Machine tab.
2. Click on the desired state and from the dropdown in either the entry or exit actions select the type Translate.
3. Press the + button to add the state to the action list.

<figure><img src="/files/xWQRv4Z5jcAcFbsLxu09" alt=""><figcaption></figcaption></figure>

4. &#x20;Select the entity of the object you wish to translate in space with the Select Entity dropdown.
5. Select the x,y, and z coordinates of where you would like the object to be translated to.

a. You have the option of translating in Global Space or Local Space. If an object is not snapped into anything, Local Space will behave like Global Space.

6. Select the mode you wish to translate with

a. You have the option of Set, which sets the position to the specified value, or Add, which adds the specified value to the objects current position

b. When using Local Space and the mode is set to Add, the scale of the parent object will affect how much a child object is translated. If the parent object is scaled smaller, the child object will also be translated less.

7. Set the amount of time you want the object to take from its current location to the end destination with the Speed field. This value must be greater than or equal to 0. Please be aware that if the object is not Kinematic that it will likely behave erratically as other forces, such as gravity or collisions, attempt to act on the object in question


---

# 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.siminsights.com/authoring-a-simulation/state-machine/actions/translate.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.