alt:V

Games
Report Issue

alt:V Multiplayer a third-party multiplayer modification for Grand Theft Auto: V

Contributors:
danielb@purpleflaghosting.com
README

alt:v

From the alt:V Site

alt:V Multiplayer a third-party multiplayer modification for Grand Theft Auto: V.

Server Ports

Ports required to run the server in a table format.

Port default
Game 7788
Docker Images (1)
Name Image
ALT:V ghcr.io/ptero-eggs/games:altv
Startup Command 
./altv-server
Variables (4)

ld lib path

Needed to load modules correctly. Best left at default.

Environment:
LD_LIBRARY_PATH
Default:
.
User Viewable:
❌
User Editable:
❌
Rules:
required|string|max:20

Release Branch

The supported versions are release, rc, dev (default: release). If you don't know what you are doing leave it on release

Environment:
BUILD
Default:
release
User Viewable:
❌
User Editable:
❌
Rules:
required|string|in:release,rc,dev

Server Password

The password to join the server

Environment:
PASSWORD
Default:
ChangeMe
User Viewable:
❌
User Editable:
❌
Rules:
nullable|string|min:6

Server Description

Description for the server.

Environment:
SERVER_DESC
Default:
A Pterodactyl Hosted Server
User Viewable:
❌
User Editable:
❌
Rules:
required|string
Installation Script
Container: ghcr.io/ptero-eggs/installers:debian
Entrypoint: bash
#!/bin/bash
#

apt update
apt install -y wget jq curl 

cd /mnt/server
NEWVERSION=$(curl -sSL https://cdn.alt-mp.com/server/${BUILD}/x64_linux/update.json | jq -r .version)


if [ -f "/mnt/server/altv-server" ]; then
    CURRENTVERSION=$(cat update.json | jq -r .version)
    if [[ "${CURRENTVERSION}" == "${NEWVERSION}" ]]; then
        echo "No update found"
        exit 0
    fi
    echo "Backing up version ${CURRENTVERSION}"
    mkdir -p /mnt/server/backup/${CURRENTVERSION}/data
    mv altv-server /mnt/server/backup/${CURRENTVERSION}/
    cd /mnt/server/data
    mv clothes.bin /mnt/server/backup/${CURRENTVERSION}/data
    mv vehmodels.bin /mnt/server/backup/${CURRENTVERSION}/data
    mv vehmods.bin /mnt/server/backup/${CURRENTVERSION}/data
    mv pedmodels.bin /mnt/server/backup/${CURRENTVERSION}/data
    mv weaponmodels.bin /mnt/server/backup/${CURRENTVERSION}/data
    mv rpfdata.bin /mnt/server/backup/${CURRENTVERSION}/data
    rm /mnt/server/update.json
fi


cd /mnt/server


echo "Installing version: ${NEWVERSION}"
wget -q https://cdn.alt-mp.com/server/${BUILD}/x64_linux/altv-server
wget -q https://cdn.alt-mp.com/server/${BUILD}/x64_linux/update.json
chmod +x ./altv-server


mkdir -p /mnt/server/data
cd /mnt/server/data

wget -q https://cdn.alt-mp.com/data/${BUILD}/data/vehmodels.bin
wget -q https://cdn.alt-mp.com/data/${BUILD}/data/vehmods.bin
wget -q https://cdn.alt-mp.com/data/${BUILD}/data/clothes.bin
wget -q https://cdn.alt-mp.com/data/${BUILD}/data/pedmodels.bin
wget -q https://cdn.alt-mp.com/data/${BUILD}/data/weaponmodels.bin
wget -q https://cdn.alt-mp.com/data/${BUILD}/data/rpfdata.bin




cd /mnt/server
if [ ! -f "/mnt/server/server.toml" ]; then
cat << EOF >> server.toml
name = 'alt:V Server'
host = '0.0.0.0'
port = ${SERVER_PORT}
players = 128
password = '${PASSWORD}'
announce = false
token = 'YOUR_TOKEN'
gamemode = 'Freeroam'
website = 'example.com'
language = 'en'
description = '${SERVER_DESC}'
modules = []
resources = []
EOF
fi

mkdir -p resources/

echo -e "install complete"