Loot dialogues define how battle gains are displayed and distributed at the end of a battle.
Loot dialogues are found in Menus > Loot Dialogues.
Loot dialogues are used to display the battle gains the player receives – i.e. loot (items, equipment, currencies, etc.), Experience and Normal type status value rewards as well as combatant and level up information.
You can set up different loot dialogues for different battle outcomes:
- victory
- escape
- defeat
- leave arena (when enabled by the used battle system, used when the moving a defined distance away from the battle)
- immediate collection
Loot dialogues can be displayed when using a Collect Battle Gains node in schematics, the battle gains are collected immediately (when an enemy was killed) or when leaving Real Time Area Battles (enabled in the real time battle system’s setup).
Loot Dialogue Types #
The following loot dialogue types are available.
You can create custom loot dialogue implementations by deriving from the BaseLootDialogueSettings class.
Simple #
Displays a series of dialogues showing the battle’s loot, player combatant changes and level ups.
Loot Dialogue Settings #
Define which dialogues will be displayed.
Battle Gain Notification #
Shows a dialogue containing the battle gains (loot, status value rewards).
The content is added via text codes, each text code is replaced by a it’s own defined text. The individual texts (e.g. for currencies, items and experience) also use text codes to add their own content (e.g. adding the name and quantity of the currency or item).
Combatant Gain Notification #
Shows a dialogue for each combatant containing the Experience and Normal status value rewards the combatant received.
The content is added via text codes, each text code is replaced by a it’s own defined text. The individual texts (e.g. experience/normal status value rewards) also use text codes to add their own content (e.g. adding the name and value of the status value). You can optionally use a HUD as a template to add more information to the dialogue.
The combatant gains can optionally be combined with the level up notification to a single dialogue.
Level Up Notification #
Shows a dialogue for each combatant that has a level up containing the level up information.
The information is defined by the level up texts setting (see below).
Layout Screen #
Displays the battle’s loot in individual UI boxes and player combatant changes/level ups all at the same time using UI layouts to arrange them.
Learn more about UI layouts in this documentation.
Loot Dialogue Settings #
Define which dialogues will be displayed.
Outcome Notification #
Displays a battle outcome message alongside the loot and combatant gains. Can also include UI backgrounds.
E.g. use this to show a victory message or add a background to the overall loot dialogue.
Loot Notification #
Define if and how loot (items, currencies, etc.) will be displayed.
A dialogue is displayed for each individual loot. You can optionally define a separate setup for currencies.
Add content information about the loot using text codes (e.g. <name> for the loot’s name) and add a HUD as a template to add additional content information (e.g. shortcut UI).
The individual loot dialogues are arranged on screen using UI layouts.
Combatant Notification #
Shows a dialogue for each combatant containing the Experience and Normal status value rewards the combatant received.
The content is added via text codes, each text code is replaced by a it’s own defined text. The individual texts (e.g. experience/normal status value rewards) also use text codes to add their own content (e.g. adding the name and value of the status value). You can optionally use a HUD as a template to add more information to the dialogue.
The combatant gains can optionally be combined with the level up notification to a single dialogue.
Custom Loot Notification #
Define if and how custom loot will be displayed. The dialogue setup is the same as for other loot (Loot Notification settings).
Custom loot can be displayed based on variable conditions and have quantity stored in global int variables. You can define content information and portraits for the custom loot.
The custom loot has to be added in the custom loot notification settings. Please note that custom loot is only displayed and doesn’t change anything.
Level Up Notification #
Shows a dialogue for each combatant that has a level up containing the level up information.
The information is defined by the level up texts setting (see below).
Sequence #
Displays the battle’s loot and player combatant changes/level ups in individual UI boxes in sequence, one after another.
Displaying the loot or combatant changes/level ups can optionally display them all at once before continuing to the next content (e.g. showing loot one at a time, followed by all combatant changes at once).
Loot Dialogue Settings #
Define which dialogues will be displayed.
Outcome Notification #
Displays a battle outcome message alongside the loot and combatant gains. Can also include UI backgrounds.
E.g. use this to show a victory message or add a background to the overall loot dialogue.
Notifications #
Displaying the actual battle gains is handled by individually added notifications.
You can add as many as you want and in what order you want. The following notification types are available:
- Combatant
Displays an individual combatant’s spoils of a battle.
Only one Combatant information type can be used. - Level Up
Displays an individual combatant’s level up information.
Not used if a Combatant information type is added that uses Combine Level Ups. - Loot
Displays the battle’s loot for defined content.
E.g. you can add separate loot notifications for items, currency or equipment.
Level Up Texts #
Define the content that’ll be displayed by level up dialogues. Multiple level ups can optionally be combined to a single dialogue.
Total Level Up Content #
The level up text that’ll be displayed for a level up.
Use text codes to add the individual parts (level up, status value, ability learn, etc.) to the text.
You can use a HUD as a template to add additional information to the dialogue.
Level Up Text #
Displayed for the combatant’s level up.
Use text codes to add content information about the combatant and the new level.
Class Level Up Text #
Displayed for the combatant’s class level up.
Use text codes to add content information about the combatant, class and the new class level.
Status Value Text #
Displayed for the combatant’s status value changes coming from the level up (status development).
Use text codes to add content information about the combatant, status value and value changes.
Ability Learn Text #
Displayed for abilities that where learned (new abilities and leveled up abilities).
Use text codes to add content information about the combatant and ability.
Group Ability Learn Text #
Displayed for group abilities that where learned (new abilities and leveled up abilities). Group abilities are abilities that are learned by the group instead of an individual combatant – they’re available to all combatants of the group.
Use text codes to add content information about the combatant and ability. Uses the combatant who has the ability learn setup (e.g. from ability development).
Research Tree Learn Text #
Displayed for research trees that where learned.
Use text codes to add content information about the combatant and research tree.
Standalone Level Up Dialogue #
Optionally display a level up dialogue when a combatant’s level increases outside of a loot dialogue, e.g. when receiving experience from a finished quest.
Define the used UI box, control blocks or pause game settings that are used by the level up dialogue.
The level up content displayed by the dialogue is defined in the Level Up Texts settings (see above).

