SetWeaponRenderEnabled

From Multi Theft Auto: Wiki
Revision as of 16:58, 10 January 2025 by Srslyyyy (talk | contribs) (Add information about one frame delay when switching weapons)
Jump to navigation Jump to search

ADDED/UPDATED IN VERSION 1.6.0 r22880:
This function allows you to completely disable/enable GTA weapon rendering for ped and player. It is particularly useful for creating custom weapon systems, where singular weapon ID could have many different models/variations, or to simply get rid of one frame delay when switching weapons.
[[{{{image}}}|link=|]] Note: If you want to selectively hide weapon use engineSetModelLODDistance with weapon model ID and value of 0.001. Do note that game will still process default rendering regardless, which isn't the case when using this function to hide weapon models.
[[{{{image}}}|link=|]] Tip: You can use it for example with optimized bone_attach resource called pAttach.

Syntax

bool setWeaponRenderEnabled ( bool enabled )

Required Arguments

  • enabled: Whether weapon render should be enabled.

Returns

Always returns true.

Example

This example disables weapon rendering once resource has started.

function onClientResourceStartDisableWeaponRender()
	setWeaponRenderEnabled(false)
end
addEventHandler("onClientResourceStart", resourceRoot, onClientResourceStartDisableWeaponRender)

See Also