Giter VIP home page Giter VIP logo

altv-open-roleplay-altlife-official's Introduction

alt:V - Open Roleplay


Open Roleplay is the base framework for my server: alt:V Life.

This project now serves as a reference for RP servers in the future; all additional updates are put on hold and privatized for alt:Life. The code base up to this point is considered free but the Terms and Conditions as well as licensing still stands.

Reach out if you wish to monetize this gamemode.


Remember to ๐ŸŒŸ this Github if you ๐Ÿ’– it.

Open Roleplay has its own Official Discord.

๐Ÿ‘‰ Sponsor this Project

I have put a ton of work into this project. If you do not want to contribute code and you use this project at least buy me some coffee; I could use it.

๐Ÿ“ Licensing

  1. Don't Monetize this Game Mode
  2. Don't Remove Splash Marks
  3. Don't Remove O:RP Links or Twitch Links from gamemode.
  4. At least mention this repository; before claiming it as your own.

Servers Who Have Monetization Allowance

  • ctgaming.fr

๐Ÿšง Feature List and Roadmap

You can find a full list of features and the roadmap here.

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.

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 then joining the Discord Group

โŒจ๏ธ Hotkeys

Tab --------> Press to Toggle Cursor
Tab + RMB  -> Show Context Menu on User
Tab + LMB  -> Select Context Option
T ----------> Open Chat
U ----------> Open Gang Menu (Notoriety 25+)
Shift + F7 -> Toggle Chat

๐Ÿ’ป Installation

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

Requirements:

Postgres

Windows Postgres Setup

  • Run the .exe and follow the prompts.

  • Run pgAdmin

  • You will be prompted for a password. This is your database password.

  • After you need to create a database called altv.

  • Here's a very brief streamable example of that taking place.

Here's how you do it!

  • Note: By default your username will be postgres and your password will be whatever you use to log in to pgAdmin4.

Linux Postgres Setup

  • Follow these instructions up to step #3

  • Type: su - postgres

  • Type: psql

  • Type: CREATE DATABASE altv;

  • If all is well you will see CREATE DATABASE or something similar replied.

  • Type: CREATE USER stuyk WITH ENCRYPTED PASSWORD 'abc123';

  • If all is well you will see CREATE ROLE replied.

  • We now have a user called stuyk with a password of abc123. We need to assign to db.

  • Type: GRANT ALL PRIVILEGES ON DATABASE altv TO stuyk;

  • If all is well you wil see GRANT replied.

  • Type: \q to exit.

  • Type: sudo -u root

  • This will bring you back to your root account.

  • Now follow the rest of the steps below.


  • Open a Power Shell or Command Prompt or Terminal

  • Download the latest version of this resource (100% Recommend CLONING the REPO with GIT).

  • After CLONING, CD into the repo through the same command prompt.

  • Open a command prompt and run npm run orp. FOLLOW THE INSTRUCTIONS CAREFULLY ON PROMPT.

  • When you get to the Discord Setup; make sure you hit 'yes' if this is a new server.

Discord

Setting Up a Discord Bot for this Gamemode

Please Create a Discord Application for your Login System.

Please Visit: https://discordapp.com/developers/applications/

  • Inside of page you need to create a Discord Application and turn it into a bot and copy the bot secret.

  • You also MUST add this bot to your own server.

  1. Hit New Application
  2. Set the Name for Your Bot / Application
  3. Click on the Bot tab.
  4. Transform your Application into a bot.
  5. Name your bot.
  6. Tick Administrator or just Send/Read Messages
  7. Copy the bots secret token.
  8. Make sure the bot is not public.
  9. Navigate to oAuth2 tab. Tick bot in scopes.
  10. Copy the URL inside of scopes. Paste in browser.
  11. Add the bot to your designated Discord.
  12. Make sure you save your changes.
  13. Keep this page open for the next section.

Gamemode Setup & Installation

Installing the Rest of O:RP

  • Clone this repository from github.

  • Open a Command Prompt or Power Shell Prompt in cloned directory.

  • Type npm run orp to begin the installation process.

  • You will be asked to agree to some terms and conditions.

  • You will be prompted for various installation steps and must provide the information asked for.

  • After filling in all information you are prompted for the server files will download.

  • We target beta branch with this gamemode.

  • Start your server based on whichever platform you use.

    • Run these from a terminal or command prompt.

    • Windows -> altv-server.exe

    • Linux -> ./start.sh

  • Join your server with Discord Open.

  • IF DISCORD DOES NOT PROMPT YOU Copy the code on screen.

  • PM the Bot you setup earlier with !login <code>

Docker (Optional)

Installation using Docker

If you do not know what docker is. Please do not proceed any further.

OpenRP includes support for building and running the alt:V and PostgreSQL server using Docker. Included is a docker-compose.yml which contains many variables that you will need to edit. Any changes you make will require you to rebuild the altv-openrp container.

To build new containers, first edit the docker-compose.yml file and fill in all the details for the altv server and discord information, and then build with docker-compose. Note: You must agree with OpenRP terms of service by passing TOS_AGREE=true as a build argument.

docker-compose build --build-arg TOS_AGREE=true

To run the containers:

docker-compose up

Please see Docker and Docker-Compose documentation for more options.

altv-open-roleplay-altlife-official's People

Contributors

c0deina avatar codewithbryan avatar dexslab avatar doodesch avatar eappels avatar enerv avatar jovanivanovic avatar matspyder51 avatar openface avatar pixellup avatar ravenous47 avatar stuyk avatar tekkupt avatar timstallinger avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.