🔑installation

Script Installation

Before starting, you must log in to the CFX portal to download the asset. You will be able to download it as many times as you want on the official CFX page. Just as you download it the first time, you will also download it multiple times in the future to get updates.

---

1

Logging in to the CFX Portal

First, log in to the official CFX Portal by clicking here: https://portal.cfx.re/assets/granted-assets

2

Find our Script

Once logged in, navigate to the Granted Assets section to access your purchased assets. You can download them by clicking the "Download" button. Find sl-chat and download it.

3

Install Script

After downloading the script, open your server resources folder and extract the zip file you downloaded. Drag and drop into resources folder.

Make sure you're starting the script in your server.cfg:

server.cfg

ensure sl-chat

⚠️ Important: Make sure sl-chat starts AFTER your framework and ox_lib!

---

Dependencies

Resource	Required	Link	Description
es_extended	Optional	https://github.com/esx-framework/esx_core	ESX Framework
ox_lib	Optional	https://github.com/overextended/ox_lib	Utility library
oxmysql	Optional	https://github.com/overextended/oxmysql	MySQL async resource

---

Framework Configuration

The script comes pre-configured for ESX. To use with other frameworks, update the framework-specific client and server bridge files.

Edit client bridge

Open modules/editable_client.lua and replace framework-specific code with your framework implementation.

Edit server bridge

Open modules/editable_server.lua and replace framework-specific code with your framework implementation.

See Framework Bridge for complete examples for:

• ESX (Default)

• QB-Core

• Custom Frameworks

---

Script Configuration

After installation, configure the script by editing files in the shared folder:

File	Description
commands.config.lua	Main chat configuration and commands
suggestions.config.lua	Additional command suggestions
logs.config.lua	Discord webhook logging
translate.config.lua	Language settings

---

Language Configuration

Open shared/translate.config.lua and set your preferred language:

shared/translate.config.lua

TranslateConfig = {}

TranslateConfig.Language = 'en' -- Available: 'en', 'pl'
TranslateConfig.FallbackLanguage = 'en'

---

File Structure

sl-chat/
├── cl_main.lua                    # Client-side main script
├── sv_main.lua                    # Server-side main script
├── fxmanifest.lua                 # Resource manifest
├── data/
│   └── language/                  # Translation files
│       ├── en.json
│       └── pl.json
├── dist/                          # Built NUI files
│   ├── index.html
│   ├── dui_text.html
│   └── assets/
├── modules/
│   ├── editable_client.lua        # Framework bridge (client)
│   ├── editable_server.lua        # Framework bridge (server)
│   ├── client/
│   │   ├── cursor.lua             # Cursor system
│   │   ├── display.lua            # 3D text display
│   │   ├── images.lua             # Streamer mode
│   │   └── suggestions.lua        # Command suggestions
│   ├── server/
│   │   ├── logs.lua               # Discord logging
│   │   └── translate.lua          # Server translations
│   └── shared/
│       ├── translate.lua          # Shared translations
│       └── utils.lua              # Utility functions
└── shared/
    ├── commands.config.lua        # Commands configuration
    ├── suggestions.config.lua     # Additional suggestions
    ├── logs.config.lua            # Logging configuration
    └── translate.config.lua       # Translation settings

---

Verification

1

Start your server

2

Join the server

3

Press T to open chat

4

Try typing /me test action - you should see styled message and 3D text above your head

5

Try /report test - admins should receive notification

---

Troubleshooting

Chat doesn't open

• Make sure sl-chat is starting after ox_lib and your framework

• Check server console for errors

• Verify all dependencies are installed

Commands don't work

• Check commands.config.lua for proper command setup

• Verify framework bridge is correctly configured

• Check server console for Lua errors

3D text doesn't appear

• Verify displayTrigger is configured in command config

• Check Chat.Display settings in commands.config.lua

• Make sure you're within the configured distance

---

Support

If you have any issues with installation or find any error/bug, open a ticket on our Discord Server for Support:

Discord: https://discord.gg/zZj4bNMuf7

---

Enjoy using sl-chat!