alt:V - Open Roleplay

Remember to 🌟 this Github if you 💖 it.

---

THIS IS A WORK IN PROGRESS AND IS NOT COMPLETE IN ANY WAY

Open Roleplay is a base gamemode for Roleplay servers. It will include the ideal functionality to get the base ground work for a roleplay gamemode started.

Official O:RP Discord

---

IMPORTANT If you are not a developer; this may not be the project for you. There is some general configuration that needs to be done and understanding code is important.

Roadmap

• PostgreSQL Integration
• Login and Registration
• Character Facial Customization
• Roleplay Name Formatting
• Character Clothing Customization
• Glasses, Bracelets, etc.
• Tattoos
• Character Inventory System
• Item Configuration
• Item Drops
• Item Pickups
• Vehicle System
• Job System
• Example Job Configuration
• Job System Types
• Driving Test
• Taxi Job
• Mechanic Job
• Vehicle Customization
• Vehicle Fuel System
• Nametags / Character Names
• Door System
• Door Sales System
• Administrative Toolkit
• Currency System
• ATM / Bank System
• Player Transfers / Give Money
• Shop System
• Faction System
• Basic Anticheat
• Time Sync
• Weather Sync
• Interaction System
• Interaction for Vehicles
• Interaction for Players
• Interaction for Objects
• Player Death Handling
• Taxation
• Taxation goes to Government Fund
• Government Fund Management
• Animation Manager
• Context Menu of Animations
• Animations for Sitting
• Splash Screens
• Custom Sounds! Blat!
• Custom Chat
• Custom Chat Commands
• Custom Chat Colors
• Custom Chat Notification Functions / Clickables
• Custom Chat is Repositionable?
• Roleplay Commands (/me, /do, /b, /cc)
• Ranged Chat
• Voice Chat
• Playing Hours Stats
• Skill System for Jobs
• Drug System
• Drugs for Health
• Drugs for Armor
• Drugs for Fast Running
• Drug Jobs 3 jobs for each type.
• Loyalty Program

I will not be providing direct support for this gamemode; if you have an issue or come across actual functionality issues please raise an issue in the issues tab. Otherwise; additional help can be found by subscribing through my twitch page and joining discord.

---

Licensing

If you'd like to remove the splash screens at any point; we can negotiate at a price. However, you will be responsible for removing them and not me. Otherwise, just leave the splash screens alone. This is a free framework and the least you can do is give credit.

---

General Information and Hotkeys

z -------> Press and hold to reveal cursor.
z + rmb -> Show Context Menu on User
z + lmb -> Select Context Option
e -------> Most clothing shops, jobs, etc. to interact.
i -------> inventory

---

Installation

If you don't have NodeJS; please go install it.

The file structure below is the required structure you must use for this game mode. You must follow it exactly for this resource to work.

• Grab the latest version of the alt:V server files. They must be clean. No resources.

• Download Postgres-Wrapper this is the Postgres SQL helper that was written to make database usage easy. Extract it and put this into a folder called postgres-wrapper. Directly inside you should have resource.cfg if done correctly.

• Install the latest version of PostgresSQL for either windows, linux, or whatever OS you're running.

• Once installed you need to create a username and password for your database; and create a database called 'altv' or something else if you know what you're doing. PAY ATTENTION HERE YOU'LL NEED THIS INFO

Creating on Windows with pgAdmin4 Where to navigate:

Postgres is the username for this database; and altv is the name:

After; it should be running automatically in your services on windows. You can always restart your database through your Task Manager.

• Download the latest version of this resource. You can either clone the repository or simply download it. The resource.cfg and the rest of the files should be directly inside of a folder called orp.

• To configure your database navigate to resources/orp/server/configuration/ and open database.mjs. Fill out the required parameters; and change them to what you setup PostgreSQL with.

Example Database Configuration

export const DatabaseInfo = {
    username: 'postgres',
    password: 'abc123',
    address: 'localhost',
    port: 5432,
    dbname: 'altv'
};

Example Folder Structure

altVServerFolder/
└── resources/
|   ├── orp/
|   |   ├── server/
|   |   ├── client/
|   |   └── resource.cfg
|   ├── postgres-wrapper/
|   |   ├── client.mjs
|   |   ├── database.mjs
|   |	└── resource.cfg

Installing Packages for NodeJS After installing the above; if you don't have a package.json in your main server directory where your .exe is you're going to need to do the following:

Open a command prompt or powershell next to your .exe file

npm init

Then press enter a bunch of times until its done stepping you through.

After you need to install the following packages from command prompt or power shell.

npm install typeorm
npm install sjcl
npm install pg

Great; now you have all the prerequisites.

Open your server.cfg next to your altv-server.exe.

You need to add orp to resources.

name: 'Open RP'
host: 0.0.0.0
port: 7766
players: 1000
announce: false
gamemode: OpenRP
website: twitch.tv/stuykgaming
language: lang-here
description: 'Using Open Roleplay'
modules: [ node-module ]
resources: [ orp ]
token: ''
debug: 'true'

That's about it; once you run it you'll be greeted with terms and conditions and you can follow the additional instructions from there.