Installation
Set up an AI Core server with txAdmin in a few minutes, or by hand.
Requirements
| Dependency | Version | Why |
|---|---|---|
| FXServer (artifact) with txAdmin | 38039 or newer | ai-core needs it: the server sees player deaths itself. |
| MariaDB (or MySQL) | latest | The database. AI Core creates its own tables. |
| Bun | latest | Only to change or build scripts. Every script ships with its build, so running a server needs no build tools. |
Install with txAdmin (recommended)
Start txAdmin
Download the latest FXServer artifact and start it: txAdmin opens in your browser. Follow the official guide up to the deployment step.
Use the AI Core recipe
Choose Popular Recipes > Remote URL Template and paste:
https://raw.githubusercontent.com/aifivem/aicore-server/main/recipe/ai-core.yamlFill in the details
Enter your server name, your license key from portal.cfx.re and the database. The recipe writes server.cfg and env.cfg, connects the database and downloads every ai-* script. There is no SQL file to import: AI Core and the scripts create and update their own tables at the first start.
Make yourself an admin
Join the server. A welcome card shows the line that makes you an admin: add it to permission.cfg and restart. Then press F10 to open the admin panel; its setup guide walks you through the first settings.
The server list name, description, tags, language, banners and Discord link are set at portal.cfx.re/servers, not in server.cfg.
Install by hand
Get the server folder
Download the server folder (the cfg files, recipe/, tools/, template/). For each ai-* script, download <name>.zip from its latest GitHub release and unzip it into resources/[ai]/. For only the files the server runs, without the source, use <name>-runtime.zip instead.
Configure secrets
Copy env.example.cfg to env.cfg, fill in your license key and the database connection, then create the database.
Start the server
Start FXServer (txAdmin) with this folder as the server data folder.
Layout
| Path | What |
|---|---|
server.cfg | The resource list and config includes. |
env.cfg | License, slots, endpoints, database, RCON. Machine-specific, never in git. |
security.cfg | Strict FiveM security settings. Never loosen them: every script is written for them. |
permission.cfg | Admins and ACE permissions. |
misc.cfg | Language and other shared convars. |
resources/[ai]/ | The AI Core scripts, one folder per ai-* script. |
resources/[standalone]/ | Third-party resources you add. |
packages/ | The @aifivem/* packages (developers). |
template/ | Template for new scripts: bun run new <name> "<description>". |