Information for server hosts

All you need to know about hosting Bigass.

It is highly recommended to use **SAPP** to host Bigass maps. A lot of useful information about SAPP can be found here

## Lua scripts

Lua scripts have to be added to "my games\halo ce\sapp\lua" folder and loaded using the following commands inside SAPP's init.txt file:

**lua 1**

**lua\_load <script name>** (without .lua)

Here is a list of scripts that can be used in Bigass:

* Armor switching - allows players to choose armor using /armor command;
* Music - starts playing music 2 minutes before the game ends
* Sprinting - allows players to run faster by double tapping 'W' key.
* Destructible vehicles - spawned vehicles can be destructible (can explode)
* Mine removal - removes player's mines when they leave the server
* Race lap records - records fastest lap times on each map
* Delayed rider ejection - ejects players from vehicles after a delay
* Falcon strafing/height lock - gives more controls to Falcon

## Commands and events

### TOD

Bigass has a command "**set tod <number>**" that switches time of day. **0 - day** (default), **1 - night** and 2 **- snow**. In the final version of Bigass there is a rare glitch that doesn't switch TOD and it can be fixed by rejoining the server. V2,104 does not have snow mode. TOD automatically switches to 1 on slayer game-type and to 2 on KOTH game-type.

To switch time in specific game-types you need to create an event in **events.txt** file. Here is an example:

**event\_start $mode:ctfn 'wait 500;set tod 2'** - this will change TOD to snow ONLY on gametype called ctfn. Make sure you wait at least 500 milliseconds before switching TOD or it might not work.

### Spawning vehicles

In the final version there are a few vehicles you can simply spawn with "**object\_create <vehicle name>**" command (their names are listed below). If you want to spawn vehicles in other locations, you will need to use SAPP command "**spawn vehi <vehicle location> X Y Z rotation**".

Vehicles can be spawned on specific game-types only. Here is an example:

**event\_start $mode:ctfa 'object\_create turret1;object\_create turret2'** - this will spawn Anti-Tank Turrets on ctfa gametype.

### Spawning players inside vehicles

Doing this is slightly more complicated. First of all you need to add events to prevent people from leaving vehicles for too long:

**event\_tick 'var\_add out\_of\_vehicle 3'**

**event\_venter 'var\_set out\_of\_vehicle false $n'**

**event\_vexit 'var\_set out\_of\_vehicle true $n'**

**event\_custom $out\_of\_vehicle:true $ename:kill\_onfoot 'kill $n'**

**event\_vexit $mode:mortargoose\_king 'say $n "You have 5 seconds to get back to your vehicle!";w8 5;cevent kill\_onfoot $n'**

Make sure you change the game-type name to the one you are using. To change the time player has to come back to the vehicle just change "**w8 5**" part to something else, as well as "**say $n "<text>**" part.

You might want to add custom spawn points so you wouldn't spawn inside bases and stuff. To do that go in-game and use command "**loc add <number>**" from 1 to 16, for example "**loc add 5**".

Now you should remove all default vehicles from the map (unless your game-type already does that). Add the following command in **commands.txt**:

**remove\_map\_vehicles 'object\_destroy\_containing hawg;object\_destroy\_containing rox;object\_destroy\_containing newhog;object\_destroy\_containing example; object\_destroy\_containing scorpion;object\_destroy\_containing truck;object\_destroy\_containing spade;object\_destroy\_containing goose'**

And now use the following events to actually spawn the vehicle to the player:

**event\_start $mode:mortargoose\_king 'remove\_map\_vehicles'**

**event\_spawn $mode:mortargoose\_king 't $n $rand;spawn vehi "altis\vehicles\mortargoose\mortargoose" $n; venter $n; nades $n 0;wdel $n 5'**

**event\_die $mode:mortargoose\_king 'w8 3;vdel $n'**

**event\_leave $mode:mortargoose\_king 'vdel $n'**

Replace gametype with your own and change vehicle directory to any other on the list below.

## Object directories list

These are for SAPP's events, commands and scripts only. Directories might be different for older versions of the map.

### Bipeds:

* Default - “bourrin\halo reach\spartan\male\mp masterchief”
* Female - “bourrin\halo reach\spartan\female\female”
* ODST - “bourrin\halo reach\spartan\male\odst”
* Marine - “bourrin\halo reach\marine-to-spartan\mp test”

### Vehicles:

* chaingun hog - “bourrin\halo reach\vehicles\warthog\h2 mp\_warthog”
* gauss hog - “bourrin\halo reach\vehicles\warthog\reach gauss hog”
* rocket hog - “bourrin\halo reach\vehicles\warthog\rocket warthog”
* snowhog - “vehicles\newhog\newhog mp\_warthog”
* mongoose - “altis\vehicles\mongoose\mongoose”
* falcon - “vehicles\falcon\falcon”
* destroyed falcon - “vehicles\falcon\_destroyed\falcon\_destroyed”
* scorpion (not recommended to spawn)- “altis\vehicles\scorpion\scorpion”
* scorpion (spawn this with sapp) - “altis\vehicles\scorpion\scorpion\_mp”
* destroyed scorpion - “altis\vehicles\scorpion\_destroyed\scorpion\_destroyed”
* truck - “halo reach\objects\vehicles\human\civilian\military\_truck\military truck”
* desroyed truck - “altis\vehicles\truck\_destroyed\truck\_destroyed”
* katyusha truck - “altis\vehicles\truck\_katyusha\truck\_katyusha”
* base turret - “halo 4\objects\vehicles\human\turrets\storm\_unsc\_artillery\unsc\_artillery\_mp”
* spade - “altis\vehicles\spade\spade”
* grackle - “altis\vehicles\grackle\grackle”
* mortargoose - “altis\vehicles\mortargoose\mortargoose”
* mortargoose w/o target - “altis\vehicles\mortargoose\mortargoose\_no\_target”

### Weapons:

* assault rifle - “bourrin\weapons\assault rifle”
* binoculars - “altis\weapons\binoculars\binoculars”
* ctf flag - “reach\objects\weapons\multiplayer\flag\flag”
* dmr - “bourrin\weapons\dmr\dmr”
* gauss sniper - “weapons\gauss sniper\gauss sniper”
* m6s(odst pistol) - “halo3\weapons\odst pistol\odst pistol”
* ma5k - “altis\weapons\br\br”
* magnum - “reach\objects\weapons\pistol\magnum\magnum”
* rocket launcher - “bourrin\weapons\badass rocket launcher\bourrinrl”
* shotgun - “cmt\weapons\human\shotgun\shotgun”
* sniper rifle - “cmt\weapons\evolved\human\sniper\_rifle\sniper\_rifle”
* spartan laser - “halo reach\objects\weapons\support\_high\spartan\_laser\spartan laser”