> For the complete documentation index, see [llms.txt](https://hiveminddocs.gitbook.io/hivemind/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hiveminddocs.gitbook.io/hivemind/code-systems/ultimate-spaceship-system-uss-knowledge-base/uss-integration-guide.md).

# USS Integration Guide

## <mark style="color:blue;">**BP\_Pilot logic transfer guide to custom characters**</mark>

This guide covers a quick version on how to transfer the logic onto your own character class in order for it to be able to interact with the BP\_Spaceship and possess it.

{% hint style="info" %}
Keep in mind this is simplified version of the process intended for Single player&#x20;
{% endhint %}

If you are intending to use this pack for project that runs with Multiplayer, there are additional steps added to these events that ensure reliable replication. You will have to copy relevant replication events from

BP\_Pilot template.&#x20;

***

### <mark style="color:blue;">**Step 1 BPI interface**</mark>

Add BPI\_HumanCharacter Interface and Re-compile your Character class.

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

Then update **Is Human?** interface call to have **Human Boolean set as true**, This will allow all external interface calls to recognize this class as human character for the purposes of additional interaction.

<figure><img src="/files/6bkpwQfrcqRD7jI7I3YT" alt=""><figcaption></figcaption></figure>

***

### <mark style="color:blue;">**Step 2 Implement Toggle Visibility**</mark>

This event fires and hides the character when you sit into the cockpit chair. Original character gets hidden, while a copy of your character mesh gets socketed into the cockpit chair and animated to sit.&#x20;

{% hint style="info" %}
It's done this way because in certain versions of Unreal engine there are replication errors when socketing an actor to another actor over the network
{% endhint %}

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

***

### <mark style="color:blue;">**Step 3 Trigger Prompt**</mark>

This event triggers when character walks into range of **BP\_Spaceship** pilot chair. It receives and records the sending actor and displays a prompt on players viewport

Stored Actor value is later used to posses the ship if player chooses to do so.

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

***

### <mark style="color:blue;">**Step 4 Interaction Input**</mark>

Final step is connecting an **Interaction Input event** to **posses** the **BP\_Spaceship** and hide the interaction prompt widget from the viewport. This example uses example enhanced input action that comes with this pack.

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

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

***

### <mark style="color:blue;">Finish Line</mark>

That's it. You can now Sit in the chair and soar to the skies!

***

## <mark style="color:blue;">Support</mark>

{% hint style="info" %}

## Stuck? Need Support? Please join our [<mark style="color:purple;">Discord</mark>](https://discord.gg/zaKb8tWSxw) And Open A Ticket.

{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://hiveminddocs.gitbook.io/hivemind/code-systems/ultimate-spaceship-system-uss-knowledge-base/uss-integration-guide.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.