RAGE Multiplayer Wiki - User contributions [en]

Getting Started with Server

2017-11-12T23:00:11Z

StreetGT:

__TOC__
== Introduction ==

This brief tutorial will show you how to run your server on both Windows and Linux distributions.

By default, the server makes use of port 22005 UDP for server access so make sure to have done the port forwarding on your router process and have also unblocked the port on your firewall before running the server.

=Windows=
== Troubleshooting ==

=Linux=

==Installing GCC 6==
===Debian, Ubuntu, and derivatives===

====Ubuntu 16.04.x and older====

<syntaxhighlight lang="bash">
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-6 g++-6
</syntaxhighlight>

==Installing the server==

<syntaxhighlight lang="bash">
# Downloading server
cd /tmp
wget https://cdn.rage.mp/lin/server
mkdir ~/srv
mv server ~/srv
cd ~/srv
chmod +x server
./server

# Firewall commands (iptables only) (dont forget to save the rule after adding it)
iptables -A INPUT -p udp --dport 22005 -j ACCEPT

</syntaxhighlight>

==Setting up==
===Installing screen===
For running the server in background, we recommend using screen mainly for its ease of use

====Debian based (Ubuntu & derivatives)====
<syntaxhighlight lang="bash">
sudo apt-get install screen
</syntaxhighlight>

====CentOS 6.x/7.x====
<syntaxhighlight lang="bash">
yum install screen
</syntaxhighlight>

===Starting the server===
<syntaxhighlight lang="bash">
screen -dmS GTASERVER -L bash -c 'cd ~/srv && ./server' &

# Parameter explanation
# screen -dmS = starts a separate shell without directly opening an interface towards it (detached mode). The S param defines a session name for the newly created session, so that it is easier to manage in the future.
# screen -L = basically logs whatever error that is shown by the server through the separate shell into a file for easier reference in the future.
# !IMPORTANT!
# Log output will be saved as screenlog._number_ in the server directory.
# &: IS IMPORTANT IF YOU WANT TO TERMINATE THE PROCESS GRACEFULLY
</syntaxhighlight>

===Stopping the server===
To stop the server, there's usually two ways to do that, one that we call a '''graceful''' shutdown that sends the server a signal for termination and the other, well, a '''crash''' since it does not allow the code to run through the termination process correctly.

'''RECOMMENDED:'''
<syntaxhighlight lang="bash">
kill $(ps h --ppid $(screen -ls | grep GTASERVER | cut -d. -f1) -o pid)
</syntaxhighlight>

'''NOT RECOMMENDED:''' It does not shut down the server gracefully
<syntaxhighlight lang="bash">
screen -S GTASERVER -X quit
</syntaxhighlight>

== Troubleshooting ==

Getting Started with Server

2017-11-12T22:59:13Z

StreetGT:

__TOC__
== Introduction ==

This brief tutorial waill show you how to run your server on both Windows and Linux distributions.

By default, the server makes use of port 22005 UDP for server access so make sure to have done the port forwarding on your router process and have also unblocked the port on your firewall before running the server.

=Windows=
== Troubleshooting ==

=Linux=

==Installing GCC 6==
===Debian, Ubuntu, and derivatives===

====Ubuntu 16.04.x and older====

<syntaxhighlight lang="bash">
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-6 g++-6
</syntaxhighlight>

==Installing the server==

<syntaxhighlight lang="bash">
# Downloading server
cd /tmp
wget https://cdn.rage.mp/lin/server
mkdir ~/srv
mv server ~/srv
cd ~/srv
chmod +x server
./server

# Firewall commands (iptables only) (dont forget to save the rule after adding it)
iptables -A INPUT -p udp --dport 22005 -j ACCEPT

</syntaxhighlight>

==Setting up==
===Installing screen===
For running the server in background, we recommend using screen mainly for its ease of use

====Debian based (Ubuntu & derivatives)====
<syntaxhighlight lang="bash">
sudo apt-get install screen
</syntaxhighlight>

====CentOS 6.x/7.x====
<syntaxhighlight lang="bash">
yum install screen
</syntaxhighlight>

===Starting the server===
<syntaxhighlight lang="bash">
screen -dmS GTASERVER -L bash -c 'cd ~/srv && ./server' &

# Parameter explanation
# screen -dmS = starts a separate shell without directly opening an interface towards it (detached mode). The S param defines a session name for the newly created session, so that it is easier to manage in the future.
# screen -L = basically logs whatever error that is shown by the server through the separate shell into a file for easier reference in the future.
# !IMPORTANT!
# Log output will be saved as screenlog._number_ in the server directory.
# &: IS IMPORTANT IF YOU WANT TO TERMINATE THE PROCESS GRACEFULLY
</syntaxhighlight>

===Stopping the server===
To stop the server, there's usually two ways to do that, one that we call a '''graceful''' shutdown that sends the server a signal for termination and the other, well, a '''crash''' since it does not allow the code to run through the termination process correctly.

'''RECOMMENDED:'''
<syntaxhighlight lang="bash">
kill $(ps h --ppid $(screen -ls | grep GTASERVER | cut -d. -f1) -o pid)
</syntaxhighlight>

'''NOT RECOMMENDED:''' It does not shut down the server gracefully
<syntaxhighlight lang="bash">
screen -S GTASERVER -X quit
</syntaxhighlight>

== Troubleshooting ==

Template:Blip definition

2017-10-07T02:02:57Z

StreetGT:

*Functions
**[[Blip::Blip]]
**[[Blip::routeFor]]
**[[Blip::unrouteFor]]
**[[Entity::destroy]]
*Properties
**[[Blip::sprite]]
**[[Blip::colour]]
**[[Blip::name]]
**[[Blip::scale]]
**[[Blip::alpha]]
**[[Blip::drawRange]]
**[[Blip::rotation]]
**[[Entity::id]]
**[[Entity::dimension]]
**[[Entity::type]]
**[[Entity::position]]

Template:Marker functions

2017-10-03T17:08:49Z

StreetGT:

*Functions
**[[Marker::Marker]]
**[[Marker::showFor]]
**[[Marker::hideFor]]
**[[Marker::getColour]]
**[[Marker::setColour]]
**[[Entity::destroy]]
*Properties
**[[Marker::scale]]
**[[Marker::colour]]
**[[Marker::direction]]
**[[Marker::visible]]
**[[Entity::id]]
**[[Entity::dimension]]
**[[Entity::type]]
**[[Entity::position]]
**[[Entity::model]]

Marker::Marker

2017-10-03T16:56:42Z

StreetGT:

Creating new markers
==Parameters==
* '''type: Number'''
* '''position: Vector3'''
* '''rotation: Vector3'''
* '''direction: Vector3'''
* '''radius: Number'''
* '''red: Number'''
* '''blue: Number'''
* '''alpha: Number'''
* '''visible: Boolean'''
* '''dimension: Number'''

==Syntax==
<div class="header" style="background-color: #408DAE; color: #FFFFFF; border: 2px solid #408DAE;">
<div style="margin: 10px 10px 10px 10px;">Server-Side</div>
<syntaxhighlight lang="javascript">
mp.markers.new(Number type, Vector3 position, Vector3 rotation, Vector3 direction, Number radius, Number red, Number green, Number blue, Number alpha[, Boolean visible, Number dimension])
</syntaxhighlight>
</div>

==Markers type==
{{Markers_type}}
==See Also==
{{Marker_function}}

Template:Blip definition

2017-10-02T17:56:24Z

StreetGT:

*Functions
**[[Blip::Blip]]
**[[Blip::routeFor]]
**[[Blip::unrouteFor]]
**[[Entity::destroy]]
*Properties
**[[Blip::model]]
**[[Blip::radius]]
**[[Blip::colour]]
**[[Blip::name]]
**[[Blip::scale]]
**[[Blip::alpha]]
**[[Entity::id]]
**[[Entity::dimension]]
**[[Entity::type]]
**[[Entity::position]]

Template:Player definition

2017-10-02T17:54:55Z

StreetGT:

*Functions
{{Player_functions}}
{{Entity_functions}}
*Properties
{{Player_properties}}
{{Entity_properties}}

Template:Object functions

2017-10-02T17:53:59Z

StreetGT:

**[[Object::Object]]

Template:Object definition

2017-10-02T17:51:42Z

StreetGT:

*Functions
{{Object_functions}}
{{Entity_functions}}
*Properties
{{Object_properties}}
{{Entity_properties}}

Template:Object functions

2017-10-02T17:51:12Z

StreetGT:

**[[Objects::new]]

Template:Object functions

2017-10-02T17:49:33Z

StreetGT: Blanked the page

Template:Object functions

2017-10-02T17:45:25Z

StreetGT:

[[Objects::new]]

Template:Object functions

2017-10-02T17:45:17Z

StreetGT: Created page with "***Objects::new"

***[[Objects::new]]

Template:Global functions

2017-10-02T17:43:51Z

StreetGT:

*Functions
**[[Globals::joaat|mp.joaat]]
*Properties
**[[Server-side_functions#Player_pool_functions|mp.players]]
**[[Server-side_functions#Entity_pool_functions|mp.vehicles]]
**[[Globals::Objects|mp.objects]]
**[[Server-side_functions#Entity_pool_functions|mp.pickups]]
**[[Server-side_functions#Entity_pool_functions|mp.blips]]
**[[Server-side_functions#Entity_pool_functions|mp.markers]]
**[[Server-side_functions#Entity_pool_functions|mp.checkpoints]]
**[[Server-side_functions#Event_functions|mp.events]]
**[[mp.config]]
**[[Globals::environment|mp.environment]]
***[[Environment::setWeatherTransition]]
***[[Environment::weather]]
***[[Environment::time.hour]]
***[[Environment::time.minute]]
***[[Environment::time.second]]

File:Westy.png

2017-09-24T16:49:27Z

StreetGT:

File:TigerShark.png

2017-09-24T16:49:27Z

StreetGT:

File:Tennis01AFY.png

2017-09-24T16:49:26Z

StreetGT:

File:TaoChengCutscene.png

2017-09-24T16:49:26Z

StreetGT:

File:Stingray.png

2017-09-24T16:49:26Z

StreetGT:

File:Shepherd.png

2017-09-24T16:49:25Z

StreetGT:

File:Seagull.png

2017-09-24T16:49:25Z

StreetGT:

File:Rottweiler.png

2017-09-24T16:49:22Z

StreetGT:

File:Retriever.png

2017-09-24T16:49:21Z

StreetGT:

File:Rat.png

2017-09-24T16:49:20Z

StreetGT:

File:RashkovskyCutscene.png

2017-09-24T16:49:20Z

StreetGT:

File:Rabbit.png

2017-09-24T16:49:20Z

StreetGT:

File:Pug.png

2017-09-24T16:49:20Z

StreetGT:

File:Poodle.png

2017-09-24T16:49:19Z

StreetGT:

File:Pigeon.png

2017-09-24T16:49:19Z

StreetGT:

File:Pig.png

2017-09-24T16:49:19Z

StreetGT:

File:MountainLion.png

2017-09-24T16:49:18Z

StreetGT:

File:KillerWhale.png

2017-09-24T16:49:15Z

StreetGT:

File:Husky.png

2017-09-24T16:49:15Z

StreetGT:

File:Humpback.png

2017-09-24T16:49:14Z

StreetGT:

File:Dolphin.png

2017-09-24T16:49:14Z

StreetGT:

File:Fish.png

2017-09-24T16:49:14Z

StreetGT:

File:Hen.png

2017-09-24T16:49:13Z

StreetGT:

File:HammerShark.png

2017-09-24T16:49:13Z

StreetGT:

File:Eastsa01AMY.png

2017-09-24T16:49:13Z

StreetGT:

File:Deer.png

2017-09-24T16:49:13Z

StreetGT:

File:Crow.png

2017-09-24T16:49:13Z

StreetGT:

File:Cormorant.png

2017-09-24T16:49:08Z

StreetGT:

File:ChefCutscene.png

2017-09-24T16:49:07Z

StreetGT:

File:Chop.png

2017-09-24T16:49:07Z

StreetGT:

File:ChickenHawk.png

2017-09-24T16:49:07Z

StreetGT:

File:Cow.png

2017-09-24T16:49:07Z

StreetGT:

File:Coyote.png

2017-09-24T16:49:07Z

StreetGT:

File:Boar.png

2017-09-24T16:49:06Z

StreetGT:

File:Chimp.png

2017-09-24T16:49:06Z

StreetGT:

File:Cat.png

2017-09-24T16:49:06Z

StreetGT: