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.
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:
- Review migration warnings individually. If a referenced third-party asset is missing from the target project, add the dependency or remove the reference.
- After migration, to enable footstep sounds, you need to add
SurfaceTypeToContextMapto the project settings (Project Settings -> Game -> GES Context Effect Settings). - 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?
- 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.
- 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.