Roblox Integration
Adonis Plugin
Configuration

Configuration

Configure the Technified Adonis plugin to match your needs.

Configuration Location

Find the configuration at the top of the plugin file:

ServerScriptService/Adonis/Loader/Config/Plugins/Server-Technified.luau

Full Configuration

local TECHNIFIED_CONFIG = {
    -- API Connection
    API_KEY = "technified_...",
    GUILD_ID = "1234567890123456789",
    BASE_URL = "https://api.technified.xyz/api/v1",
    REQUEST_TIMEOUT = 10,
 
    -- Features
    SYNC_PERMISSIONS = true,
    SYNC_BANS = true,
    SYNC_MUTES = true,
    BIDIRECTIONAL_SYNC = true,
    LOG_ACTIONS = true,
    TRACK_SESSIONS = true,
    SESSION_MIN_LEVEL = 100,
}

API Connection

API_KEY

Your Technified API key for authentication.

API_KEY = "technified_1234567890_abc123..."

Get this from Dashboard > Settings > API Keys.

GUILD_ID

Your Discord server ID.

GUILD_ID = "1234567890123456789"

Get this by right-clicking your Discord server with Developer Mode enabled.

BASE_URL

The Technified API endpoint. Usually you don't need to change this.

BASE_URL = "https://api.technified.xyz/api/v1"

REQUEST_TIMEOUT

How long to wait for API responses in seconds.

REQUEST_TIMEOUT = 10

Increase this if you experience timeout errors on slow connections.

Feature Toggles

SYNC_PERMISSIONS

Sync staff permissions from Technified to Adonis.

SYNC_PERMISSIONS = true

When enabled:

  • Staff members get their Adonis level from the Technified API
  • Permissions update on player join
  • 5-minute cache for performance

SYNC_BANS

Check ban status from Technified when players join.

SYNC_BANS = true

When enabled:

  • Banned players are kicked on join
  • Bans from dashboard apply in-game immediately
  • Ban list synced to Adonis :bans command

SYNC_MUTES

Check mute status from Technified when players join.

SYNC_MUTES = true

When enabled:

  • Muted players are muted in Adonis on join
  • Mutes from dashboard apply in-game
  • Mutes added to Adonis mute list

BIDIRECTIONAL_SYNC

Sync Adonis bans/mutes back to the Technified API.

BIDIRECTIONAL_SYNC = true

When enabled:

  • :ban in Adonis creates a ban in Technified
  • :unban in Adonis removes the ban from Technified
  • Same for :mute and :unmute
  • Prevents echo loops (doesn't re-sync API actions)

LOG_ACTIONS

Log moderation and admin commands to Technified.

LOG_ACTIONS = true

Logged commands include:

  • Moderation: kick, ban, unban, mute, unmute, warn, jail, shutdown
  • Admin: fly, tp, god, speed, heal, kill, freeze, invisible, and more

TRACK_SESSIONS

Track staff play sessions.

TRACK_SESSIONS = true

When enabled:

  • Staff session starts when they join
  • Session ends when they leave
  • Visible in Dashboard > Roblox > Staff Activity

SESSION_MIN_LEVEL

Minimum Adonis level required for session tracking.

SESSION_MIN_LEVEL = 100

Adonis levels:

  • 100 = Moderators
  • 200 = Admins
  • 300 = HeadAdmins
  • 900 = Creators

Only track staff at or above this level.

Permission Mapping

The plugin maps Technified permission levels to Adonis levels:

Technified LevelAdonis LevelAdonis Rank
10+900Creators
7-9300HeadAdmins
3-6200Admins
1-2100Moderators
00Players

This mapping is built into the plugin. Staff set up in the Technified dashboard automatically receive the appropriate Adonis permissions.

Example Configurations

Full Integration

All features enabled (default):

local TECHNIFIED_CONFIG = {
    API_KEY = "technified_...",
    GUILD_ID = "123456789",
    BASE_URL = "https://api.technified.xyz/api/v1",
    REQUEST_TIMEOUT = 10,
 
    SYNC_PERMISSIONS = true,
    SYNC_BANS = true,
    SYNC_MUTES = true,
    BIDIRECTIONAL_SYNC = true,
    LOG_ACTIONS = true,
    TRACK_SESSIONS = true,
    SESSION_MIN_LEVEL = 100,
}

Read-Only Mode

Only receive data from dashboard, don't sync back:

local TECHNIFIED_CONFIG = {
    API_KEY = "technified_...",
    GUILD_ID = "123456789",
    BASE_URL = "https://api.technified.xyz/api/v1",
    REQUEST_TIMEOUT = 10,
 
    SYNC_PERMISSIONS = true,
    SYNC_BANS = true,
    SYNC_MUTES = true,
    BIDIRECTIONAL_SYNC = false,  -- Disabled
    LOG_ACTIONS = false,         -- Disabled
    TRACK_SESSIONS = true,
    SESSION_MIN_LEVEL = 100,
}

Bans Only

Only sync bans, nothing else:

local TECHNIFIED_CONFIG = {
    API_KEY = "technified_...",
    GUILD_ID = "123456789",
    BASE_URL = "https://api.technified.xyz/api/v1",
    REQUEST_TIMEOUT = 10,
 
    SYNC_PERMISSIONS = false,
    SYNC_BANS = true,
    SYNC_MUTES = false,
    BIDIRECTIONAL_SYNC = true,
    LOG_ACTIONS = false,
    TRACK_SESSIONS = false,
    SESSION_MIN_LEVEL = 100,
}

Senior Staff Only

Only track sessions for Admins and above:

SESSION_MIN_LEVEL = 200,  -- Admins and above