Set Player Visual Action
An action that replaces the default player visuals with a given prefab. The player will see themselves as that prefab and can move around as usual. The player's visuals can be reset to the default pummel character visuals by leaving the prefab field empty.
|Targets||The gameobject(s) that should be affected by this action. This action only works on players; any other gameobject will be ignored.|
|Prefab||The prefab that will replace the player's current visuals.|
|Use Player Color||When enabled, all props that are not using custom materials will have their tint color set to the player's color.|
|Vertical Rotation Child||This option allows one of the prefab's child gameobjects to be tilted up/down around its pivot point when the player looks up and down.
Note that this setting only affects the 'Third Person' Player Type.
|Movement Rotation Child||By default the entire prefab is rotated to match the player's facing direction. Instead, this option allows one of the prefab's child gameobjects to be rotated separately towards the player's movement direction.
Note that the player's facing direction and movement direction will be the same when using the 'Top Down' Player Type, unless 'Twinstick Controls' is enabled.
Player Size and Collisions
The player's collider is a vertical capsule-shaped volume. When using a custom visual prefab, the size of this volume is made to match the size of the prefab.
The height of the capsule will be set to the combined height of the prefab's colliders. Then, the width of the capsule is set to the width of the prefab's colliders on the X or Z axis, whichever is smallest.
For activating triggers and being hit by weapons, the colliders on all of the prefab's objects will be used, not just the player's collision capsule.
If there are any triggers on the player's custom visual prefab, these are excluded from the size calculation, and will not be hit by weapons. They can still activate other triggers in the world, however.
The gameobjects in the player's custom visual will be made non-solid to other players and objects.
When positioning items on the custom prefab, the location of the different item slots will be chosen based on the position of the gameobjects that make up the prefab.
|Item Slot||Chosen Gameobject|
|Head||Gameobject with the greatest y value.|
|Left Hand||Gameobject with the smallest x value.|
|Right Hand||Gameobject with the greatest x value.|
|Back||Gameobject with the smallest z value.|
|Body||The prefab's root gameobject.|
When the player dies with a custom visual set, they will keep the custom visual when they respawn. If you want them to respawn without the custom visual, use another Set Player Visual Action with the player's OnRespawn action, and leave the Prefab field blank.
- Objects cannot be destroyed while used as a player's visuals.