> For the complete documentation index, see [llms.txt](https://venty.gitbook.io/cmc-plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://venty.gitbook.io/cmc-plus/usage/getting-started.md).

# 🔹 Getting Started

## <mark style="color:$primary;">Important: Before Using CMC PLUS</mark>

Before using CMC PLUS, there is one important thing you need to understand.

To ensure that the plugin can safely perform its intended functionality and remain compatible with future improvements, CMC PLUS uses a custom Character class called **CharacterPlus**.

**CharacterPlus** is the base class that should be used for characters whose movement and prediction data will be affected by the plugin.

If you are starting a new project, it is recommended to use **CharacterPlus** as your character's base class from the beginning.

***

### <mark style="color:$primary;">Migrating Existing Character Classes</mark>

If your project was previously developed using Unreal Engine's default **Character** class and you want to migrate to CMC PLUS, you need to change your character's parent class.

To do this:

1. Open your existing Character Blueprint.
2. Go to the **Class Settings** panel.
3. Change the **Parent Class** from `Character` to `CharacterPlus`.

After changing the parent class, your existing Blueprint logic should continue working without requiring major modifications.

However, because changing a Blueprint's parent class can potentially cause compatibility issues depending on how complex your character setup is, a backup is strongly recommended before performing this change.

***

### <mark style="color:$warning;">Important Backup Recommendation</mark>

The migration process itself is not a limitation of CMC PLUS. However, changing the parent class of an existing Blueprint is an Unreal Engine operation that can sometimes cause unexpected issues, especially if your Character Blueprint contains many custom variables, components, or advanced logic.

For this reason:

**Always create a backup of your project before changing the Parent Class.**

CMC PLUS is designed to provide a smooth migration path, but we cannot guarantee that every existing Character Blueprint will migrate without issues due to differences in individual project setups.

Once your backup is created, you can safely proceed with changing your Character class to inherit from **CharacterPlus**.