Trouble using an .ini file for gameplay tags

The main goal is that I’d like to be able to edit my tags in VSCode, rather than have to sign into google sheets and go through import/export process to work from a datatable

Hello, I am following the docs here:


but unable to get my custom .ini file to register in the project settings.

I’ve copy pasted that same example code to an .ini file into the projects config/tags directory, seen here:

I’ve tried toggling the Import Tags from Config but it doesn’t seem to work.

Here is the text I pasted into the .ini file:

To make the .ini file, I just made a new text file, but changed the extension to .ini.

Have I done something wrong? I am not sure what the "class=“language-cpp…” is about? Does that need to point somewhere else?

In the Lyra example, the DefaultGameplayTags.ini is like this:

So it looks there, all the tags are just in that default file. I’m okay with that, however even adding tags to the default file doesn’t seem to pickup in my project settings.

Strange thing here:

I’ve added the example tags to the default .ini and reloaded the project. Just one of the tags is showing:

This is some instruction for the docs ( you can ignore ):

<code class="language-cpp"></code>

Try adding + before each Tag:

[/Script/GameplayTags.GameplayTagsList]
+GameplayTagList=(Tag="Vehicle.Air.Helicopter",DevComment="This is a custom tooltip!")
+GameplayTagList=(Tag="Movement.Flying",DevComment="")
+GameplayTagList=(Tag="Movement.Hovering",DevComment="")
+GameplayTagList=(Tag="Movement.Landing",DevComment="")

https://docs.unrealengine.com/4.27/en-US/ProductionPipelines/ConfigurationFiles/

Special Characters

  • + - Adds a line if that property does not exist yet (from a previous configuration file or earlier in the same configuration file).
  • - - Removes a line (but it has to be an exact match).
  • . - Adds a new property.
  • ! - Removes a property; but you do not have to have an exact match, just the name of the property.
1 Like

Still no luck unfortunately.

Not sure how to debug further. I’ll test in an empty project a bit later and see if I can at least get it working there.

Is your plugin a GameFeature Plugin? (LIke Lyra ShooterCore?)

If so, the name of the file you have to use is very important. Say your plugin name is “MyGame”, then you must store your Tags in a file with this name:

YourProject/Plugins/GameFeatures/MyGame/Config/Tags/MyGameTags.ini

Inside a GFP there is a UE bug that breaks INI files, so you MUST NOT put leading + signs in GFP INIs. The expected format looks like:

[/Script/GameplayTags.GameplayTagsList]
GameplayTagList=(Tag="My.Tag1",DevComment="")
GameplayTagList=(Tag="My.Tag2",DevComment="")

Also, any time you edit an INI file, you must completely close and restart the Unreal Editor.

2 Likes