===== Minigames & Weapons Overview =====

==== Minigames Overview ====

There are a few minigames built into the game that you can include on your world by activating them in different ways:

  * [[world_setup:game_features:RC|RC Drones / Robocrows]]
  * [[world_setup:game_features:Racing|Racing]]
  * [[world_setup:game_features:Fishing|Fishing]]
  * [[world_setup:game_features:Pub|Pub games (Chess, poker, etc)]]
  * [[world_setup:game_features:Hornball|Hornball]]

If you get into scripting you can create your own game rules. Minigames are made easier by making use of the [[scripting:subgames|Subgame script system]]. 

==== Introduction to Weapons ====

The World Editor (F10) has two main screens for controlling the use of weapons in the world : **Global Weapons Controls** (which sets parameters that affect how weapons work in general) and the **Weapons Editor** (which allows you to change the properties of individual weapons.


==== Global Weapons Controls ====

There are 3 main options for determining which weapons players have access to:\\
1) ***Weapon Selection Mode** -> **Set By Vehicle** : the weapons a player can use will depend on which vehicle they are in. The weapons available to the vehicle are set in the Vehicle Settings screens.\\
2) ***Weapon Selection Mode** -> **Selected by Inventory** : the weapons a player can use will depend on what items they have in their inventory. (Weapon item numbers correspond to the weapon types in your setup file).\\
3) You can also assign weapons to players via script using [[reference:server_commands:full_command_list#bonusweapon|*bonusweapon]] or [[reference:server_commands:full_command_list#bonusweaponsecondary|*bonusweaponsecondary]]


On this page you can also set which keys are used to fire weapons ( **Weapon Control** ) or you can use **Weapon Selection** -> **Inventory + next weapon select** which means the player has one weapon active on the primary key and then a 'select next weapon from inventory' button on the secondary key.


=== Other ways of affecting weapons ===

** Whether weapons work everywhere or just in certain places.**
By default, weapons will be allowed everywhere as long as you have set Fighting to 1, but you can add safe zones where no weapons are allowed.. Check out the Zones tool on the left panel in the world editor.



==== Modifying Weapons.txt directly (Advanced) ====

Weapons on your world are created using a combination of settings, the weapons definition file (**Data\Weapons.txt**) and (optionally) 3d models & sound effects. Weapons can also be tied in to Server Scripts.

Settings control which weapons are assigned to a player (though you can also do this in script) and if/when they're usable. The ** weapons.txt** file is used to set the specific behaviours of each weapon type. 

<note tip>Use the command ***refreshweap** to reload the Data\Weapons.txt file when you have made changes to it.</note>

The basic format for a weapon in weapons.txt is as shown:
 
Weapon 1
{            #Spear
  Fire=Basic
  Control=Javelin 
  object=Projectile 
  Speed=1000 
  graphic=2 
  delay=1000 
  item=NONE 
  damage=3 
  anim=AnimFire 
} 
Weapon 2
{             #Plasma gun
  Fire=DualAim 
  Control=Basic
  object=Plasma1KeepHeight
  Speed=1000 
  Expiry=300
  delay=500 
  damage=50 
  sound=2
}

Check the [[World Setup::Weapons Reference|Weapons Reference]] section for full descriptions of the weapons parameters.


==== Raw Settings for Weapons ====

**1. Whether your world allows weapons, or not.**
To enable weapons on your world you need to set a global World Setting called Fighting. 
  *settings -> World Rules -> Fighting
If you set it to 0, weapons will be disabled. 
If you set it to 1, weapons will be enabled. 

**2. Whether weapons work everywhere or just in certain places.**
By default, weapons will be allowed everywhere as long as you have set Fighting to 1, but you can add safe zones where no weapons are allowed.

**3. How people on your world are allowed to use weapons.**
There are 3 options for determining which weapons players can use:\\
1) ***Settings -> World -> Weapon Selection Mode** set to 0 : the weapons a player can use will depend on which vehicle they are in. The primary and secondary weapon types are set in the *Settings -> Vehicle sections.\\
2) ***Settings -> World -> Weapon Selection Mode** set to 1 : players will be able to use any weapon item that is currently in their inventory. (Weapon item numbers correspond to the weapon types in your setup file).\\
3) You can also assign weapons to players via script using [[reference:server_commands:full_command_list#bonusweapon|*bonusweapon]] or [[reference:server_commands:full_command_list#bonusweaponsecondary|*bonusweaponsecondary]]


**4. Which controls a player must use to fire different weapons.**
By default, a vehicle will fire its Primary weapon when a player presses the Tab key, and fire its secondary weapon when a player presses Shift + Ctrl. 

There are a few other options for setting the "fire" key for weapons, as well as other modes that allow more than two weapons per vehicle. Which mode you use depends to a large extent on what kind of game you're trying to create. These options are explained in Weapons Control Mode.