/// 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.1. 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
- X Size Min
- Number
Left pixel offset from the horizontal screen anchor. Check the result in game; the Hub does not render this legacy layout.
JSON path
UI Configuration → WindowConfiguration → Rect → X Size Min - Y Size Min
- Number
Bottom pixel offset from the vertical screen anchor. Keep the lower edge below the upper edge.
JSON path
UI Configuration → WindowConfiguration → Rect → Y Size Min - X Size Max
- Number
Right pixel offset from the horizontal screen anchor. Keep the right edge beyond the left edge.
JSON path
UI Configuration → WindowConfiguration → Rect → X Size Max - Y Size Max
- Number
Top pixel offset from the vertical screen anchor. The height is this value minus the lower offset.
JSON path
UI Configuration → WindowConfiguration → Rect → Y Size Max - Position X
- Number
Horizontal screen anchor; 0 is left, 0.5 centre and 1 right. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → WindowConfiguration → Rect → Position X - Position Y
- Number
Vertical screen anchor; 0 is bottom, 0.5 centre and 1 top. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → WindowConfiguration → Rect → Position Y
Close button position and size 6
- X Size Min
- Number
Left pixel offset from the horizontal screen anchor. Check the result in game; the Hub does not render this legacy layout.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → X Size Min - Y Size Min
- Number
Bottom pixel offset from the vertical screen anchor. Keep the lower edge below the upper edge.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → Y Size Min - X Size Max
- Number
Right pixel offset from the horizontal screen anchor. Keep the right edge beyond the left edge.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → X Size Max - Y Size Max
- Number
Top pixel offset from the vertical screen anchor. The height is this value minus the lower offset.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → Y Size Max - Position X
- Number
Horizontal screen anchor; 0 is left, 0.5 centre and 1 right. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → Position X - Position Y
- Number
Vertical screen anchor; 0 is bottom, 0.5 centre and 1 top. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → CloseButtonConfiguration → Root → Rect → Position Y
Question position and size 6
- X Size Min
- Number
Left pixel offset from the horizontal screen anchor. Check the result in game; the Hub does not render this legacy layout.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → X Size Min - Y Size Min
- Number
Bottom pixel offset from the vertical screen anchor. Keep the lower edge below the upper edge.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → Y Size Min - X Size Max
- Number
Right pixel offset from the horizontal screen anchor. Keep the right edge beyond the left edge.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → X Size Max - Y Size Max
- Number
Top pixel offset from the vertical screen anchor. The height is this value minus the lower offset.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → Y Size Max - Position X
- Number
Horizontal screen anchor; 0 is left, 0.5 centre and 1 right. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → QuestionConfiguration → Root → Rect → Position X - Position Y
- Number
Vertical screen anchor; 0 is bottom, 0.5 centre and 1 top. Pixel offsets are measured from this anchor.
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
- X Size Min
- Number
Left pixel offset from the horizontal screen anchor. Check the result in game; the Hub does not render this legacy layout.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → X Size Min - Y Size Min
- Number
Bottom pixel offset from the vertical screen anchor. Keep the lower edge below the upper edge.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → Y Size Min - X Size Max
- Number
Right pixel offset from the horizontal screen anchor. Keep the right edge beyond the left edge.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → X Size Max - Y Size Max
- Number
Top pixel offset from the vertical screen anchor. The height is this value minus the lower offset.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → Y Size Max - Position X
- Number
Horizontal screen anchor; 0 is left, 0.5 centre and 1 right. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → Position X - Position Y
- Number
Vertical screen anchor; 0 is bottom, 0.5 centre and 1 top. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → ResponsesConfiguration → Root → Rect → Position Y
Title position and size 6
- X Size Min
- Number
Left pixel offset from the horizontal screen anchor. Check the result in game; the Hub does not render this legacy layout.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → X Size Min - Y Size Min
- Number
Bottom pixel offset from the vertical screen anchor. Keep the lower edge below the upper edge.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → Y Size Min - X Size Max
- Number
Right pixel offset from the horizontal screen anchor. Keep the right edge beyond the left edge.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → X Size Max - Y Size Max
- Number
Top pixel offset from the vertical screen anchor. The height is this value minus the lower offset.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → Y Size Max - Position X
- Number
Horizontal screen anchor; 0 is left, 0.5 centre and 1 right. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → Position X - Position Y
- Number
Vertical screen anchor; 0 is bottom, 0.5 centre and 1 top. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → TitleBarConfiguration → Root → Rect → Position Y
Reply button position and size 6
- X Size Min
- Number
Left pixel offset from the horizontal screen anchor. Check the result in game; the Hub does not render this legacy layout.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → X Size Min - Y Size Min
- Number
Bottom pixel offset from the vertical screen anchor. Keep the lower edge below the upper edge.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → Y Size Min - X Size Max
- Number
Right pixel offset from the horizontal screen anchor. Keep the right edge beyond the left edge.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → X Size Max - Y Size Max
- Number
Top pixel offset from the vertical screen anchor. The height is this value minus the lower offset.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → Y Size Max - Position X
- Number
Horizontal screen anchor; 0 is left, 0.5 centre and 1 right. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → Position X - Position Y
- Number
Vertical screen anchor; 0 is bottom, 0.5 centre and 1 top. Pixel offsets are measured from this anchor.
JSON path
UI Configuration → ResponsesConfiguration → ResponseTemplate → Root → Rect → Position Y
Plugin instructions
Dialogs 1.1.1
Dialogs 1.1.1 uses PimpMyCUI 1.4.0 to display five conversation layouts with paginated replies. Also install PlayerEventStates 1.0.0. An NPC provider is needed to open a dialogue by interaction. The opening commands and hooks work without an NPC.
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.
Template keys: cinematic-ember, wasteland-radio, monument-dossier, arctic-signal, carbon-terminal. Cinematic Ember is the new-installation default. Each page has up to four replies; navigation exposes remaining replies. A per-dialogue entry overrides the global choice. Reload Dialogs after changes.
Language: "fr" translates dynamic navigation/conversation labels, not the dialogue text; decorative headings remain English. Other language values use English. The retained UI Configuration contains legacy native settings and is not used by this PimpMyCUI version. For an older native configuration without Presentation, this version interprets legacy as Cinematic Ember and reports the conversion. Unknown template keys or invalid presentation settings are rejected instead of opening a different interface.
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, NPC bindings and edited CUI files: 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 remains optional and independent.
Open a loaded conversation for a connected player from server console/RCON or a server-command trigger:
dialogs.show <steamid> BobA trigger plugin 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. After a reply, Console Commands and Plugins Hooks are separate actions; %steamid% substitution is retained. Dialogs does not create NPCs or a complete quest/reward system.
Customize the CUI
- Open Appearance, choose the template and select the number of replies to edit (one to four).
- Click Edit in CUI Editor, change the visuals and apply the changes back to Dialogs. Reply text and actions still belong to the dialogue, not the visual template.
- Repeat for the other reply-count layouts you want to change. Dialogs chooses the layout for the number of visible replies in game.
- Click Export and select the changed appearance files. Install each at its displayed path,
oxide/data/Dialogs/UI/<template>.cN.json, then reload Dialogs. Exporting a conversation orDialogs.jsonalone does not install those separate CUI files.
These are the existing Dialogs template files, not a second format or a standalone PimpMyCUI package. The Editor checks the template identity, bindings and events; incompatible changes must be fixed before export.
The native and beta editions share layouts but use different rendering runtimes. The gallery shows offline CUI previews, not new gameplay captures. Test long replies, image availability and plugin integrations in game before live use.
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.