LibertyCode
LibertyCode
  • Welcome
  • lc_adminmenu
    • Introduction
    • Installation
    • Avatars
    • Screenshots
    • Bridge
      • Server
      • Client
    • Player functions
    • Permissions
      • Permission Groups
      • Discord Permissions
    • Exports
Powered by GitBook
On this page
  • Permissions
  • isPlayerIdentifierAllowed
  • isPlayerIdAllowed
  • getPermissionsFromIdentifier
  • bridgePermissionCheck
  • Ban System
  • banPlayer
  • checkIsPlayerBanned
  • unbanIdentifier
  • Dashboard Feed
  • addFeedMessage
  • Trust Score
  • getTrustScoreById
  • setTrustScoreById
  • addTrustScoreById
  • removeTrustScoreById
  1. lc_adminmenu

Exports

PreviousDiscord Permissions

Last updated 4 months ago

These are SERVER SIDE exports!

Permissions


isPlayerIdentifierAllowed

exports.lc_adminmenu:isPlayerIdentifierAllowed(identifier, permission)

Parameters:

  • identifier: string -

  • permission: string - Permission name (from data/permissions.lua)

Returns: boolean


isPlayerIdAllowed

exports.lc_adminmenu:isPlayerIdAllowed(targetId, permission)
  • targetId: number

  • permission?: string - Optional. If permission name is not defined, function just checks if player with given ID is an admin.

Returns: boolean

-- Command that checks if player has permission to revive
-- Example Input: isPlayerIdAllowedToRevive 2
-- Example Output:
-- Check passed! Player with ID 2 is administrator
-- This administrator has permission to revive.

RegisterCommand('isPlayerIdAllowedToRevive', function(source, args)
    if source ~= 0 then return end -- Command can be only used from console
    if not args[1] or not tonumber(args[1]) then return end -- Argument validation

    local allowed = exports.lc_adminmenu:isPlayerIdAllowed(args[1])
    if not allowed then
        print('This player is not an admin.')
        return
    end
    
    print(('Check passed! Player with ID %s is administrator'):format(args[1]))
    
    -- You can also check if player has any permission from data/permissions.lua
    local revive_allowed = exports.lc_adminmenu:isPlayerIdAllowed(args[1], 'revive')
    if revive_allowed then
        print('This administrator has permission to revive.')
    else
        print('This administrator DOES NOT have permission to revive.')
    end
end)

getPermissionsFromIdentifier

exports.lc_adminmenu:getPermissionsFromIdentifier(identifier)

Returns: string[] | false - List of player's permission names, false is returned only when player is not an admin.

-- Console command that prints player's permissions
-- Example Input: /getPermissionsFromIdentifier identifier:0000000000
-- Example Output:  {"all"}

RegisterCommand('getPermissionsFromIdentifier', function(source, args)
    if source ~= 0 then return end -- Command can be only used from console
        
    local permissions = exports.lc_adminmenu:getPermissionsFromIdentifier(args[1])
    if not permissions then
        print('This player is not an admin.') -- export returned false, it means that this player is not an admin
    end
    
    print(json.encode(permissions)) -- if it didn't return false - it returned list of admin's permissions, let's print them!
end)

bridgePermissionCheck

exports.lc_adminmenu:bridgePermissionCheck(targetId)
  • targetId: number


Ban System


banPlayer

exports.lc_adminmenu:banPlayer(targetId, reason, duration, disconnect)

Parameters:

  • targetId: number - ID of player you want to ban

  • reason: string - Ban reason

  • duration: number - In seconds, -1 for permament ban

  • disconnect?: boolean - Optional, if it's set to false - the player can continue the game, but will not be able to join the server next time


checkIsPlayerBanned

exports.lc_adminmenu:checkIsPlayerBanned(identifiers)

Parameters:

  • identifiers: table

    • discord: string

    • steam: string

    • license: string

    • xbl: string

    • live: string


unbanIdentifier

exports.lc_adminmenu:unbanIdentifier(any_identifier)

This function will delete ALL BANS associated with given identifier.

Parameters:

  • any_identifier: string - discord / steam / license / xbl / live (with prefix: discord:000000 etc.)


Dashboard Feed


addFeedMessage

exports.lc_adminmenu:addFeedMessage(feed_message)

Parameters:

  • feed_message: table

    • title: string - Message title

    • content: string | string[] - Message content

    • avatar_url?: string

    • timestamp?: number - Optional, Epoch Unix Timestamp

    • server_id?: number - If specified - clicking on the feed message will open user's page

    • report_id?: number - If specified - clicking on the feed message will open report page

Example usage:

exports.lc_adminmenu:addFeedMessage({
    title = 'Player banned',
    content = {
        'Player: 123',
        'Reason: Trolling',
        'Duration: 2W',
        'Banned by: dev7'
    },
    avatar_url = 'https://api.dicebear.com/9.x/pixel-art/svg?seed=123'
})

Trust Score


getTrustScoreById

exports.lc_adminmenu:getTrustScoreById(targetId)

Parameters:

  • targetId: number

Returns: number


setTrustScoreById

exports.lc_adminmenu:setTrustScoreById(targetId, amount)

Parameters:

  • targetId: number

  • amount: number

Returns: number


addTrustScoreById

exports.lc_adminmenu:addTrustScoreById(targetId, amount)

Parameters:

  • targetId: number

  • amount: number

Returns: number


removeTrustScoreById

exports.lc_adminmenu:removeTrustScoreById(targetId, amount)

Parameters:

  • targetId: number

  • amount: number

Returns: number

identifier: string -

Returns: boolean - Checks if player with given ID passes through the or functions from Server bridge

GetGlobalIdentifier
GetGlobalIdentifier
Server
IsPlayerAllowedToOpenMenu