Forge Server Extension

# Forge Server Extension

Forge Server is an arma-rs extension for Arma 3 server-side persistence and domain services. It exposes game-facing commands and stores durable state in SurrealDB.

# Forge Server Extension

Forge Server is an arma-rs extension for Arma 3 server-side persistence and domain services. It exposes game-facing commands and stores durable state in SurrealDB.

## Architecture

SQF modules call `forge_server` through `fnc_extCall`. Small requests use the direct `callExtension` path, while large payloads are staged through the transport layer.

    SQF module
      -> extension bridge
      -> domain command
      -> service layer
      -> repository
      -> SurrealDB

## Configuration

Copy `config.example.toml` to `config.toml` next to the extension DLL.

    [surreal]
    endpoint = "127.0.0.1:8000"
    namespace = "forge"
    database = "main"
    username = "root"
    password = "root"
    connect_timeout_ms = 5000

For install links and Forge-specific setup steps, see SurrealDB Setup.

## References

- API Reference
- Usage Examples
- Framework Module Guides

Edit this page or Report an issue

SurrealDB Setup

Forge uses SurrealDB for durable storage. The Rust server extension connects to SurrealDB on startup and applies Forge schema modules automatically, so setup comes down to running a reachable database and matching the Forge config.

Forge Server API Reference

The Forge server extension exposes domain-oriented commands through callExtension. Persistent data is stored through the configured SurrealDB connection and schema modules.