Back to mods
sim-chat project artwork

CurseForge · Minecraft mod

sim-chat

A Minecraft Forge mod that adds a slack/discord-style chat interface for dialogues. Designed for modpack creators to script conversations via datapacks and commands.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which sim-chat release matches 1.20.1 Forge?

Updated 9 months ago
Best match for your filters sim-chat-0.12.0+forge-1.20.1
Game version 1.20.1
Loader Forge

sim-chat-0.12.0+forge-1.20.1 targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is sim-chat required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does sim-chat-0.12.0+forge-1.20.1 need?

sim-chat-0.12.0+forge-1.20.1 on 1.20.1 Forge. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add sim-chat without breaking your instance.

Built for sim-chat-0.12.0+forge-1.20.1 on 1.20.1 Forge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use sim-chat-0.12.0+forge-1.20.1. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside sim-chat-0.12.0+forge-1.20.1. It opens that exact file at the source.

About this project

What does sim-chat add?

image

Sim Chat

A Minecraft Forge mod that adds a slack/discord-style chat interface for dialogues. Designed for modpack creators to script conversations via datapacks and commands.

Features

  • Slack/Discord-style UI: Sidebar with conversation list, chat history panel with message bubbles
  • Team-based conversations: Players share conversation history within their team
  • Datapack-driven dialogues: Define dialogue trees in JSON, loaded as datapack resources
  • Action buttons: Clickable response options that trigger commands or continue dialogue
  • Conditional actions: Show/hide buttons based on data, scores, or KubeJS callbacks
  • Template system: Dynamic text with player names, team data, world info
  • Typing indicators: Simulated typing delay before messages appear
  • Toast notifications: Non-intrusive popups when new messages arrive
  • Custom avatars: Load PNG images from config folder for sender portraits
  • Team data storage: Store values, states, and scores per-team
  • KubeJS integration: Register custom callbacks for conditions and templates

Commands

Basic Commands

/simchat send <player> <dialogueId>    - Send dialogue to player
/simchat system <player> <entityId> <message>  - Send system message
/simchat clear <player> [entityId]     - Clear chat history
/simchat open <player> [entityId]      - Open chat screen for player
/simchat reload                        - Reload KubeJS callbacks

Team Commands

/simchat team create <name>            - Create a new team
/simchat team invite [player]          - Invite player (or broadcast to all if omitted)
/simchat team join <teamId>            - Join a team by ID
/simchat team list                     - List all teams
/simchat team info                     - Show current team info
/simchat team title <newTitle>         - Change team name
/simchat team color <color>            - Change team color (name or 0-15)

Available colors: black (0), dark_blue (1), dark_green (2), dark_aqua (3), dark_red (4), dark_purple (5), gold (6), gray (7), dark_gray (8), blue (9), green (10), aqua (11), red (12), light_purple (13), yellow (14), white (15)

Data Commands

Store values per-team for tracking progress, scores, states. All commands accept an optional [target] parameter (player name or team ID/title) to operate on a specific team:

/simchat data get <key> [target]       - Get value
/simchat data set <key> <value> [target]   - Set value (auto-detects numbers)
/simchat data add <key> <amount> [target]  - Add to numeric value
/simchat data remove <key> [target]    - Remove key
/simchat data list [target]            - List all data

Examples:

/simchat data get gold                 - Get your team's gold
/simchat data get gold Steve           - Get Steve's team's gold
/simchat data set rank vip "Team Alpha"    - Set string on Team Alpha
/simchat data set gold 100             - Set number (auto-detected)
/simchat data add points 10 abc1234    - Add 10 points to team abc1234

Callback Commands

/simchat callback list                 - List registered KubeJS callbacks
/simchat callback run <name> [player]  - Execute callback and show result

Datapack Format

Dialogues are loaded from: data/<namespace>/simchat/<path>.json

Example: data/mypack/simchat/contractor/greeting.json

{
  "entityId": "contractor",
  "entityName": "Director Vex",
  "entitySubtitle": "Helion Industries",
  "text": "Hello {player:name}! Your team ({team:title}) has completed {data:contracts_done} contracts.",
  "actions": [
    {
      "label": "Accept Contract (+{data:reward} credits)",
      "commands": [
        "simchat data add contracts_done 1",
        "give @s emerald 10"
      ],
      "reply": "I'll take the job.",
      "nextState": "mypack:contractor/contract_details",
      "condition": "data:has_clearance"
    },
    {
      "label": "Decline",
      "reply": "Not interested.",
      "condition": "!data:forced_contract"
    }
  ]
}

Dialogue Fields

Field Type Description
entityId string Unique entity identifier (used for avatar lookup and conversation grouping)
entityName string Display name shown in chat
entitySubtitle string Optional subtitle (company, title)
text string Message content (supports templates)
actions array Response buttons (optional)

Action Fields

Field Type Description
label string Button text (supports templates)
commands array Commands to run when clicked
reply string Player's reply shown in chat (supports templates)
nextState string Dialogue ID to trigger after this action
condition string Condition that must be true to show button
itemsVisual array Items to display on button
itemsInput array Items required from player (checked before enabling)
itemsOutput array Items given to player

Item Format

{
  "item": "minecraft:diamond",
  "count": 5
}

Templates

Use {resolver:name} syntax in text, labels, and replies:

Template Description Example
{player:name} Player's username "Steve"
{player:uuid} Player's UUID "069a79f4…"
{team:id} Team ID "a1b2c3d"
{team:title} Team name "The Builders"
{team:memberCount} Number of team members "3"
{team:color} Team color index (0-15) "12"
{data:keyname} Team data value "42"
{world:day} Current world day "15"
{world:time} Time of day (0-24000) "6000"
{world:dimension} Dimension ID "minecraft:overworld"
{world:weather} Weather state "clear", "rain", "thunder"
{kjs:callbackName} KubeJS callback result (any value)

Example:

{
  "text": "Day {world:day}: Hello {player:name}! You have {data:points} points."
}

Conditions

Use conditions to show/hide action buttons. Prefix with ! to negate.

Condition Description
data:keyname True if team data is truthy (exists, non-zero, non-empty)
kjs:callbackName True if KubeJS callback returns truthy
score:objectiveName True if player's scoreboard score > 0
permission:level True if player has permission level

Examples:

{
  "actions": [
    {
      "label": "VIP Option",
      "condition": "data:is_vip"
    },
    {
      "label": "Regular Option",
      "condition": "!data:is_vip"
    },
    {
      "label": "Admin Only",
      "condition": "permission:2"
    }
  ]
}

KubeJS Integration

Register callbacks in kubejs/server_scripts/simchat.js:

// Clear old callbacks on reload
SimChat.clearCallbacks()

// Register a condition callback
SimChat.registerCallback('hasEnoughGold', ctx => {
    return ctx.player.persistentData.getInt('gold') >= 100
})

// Register a template callback
SimChat.registerCallback('goldAmount', ctx => {
    return ctx.player.persistentData.getInt('gold')
})

// Register using team data
SimChat.registerCallback('isVeteran', ctx => {
    return ctx.team && ctx.team.data.missions_completed >= 10
})

// Time-based callback
SimChat.registerCallback('greeting', ctx => {
    let time = ctx.player.level.dayTime % 24000
    if (time < 6000) return 'Good morning'
    if (time < 12000) return 'Good afternoon'
    return 'Good evening'
})

SimChat.logStatus() // Log callback count

Callback Context

Available in callbacks via ctx:

// Player (KubeJS wrapped - full access)
ctx.player
ctx.player.persistentData
ctx.player.level.dayTime
ctx.player.inventory

// Team (null if no team)
ctx.team.id
ctx.team.title
ctx.team.memberCount
ctx.team.data           // Map of all team data
ctx.team.data.keyname   // Access specific key
ctx.team.hasData('key') // Boolean check

// Entity (null if no entity context)
ctx.entity.id
ctx.entity.displayName
ctx.entity.messageCount
ctx.entity.lastMessage
ctx.entity.isTyping

Usage in Dialogues

{
  "text": "{kjs:greeting}, {player:name}! You have {kjs:goldAmount} gold.",
  "actions": [
    {
      "label": "Buy Item (100 gold)",
      "condition": "kjs:hasEnoughGold",
      "commands": ["simchat data add purchases 1"]
    }
  ]
}

Entity Files

Place entity configs and avatars in: config/simchat/entities/

Each entity can have:

  • <entityId>.json - Config with name, subtitle, avatar settings
  • <entityId>.png - Avatar image (any size, displayed at 36x36)

Example: config/simchat/entities/merchant.json

{
  "name": "Merchant Bob",
  "subtitle": "Ironwood Trading Co.",
  "avatar": "merchant"
}
Field Description
name Default display name
subtitle Default subtitle
avatar Avatar ID (defaults to entityId)

Defaults

Create default.json and/or default.png as fallbacks for entities without specific files.

All entity files hot-reload when modified.

Configuration

Client Config (simchat-client.toml)

Option Default Description
notificationSound minecraft:block.note_block.bell Sound on new message
notificationVolume 0.5 Sound volume (0.0-1.0)
showToasts true Show toast popups
toastDuration 5.0 Toast display time (seconds)
sidebarWidth 240 Conversation list width
sidebarSortMode 0 Sort: 0=recent, 1=alphabetical

Server Config (simchat-common.toml)

Option Default Description
minDelay 0.3 Minimum typing delay (seconds)
maxDelay 3.0 Maximum typing delay (seconds)
charsPerSecond 100.0 Simulated typing speed
commandPermissionLevel 2 Permission for /simchat commands

Keybinds

Key Action
; (semicolon) Open chat screen

JSON Schema

Validate your dialogues with the JSON schema at schemas/dialogue.schema.json.

VS Code setup:

{
  "$schema": "https://raw.githubusercontent.com/YardenZamir/sim-chat/main/schemas/dialogue.schema.json",
  "entityId": "...",
  ...
}

License

MIT

Project description from CurseForge.

Pick your setup

sim-chat by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

sim-chat versions and loaders

12 of 12 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.