Garry's Mod Wiki

Home / Garry's Mod Wiki

Garry's Mod Wiki

  boolean Entity:PhysicsInitConvex( table points, string surfaceprop = "default", Vector massCenterOverride = nil )
Search Github

Description

Initializes the physics mesh of the entity with a convex mesh defined by a table of points. The resulting mesh is the of all the input points. If successful, the previous physics object will be removed.

This is the standard way of creating moving physics objects with a custom convex shape. For more complex, concave shapes, see Entity:PhysicsInitMultiConvex.

You may be expected to call Entity:SetSolid with desired solid type before calling this function.

Clientside physics objects on serverside entities do not move properly in some cases. Physics objects should only created on the server or you will experience incorrect physgun beam position, prediction issues, and other unexpected behavior.

You can use the following workaround for movement, though clientside collisions will still be broken.

function ENT:Think() if ( CLIENT ) then local physobj = self:GetPhysicsObject() if ( IsValid( physobj ) ) then physobj:SetPos( self:GetPos() ) physobj:SetAngles( self:GetAngles() ) end end end


Issue Tracker: 5060

Arguments

1 table points
A table of eight Vectors, in local coordinates, to be used in the computation of the convex mesh. Order does not matter.
2 string surfaceprop = "default"
Physical material from surfaceproperties.txt or added with physenv.AddSurfaceData.
3 Vector massCenterOverride = nil
If set, overwrites the center of mass for the created physics object.

Returns

1 boolean
Returns true on success, false otherwise.

Example

Creates a "box" physics mesh for the entity.

function ENT:Initialize() if ( CLIENT ) then return end -- We only want to run this code serverside local x0 = -20 -- Define the min corner of the box local y0 = -10 local z0 = -5 local x1 = 20 -- Define the max corner of the box local y1 = 10 local z1 = 5 self:PhysicsInitConvex( { Vector( x0, y0, z0 ), Vector( x0, y0, z1 ), Vector( x0, y1, z0 ), Vector( x0, y1, z1 ), Vector( x1, y0, z0 ), Vector( x1, y0, z1 ), Vector( x1, y1, z0 ), Vector( x1, y1, z1 ) } ) -- Set up solidity and movetype self:SetMoveType( MOVETYPE_VPHYSICS ) self:SetSolid( SOLID_VPHYSICS ) -- Enable custom collisions on the entity self:EnableCustomCollisions( true ) end

This site is a community mirror of the official Garry's Mod wiki.. This site is not maintained by Facepunch Studios.

Page content is automatically updated four times a day. Edits and history are not available.

Last Parsed: Loading...