{{tag>beam part}}
{{htmlmetatags>metatag-keywords=(pac3, wiki, part, beam)
metatag-description=(Creates a visual connection between two points.)
metatag-og:title=(Beam | Part | PAC3)
metatag-og:description=(Creates a visual connection between two points.)
}}

====== Beam ======
<grid>
<col xss="12" xs="12" sm="12" md="6" lg="6">
The beam part allows you to create a visual connection between two points. Can be used to create a variety of beam-like effects. 

===== Location =====
<block indent> This part can be found under: 
  * :effect: **Effects** > [[:part:beam]]
</block>

<block box compact>
{{fa>question?color=#7ab353&fw&lg}} You can easily find it by clicking on the {{:icon:editor:add.png?nolink|}} sign and typing //**beam**//.
</block>

</col>
<col xss="12" xs="12" sm="12" md="6" lg="6">
{{ :part:beam.mp4?20x50 }}
</col>
</grid>

===== Usage & Examples =====
<block box>
==== Basic Beam ====
  - Add the [[:part:beam]] part to your outfit, set the [[#position]]/[[#angle]], this is where the beam starts.
  - Add a [[:part:model]] part and move it to where you want the beam to end.
  - Click (...) next to [[#end point name]] and pick the model.
</block>

<block box>
==== Beam Brightness Fix ====
Most beam materials use the **Unlit** shader which means they don't receive shadows and appear very bright in dark areas. You can work around that by using a <span code>light_amount</span> proxy on the <span code>StartColor</span> and <span code>EndColor</span> variables.

<block box compact>
{{fa>download?color=#7ab353&fw&lg}} **Download:** {{:part:beam:beam_brightness.txt}}
</block>
</block>

===== Related commands: =====
|pac_enable_beam| 1/0 (1) | Enables/Disables the beam part. |

===== Properties =====
==== Generic ====
<block box compact>
== name ==
{{section>property:name#include&inline}}
</block>

<block box compact>
== hide ==
{{section>property:hide#include&inline}}
</block>

<block box compact>
== parent name ==
{{section>property:parent#include&inline}}
</block>

<block box compact>
== material ==
Material used for the beam. Custom materials are possible. Shaders other than **unlit** cause shadow issues on the beam.
</block>

<block box compact>
== end point name ==
Name of the part that the beam end connects to.
</block>

<block box nomargins>
== bend ==
Controls how bent the beam is.  <block 400px> {{:part:beam_bend.mp4 }} </block>
</block>

<block box nomargins>
== frequency ==
Controls the frequency of the beam. Higher frequency means more bends. <block 400px> {{:part:beam_frequency.mp4 }} </block>
</block>

<block box compact>
== resolution ==
Number of beam segments. The more segments the smoother the beam is. Max is 256.
</block>

<block box nomargins>
== width ==
Controls the width of the beam. <block 400px> {{:part:beam_width.mp4 }} </block>
</block>

<block box nomargins>
== width bend ==
Controls the width of the bends. <block 400px> {{:part:beam_bend_width.mp4 }} </block>
</block>

<block box nomargins>
== width bend size ==
Controls the length of the bends. Use integers, when using decimals half of the beam segments disappear. <block 400px>{{:part:beam_bend_size.mp4 }} </block>
</block>

<block box compact>
== texture stretch ==
Stretches the beam texture/material.
</block>

<block box compact>
== texture scroll ==
Offsets the texture/material position. Combine this with a proxy for a 'flow' effect.
</block>

<block box compact>
== use endpoint offsets ==
Uses the offset position of the endpoint.
</block>

<block box compact>
== is explicit ==
{{section>property:is explicit#include&inline}} [[:property:is explicit|→ Read More]]
</block>

==== Orientation ====
These only affect the starting point of the beam.

<block box compact>
== aim part name ==
{{section>property:aim-part#include&inline}} [[property:aim-part|→ Read More]]
</block>

<block box compact>
== bone ==
{{section>property:bone#include&inline}} [[:property:bone|→ Read More]]
</block>

<block box compact>
== position ==
{{section>property:position#include&inline}} [[:property:position|→ Read More]]
</block>

<block box compact>
== angles ==
{{section>property:angles#include&inline}} [[:property:angles|→ Read More]]
</block>

<block box compact>
== eye angles ==
{{section>property:eye angles#include&inline}} [[:property:eye angles|→ Read More]]
</block>

<block box compact>
== position offset ==
{{section>property:position offset#include&inline}} [[:property:position offset|→ Read More]]
</block>

<block box compact>
== angle offset ==
{{section>property:angle offset#include&inline}} [[:property:angle offset|→ Read More]]
</block>

==== Appearance ====
<block box compact>
== start color ==
Color of the beam's starting point.
</block>

<block box compact>
== end color ==
Color of the beam's end point.
</block>

<block box compact>
== translucent ==
???
</block>

<block box compact>
== ignore z ==
{{section>property:ignore z#include&inline}} [[:property:ignore z|→ Read More]]
</block>

<block box compact>
== no texture filtering ==
{{section>property:no texture filtering#include&inline}} [[:property:no texture filtering|→ Read More]]
</block>

<block box compact>
== blend mode ==
???
</block>

==== Other ====
<block box compact>
== draw order ==
???
</block>