Beruflich Dokumente
Kultur Dokumente
Contents
Rationale ......................................................................................................................... 4
Drug Dealer................................................................................................................ 33
Visual Studio 2017 Enterprise: Main platform is used for the development of
this project, programming for all server scripts.
SQL Server: Communication between the players (client) and the server,
register/login, saving player information as progress is done on the server.
GT-MP API: Necessary for the development of the project, so we are able to
program straight into the game engine and be able to interact with it (Link Here).
Game GTA V: Original version of the game is necessary to able to connect and
play on the server.
PAP Report
GTA V Roleplay Server
Scripts Developed
Admin Script;
Arms Dealer Script;
Money/Bank and ATM Script;
Car Dealership Script;
Car System Script;
Clothes Store Script;
Register/Login Script;
Drug Dealer Script;
Resources Handler Script;
Object Creation Script;
Time Sync Script;
Weather Script;
Drug Smuggler Script;
PAP Report
GTA V Roleplay Server
Script Description
Admin Script: So far contains a list of 38 scripted commands for usage only by
authorized users (server administrators), allows for easy server management and
server control.
Register/Login Script: One of the most important scripts developed for the server,
allow for the character creation and register to the server database, so that progress
made can be saved accordingly to what has been done by the player (client).
Resources Handler Script: One of the most useful scripts developed for the server for
easy management and changes/updates of other loaded server scripts with no need for
a server restart.
Object Creation Script: Just a basic script developed that adds thousands of game
objects into the game world.
Money/Bank & ATM Script: So far contains 8 commands for usage by the player
(client), this script allows for the use of banks and ATMs scripted in the world, allowing
for such things as in checking the amount of money present in the player’s wallet and
bank account.
Time Sync: This script has one very simple function and that’s basically to sync the
server time to all players, in a way that the server time will always be the same to all the
players, whether day or night time. With this script, the server updates and syncs the
server time to the host machine current time every minute.
Weather Script: Much like the Time Sync script, this script has only one very simple
function, and that’s basically set and sync the server weather to a random iteration of all
of the weather types available by the API, the change of weather, is also set on a
random timer (set between 30 minutes and 120 minutes), so that the weather can be a
more dynamic and allow for a more diversity, may very well it be foggy, rainy or clear
skies.
Clothes Store Script: This script allows for the players to walk into clothes stores
scripted around the map, change the player model (skin), and/or use a custom player
model and be able to buy separate clothes for his character.
Car Dealership Script: This script, with 8 commands so far, creates vehicles
dealerships across town, players can choose their vehicle of choice and if they have the
money they can purchase them, along with other useful vehicle commands:
Arms Dealer Script: This is one of the illegal server scripted jobs, players with
this job are able to buy packages in certain locations on the map and deliver
them to another location marked on their GPS in exchange for weapon materials,
this weapon materials will later be able to be crafted into actual weapons,
depending on the type of materials in question, this weapons can later on be kept
by the player or sold to other players by the arms dealer.
Drug Dealer Script: Another of the illegal server scripted jobs, much like the
arms dealer, the drug dealer function is to obtain drugs from the warehouse,
buying them. These drugs can later be kept/used by the player to obtain certain
buffs, or sold to other players.
Admin Script
For the commands in this script, the user is required to be an administrator to use
them. Before most of the commands, a check to see if the user issuing the command is
an administrator is made (AdminCheck), as shown in Figure 1 below:
What is a dimension?
What is an Entity?
An entity is pretty much everything added into the server that can be controlled in
certain way, change the rotation, position, dimension, in between others, may this be a
vehicle or an added game object.
Command “Car ID” (/carid) - This command, only usable by admins, tells the
ID (Identification) of a specified vehicle that the player is inside of.
Command “Mod” – This command allows for the server admin to modify a
car that he is currently inside of, this includes cosmetic/exterior mods, from
bumpers to spoilers to car color as well as many others that area available within
the game’s API, this also includes performance modifications from turbo, to
engine, breaks, and many others, as long as they are incorporated in the API.
Command “Weather” – This command allows for the admin to change the
server weather to any available weather in between ID (1-13), (clear day,
raining, snow, foggy) any weather IDs below 1 or above 13 causes server
crashes and are so restricted within the command.
Command “Set Health” (/sethp) – This command will heal the chosen
player to his max health, being this value 100.
Command “Set Armor” (/setarmor) – This command will heal the chosen
player to his max armor, being this value 100.
Command “Slap” – Using this command will make the chosen player fly to
the chosen height by the administrator, cause him to fly down the sky, or maybe
not that high, depending on the chosen height.
Command “Buy Car” (/buycar) – This command is used to purchase vehicles from
a local dealership, it can be used by any player and only usable under one
circumstance, the player must be inside a car that is currently a ‘dealership car’ server
scripted and only purpose is to be purchased by the player, upon usage the user is
requested to input a custom license plate for the vehicle(between 4-8 characters), this
license plate is later used to detect the vehicle within the database, along with all the
information and who owns the car, the command checks if the player has enough
money to buy the car and if that license plate was already registered into the database.
Car System
Command “Vehicle Park” (/vpark) – This command is restricted to only cars that
have been purchased by players and it only works to the owner of the car, basically
what this does is saving mostly the position and rotation of the vehicle, along with some
other minor information into the vehicles database and changes the vehicle dimension
from zero to a random dimension, making the car despawn(disappear).
PAP Report
GTA V Roleplay Server
Command “Vehicle Get” (/vget) – This command, much like the ‘(/vpark)’
command is restricted to owned vehicles, the player is asked for an input (license plate)
of the owned vehicle and the vehicle spawns(is created) in the last parked position from
the ‘(/vpark)’ command, this only works with vehicles the player using it currently owns,
the list of owned vehicles can be checked with another command.
Command “Properties” – With this command, the player will be able to see the list
of owned vehicles and the respective license plates and car name.
PAP Report
GTA V Roleplay Server
Command “Lock” – Upon usage, both inside and outside the vehicle, the car will
be locked, no players can get inside the car or open/close the trunk of hood of the
vehicle, this command is also restricted to only the owner of the vehicle.
Command “Trunk & Hood” – With this command the player can open/close the
trunk or hood of the vehicle visually, only works when the vehicle is currently unlocked.
Command “Locate” – Any player that uses this command can track the current
location of his vehicle, in case they forgot where they last left their vehicle or if it has
been stolen, the player can only track the vehicles he owns and he must have
purchased a GPS to his vehicle.
PAP Report
GTA V Roleplay Server
Bank/Money Script
All the commands within this script are meant to be used by all players and
allows for the interaction within banks and ATMs scripted to the server.
PAP Report
GTA V Roleplay Server
Commands for Banks
Command “Deposit” – With this command the player can deposit the
money he has on him to his bank account, only works if used within range of the
bank counter.
Command “Balance” - With this command the player can check the correct
amount of money he has in his bank account.
PAP Report
GTA V Roleplay Server
Command “Wallet” – With this command the player can check how much
money he is carrying with him on his wallet.
This script was created for easy server management in terms of updating scripts,
with few commands we can simply reload the script file with the updated one without
having to restart the whole server, extremely usefully when creating new scripts and
testing is needed.
Command “Restart Resource” (/rr) – Resource start allows for the admin
to restart a specific resource (script file), forcing it to update with the new one,
without the need for a full server restart.
PAP Report
GTA V Roleplay Server
Enriching Environments
We have created a separate script, that also affects other script, such as the Drug
Dealer and Drug Smuggler, the objective being adding objects into the server in a way
of creating ‘life’ into the environment, making it seem less empty, not just objects but
also static NPCs (AI).
The server objects we’ve added already go over the five thousand, areas were created
to job pickup areas, such as the Drug Dealer pickup and the Drug Smuggler and the
Drug Warehouse, over a thousand of several types of trees were added around the
map, even a custom prison interior for roleplay purposes, although no law enforcement
or prison system is yet in place.
The next pages will follow some before and after images of some areas, not all.
PAP Report
GTA V Roleplay Server
PAP Report
GTA V Roleplay Server
PAP Report
GTA V Roleplay Server
PAP Report
GTA V Roleplay Server
Script Commands
Command “Buy Skin” (/buyskin) – With this command the player will be
able to buy a new character skin for himself, this command requires an input
for the skin ID available by the API, the idea is to add menus later on for full
character customization.
PAP Report
GTA V Roleplay Server
Illegal Jobs
Drug Dealer
Types of Drugs
There are three types of drugs added into the server, those drugs being ‘Weed’,
‘Crack’, ‘Meth’, all this drugs once used by the player give a raise in character
stats, in this case Health and Armor.
o Weed – Once it is consumed an animation will be played on the player’s
character for a couple seconds and the player will gain ‘10’ health, 100
being the maximum allowed.
o Crack – Exact same as the above but the player will gain ‘10’ armor, 100
also being the maximum allowed.
o Meth – Pretty much the same as the above but instead of gaining only
one stat at a time, the player will gain ‘15’ on each stat, both health and
armor, the plan was to allow for a maximum of 125 of each stat, but due to
API limitations it’s not possible.
Drug Smuggler
Command “Get Crate” (/getcrate) – Using this command at the right location
the player will purchase one of three types of different packages, depending on
the location he obtained it from, the player can only possess one package in his
inventory at a time and he is supposed to deliver it to the drug warehouse for
some profit money.
Command “Job Help” (/jobhelp) – Just like all the other jobs, displays
information on the current job.
PAP Report
GTA V Roleplay Server
Arms Dealer
Materials Type
Materials Type A – This tier allows for the crafting of the following weapons.
Bat (200), Hammer (200), Crowbar (200), Pistol (1000), AP Pistol (1500),
Marksman Pistol (1000).
Materials Type B – This tier allows for the crafting of the following weapons.
Micro SMG (2000), SMG (2000), Assault SMG (2000), Mini SMG (2000),
Gusenberg (2500), Pump Shotgun (2500), Sawnoff Shotgun (1500).
Materials Type C – This tier allows for the crafting of the following weapons.
AK-47 (2500), M4 Carbine (2500), Sniper Rifle (5000), Heavy Sniper Rifle
(6500), Auto Sniper (6500).
Legal Jobs
Job Objective
Once the plays has assigned this job, he will be able to drive one of the truck
available to him in the truck yard by the docks, once inside, he can start a service
and a new random location will be updated on his GPS to make his delivery,
might this be a clothes store, gas station or a food store, once delivery is made
the player must then return to the truck yard to collect is payment and do another
delivery if he chooses to, payment amount will be determined by the distance of
the delivery.
Job Objective
There will be several location around the map where the player can actively fish
once he has purchased a fishing rod from a 24-7 store, once his cooler is full of
fish he can then make his way to the fish market and sell the fish, the payment
amount will be dependent of the type of fish and weight.
Job Objective
With this job assigned players will need to drive a ruble truck and make his way
towards the quarry to start mining, once done mining the player will have in his
inventory a certain amount of rough stone, this stone must later be processed at
the refinery and some raw materials might come out of it, those raw materials will
then be sold at the buyer.
PAP Report
GTA V Roleplay Server
Job Objective
Once the player has this job assigned, he will then be able to rent a taxi vehicle
for the day, any other players that request a taxi will send a notification to the taxi
driver with the location, taxi drivers that own a taxi license may use their personal
vehicle for the job.