Settings

🎮 Arena PvP — Script Configuration (config.lua)

This page explains how to configure the Arena PvP through the config.lua file in a simple and clear way.

You will understand:

• What each configuration does

• What you can safely edit

• How each game mode works

• How to configure maps properly

⚠️ After editing config.lua, always restart the resource:

restart energy_arenapvpv3

---

📂 File Location

The configuration file is usually located at:

shared/config.lua

or

config.lua

---

🌎 General Settings

🔤 Language

Language = 'en', -- en, ptbr

Defines the script language.

Value	Language
en	English
ptbr	Portuguese
es	Spanish
fr	French

Example:

Language = 'ptbr'

---

🖼 Logo

Logo = 'https://i.postimg.cc/157xSPx9/image.png'

Image displayed in the Arena menu.

• Must be a direct image URL (png/jpg/webp).

• You can use Postimg, Imgur, etc.

---

🔫 Weapon Spawn Mode

spawnWeapon = 'client'
spawnAmmoo = 'client'

spawnWeapon

Value	Description
client	Weapon given by client (default)
server	Weapon given by server (recommended for stricter anti-cheat setups)

If needed:

spawnWeapon = 'server'

spawnAmmoo

🚫 Do not change this value.

---

🎮 Commands

Open Arena Command

CommandOpenArena = {
    name = 'iniciar',
    enable = true,
}

• name → command players type (example: /arena)

• enable → enable or disable the command

Example:

name = 'arena'

---

Exit Arena Command

exitArenaCommand = 'sairarena'

Players exit using:

/sairarena

---

Open Menu via Event

You can also open the Arena menu using:

TriggerEvent("energy_arena:open")

---

📍 Arena Marker (Locations)

Locations = {
    vec3(-290.41, -1916.47, 29.95),
}

Defines where the Arena access marker appears.

To add more locations:

vec3(200.0, -900.0, 30.0),

If the marker does not appear, the Z coordinate is usually incorrect.

---

💥 Defuse Explosion

ExplisionAnimation = true

Value	Result
true	Bomb explosion enabled
false	Explosion disabled (recommended if using anti-cheat)

---

🎬 Animations

Animations = {
    Dead = {
        name = 'misslamar1dead_body',
        dict = 'dead_idle',
    },
}

Defines the death animation inside Arena.

Normally you do not need to edit this.

---

⌨ Keys (Keybinds)

Leave Training

Keys = {
    LeaveTraining = {
        command = 'arena:leaveTraining',
        description = 'Return to lobby',
        key = 'F'
    },
}

• key → key to leave training

• description → displayed text

• command → internal command triggered

Example:

key = 'G'

---

💰 Defuse Economy

Money = {
    kill = 100,
    loseRound = 500,
    winRound = 1000,
    plantSpike = 1000,
}

Defines rewards in Defuse mode:

• kill → money per kill

• loseRound → reward for losing round

• winRound → reward for winning round

• plantSpike → reward for planting the bomb

---

🛒 Buy Phase (Defuse Shop)

BuyPhase = {
    key = 'E',
    timeToBuy = 10,
    initialMoney = 10000,
    percentageSell = 1,
}

Explanation

• key → key to open shop

• timeToBuy → buy phase duration (seconds)

• initialMoney → starting money

• percentageSell

  • 1 = 100%

  • 0.5 = 50%

---

Default Weapons

initialWeapons = {
    {key = 'WEAPON_PISTOL', ammo = 100},
    {key = 'WEAPON_KNIFE', ammo = 1},
},

Defines the weapons players start with.

---

Store Structure

Each category inside store looks like:

[1] = {
    type = 'pistol',
    label = 'Pistols',
    items = {
        {label = 'Glock', key = 'WEAPON_PISTOL', price = 500, ammo = 100, type = 'pistol'},
    },
},

To add a weapon:

• label → display name

• key → weapon name

• price → cost

• ammo → ammo amount

• type → category

---

🎯 Game Modes (Modes)

---

Deathmatch

['deathmatch'] = {
    queueCountdown = 25,
    timeLimit = 420,
    players = {min = 1, max = 25},
    randomCoords = true,
    autoRespawn = true
}

• randomCoords → random spawn positions

• autoRespawn → instant respawn

---

Gungame

['gungame'] = {
    finishKill = 45,
    killsToUpgrade = 3,
}

• finishKill → kills required to win

• killsToUpgrade → kills to switch weapon

The weapons list defines the weapon order.

---

Defuse

['defuse'] = {
    roundTime = 55,
    timeToDefuse = 10,
    maxRounds = 20,
    buyPhase = true,
}

• roundTime → round duration

• timeToDefuse → time required to defuse

• maxRounds → maximum rounds

• buyPhase → enables shop

ChooseTeam

Handles:

• Team selection time

• Attack team spawns

• Defense team spawns

• Camera position during selection

---

Training Mode

Contains two sub-modes:

Aimlab

Aim training with fixed target positions.

NPC

Training against NPC enemies.

---

🗺 Maps

Each map contains:

[1] = {
    name = 'Map Name',
    img = 'IMAGE_URL',
    arenaData = {cds = vec3(x,y,z), range = 300.0},
    gamemodes = { ... },
}

arenaData

• cds → map center

• range → map radius

gamemodes

Defines allowed modes:

['deathmatch'] = true,
['gungame'] = true,
['defuse'] = true,

To disable a mode:

['defuse'] = false

randomCoords

List of random spawn locations.

spike

Defines plant zones in Defuse mode:

• radius → plant area radius

• radiusToDefuse → defuse distance

• coords → bomb position

---

🏠 Lobby

Lobby = {
    [1] = { pos = vec(-1049.89, -2754.44, -65.48), h = 182.70 },
    cam = {
        pos = vec3(-1049.29, -2763.52, -65.48),
        fov = 45
    },
}

Defines:

• Player spawn position in lobby

• Heading (direction)

• Camera position

• Zoom (FOV)

---

🚨 Common Issues

Marker not appearing

• Z coordinate incorrect

• Resource not restarted

Players spawning on top of each other

• Not enough spawn points in randomCoords

• Not enough spawns in coordsAttack/coordsDefense

Defuse not starting

• players.min too high

• Map has Defuse disabled