{{tag>entity part}}
{{htmlmetatags>metatag-keywords=(pac3, wiki, part, model, entity, playermodel, mdl, zip)
metatag-description=(Used for entity customization. Supports custom .MDL files.)
metatag-og:title=(Entity | Part | PAC3)
metatag-og:description=(Used for entity customization. Supports custom .MDL files.)
}}

====== Entity ======
This part lets you customize your entity (usually playermodel). Additional player-related configuration can be found in the [[:part:player-config]] part. 

Some of the settings can be used props or NPCs -> See :group: [[part:group:#owner-name| Group: owner-name]]

Supports in-game models as well as custom **.MDL** files. -> [[:tutorial:using-mdl-files]]

===== Location =====
This part can be found under: 
  * Right Click >> [[:part:entity]]

{{page>:includes#location}}

===== Usage & Examples =====
<block box>
==== In-game models ====
  * Add the [[:part:entity]] part to your outfit
  * Click on (...) next to <span code>[[#model]]</span> and select the model that you want to use as your entity.
</block>

<block box>
==== Importing custom models ====
  * Zip the **.MDL** file -> [[:tutorial:using-mdl-files]]
  * Upload it to an online hosting -> [[:tutorial:hosting]]
  * Add an [[:part:entity]] part and paste the link into the <span code>[[#model]]</span> field.
</block>

<block box>
<block right 7.4em nop>
<wrap shadow nomargins> {{:part:entity:entity_playermodel.jpg?direct|}} </wrap>
</block>
==== Custom Playermodel ====
Example of a custom playermodel.

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

<block box>
<block right 7.4em nop>
<wrap shadow nomargins> {{:part:entity:entity_nonhuman.jpg?direct|}} </wrap>
</block>
==== Custom Non-Human Playermodel ====
Example of a custom non-human playermodel with a custom animation set. -> [[tutorial:using-mdl-files#external-animations|External animations.]]

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

===== Properties =====
==== Generic ====
<block box compact>
== model ==
Path to an in-game model or a link to an **.MDL** zip. 
</block>

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

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

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

==== Appearance ====
<block box compact>
== no draw ==
Makes the model invisible.
</block>

<block box compact>
== draw shadow ==
Makes the shadow under the model visible.
</block>

<block box compact>
== inverse kinematics ==
Enables [[https://developer.valvesoftware.com/wiki/$ikchain|Inverse Kinematics]]. This is mainly used to make arms follow the weapon properly, otherwise they will just float instead of actually holding the weapon. Disable this option if you want to pose each arm independently.

<btn type="primary" collapse="entity_ik" size="xs" icon="fas fa-image">Image Preview</btn>
 
<collapse id="entity_ik" collapsed="true">
<wrap shadow>
{{:part:entity:entity_inverse_kinematics.jpg?direct|}}
</wrap>
</collapse>
</block>

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

<block box compact>
== draw order == 
Display order of transparent objects (<span code>[[#alpha]]</span> below 1). Models with higher draw order will appear in front of other models.
</block>

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

<block box compact>
== color ==
Color of the model in <span code>R</span> <span code>G</span> <span code>B</span> format in the <span code>0</span> - <span code>1</span> range. Values over 1 increase brightness.
</block>

<block box compact>
== brightness ==
Brightness of the model.
</block>

<block box compact>
== no lighting ==
Disables lights/shadows on the model. Also known as <span code>fullbright</span>.
</block>

<block box compact>
== no culling ==
Forces the model to show from both sides. Also known as <span code>double face</span>.
</block>

<block box compact>
== invert ==
Inverts the normals of the model.
</block>

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

<block box compact>
== skin == 
Changes the skin ([[https://developer.valvesoftware.com/wiki/$texturegroup|texturegroup]]) of a model. This option appears even if the model doesn't have any additional skins.
</block>

<block box compact>
== level of detail == 
Overrides the **Level of Detail** of the model. Higher number means lower model quality.
</block>

<block box compact>
== eye target name == 
Makes the eyes follow a specified model/bone. Type the name in or click on (...)((**Right Click** on (...) to list all available options.)) to select.
</block>

<block box compact>
== ignore z ==
Ignores depth buffer. Renders the model in front of everything else.
</block>

<block box compact>
== no texture filtering == 
Disables texture filtering
</block>

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

==== Hull ====
The collision hull is used for player/prop/world collisions. Also acts as a hitbox for projectiles. Hitscan hitboxes need to be inside of the collision hull to work properly. Requires <span code>pac_modifier_size 1</span>. 

----

<block box compact>
== standing hull height == 
Height of the collision hull while standing.
</block>

<block box compact>
== crouching hull height == 
Height of the collision hull while crouching. Your character will temporarily crouch when editing this, that isn't a bug.
</block>

<block box compact>
== hull width == 
Width of the collision hull.
</block>

==== Orientation ====
<block box compact>
== size ==
{{section>property:size#include&inline}} Scales the collision hull and hitboxes as well.
</block>

<block box compact>
== scale ==
{{section>property:scale#include&inline}} This only scales the visual model.
</block>

<block box compact>
== bone merge ==
Automatically bonemerges the model to your playermodel, only works if the bones match. 
</block>

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

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

<block box compact>
== bone ==
{{section>property:bone#include&inline}}
</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>

==== Bodygroups ====
This section only appears if the model has [[https://developer.valvesoftware.com/wiki/$bodygroup|bodygroups]] that can be changed. All of the available bodygroups can be changed here.

==== Submaterials ====
This section allows you to change all of the submaterials on the model. Works with in-game materials (Click (...) to select), materials created in PAC (type in the name of the material part), or texture links. Changing any material on this list disables the :material: [[:part:material#material-override]] functionality.

===== Related tutorials =====

{{topic>tutorial +model}}