Troubleshooting

All · 5 min · No code

Find what you see in the table, then follow the link. Most entries are failures that log nothing and mark nothing red, which is why they are written down. Each entry says what you see, why it happens, how to fix it, and which recipe prevents it.

If your problem is not here, start with Diagnostics: where the logs are, the XenoCore log categories and console commands, and how to check a Blueprint really compiled. If that does not explain it, see Reporting a bug.

Entries marked (C++) only happen to someone compiling the project's C++; everything else can be fixed in the editor.

Characters and party

What you see	Entry
A new party member never appears in the field	Characters and party
A character can't attack, can't use Arts, and can't die	Characters and party
Stats don't change when a character levels up, or every character has the same stats	Characters and party
After making someone else the leader and swapping back, the controls do nothing	Characters and party
A character turns invisible after I give it a cosmetic part	Characters and party
The log warns that Body Meshes has no Default Mesh	Characters and party
A party member at 0 HP ragdolls instead of kneeling, and can't be revived	Characters and party
Pressing A over a downed ally doesn't revive them	Characters and party
A recruit joins at level 1, or benched members never level	Characters and party
Companions zig-zag or wobble while following the leader	Characters and party
Companions walk, sprint to catch up, then drop back to a walk	Characters and party
Companions stare straight ahead and never look around	Characters and party
Companions stand still between fights and never chat or wander	Characters and party
A skill is learnt but nothing changes	Characters and party
Skill points stop filling the Skills screen	Characters and party
A character lost their skill progress after I edited their tree	Characters and party
The Skills screen says "No skill tree"	Characters and party
After a party wipe, the party reappears stuck in the floor or falls through it	Characters and party

Combat and Arts

What you see	Entry
Using one Art puts another Art on cooldown too	Combat and Arts
An Art never goes on cooldown and can be used again straight away	Combat and Arts
An Art plays no animation and its effect lands at once	Combat and Arts
An Art starts and stops on its first frame, with no hit	Combat and Arts
After an Art or a custom action, my character is frozen in place for good	Combat and Arts
After a fight my character can't turn, or keeps playing sideways and backwards walks	Combat and Arts
A tag list I set on an ability Blueprint lost the tags the C++ class adds	Combat and Arts
My healing Art plays a blade trail, hit sounds or a hit reaction	Combat and Arts
Hits land but there's no camera shake or controller rumble	Combat and Arts
Hit numbers or hit sounds are missing	Combat and Arts
My new gameplay cue never plays	Combat and Arts
My code can't find an ability the character definitely has	Combat and Arts
A tag-relationship row doesn't block my ability	Combat and Arts
A skill for a new percentage stat makes it 100 %	Combat and Arts
The God cheat doesn't stop the player taking damage	Combat and Arts

Enemies and AI

What you see	Entry
An enemy takes no damage and can't die	Enemies and AI
An enemy's stats aren't what the curve table says, or they double after a level change	Enemies and AI
An enemy takes almost no damage, whatever the party does	Enemies and AI
An enemy ignores the party and walks past	Enemies and AI
An enemy never patrols	Enemies and AI
An enemy never uses its Arts, or uses one and never the other	Enemies and AI
An enemy uses Arts back to back	Enemies and AI
A state I added to a StateTree is never entered	Enemies and AI
A Toppled or Dazed enemy stands still instead of falling, or keeps attacking	Enemies and AI
An enemy slides sideways or backwards in an idle or forward-running pose	Enemies and AI
A defeated enemy drops no chest, or the chest opens empty	Enemies and AI

Items and equipment

What you see	Entry
My new item shows in the list, but choosing it does nothing	Items and equipment
Armour equips and shows its name, but gives no stats	Items and equipment
My weapon no longer draws or sheathes	Items and equipment
Menus show old item counts after my script adds or removes items	Items and equipment
An equipped item vanished from the bag, and the log shows an error	Items and equipment
The editor stops when my graph calls Add Item Instance	Items and equipment
An ability with an item cost never activates	Items and equipment
A screen shows zero stats for the weapon a character just equipped	Items and equipment
A character spawns without its starting weapon	Items and equipment
An item's name is not in its rarity colour	Items and equipment

Animation

What you see	Entry
Play refuses to start with "Blueprint failed to compile", and no error is shown anywhere	Animation
Equipping a weapon never changes the character's stance	Animation
The pose pops when switching between armed and unarmed	Animation
A montage slot I added inside an anim layer never plays anything	Animation
I reparented an anim Blueprint to another one and its graph is gone	Animation
Feet slide or float between walk and run speeds	Animation
The character's feet snap or jitter only while a weapon is equipped	Animation
Imported Paragon clips play in place and don't move the character	Animation
The idle break never plays, or an armed stance plays the unarmed fidget	Animation
A feminine or armed character stands in the masculine unarmed idle, but moves correctly	Animation
A character's own Topple (or flinch, block, dodge, death) never plays; the shared clip does	Animation
Hits knock a character back but its flinch barely shows, or a hit cuts its swing short	Animation
A companion's face never changes expression, or one expression never shows	Animation

UI and input

What you see	Entry
One tap of a button does the action several times	UI and input
A button does nothing, even though its input action is mapped	UI and input
One press of a button also opens the menu	UI and input
Holding a trigger switches at once instead of opening the party cursor	UI and input
Tapping a trigger shows "Can't switch"	UI and input
The triggers do nothing at all	UI and input
The character jumps or acts while a menu is open, or when it closes	UI and input
Enter doesn't press menu buttons on keyboard	UI and input
Pad A on a focused button does nothing, but the mouse works	UI and input
A prompt glyph shows the wrong key	UI and input
A button's prompt stays in the action bar when the button shouldn't be usable	UI and input
Pressing Back on a popup closes the whole screen behind it	UI and input
Pressing Back on a loot or choice panel loses what it offered	UI and input
A screen works the first time and misbehaves when opened again	UI and input
A screen doesn't update after something changes	UI and input
A Delete or other screen action acts on the wrong row	UI and input
A list is missing its "none" or "empty" row	UI and input
A shipped menu entry disappeared after I added mine	UI and input
A menu entry shows but does nothing when pressed	UI and input
A widget above a character never appears, or disappears and never comes back	UI and input
A world widget is enormous, cropped or invisible	UI and input
A tutorial card never appears	UI and input
The dialogue box jumps around the screen during a conversation	UI and input

World and maps

What you see	Entry
Footsteps sound like concrete on grass	World and maps
A map plays no music, or the music stops as you walk	World and maps
Pack assets are missing when the project is opened on another machine	World and maps
A ridge or cliff edge casts no shadow onto the plain below	World and maps
My new actor never shows an interaction prompt	World and maps
An NPC's third action never appears on its prompt	World and maps
The speech box height can't be changed, or a warning names the dialogue anchor	World and maps
A conversation closes on its own after 2 seconds, with a warning	World and maps
A new NPC offers the sample quest or says the sample lines	World and maps
A chest the player emptied is full again after loading a save	World and maps
A saved actor comes back with its default values	World and maps
Only one copy of a spawned actor keeps its saved state	World and maps
Saves made on my map show no location on the save screen	World and maps

Build and editor

What you see	Entry
Play loads the wrong experience, whatever the map's World Settings say	Build and editor
The experience in my own Game Feature plugin can't be found	Build and editor
A Blueprint uses a default value instead of the one I expected, with no error	Build and editor
A base Blueprint I made by duplicating a character won't compile after reparenting	Build and editor
My replacement screen works in the editor, but the packaged game shows the shipped one	Build and editor
The build says it succeeded, but my C++ change isn't in the game (C++)	Build and editor
The C++ build fails inside the VRM4U plugin (C++)	Build and editor
Linker error "unresolved external symbol" for a Lyra class (C++)	Build and editor
A compile error points into a .gen.cpp file I never wrote (C++)	Build and editor
A gameplay tag lookup in C++ returns an empty tag (C++)	Build and editor
Everything works in Play-in-Editor but a standalone or packaged game crashes on launch (C++)	Build and editor
A packaged game halts on the title screen with "breaking Disregard for GC assumptions" (C++)	Build and editor
The editor builds, but the packaged game fails to compile (C++)	Build and editor