RemoveWorldModel: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Add link to restore func)
(Remove obsolete Requirements section)
 
(2 intermediate revisions by the same user not shown)
Line 23: Line 23:
===Returns===
===Returns===
Returns ''true'' if the world object was removed, ''false'' if invalid arguments were passed.
Returns ''true'' if the world object was removed, ''false'' if invalid arguments were passed.
==Requirements==
{{Requirements|1.2.0-9.03618|1.2.0-9.03618|}}


==Example==  
==Example==  
Line 58: Line 55:


==See Also==
==See Also==
===Client world functions===
{{Client_world_functions}}
{{Client_world_functions}}
===Building functions===
{{Building functions}}
===Object functions===
{{Object functions}}

Latest revision as of 15:40, 7 November 2024

This function is used to remove a world object. Use restoreWorldModel to reverse this action.

Syntax

bool removeWorldModel ( int modelID, float radius, float x, float y, float z [, int interior = -1 ] )

Required Arguments

  • modelID: A whole integer specifying the GTASA object model ID.
  • radius: A floating point number representing the radius that will be eliminated.
  • x: A floating point number representing the X coordinate on the map.
  • y: A floating point number representing the Y coordinate on the map.
  • z: A floating point number representing the Z coordinate on the map.

Optional Arguments

  • interior: The interior ID to apply the removal to. Some objects in interior 13 show in all interiors so if you want to remove everything in interior 0 also remove everything in interior 13. A value of -1 here will affect all interiors.

Returns

Returns true if the world object was removed, false if invalid arguments were passed.

Example

This example will removes buildings on BigEar:

removeWorldModel(16617, 1000, -300, 1556, 75) --lod
removeWorldModel(16616, 1000, -300, 1556, 75) --lod
removeWorldModel(16615, 1000, -300, 1556, 75) --lod
removeWorldModel(16138, 1000, -300, 1556, 75) -- model

This example removes CJ house:

for i = 700, 18630 do
    removeWorldModel(i, 10, 2494, -1696, 17)
end

This server script example removes all models, everywhere:

for i = 321, 18630 do
    removeWorldModel(i, 10000, 0, 0, 0)
end
setOcclusionsEnabled(false)  -- Also disable occlusions when removing certain models
setWaterLevel(-5000)         -- Also hide the default water as it will be full of holes

Changelog

Version Description
1.3.1-9.04636 Added interior argument
1.3.1-9.04844 Everything streams out fine now.

See Also

Client world functions



Building functions


Object functions