Skip to main content

Troubleshooting

Common Issues​

Messages not appearing for other players​

  • Ensure UERPChatSubsystem::SetConfig() is called in GameMode BeginPlay
  • Verify RegisterPlayer() is called for each connected player
  • Check that the channel scope matches your test setup (Proximity requires players to be within radius)

Language corruption not working​

  • Verify UERPLanguageComponent is attached to the character/playerstate
  • Check that the language is added to UERPChatConfig::Languages
  • Ensure the player has learned the language via LearnLanguage()

Autocomplete not showing suggestions​

  • GetAutoCompleteSuggestions() returns max 6 results
  • Custom commands must have RequiredRole matching the player's role
  • Argument resolvers must be registered via RegisterArgumentResolver()

Speech bubbles not visible​

  • UERPChatBubbleComponent must be attached to the character (not PlayerController)
  • Ensure the widget class is set on the component
  • Check that ShowMessage() is being called (bind to OnMessageReceived)

Blocked players can still see my messages​

  • Blocking is receiver-side: blocked players won't see YOUR messages. It does not prevent them from sending.
  • Verify UERPSocialComponent is properly replicated

FAQ​

Q: Can I use ElysChat without ElysIdentity? A: Yes. ElysChat uses its own player ID system. ElysIdentity integration is optional via PlayerIdResolver.

Q: Are messages persisted? A: Channel history is kept in memory during the session. For persistent logs, bind to OnMessageRouted and write to your own storage.

Q: Can NPCs use the chat system? A: Use UERPLanguageFunctionLibrary for NPC dialogue corruption. NPCs don't need chat components.