Skip to content

Your First Server ​

Zero to a running Shiva RP server in 15 minutes. This guide assumes you've completed Installation.

What You'll Build ​

A basic RP server with:

  • Player character creation and persistence
  • A simple economy (bank + cash)
  • Jobs system
  • Basic inventory

1. Check the Default Modules ​

After shiva init, your resources/ directory contains the default modules:

resources/
├── [shiva]
│   ├── shiva-core/
│   ├── shiva-player/
│   ├── shiva-economy/
│   ├── shiva-jobs/
│   └── shiva-inventory/

All default modules are enabled. You don't need to touch them to get started.

2. Configure a Spawn Point ​

In resources/[shiva]/shiva-player/config.lua:

lua
Config.defaultSpawn = {
    x = -269.4,
    y = -955.3,
    z = 31.2,
    heading = 205.0
}

3. Set Up the Economy ​

In resources/[shiva]/shiva-economy/config.lua:

lua
Config.startingCash = 500
Config.startingBank = 2500
Config.cashAccountName = 'cash'
Config.bankAccountName = 'bank'

4. Add Your First Job ​

In resources/[shiva]/shiva-jobs/config.lua, jobs are defined as a table:

lua
Config.jobs = {
    unemployed = {
        label = 'Unemployed',
        defaultGrade = 0,
        grades = {
            [0] = { label = 'Civilian', salary = 0 },
        },
    },
    police = {
        label = 'Los Santos Police Department',
        defaultGrade = 0,
        grades = {
            [0] = { label = 'Cadet', salary = 150 },
            [1] = { label = 'Officer', salary = 200 },
            [2] = { label = 'Sergeant', salary = 250 },
        },
    },
}

5. Start and Connect ​

bash
./run.sh

Connect via FiveM. On first connection you'll see:

  1. A character creation screen (name, date of birth, appearance)
  2. Your character spawning at the configured spawn point
  3. The HUD showing cash and health

6. Admin Commands ​

By default, the first player to connect gets admin access. In-game:

/givemoney [player_id] [account] [amount]
/setjob [player_id] [job] [grade]
/revive [player_id]

What's Next ​

Released under the MIT License.