⚙️ Configuration

Config File Location

The configuration file is located at:

resources/daphne_chat/chat_config.json

This file is auto-generated on first start and can be edited directly (not recommended) or via in-game admin editor (recommended).

Complete Config Schema

interface ChatConfig {
  version: string;
  chatModes: ChatMode[];
  settings: SettingsConfig;
  theme?: ThemeConfig;
  font?: FontConfig;
  layout?: LayoutConfig;
  style?: StyleConfig;
  framework?: FrameworkConfig;
  discord?: DiscordConfig;
  inputHints?: InputHintsConfig;
  autocomplete?: AutocompleteConfig;
}

Chat Modes

Default Chat Modes

Mode	Command	Aliases	Distance	Type	Description
Local	/local	/l	15m	Proximity	Standard local chat
Shout	/shout	/s, /y, /yell	30m	Proximity	Call out to nearby players
Whisper	/whisper	/w, /low	5m	Proximity	Quiet conversation
Me	/me	-	10m	Proximity	Describe character actions (bold)
Do	/do	-	10m	Proximity	Describe environment (italic)
Try	/try	-	10m	Proximity	Attempt action with random success/fail
OOC	/ooc	/b, /looc	-	Global	Out of character chat
Admin	/admin	/a	-	Global	Admin-only chat (requires permission)
Department	/dept	/d, /dep	-	Global	Department radio (Police, EMS, etc.)
Advertisement	/ad	/advert	-	Global	Server-wide ads (120s cooldown)

ChatMode Interface

interface ChatMode {
  id: string;                          // Unique identifier
  name: string;                        // Display name
  command: string;                     // Command (e.g., "local")
  aliases?: string[];                   // Command aliases
  description: string;                 // Mode description
  color: string;                       // Hex color code
  icon: string;                        // Heroicon or emoji
  distance: number;                    // Proximity distance (0 = global)
  isGlobal: boolean;                   // Global or proximity-based
  isDefault?: boolean;                 // Default chat mode
  enabled?: boolean;                   // Enable/disable mode
  cooldown?: number;                   // Cooldown in seconds
  requiredPermission?: string;         // ACE permission required
  format?: 'normal' | 'italic' | 'bold';  // Text formatting
  hasSuccessState?: boolean;           // For /try command
  requiresJob?: string | string[];      // Job requirement (framework)
  requiresJobGrade?: number;           // Minimum job grade
  requiresGroup?: string | string[];   // Group requirement
  cost?: number;                       // Cost per message (framework)
}

Example Configuration

{
  "id": "local",
  "name": "Local",
  "command": "local",
  "aliases": ["l"],
  "description": "Talk to nearby players",
  "color": "#da7d7d",
  "icon": "heroicon:ArchiveBoxArrowDownIcon:outline",
  "distance": 15,
  "isGlobal": false,
  "isDefault": true,
  "enabled": true,
  "cooldown": 0,
  "format": "normal"
}

Settings

interface SettingsConfig {
  maxMessageLength: number;           // Default: 256
  defaultMode: string;                // Default: "local"
  showDistanceInMessages: boolean;     // Default: true
  enableCooldowns: boolean;            // Default: true
  enablePermissions: boolean;          // Default: true
}

Theme Configuration

interface ThemeConfig {
  background: string;                 // Main background color
  backgroundHover: string;            // Hover background color
  foreground: string;                 // Text color
  muted: string;                      // Muted text color
  border: string;                     // Border color
  success: string;                     // Success color
  error: string;                       // Error color
  warning: string;                    // Warning color
  info: string;                       // Info color
  card: string;                       // Card background
  popover: string;                    // Popover background
  primary: string;                    // Primary color
  primaryForeground: string;           // Primary text
  secondary: string;                  // Secondary color
  secondaryForeground: string;         // Secondary text
  accent: string;                     // Accent color
  accentForeground: string;            // Accent text
  destructive: string;                 // Destructive color
  destructiveForeground: string;       // Destructive text
  input: string;                      // Input background
  ring: string;                       // Ring/focus color
  shadow: string;                     // Shadow color
}

Font Configuration

interface FontConfig {
  family: 'inter' | 'roboto' | 'poppins' | 'system';
  size: {
    timestamp: number;                 // Default: 12
    message: number;                  // Default: 14
    username: number;                 // Default: 14
    system: number;                   // Default: 13
  };
  weight: {
    normal: number;                   // Default: 400
    medium: number;                   // Default: 500
    semibold: number;                 // Default: 600
    bold: number;                     // Default: 700
  };
}

Layout Configuration

interface LayoutConfig {
  width: number;                      // Default: 550
  height: number;                     // Default: 600
  position: {
    top: number;                      // Default: 25
    left: number;                     // Default: 30
  };
  constraints: {
    minWidth: number;                 // Default: 350
    maxWidth: number;                 // Default: 800
    minHeight: number;                // Default: 400
    maxHeight: number;                // Default: 900
  };
  avatarSize: number;                 // Default: 35
  inputMinHeight: number;             // Default: 60
  inputMaxHeight: number;             // Default: 120
  spacing: {
    message: number;                  // Default: 12
    padding: number;                  // Default: 16
    gap: number;                      // Default: 12
  };
}

Style Configuration

interface StyleConfig {
  borderRadius: number;               // Default: 5
  backdropBlur: 'none' | 'sm' | 'md' | 'lg' | 'xl';
  opacity: {
    background: number;               // Default: 1.0
    header: number;                   // Default: 0.3
  };
}

Framework Configuration

interface FrameworkConfig {
  enabled: boolean;                   // Default: true
  force?: 'esx' | 'qbcore' | 'qbox' | 'standalone' | null;
  moneyType: 'cash' | 'bank';        // Default: 'cash'
}

Discord Configuration

interface DiscordConfig {
  enabled: boolean;                   // Default: true
  showAvatars: boolean;               // Default: true
  showRoles: boolean;                 // Default: true
  useDiscordUsername: boolean;        // Default: false
  defaultUsernameColor: string;        // Default: '#e3e3e3'
  botToken: string;                   // Set via server.cfg convar
  guildId: string;                   // Set via server.cfg convar
  roleRefreshInterval: number;        // Default: 1800000 (30 min)
  defaultMemberRole: {
    name: string;                     // Default: 'Member'
    color: string;                   // Default: '#6b7280'
    priority: number;                 // Default: 10
  };
  roleMapping: Record<string, {      // Manual role overrides
    name: string;
    color: string;
    priority: number;
  }>;
  display: {
    maxRoles: number;                // Default: 2
    showAllRoles: boolean;           // Default: true
  };
}