"Getting Started with FiveForge: Your AI-Powered FiveM Development Assistant"

FiveForge is an AI-powered development assistant built specifically for FiveM server development. Unlike general-purpose AI coding tools, FiveForge understands FiveM resources, QBCore, ESX, vRP, and the unique patterns that make FiveM development challenging.

This guide walks through installation, first workspace setup, and your first session.

Installation

FiveForge Desktop runs on Windows, macOS, and Linux.

System Requirements

Windows

1. Download the installer from /download — it's named FiveForge-Setup-x.x.x.exe
2. Run the installer and follow the setup wizard
3. The app downloads dependencies on first launch (this may take a moment)

Note: If your antivirus blocks the installer, it's a false positive common with Electron apps. Add an exception for the FiveForge directory.

macOS

1. Open the .dmg file and drag FiveForge to Applications
2. Launch from Applications or Spotlight
3. If Gatekeeper blocks the app, go to System Settings > Privacy & Security and click Open Anyway

Linux

# AppImage (any distro)
chmod +x FiveForge-x.x.x.AppImage
./FiveForge-x.x.x.AppImage

# Debian/Ubuntu
sudo dpkg -i fiveforge_x.x.x_amd64.deb
sudo apt-get install -f

Choosing Your Workspace

The workspace is the most important decision in your setup. FiveForge reads your entire workspace to understand your server's framework, resource structure, and coding patterns.

Do: point it to your server's full resources directory (or the directory containing all your resources).

Don't: point it to a single script or folder. The AI needs the full picture to generate contextually correct code.

Your workspace should contain your fxmanifest.lua files, framework configurations, and at least a few resources. FiveForge will automatically detect your framework (QBCore, ESX, vRP, or standalone) and understand which exports and events are available.

Your First Session

Once your workspace is set up, try a real task. Here's a good first prompt:

"Create a qb-target interaction for a weapon shop. It should check the player's job, require police presence at night, and show a 3D text label. Use my existing resource patterns."

FiveForge will:

1. Scan your existing resources to understand your code style
2. Detect your framework version (QBcore, ESX, etc.)
3. Check what dependencies you have (qb-target, ox_lib, etc.)
4. Generate complete resource files that match your conventions

The generated code won't be generic boilerplate — it will use the same export patterns, naming conventions, and utility functions your other resources use.

Understanding the Interface

The dashboard has three areas:

• Sidebar — navigate between chat sessions, saved templates, the prompt library, and settings
• Chat area — the main workspace where you interact with the AI
• Header bar — shows your active workspace, daily usage, and account menu

Usage Tracking

The usage bar in the header shows your remaining daily messages:

• Green — plenty of tokens remaining
• Amber — approaching your daily limit
• Red — daily limit reached; new tasks are paused until the UTC midnight reset

Every plan includes every available AI model. Free accounts get a lower daily token budget; GO subscribers get a higher one plus the premium features.

Common Pitfalls to Avoid

Too-Vague Prompts

This is too broad. FiveForge works best with specific requests:

Mixing Frameworks

If your server uses QBCore but you ask for an ESX-style export, the generated code won't work. Always specify your framework or let FiveForge auto-detect it.

Forgetting Context

FiveForge remembers your workspace, not your previous prompts. If you switch tasks, include relevant context:

Next Steps

• Learn about model selection and picking the right one for your task
• Browse the template library for common patterns
• Check out QBCore or ESX specific guides
• Join the Discord to share what you build