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.