Dialogs 1.1.0

Give your NPCs something to say

Dialogs creates branching conversations for your Rust server. Write an NPC's message, add player replies and decide what each choice does: continue to another message, record a decision or trigger a server action.

• Offer different replies according to a player's progress.
• Remember choices with Player Event States and reuse them in another conversation.
• Open a dialogue through an NPC interaction, a server command or another plugin.
• Present conversations with five built-in interfaces and paginated replies.

Required: Player Event States, installed separately. Dialogs 1.1.0 on this page is the native edition. It requires neither PimpMyCUI nor ImageLibrary.

Conversations that react to players

An NPC can introduce the camp to a newcomer, offer another reply after the player speaks with a second character, or stop offering a one-time choice once it has been taken.

Set conditions on opening messages and replies. Record a true/false player state after a choice, then use that state elsewhere through Player Event States. The included Alice and Bob examples demonstrate linked conversation paths; they do not give items or create a complete quest system.

For rewards, events or other gameplay, add your installed plugins' console commands or hooks to a reply. %steamid% passes the player ID in string parameters. Those integrations handle the actual reward or gameplay action.

NPC Overlay is optional: it can display an NPC's name or role, but does not open Dialogs or spawn characters.

Five interfaces included

Choose Cinematic Ember, Wasteland Radio, Monument Dossier, Arctic Signal or Carbon Terminal. Set one style globally and override it for individual dialogues when needed.

Each template displays up to four replies per page, with controls for the remaining replies. Conversations with no available replies still have a close action. New installations use Cinematic Ember. An existing native configuration without the new presentation settings retains its previous legacy layout.

The native templates are built into Dialogs; applying a custom CUI Editor project belongs to the separate beta edition below.

Create and edit dialogues on PimpMyRust

Use the dialogue graph to see the conversation's branches, select a message or reply to edit it, and choose what happens next. Import your current files or create a new conversation. Export only the dialogues, NPC associations or configuration you want to install.

Create and edit dialogues on PimpMyRust →

Installation and dialogue guide →

With an NPC, or without one

NPC interaction: create a character with Human NPC, or another provider compatible with Dialogs, then associate its actual NPC ID with a dialogue. Dialogs handles the conversation, not NPC spawning.

Server command: open a dialogue for a connected player from the server console, RCON or a trigger plugin:

dialogs.show <steamid> Bob

Replace <steamid> with the connected player's SteamID64 and Bob with the ID of a loaded dialogue. A dialogue named Bob is stored in DialogData_Bob.json.

Plugin integration: another plugin can open a conversation through Dialogs's API. See the guide for commands, hooks and their parameters.

Start with the supplied conversations

1. Install PlayerEventStates.cs and Dialogs.cs. Back up your existing conversations.
2. Add the optional Alice/Bob examples from the ZIP to oxide/data/Dialogs/ and reload.
3. Join as an administrator and enter /dialog_show Bob to try a conversation. Edit its files on PimpMyRust and export your changes.

The main configuration is oxide/config/Dialogs.json. Dialogue files and DialogsNpcsData.json belong in oxide/data/Dialogs/. Use Carbon's corresponding configured directories.

Optional PimpMyCUI beta

Separate beta on PimpMyRust — not the native Codefling download above.

The separate Dialogs beta lets you edit its interface in PimpMyCUI Editor. It still requires Player Event States and additionally needs the free PimpMyCUI plugin, installed separately.

Explore the Dialogs beta →

Access is for verified Dialogs buyers: sign in to PimpMyRust, link your Codefling account and refresh your purchases. Install one Dialogs edition at a time. Both editions currently display version 1.1.0, so choose the native/stable configurator for the Codefling ZIP and the beta configurator for the PimpMyCUI download.

Compatibility and support

Back up your configuration, conversations and NPC associations before updating. Review commands and hooks on a test server before exposing them to players. Dialogs does not include NPC reaction animations or a complete quest/reward system.

Codefling support · PimpMyRust Discord

Artwork is illustrative. Interface images are offline previews over a Rust screenshot, not new in-game captures. Configurator images are software captures.

DialogData_Alice.json DialogData_Bob.json