ActivityManager

Installation

Follow these steps to install ActivityManager on your FiveM server.

Step by step

  1. 1

    Download & extract

    Download the activitymanager resource from your purchase, extract it into your server's resources directory, and rename the folder to activitymanager (remove version numbers).

  2. 2

    Database setup

    Import the SQL file to create the required tables:

    activitymanager_zones.sql
    -- Run this in your MySQL database
    CREATE TABLE IF NOT EXISTS `activitymanager_zones` (
      `id` INT AUTO_INCREMENT PRIMARY KEY,
      `name` VARCHAR(100) NOT NULL,
      `job_name` VARCHAR(50) NOT NULL,
      `coords_x` FLOAT NOT NULL,
      `coords_y` FLOAT NOT NULL,
      `coords_z` FLOAT NOT NULL,
      `radius` FLOAT DEFAULT 5.0,
      `enabled` TINYINT(1) DEFAULT 1,
      `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
    );
    
    CREATE TABLE IF NOT EXISTS `activitymanager_guilds` (
      `id` INT AUTO_INCREMENT PRIMARY KEY,
      `guild_id` VARCHAR(20) NOT NULL,
      `guild_name` VARCHAR(100) NOT NULL,
      `job_name` VARCHAR(50) NOT NULL,
      `billing_system` VARCHAR(50) DEFAULT 'okokBilling',
      `billing_table` VARCHAR(100) DEFAULT 'okokbanking_transactions',
      `enabled` TINYINT(1) DEFAULT 1,
      UNIQUE KEY `unique_guild` (`guild_id`)
    );
  3. 3

    Server configuration

    Add the resource to your server.cfg:

    server.cfg
    # Ensure your database resource starts first
    ensure oxmysql
    
    # Start ActivityManager
    ensure activitymanager
  4. 4

    IP whitelist

    Your server IP must be whitelisted to communicate with the ActivityManager API. Open a ticket on Discord with your server IP address.

  5. 5

    Discord bot setup

  6. 6

    Admin panel access

    Configure admin permissions in config.lua and open the panel:

    lua
    /ampanel  -- Opens the in-game admin panel to manage zones

Verify installation

Check your server console for:

console
[ActivityManager] Sistema inizializzato correttamente!
[ActivityManager] Guild MyServer: API connessa (Premium: true)
IP whitelist requiredWithout a whitelisted server IP the resource cannot reach the API. Make sure you complete step 4 before going live.