{{tag>projectile part}}
{{htmlmetatags>
metatag-keywords=(pac3, wiki, part, projectile, damage)
metatag-description=(Spawns a projectile to create visual effects or deal damage.)
metatag-og:site_name=(wiki.pac3.info)
metatag-theme-color=(#3c5b7f)
metatag-og:title=(Projectile | Part | PAC3)
metatag-og:description=(Spawns a projectile to create visual effects or deal damage.)
}}

<row>
<col lg="8" md="8" sm="7" xs="6">
====== Projectile ======
Spawns a projectile that can be used to create visual effect of shooting/throwing, deal damage or push props. 

===== Location =====
This part can be found under: 
  * **Advanced** > [[:part:projectile]]
{{page>:includes#location}}
</col>
<col lg="4" md="4" sm="5" xs="6">
\\ 
\\ 
<block center>
{{ :tutorial:part_thumbnails:projectile.webm?327x197direct|}}
</block>
</col>
</row>

===== Limitations =====
  * The projectile model is only visual. It does **NOT** affect the collision or damage radius.
  * Maximum radius is **100**.
  * Maximum damage radius is **300**.
  * Maximum mass is **50000**.
  * Maximum damage is **100000**.
  * Maximum lifetime is **10**.


===== Usage and examples =====
<block box>
==== Basic Projectile ====
  - Add **Advanced** > [[:part:projectile]] to your oufit
  - Add a [[:part:group]] or [[:part:model]] part and give it a unique name
  - Put the name into the [[#outfit part name]] field
  - Aim the red positional arrow in the direction you want your projectile to go
  - Use an event to trigger the projectile
</block>

===== Properties =====
<block box compact>
{{fa>info?color=#3bb0ff&fw&lg}} These settings only control the projectile itself. To change the visuals tweak the [[#outfit part name]] group/model.
</block> 

==== Generic ====
<block box compact>
== speed ==
Speed of the projectile. **1** Speed equals the velocity of **1000** units per second.
</block>

<block box compact>
== add owner speed ==
Adds speed of the owner (player by default) to the projectile.
</block>

<block box compact>
== damping ==
Controls how quickly the projectile stops moving.
</block>

<block box compact>
== gravity ==
Enables gravity.
</block>

<block box compact>
== collisions ==
Causes the projectile to collide with the world. To collide with players and props [[#physical]] needs to be enabled.
</block>

<block box compact>
== sphere ==
Uses a sphere collision model instead of a box. Useful when you want projectiles to roll on the ground.
</block>

<block box compact>
== radius ==
Collision radius of the projectile. Max is **100**.
</block>

<block box compact>
== damage radius ==
Damage radius of the projectile. Max is **300**.
</block>

<block box compact>
== life time ==
Life time of the projectile in seconds. Controls for how long the projectile stays present before disappearing. \\ E.g. Projectile with a life time of **1** will disappear after **1** second.
</block>

<block box compact>
== aim dir ==
Aims the projectile model in the direction of the projectile.
</block>

<block box compact>
== sticky ==
Causes the projectile to stick to surfaces. If [[#sticky]] and [[#bounce]] are enabled at the same time then projectiles will bounce off the world but still stick to props and characters.
</block>

<block box compact>
== bounce ==
Enables bounciness causing projectiles to bounce off the world/objects. Values under **1** slow down the projectile on each bounce while values above **1** speed it up.
</block>

<block box compact>
== bullet impact ==
Creates bullet impact effects (particles, sounds and bullet holes) when the projectile hits something.
</block>

<block box compact>
== damage ==
The amount of damage dealt by the projectile in the [[#damage radius]].
</block>

<block box compact>
== damage type ==
Adds special damage properties to the projectile. These happen on collision and include effects such as being set on fire or healing.
<button collapse="damage_types" type="default" size="xs">Show damage types table.</button>
<collapse id="damage_types" collapsed="true">
Effects that are not explained (??) either don't do anything special or I simply have no idea how to use them. If you know anything about them please update the table.
^Type^Effect^
|<span code>acid</span>|??|
|<span code>airboat</span>|??|
|<span code>alwaysgib</span>|??|
|<span code>armor</span>|Restores armor. Requires [[#collide with owner]] if you want to restore your own armor.|
|<span code>blast</span>|Explodes on hit and sets props on fire, seems to have a really weak knock-back, if you need something stronger use [[#explosion]].|
|<span code>blast_surface</span>|Same as **blast**?|
|<span code>buckshot</span>|??|
|<span code>bullet</span>|??|
|<span code>burn</span>|Sets props on fire.|
|<span code>club</span>|??|
|<span code>crush</span>|??|
|<span code>direct</span>|??|
|<span code>dissolve</span>|Adds a dissolve effect on death.|
|<span code>dissolve_core_effect</span>|Different kinds of dissolve effects. Damage is dealt in the [[#damage radius]] but the effects only apply on a direct hit.|
|<span code>dissolve_energy</span>|:::|
|<span code>dissolve_heavy_electrical</span>|:::|
|<span code>dissolve_light_electrical</span>|:::|
|<span code>dissolve_light_electrical</span>|:::|
|<span code>drown</span>|??|
|<span code>drownrecover</span>|??|
|<span code>energybeam</span>|??|
|<span code>explosion</span>|Explosion with a stronger knock-back effect than **blast**. Sets props on fire.|
|<span code>fall</span>|??|
|<span code>fire</span>|Sets characters and props in the [[#damage radius]] on fire.|
|<span code>generic</span>|??|
|<span code>heal</span>|Restores health. Requires [[#collide with owner]] if you want to restore your own health.|
|<span code>nervegas</span>|??|
|<span code>nevergib</span>|??|
|<span code>paralyze</span>|??|
|<span code>physgun</span>|??|
|<span code>plasma</span>|??|
|<span code>poison</span>|??|
|<span code>prevent_physics_force</span>|??|
|<span code>radiation</span>|??|
|<span code>removenoragdoll</span>|Doesn't create a ragdoll on kill.|
|<span code>shock</span>|Creates sparks on collision if there is a character in the [[#damage radius]].|
|<span code>slash</span>|??|
|<span code>slowburn</span>|??|
|<span code>sonic</span>|??|
|<span code>vehicle</span>|??|
</collapse>
</block>

<block box compact>
== spread ==
Initial spread of the projectile. The bigger the number the more random the shooting direction is.
</block>

<block box compact>
== delay ==
Delay between triggering and shooting the projectile in seconds.
</block>

<block box compact>
== maximum ==
The maximum number of projectiles present at once when using [[#physical]].
</block>


<block box compact>
== mass ==
Mass of the projectile. The bigger the mass the more force is applied to the target on collision, meaning you can push bigger props. Projectiles with high mass and velocity will most likely kill anyone instantly, if you want to make sure that characters are killed by [[#damage]] instead of the projectile itself, set the mass to 1.
</block>

<block box compact>
== attract ==
How fast the projectile follows its target. Requires [[#physical]].
</block>

<block box compact>
== attract mode ==
The target that the projectile is going to follow.
|<span code>hitpos</span>|Follows the **hitpos** (the spot that you aim at). [[#Radius]] is not used.|
|<span code>hitpos radius</span>|Follows a point in the direction of your **hitpos** (the spot that you aim at), at the distance defined by [[#radius]].|
|<span code>closest_to_hitpos</span>|Follows the entity that is the closest to your **hitpos** (the spot that you aim at) in a given [[#radius]].|
|<span code>closest_to_projectile</span>|Follows the entity that is the closest to the projectile in a given [[#radius]].|
</block>

<block box compact>
== attract radius ==
Radius in which the projectile will look for targets.
</block>

<block box compact>
== outfit part name ==
The model/group used by the projectile. This defines how the projectile will look like, does not affect the [[#radius]] or [[#damage radius]].
</block>

<block box compact>
== physical ==
Spawns the projectile as a physical object. Allows you to use multiple projectiles at once (limited by [[#maximum]]). Required if you want the projectile to interact with props/characters. Requires <span code>pac_sv_projectiles 1</span>
</block>

<block box compact>
== collide with owner ==
Causes the projectile to collide with its owner (player by default). Requires [[#physical]].
</block>

<block box compact>
== remove on collide ==
Removed the projectile when it collides with something. Requires [[#physical]].
</block>

<block box compact>
== name ==
Name of this part. Keep this unique.
</block>

<block box compact>
== hide ==
Hides (disables) this part.
</block>

<block box compact>
== is explicit ==
Marks this part as explicit. Players using <span code>pac_hide_disturbing 1</span> won't be able to see it.
</block>

===Orientation===
<block box compact>
== parent name ==
Parent of this part.
</block>

<block box compact>
== aim part name ==
Rotates the projectile part towards a given part of your outfit.
</block>

<block box compact>
== bone ==
Moves the projectile parts origin to a given bone.
</block>

<block box compact>
== position ==
Moves the projectile parts origin on each axis (X, Y, Z).
</block>

<block box compact>
== angles ==
Rotates the projectile parts origin on each axis (X, Y, Z). The red arrow shows the shooting direction.
</block>

<block box compact>
== eye angles ==
Sets the projectile parts angles based on your eye angles, so the projectile will shoot in the direction you're facing. Set [[#angles]] to <span code>(0, 0, 0)</span> for this to work properly.
</block>

<block box compact>
== position offset ==
Moves the projectile part without moving its origin. Since its not visualized in any way it is hard to know where it actually is so it is better to just use [[#position]]. 
</block>

<block box compact>
== angle offset ==
Rotates the projectile part without rotating its origin. Since its not visualized in any way it is hard to know where it actually is so it is better to just use [[#angles]]. 
</block>

=== Appearance ===
These don't affect the projectile at all.