/// PIMPMYRUST PLUGIN
Dialogs
Settings guide for this version of Dialogs. Check the plugin page before using it on your server.
Prepare your file
- Check the installed version
This guide describes Dialogs 1.1.0. Use the same version in the configurator.
- Get the settings
Click Import, then From my server. Select the files and confirm loading them. Selecting a server does not replace the open document. You can also import files from this device or a configuration from My projects.
- Edit and send
Adjust settings, fix errors, then use Send to transfer files to the selected server. A conflict blocks sending until you choose how to resolve it. You can still export only the files you need.
Server transfers have private backups. Save keeps your work in My projects; it does not send anything to the server. A download also lets you resume without a server connection.
Settings for this version
Presentation 3
- Default template
- Choice
Choose the conversation appearance. The PimpMyCUI beta falls back to Cinematic Ember for legacy; only the native candidate can render a retained legacy layout.
JSON path
Presentation → TemplateAllowed values: cinematic-ember, wasteland-radio, monument-dossier, arctic-signal, carbon-terminal, legacy
- Template per dialogue
- JSON value
Map a dialogue ID such as Bob to a template key. Unknown keys fall back to Cinematic Ember; this does not edit dialogue questions, replies or actions.
JSON path
Presentation → Template by dialogue - Interface language
- Text
fr translates dynamic navigation labels; other values use English. Dialogue text is not translated, and decorative template headings remain English.
JSON path
Presentation → Language
Close button 5
- Sprite
- JSON value
Optional Rust sprite asset for this CUI element. Preserve null when no sprite is needed; supported assets depend on the running game.
JSON path
UI Configuration → CloseButtonConfiguration → Sprite - Material
- JSON value
Optional Rust material asset for this CUI element. Preserve null when no material override is needed.
JSON path
UI Configuration → CloseButtonConfiguration → Material - Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → CloseButtonConfiguration → Color - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → CloseButtonConfiguration → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → CloseButtonConfiguration → FadeOut
Replies 1
- Reply button positions
- Object list
JSON path
UI Configuration → ResponsesConfiguration → Rects
Window background 6
- Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → WindowConfiguration → Color - ImageUrl
- JSON value
Remote image used by the legacy native CUI element. Null uses a native image component instead; image availability is not checked by the Hub.
JSON path
UI Configuration → WindowConfiguration → ImageUrl - Sprite
- JSON value
Optional Rust sprite asset for this CUI element. Preserve null when no sprite is needed; supported assets depend on the running game.
JSON path
UI Configuration → WindowConfiguration → Sprite - Material
- JSON value
Optional Rust material asset for this CUI element. Preserve null when no material override is needed.
JSON path
UI Configuration → WindowConfiguration → Material - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → WindowConfiguration → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → WindowConfiguration → FadeOut
Close button text 7
- Text
- Text
Fallback label content. Dialogs fills speaker, question and answer labels from the conversation data while rendering.
JSON path
UI Configuration → CloseButtonConfiguration → Label → Text - Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → CloseButtonConfiguration → Label → Color - Font
- JSON value
Optional Rust CUI font asset. Keep null to retain the runtime default; the Hub does not install or verify game fonts.
JSON path
UI Configuration → CloseButtonConfiguration → Label → Font - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → CloseButtonConfiguration → Label → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → CloseButtonConfiguration → Label → FadeOut - Size
- Whole number
Font size passed to the native CUI label. A large value can overflow the configured rectangle; test long dialogue text in game.
JSON path
UI Configuration → CloseButtonConfiguration → Label → Size - Anchor
- Choice
Alignment of text inside its rectangle. This is separate from the screen anchor in the Rect settings.
JSON path
UI Configuration → CloseButtonConfiguration → Label → AnchorAllowed values: UpperLeft, UpperCenter, UpperRight, MiddleLeft, MiddleCenter, MiddleRight, LowerLeft, LowerCenter, LowerRight
Close button background 6
- Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Color - ImageUrl
- JSON value
Remote image used by the legacy native CUI element. Null uses a native image component instead; image availability is not checked by the Hub.
JSON path
UI Configuration → CloseButtonConfiguration → Root → ImageUrl - Sprite
- JSON value
Optional Rust sprite asset for this CUI element. Preserve null when no sprite is needed; supported assets depend on the running game.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Sprite - Material
- JSON value
Optional Rust material asset for this CUI element. Preserve null when no material override is needed.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Material - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → CloseButtonConfiguration → Root → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → CloseButtonConfiguration → Root → FadeOut
Question text 7
- Text
- Text
Fallback label content. Dialogs fills speaker, question and answer labels from the conversation data while rendering.
JSON path
UI Configuration → QuestionConfiguration → Label → Text - Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → QuestionConfiguration → Label → Color - Font
- JSON value
Optional Rust CUI font asset. Keep null to retain the runtime default; the Hub does not install or verify game fonts.
JSON path
UI Configuration → QuestionConfiguration → Label → Font - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → QuestionConfiguration → Label → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → QuestionConfiguration → Label → FadeOut - Size
- Whole number
Font size passed to the native CUI label. A large value can overflow the configured rectangle; test long dialogue text in game.
JSON path
UI Configuration → QuestionConfiguration → Label → Size - Anchor
- Choice
Alignment of text inside its rectangle. This is separate from the screen anchor in the Rect settings.
JSON path
UI Configuration → QuestionConfiguration → Label → AnchorAllowed values: UpperLeft, UpperCenter, UpperRight, MiddleLeft, MiddleCenter, MiddleRight, LowerLeft, LowerCenter, LowerRight
Question background 6
- Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → QuestionConfiguration → Root → Color - ImageUrl
- JSON value
Remote image used by the legacy native CUI element. Null uses a native image component instead; image availability is not checked by the Hub.
JSON path
UI Configuration → QuestionConfiguration → Root → ImageUrl - Sprite
- JSON value
Optional Rust sprite asset for this CUI element. Preserve null when no sprite is needed; supported assets depend on the running game.
JSON path
UI Configuration → QuestionConfiguration → Root → Sprite - Material
- JSON value
Optional Rust material asset for this CUI element. Preserve null when no material override is needed.
JSON path
UI Configuration → QuestionConfiguration → Root → Material - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → QuestionConfiguration → Root → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → QuestionConfiguration → Root → FadeOut
Reply button template 5
- Sprite
- JSON value
Optional Rust sprite asset for this CUI element. Preserve null when no sprite is needed; supported assets depend on the running game.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Sprite - Material
- JSON value
Optional Rust material asset for this CUI element. Preserve null when no material override is needed.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Material - Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Color - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → FadeOut
Reply panel background 6
- Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → ResponsesConfiguration → Root → Color - ImageUrl
- JSON value
Remote image used by the legacy native CUI element. Null uses a native image component instead; image availability is not checked by the Hub.
JSON path
UI Configuration → ResponsesConfiguration → Root → ImageUrl - Sprite
- JSON value
Optional Rust sprite asset for this CUI element. Preserve null when no sprite is needed; supported assets depend on the running game.
JSON path
UI Configuration → ResponsesConfiguration → Root → Sprite - Material
- JSON value
Optional Rust material asset for this CUI element. Preserve null when no material override is needed.
JSON path
UI Configuration → ResponsesConfiguration → Root → Material - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → ResponsesConfiguration → Root → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → ResponsesConfiguration → Root → FadeOut
Title text 7
- Text
- Text
Fallback label content. Dialogs fills speaker, question and answer labels from the conversation data while rendering.
JSON path
UI Configuration → TitleBarConfiguration → Label → Text - Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → TitleBarConfiguration → Label → Color - Font
- JSON value
Optional Rust CUI font asset. Keep null to retain the runtime default; the Hub does not install or verify game fonts.
JSON path
UI Configuration → TitleBarConfiguration → Label → Font - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → TitleBarConfiguration → Label → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → TitleBarConfiguration → Label → FadeOut - Size
- Whole number
Font size passed to the native CUI label. A large value can overflow the configured rectangle; test long dialogue text in game.
JSON path
UI Configuration → TitleBarConfiguration → Label → Size - Anchor
- Choice
Alignment of text inside its rectangle. This is separate from the screen anchor in the Rect settings.
JSON path
UI Configuration → TitleBarConfiguration → Label → AnchorAllowed values: UpperLeft, UpperCenter, UpperRight, MiddleLeft, MiddleCenter, MiddleRight, LowerLeft, LowerCenter, LowerRight
Title background 6
- Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → TitleBarConfiguration → Root → Color - ImageUrl
- JSON value
Remote image used by the legacy native CUI element. Null uses a native image component instead; image availability is not checked by the Hub.
JSON path
UI Configuration → TitleBarConfiguration → Root → ImageUrl - Sprite
- JSON value
Optional Rust sprite asset for this CUI element. Preserve null when no sprite is needed; supported assets depend on the running game.
JSON path
UI Configuration → TitleBarConfiguration → Root → Sprite - Material
- JSON value
Optional Rust material asset for this CUI element. Preserve null when no material override is needed.
JSON path
UI Configuration → TitleBarConfiguration → Root → Material - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → TitleBarConfiguration → Root → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → TitleBarConfiguration → Root → FadeOut
Window position and size 6
- Left edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → WindowConfiguration → Rect → X Size Min - Bottom edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → WindowConfiguration → Rect → Y Size Min - Right edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → WindowConfiguration → Rect → X Size Max - Top edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → WindowConfiguration → Rect → Y Size Max - X position
- Number
Move this area horizontally within its panel: 0 left, 0.5 centre, 1 right.
JSON path
UI Configuration → WindowConfiguration → Rect → Position X - Y position
- Number
Move this area vertically within its panel: 0 bottom, 0.5 centre, 1 top.
JSON path
UI Configuration → WindowConfiguration → Rect → Position Y
Close button position and size 6
- Left edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → X Size Min - Bottom edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → Y Size Min - Right edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → X Size Max - Top edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → Y Size Max - X position
- Number
Move this area horizontally within its panel: 0 left, 0.5 centre, 1 right.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → Position X - Y position
- Number
Move this area vertically within its panel: 0 bottom, 0.5 centre, 1 top.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → Position Y
Question position and size 6
- Left edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → X Size Min - Bottom edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → Y Size Min - Right edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → X Size Max - Top edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → Y Size Max - X position
- Number
Move this area horizontally within its panel: 0 left, 0.5 centre, 1 right.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → Position X - Y position
- Number
Move this area vertically within its panel: 0 bottom, 0.5 centre, 1 top.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → Position Y
Reply button text 7
- Text
- Text
Fallback label content. Dialogs fills speaker, question and answer labels from the conversation data while rendering.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Label → Text - Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Label → Color - Font
- JSON value
Optional Rust CUI font asset. Keep null to retain the runtime default; the Hub does not install or verify game fonts.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Label → Font - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Label → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Label → FadeOut - Size
- Whole number
Font size passed to the native CUI label. A large value can overflow the configured rectangle; test long dialogue text in game.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Label → Size - Anchor
- Choice
Alignment of text inside its rectangle. This is separate from the screen anchor in the Rect settings.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Label → AnchorAllowed values: UpperLeft, UpperCenter, UpperRight, MiddleLeft, MiddleCenter, MiddleRight, LowerLeft, LowerCenter, LowerRight
Reply button background 6
- Color
- Text
Rust CUI red, green, blue and alpha values separated by spaces. Transparent panels commonly use 0 0 0 0.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Color - ImageUrl
- JSON value
Remote image used by the legacy native CUI element. Null uses a native image component instead; image availability is not checked by the Hub.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → ImageUrl - Sprite
- JSON value
Optional Rust sprite asset for this CUI element. Preserve null when no sprite is needed; supported assets depend on the running game.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Sprite - Material
- JSON value
Optional Rust material asset for this CUI element. Preserve null when no material override is needed.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Material - FadeIn
- Number
Fade-in duration passed to the native CUI component, in seconds. Check readability and interaction in game.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → FadeIn - FadeOut
- Number
Fade-out duration passed to the native CUI element, in seconds. It does not alter conversation conditions or actions.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → FadeOut
Reply panel position and size 6
- Left edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → X Size Min - Bottom edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → Y Size Min - Right edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → X Size Max - Top edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → Y Size Max - X position
- Number
Move this area horizontally within its panel: 0 left, 0.5 centre, 1 right.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → Position X - Y position
- Number
Move this area vertically within its panel: 0 bottom, 0.5 centre, 1 top.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → Position Y
Title position and size 6
- Left edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → X Size Min - Bottom edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → Y Size Min - Right edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → X Size Max - Top edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → Y Size Max - X position
- Number
Move this area horizontally within its panel: 0 left, 0.5 centre, 1 right.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → Position X - Y position
- Number
Move this area vertically within its panel: 0 bottom, 0.5 centre, 1 top.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → Position Y
Reply button position and size 6
- Left edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → X Size Min - Bottom edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → Y Size Min - Right edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → X Size Max - Top edge
- Number
Move this edge in pixels from the X/Y position. The distance between opposite edges determines the area's size.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → Y Size Max - X position
- Number
Move this area horizontally within its panel: 0 left, 0.5 centre, 1 right.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → Position X - Y position
- Number
Move this area vertically within its panel: 0 bottom, 0.5 centre, 1 top.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → Position Y
Plugin instructions
Dialogs — native candidate 1.1.0
This guide covers the native 1.1.0 candidate: five layouts, paginated replies and a server command to open a conversation for a connected player. It is not the current Codefling release, which remains 1.0.1. The separate PimpMyCUI beta also uses version number 1.1.0. Install one edition at a time and test it on a private server before live use.
Choose the presentation
In the configurator, open Appearance; these choices are stored under Presentation in JSON:
- Choose the global layout under
Template, for examplecinematic-ember. - Under Template per dialogue, choose a loaded conversation and another layout, for example
wasteland-radio. The choice is stored inTemplate by dialogue. - Set Control language (
Language) toenorfr, then include configuration in your export tooxide/config/Dialogs.json.
Five layouts are available: cinematic-ember, wasteland-radio, monument-dossier, arctic-signal and carbon-terminal. Cinematic Ember is the new-installation default. A per-dialogue entry overrides the global choice. Each page has up to four replies, with navigation for the remaining replies. The native edition renders these layouts without requiring PimpMyCUI.
An existing native config without Presentation selects legacy; explicitly choosing legacy also keeps the native interface configured by UI Configuration. Missing or invalid legacy UI data stops initialization with an error. Unknown template keys and invalid presentation settings are rejected, not replaced by another layout. The PimpMyCUI beta interprets legacy as Cinematic Ember and reports that conversion. Native and beta files are not interchangeable just because both use version 1.1.0.
Language: "fr" translates dynamic navigation/conversation labels, not dialogue text. Decorative headings remain English; other language values use English. Reload Dialogs after changes.
Author conversations in the Hub
Under Dialogues, create or import a conversation. The graph shows NPC messages and player replies: select a card or reply to edit it, connect a reply to its next message or choose End conversation. A list view remains available. Moving cards is visual only; it changes neither runtime order nor exported JSON. Delete buttons are directly accessible; a deleted reply can be undone while its deletion journal is retained. The graph edits existing files, without a second dialogue format. These authoring tools belong to the Hub, not new plugin APIs; the editor never executes actions authored here.
Assign an NPC
Configuration stays in oxide/config/Dialogs.json. Each conversation is an oxide/data/Dialogs/DialogData_<id>.json file; DialogData_Bob.json is identified as Bob. Select a conversation under Dialogues, then use NPCs for this dialogue → + Assign NPC with the real provider's UserIDString. The selected dialogue is the target; reassigning an NPC from another conversation requires confirmation. Current bindings appear below the dialogue heading. To correct an identifier, open Dialogue settings → Edit NPC identifiers · Advanced. Bindings whose dialogues are not loaded remain available under NPCs with unloaded dialogues.
DialogsNpcsData.json retains the exact List of all npcs with dialog wrapper and { "Dialog Id": "Bob" } entries. An NPC binding is optional when a command or another plugin opens the dialogue. Dialogs does not create NPCs, and example names such as Bob are not NPC identifiers. Do not overwrite existing data with examples.
Player conditions and states
PlayerEventStates is required. The editor suggests names already used in loaded dialogues, or lets you create a use of a free boolean state. Show if this state is True/False sets Recquired Event States (exact spelling); After this choice, this state becomes True/False sets Event States Updated. All conditions must match; a missing state is False. There is no event-definitions file to create, and adding a use does not initialize player progress.
The first eligible opening message is selected in stored order. Reply conditions filter visible choices; imported conditions on a next message are not rechecked during a transition. Move up/down buttons control reply order independently of card positions. Loops are allowed and exit takes priority over a retained target. Renaming a state changes only known uses in loaded dialogues: existing player progress and other plugins’ references are not migrated. The editor modifies neither global states nor PlayerEventStates runtime files.
Import and export a selection
Import accepts individual JSON files or a ZIP exported by this editor. Choose new files to add and, for each existing file, Keep or Replace. Replacement affects the whole file without merging entries; unknown properties absent from the import disappear with the old file. Unselected files are kept. Replace the entire project is a separate advanced option requiring confirmation. A partial import does not add default configuration.
Export lets you select dialogues, configuration and NPC bindings: one file downloads as JSON, several as a ZIP using exact installation paths. Files remain whole, without filtering bindings or templates: including the NPC file exports all its bindings, not only those of the selected dialogue. Review warnings about excluded dependencies; errors and unapplied input in selected files must be repaired before download. Numeric or reserved message/reply identifiers require explicit repair, not automatic normalization. No player runtime files are included. The draft stays in this browser. Export a copy, or use Save to keep a project in your account. Saving a project replaces no server file. Review selected files before sending, then reload Dialogs and test the paths in game.
Open a conversation in game
Use an NPC provider emitting the expected OnUseNPC hook; HumanNPC is the documented example. NPC Overlay is optional and independent. Dialogs does not create NPCs or a complete quest/reward system.
Open a loaded conversation for a connected player from server console/RCON or a server-command trigger:
dialogs.show <steamid> BobA trigger must use its own documented player placeholder. F1 use is administrator-only. The API Dialogs?.Call("ShowDialog_API", player, "Bob") receives a BasePlayer; administrator chat /dialog_show Bob remains available. Response Console Commands and Plugins Hooks are separate actions; %steamid% substitution is retained. Run trusted commands only after testing their effects.
Customize the interface
The gallery shows offline CUI previews, not new gameplay captures. UI Configuration remains available for the legacy native presentation; this configurator does not preview that old layout.
The supplied .pimpmycui-project.json files can be opened in CUI Editor, but applying a changed layout to Dialogs still requires a developer to compile the response-count variants and preserve the document identity, slots, bindings and events. There is no direct “edit and apply” integration from this configurator yet. Test long replies, image availability and plugin integrations in game.
Install the files
With a connected server, click Send in the configurator. The result shows whether the files were sent and the plugin reloaded. Without RCON, reload the plugin from your server panel after sending.
Without a connected server: Keep a copy of the current files. Place each export in the folder shown before export, or follow the paths in the ZIP. Do not put data or translation files in the config folder.
Follow the plugin instructions above for dependencies and reloading. Exporting does not connect the site to your server.