Skip to content
Back to wiki

Preparation & Migration

Created: Apr 20, 2025Updated: Oct 28, 2026

Preparation

Enable Plugins

Make sure you installed GenericMovementSystemandGenericGameSystem from Epic Launcher, and enable these 2 plugins in your project.

note

Only the demo files of GMS require Generic Game System plugin.

Get Provided Project

Check Help and Verification to know where to look for help and verification.

Users verified through Discord will receive a complete project that includes core asset files, additional assets, and a demo.

note

The provided project is sufficient for understanding how GMS works. This document is merely an overview and cannot replicate all functionalities of GMS one-to-one, so please use it in conjunction with the provided project.

Familiarize Yourself with Project Content

It is also strongly recommended to study this document alongside video tutorials.

Folder

Description

GenericGame/Shared

Contains UE5/4 Mannequins assets, Resuable utility blueprints, some from Epic content (please follow Epic's licence to use)

GenericGame/CommonSystem

Assets belongs to GenericGameSystem, Contains common asset like UI,Camera,Footstep vfx/sfx etc.

GenericGame/MovementSystem/Core

Core assets of GMS, you should not modify the contents of it. It may be overwritten when updating to a new version.

GenericGame/MovementSystem/Extras

Includes Mannequin animation from Lyra, complete with movement definition configuration in GMS. Provided as a case study.

GenericGame/MovementSystem/Integration

Contains some of GMS's integration configurations for third-party animations, which can be removed during the migration process if you don't need it.

GenericDemo/GMS

Demo Blueprints, characters, and levels. Migrate them as needed, including any assets referenced by content you retain.

Other Toplevel folders

Resources used mainly by demos. Migrate any that are dependencies of content you retain.

note

Avoid modifying the contents under the GenericGame folder. Instead, copy or inherit from the provided content and modify it to prevent overwriting during updates.

note

Avoid modifying the contents under the GenericDemofolder as it's for reference only. If you think the demo setup also meets your needs, then you can also copy the whole demo folder somewhere else and start modifying these files.

Migrate to your project

Use the Content Browser's Migrate command to bring the GMS core assets and their dependencies into your project. Migrate example characters, maps, and third-party animations as needed. Afterwards, check for missing references, especially to third-party assets that are not present in the target project.

The companion project includes settings in DefaultEngine.ini, DefaultGame.ini, DefaultInput.ini, and tag files under Config/Tags. Review the entries needed by the content you migrated and merge them into your project rather than replacing its existing configuration. Enable ImportTagsFromConfig under Project Settings → Gameplay Tags.

Important Notes:

  1. Review migration warnings individually. If a referenced third-party asset is missing from the target project, add the dependency or remove the reference.
  2. After migration, to enable footstep sounds, you need to add SurfaceTypeToContextMap to the project settings (Project Settings -> Game -> GES Context Effect Settings).
  3. Check the companion project's .uproject file and enable the plugins needed by the target project.

You can also check:

How to use this system?

  1. For beginners: You need to understand the basic blueprint knowledge and GameplayTags usage. Then prepare the animation package for your character, then refer to the pre-configured movement definitions of GMS to create your character's animation movement definitions, and then switch different movement definitions according to your game logic, so you can switch the character's control logic and animations.
  2. For advanced users: You need to understand basic blueprints or Unreal C++ programming knowledge, as well as the basics of animation blueprints. Then familiar with GMS design architecture and integrate other types of movement or add new movement modes based on the GMS framework.