> For the complete documentation index, see [llms.txt](https://october-studio.gitbook.io/monster-survivors-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://october-studio.gitbook.io/monster-survivors-documentation/character/add-a-character.md). # Add a Character {% stepper %} {% step %} ## Preparation Before you begin, make sure that you have all the components needed: 1. Import sprite sheets or sprites for character and it's animations, as listed below:

2. Prepare these sprite sheets to be used for animating. If you need a reminder on how to do that, take a look at [Unity Learn Documentation](https://learn.unity.com/tutorial/introduction-to-sprite-animations). 3. Create Animation Controller and Animations from these sprite sheets. Visit [Unity Learn Documentation](https://learn.unity.com/tutorial/introduction-to-sprite-animations) to know more. {% endstep %} {% step %} ## Character Prefab Creation Now you can create a prefab for your character. The easiest way to do this is to modify or copy existing prefab: 1. Navigate to ![](/files/l4a6UuofIBDShlkhQjlK) and select one of the character prefabs there. Open it, or make a copy. 2. In the Inspector there will be 3 main components: Sprite Renderer, Animator and Character Behavior Script. 3. In the Sprite Field of the Sprite Renderer assign a sprite from your character. By default it can be a simple standing pose. 4. Make sure that the Material field of the same component has Player material assigned. 5. Make sure that Sorting Layer is set to 0

If the sprite you assigned appears to be larger or smaller than expected, tweak its Pixel Per Unit value in the import settings. 6. In the Animator Component, assign your Controller in the appropriate field.

7. In the Character Behavior script, assign the components needed. If you did not add these components as new, and simply copied the prefab, they will be most likely assigned correctly by default.

{% endstep %} {% step %} ### Registering a Character When you have your character prefabs ready, you need to register them. However, if you modified existing characters instead of creating new one, you can skip the steps from 1 to 4. {% hint style="info" %} From [v1.4.0](https://october-studio.gitbook.io/monster-survivors-documentation/character/pages/2GSJW4TQ4qncHqDlz1OM#version-1.4.0) of the asset, the CharacterData was migrated to scriptable object CharacterDataSO.\ Clone an existing Character Data scriptable object and assigne it inside a Character Datas list of the database. All the fields in the scriptable object are the same as below. {% endhint %} 1. Navigate to the Characters Database at ![](/files/Hur1qvdNb2PBFirWxOxM) and open it. 2. In the Inspector you will find several entries of the existing characters. It should look like this:

Every entry has fixed fields:

Field	Description
Name	Character name that will display in the Character Selector
Cost	Amount of currency to unlock in the Character Selector
Icon	Preview image
Prefab	Link to the specific character prefab
Base HP	Initial health amount
Base Damage	Initial damage

3. Press the Plus button below the list to create a new entry. 4. Assign your character prefab to the according field. 5. Populate all other fields to your liking. {% endstep %} {% step %} ## Finish Now you can start the game, and navigate to the Character Selector from the Main Menu to see your character. {% endstep %} {% endstepper %} --- # 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, and the optional `goal` query parameter: ``` GET https://october-studio.gitbook.io/monster-survivors-documentation/character/add-a-character.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.