shieldAdmin Settings

This page covers admin permission configuration and available admin commands for managing Koja-Crafting.


πŸ”§ Configuration Options

All admin settings are located in shared/config.lua under the ADMIN PERMISSIONS section.

-- ════════════════════════════════════════════════════════════════════════════════════
--  ADMIN PERMISSIONS
-- ════════════════════════════════════════════════════════════════════════════════════

Config.AdminGroups = { 'admin', 'owner', 'superadmin', 'god' }

πŸ“ Setting Description

Admin Groups

Config.AdminGroups = { 'admin', 'owner', 'superadmin', 'god' }

Purpose: Define which player groups have access to admin commands.

How it works:

  • The script checks if a player's group matches any entry in this list

  • Case-sensitive (must match exact group names in your framework)


πŸ› οΈ Available Admin Commands

1

Add Blueprint Command

Command: /addblueprint [playerID] [blueprintItem]

Purpose: Grant a blueprint to a player, allowing them to craft special items.

Syntax:

Parameters:

Parameter
Type
Description
Example

playerID

Number

Target player's server ID

1, 5, 42

blueprintItem

String

Blueprint item name from config

parachute_blueprint

Examples:

What happens:

  • Blueprint is added to player's database record

  • Player receives notification

  • Blueprint item becomes available in crafting menu

  • Player can now craft the associated item

Requirements:

  • Player must be online

  • Blueprint must exist in crafting config

  • Item must have blueprintItem field defined

Blueprint Configuration Example:

2

Add Experience Command

Command: /addexp [playerID] [amount]

Purpose: Grant experience points to a player for crafting level progression.

Syntax:

Parameters:

Parameter
Type
Description
Example

playerID

Number

Target player's server ID

1, 5, 42

amount

Number

XP amount to add

100, 500, 1000

Examples:

What happens:

  • XP is added to player's current experience

  • Player's level is recalculated automatically

  • If enough XP, player levels up (possibly multiple times)

  • Player receives notification with new level

  • Progress saved to database immediately



πŸ“‹ Permission Errors

chevron-right"No permissions! You need admin rights to use this command."hashtag
  • Player doesn't have required group

  • Check Config.AdminGroups configuration

  • Verify player's actual group in framework

chevron-right"Command error - contact administrator"hashtag
  • Framework detection failed

  • koja-lib not loaded properly

  • Check console for detailed error

Debugging Permission Issues

  1. Enable debug mode:

  1. Check console output:

  1. Check framework initialization:


πŸ“Š Admin Command Reference

Command
Syntax
Purpose
Permission Required

/addblueprint

[playerID] [item]

Grant blueprint to player

Admin group

/addexp

[playerID] [amount]

Give XP to player

Admin group


  • For progression system details, see Player Progression

  • For crafting configuration, see Crafting Stations

  • For server setup, see Server Settings

  • For command implementation, see Commands

Last updated