Standalone

Agency-Doorlock الإعدادات

أبسط طريقة لإغلاق مدينتك. يحوّل Agency-Doorlock أي باب إلى قفل آمن يحفظ حالته، والإعداد يتم داخل اللعبة: صوّب نحو.

v1.1.8مجاني6 صفحات

01الإعدادات

تثبيت سريع · config.lua · Agency-Doorlock

--[[
    ╔══════════════════════════════════════════════════════════════════════╗
    ║                  AGENCY DOORLOCK  -  CONFIGURATION                   ║
    ║                          (c) Agency Scripts                          ║
    ╚══════════════════════════════════════════════════════════════════════╝

    Lockable doors with E & Target, easy in-game setup, Job / Gang / Grade,
    per-player and item-key access. QB / QBox / ESX / Standalone auto-detect.

    CONTENTS
     1. Core               Language, framework, notifications, debug
     2. Interaction        Key / target, prompt, interaction range
     3. Item Keys          Items that lock and unlock doors
     4. Door Behaviour     Lock closes door, hold open (garage doors, gates)
     5. Sound & Animation  Lock sound, hand animation
     6. Setup              /adoorlock command, permissions, door detection
     7. Visuals            Colours, door marker
     8. Static Doors       Doors defined in this file instead of in-game
     9. Companion App      Free iOS / Android remote control

    No version number in this file, on purpose: your config is kept across
    updates, so a number here would go stale and misreport your install.
    The version you are running is the one in fxmanifest.lua, please quote
    that one in support.
]]

Config = {}


--==============================================================================
--  1 · CORE
--==============================================================================

-- ── Language ─────────────────────────────────────────────────────────────────
-- Default is English. Add more by dropping a file into shared/locale/<code>.lua
-- (English is the fallback for any missing text).
-- Available: en de fr es it pt nl pl cs sk ro ru uk bg tr el hu hr sv da no fi ja zh ko
Config.Locale = 'en'

-- ── Framework ────────────────────────────────────────────────────────────────
-- 'auto'       = detect QBox (qbx_core), QBCore or ESX (recommended)
-- 'qb' / 'qbx' / 'esx' = force a framework
-- 'standalone' = no framework: only "everyone" and per-player (identifier)
--                access are enforced. Job / Gang locks need QB, QBox or ESX.
Config.Framework = 'auto'

-- ── Notifications ────────────────────────────────────────────────────────────
-- 'agency-notify' = Agency Notify (free): https://shop.agencyg.de
-- 'framework'     = the QBCore / ESX built-in notification
-- 'none'          = no notifications
Config.NotifySystem = 'agency-notify'

-- ── Debug ────────────────────────────────────────────────────────────────────
-- Prints access-check details to the server console. Set false when live.
Config.Debug = true


--==============================================================================
--  2 · INTERACTION
--==============================================================================

-- ── Mode ─────────────────────────────────────────────────────────────────────
-- 'key'    = press Config.InteractKey at the door (uses the Text UI)
-- 'target' = ox_target / qb-target eye option
-- 'both'   = key prompt AND target option (recommended)
Config.Interaction = 'both'

Config.InteractKey = 38                       -- control id, 38 = E
Config.InteractKeyLabel = 'E'                 -- shown on the prompt keycap
Config.TargetSystem = 'ox_target'             -- 'ox_target' | 'qb-target'

-- ── Prompt ───────────────────────────────────────────────────────────────────
-- 'default'   = built-in prompt (no dependency)
-- 'jg-textui' = https://github.com/jgscripts/jg-textui
Config.TextUISystem = 'default'

-- Master switch for the [E] prompt. Leave true: hiding the prompt for SINGLE
-- doors is done per door in the setup UI ("Hide [E] prompt").
Config.ShowPrompt = true

Config.DrawDistance = 12.0                    -- metres before a door's prompt is drawn (performance)

-- ── Range ────────────────────────────────────────────────────────────────────
-- DEFAULT range (metres) in which a player can lock AND unlock a door. Every
-- door can override it in /adoorlock ("Interaction range"), which large
-- garage doors and gates need: their centre point sits several metres from
-- where a player can actually stand. Doors without an override use this value.
Config.InteractDistance = 1.6

-- Upper limit for the per-door override, so a mistyped value can't make a
-- door operable from across the map. Enforced server-side on save.
Config.MaxInteractDistance = 50.0


--==============================================================================
--  3 · ITEM KEYS
--==============================================================================
-- Doors can be opened with items: a key, a keycard, a badge. Which items open
-- a door is set PER DOOR in /adoorlock (tab "Items"). A player carrying one of
-- those items may lock and unlock the door, like a job or player grant.
--
-- Items are checked last: a player who already has access through a job, gang,
-- player grant or "Everyone" never uses up an item.
--
-- Supported inventories: ox_inventory, qb-inventory / ps-inventory (QBCore),
-- ESX. Works on QBox through ox_inventory.
--
-- This block is OPTIONAL. If an older config.lua doesn't have it, item keys
-- stay enabled with the defaults below.
Config.ItemKeys = {
    Enable    = true,                         -- master switch for item keys
    Inventory = 'auto',                       -- 'auto' | 'ox_inventory' | 'framework'

    -- Items that open EVERY door, no matter what the door allows.
    -- Example: { 'master_key' }
    MasterItems = {},

    -- Items that are used up (one removed) each time they lock or unlock a door.
    -- Example: { ['keycard_single'] = true }
    ConsumeItems = {},
}


--==============================================================================
--  4 · DOOR BEHAVIOUR
--==============================================================================

-- ── Locking ──────────────────────────────────────────────────────────────────
-- true  = a locked door is always closed and locked (reliable, default)
-- false = a locked door that's open stays movable until it swings shut, then latches
Config.LockClosesDoor = true

-- ── Hold open (garage doors, shutters, gates) ────────────────────────────────
-- Garage doors roll shut on their own as soon as nobody is near. With
-- "Hold open" ticked ON A DOOR in /adoorlock:
--   unlocked -> the gate opens and STAYS open, by itself
--   locked   -> the gate closes and locks, as normal
-- It is a per-door setting, every other door behaves exactly as before.

-- How far the gate travels while held open. 1.0 = fully open. Lower it for
-- shutters that clip into geometry when fully raised (e.g. 0.9).
Config.HoldOpenRatio = 1.0

-- How close a player has to be for the hold to be re-applied. The game rolls
-- these doors shut every time they stream back in, so this must cover the
-- distance the gate is visible from. Raise it for very large gates.
Config.HoldOpenDistance = 60.0


--==============================================================================
--  5 · SOUND & ANIMATION
--==============================================================================

-- ── Sound ────────────────────────────────────────────────────────────────────
-- Plays the real door bolt sound (html/door-bolt-4.ogg) on lock / unlock,
-- heard by players near the door.
Config.PlaySound = true
Config.Sounds = {}                            -- no longer used, kept for older configs

-- ── Animation ────────────────────────────────────────────────────────────────
-- Short forward hand-reach played on the player who toggles the door (no prop).
Config.Animation = {
    enabled  = true,
    dict     = 'anim@heists@keycard@',
    name     = 'exit',
    duration = 1100,                          -- ms
}


--==============================================================================
--  6 · SETUP
--==============================================================================

-- ── Commands ─────────────────────────────────────────────────────────────────
Config.SetupCommand = 'adoorlock'             -- opens the in-game door setup
Config.SetupCommandAlias = 'adl'              -- short alias, '' = none

-- ── Permission ───────────────────────────────────────────────────────────────
-- Who may open the setup and create / delete doors:
-- 'ace'   = ACE permission Config.SetupAce (server-sided, secure)
-- 'admin' = QBCore / QBox / ESX admin or god (ace 'command' as fallback)
-- 'job'   = one of the jobs in Config.SetupJobs
Config.SetupPermission = 'admin'
Config.SetupAce = 'agency.doorlock'           -- used when SetupPermission = 'ace'
Config.SetupJobs = { ['mechanic'] = 0 }       -- used when SetupPermission = 'job' (job = min grade)

-- ── Door selection ───────────────────────────────────────────────────────────
-- During setup a marker sits where you look. Aim it at a door and press [E].
Config.SetupRayDistance = 7.0                 -- how far in front the selector reaches

-- Auto-pair a second door leaf (double doors) within this distance. 0 = off,
-- click each leaf you want instead.
Config.DoubleDoorDistance = 0

-- Only door-shaped objects can be selected: tall, fairly wide, but thin.
-- false = allow ANY object.
Config.OnlyDoors = true
Config.DoorDetect = {
    minHeight    = 1.2,                       -- door is at least this tall (m)
    maxHeight    = 5.0,                       -- ... and at most this tall (gates, garage doors)
    maxThickness = 0.6,                       -- thinnest horizontal side must be <= this
    minWidth     = 0.5,                       -- widest horizontal side range
    maxWidth     = 5.0,
}


--==============================================================================
--  7 · VISUALS
--==============================================================================

-- ── Colours ──────────────────────────────────────────────────────────────────
Config.Colors = {
    locked   = { r = 255, g = 72,  b = 72  },  -- red
    unlocked = { r = 0,   g = 255, b = 136 },  -- green
    accent   = { r = 0,   g = 212, b = 255 },  -- setup highlight
}

-- ── Door marker ──────────────────────────────────────────────────────────────
-- A dome on configured doors, red while locked, green while unlocked.
-- Off by default: the [E] prompt shows once the player is close.
Config.Marker = {
    enabled   = false,
    type      = 28,                           -- 28 = dome / half-sphere
    distance  = 12.0,                         -- draw within this range of a door
    size      = vec3(0.18, 0.18, 0.18),
    alpha     = 90,
    bob       = false,
    onlyWhenLocked = false,                   -- true = only on locked doors
}


--==============================================================================
--  8 · STATIC DOORS
--==============================================================================
-- Most doors are created in-game with /adoorlock (stored in the database).
-- You can ALSO predefine doors here; they are merged with the database doors.
-- Each leaf = { model = <hash>, coords = vec3(x, y, z) }
--
-- Example:
-- Config.StaticDoors = {
--     {
--         label = 'Police Cell 1',
--         locked = true,
--         doors = {
--             { model = `v_ilev_ph_cellgate`, coords = vec3(441.1, -998.6, 25.0) },
--         },
--         access = {
--             everyone = false,
--             jobs    = { { name = 'police', grade = 0 } },
--             gangs   = {},
--             players = {},                  -- citizenids / identifiers
--             items   = { 'cell_key' },      -- item keys (see section 3)
--         },
--     },
-- }
Config.StaticDoors = {}


--==============================================================================
--  9 · COMPANION APP
--==============================================================================
-- Links your doors to the free Agency Companion app (iOS / Android) via the
-- Agency relay: players lock / unlock doors they have access to from their
-- phone, admins can override or delete any door remotely. Own QR code, fully
-- independent of Agency-Phone / Agency-Elevator.
--   Players: /adlconnect (alias /adlc) shows a pairing QR anyone can scan.
--   Admins:  the QR also lives inside the /adoorlock setup menu.
-- The pairing token can NEVER grant admin, every admin action re-checks rights.
--
-- This block is OPTIONAL. If it is missing, the companion stays ENABLED with
-- the defaults below. Set Enable = false to opt out.
Config.Companion = {
    Enable       = true,                      -- show the Companion page and allow pairing
    EnableRemote = true,                      -- false = QR shows but no remote control
    RelayUrl     = 'https://api.agencyg.de',  -- do not change unless self-hosting
    TokenTTL     = 300,                       -- seconds a pairing QR / 6-digit code stays valid
    ToggleDistance = 20.0,                    -- metres a player must be from a door to use it
                                              -- from the app (admins bypass this)
}

02ملف SQL

استورد ملف SQL هذا إلى قاعدة بياناتك قبل تشغيل المورد:

-- Agency Doorlock — database table (auto-created on first start, this is a manual fallback)
CREATE TABLE IF NOT EXISTS `agency_doorlock` (
    `id` INT NOT NULL AUTO_INCREMENT,
    `label` VARCHAR(64) NOT NULL DEFAULT 'Door',
    `locked` TINYINT(1) NOT NULL DEFAULT 1,
    `doors` LONGTEXT NOT NULL,
    `access` LONGTEXT NOT NULL,
    PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;