enableSimulation: Difference between revisions
Waffle SS. (talk | contribs) m (setPos link) |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
| (69 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{RV|type=command | ||
| arma2 |= | |game1= arma2 | ||
|version1= 1.00 | |||
|1. | |game2= arma2oa | ||
|version2= 1.50 | |||
| | |game3= tkoh | ||
|version3= 1.00 | |||
| | |game4= arma3 | ||
|version4= 0.50 | |||
| | |arg= global | ||
| | |eff= local | ||
| | |gr1= Object Manipulation | ||
| | |descr= Enables / disables simulation for the given entity, e.g its animation and physics; it will still be able to take damage and report enemies. | ||
This command will affect entity simulation only [[local|locally]]. | |||
For a global and JIP enabled alternative, see [[enableSimulationGlobal]]. | |||
| [[ | |s1= entity [[enableSimulation]] state | ||
|p1= entity: [[Object]] | |||
| | |p2= state: [[Boolean]] | ||
|r1= [[Nothing]] | |||
| | |x1= <sqf>player enableSimulation false;</sqf> | ||
| | |seealso= [[enableSimulationGlobal]] [[simulationEnabled]] [[enableDynamicSimulationSystem]] [[dynamicSimulationSystemEnabled]] [[enableDynamicSimulation]] [[dynamicSimulationEnabled]] [[setDynamicSimulationDistance]] [[dynamicSimulationDistance]] [[setDynamicSimulationDistanceCoef]] [[dynamicSimulationDistanceCoef]] [[triggerDynamicSimulation]] [[canTriggerDynamicSimulation]] | ||
}} | }} | ||
{{Note | |||
|user= Tyrspawn | |||
|timestamp= 20110720043900 | |||
|text= {{Feature|informative|The following only applies to {{arma2}} before a certain patch, in which such changes have been integrated in the game code.}} | |||
Nou/Jaynus have discovered something quite important about the {{arma2}} engine: | |||
Orient yourself to the enableSimulation command in {{arma2}}: | |||
Orient yourself to the enableSimulation command in | |||
If simulation is disabled on objects (this enablesimulation false), they do not send updates across the network, drastically reducing traffic across the network by an order of magnitude. What this means in practicality is that it is possible to have huge mission maker created cities with no or negligible impact on mission performance. Mission placed objects is the most common cause of performance woes - so this is huge news, and was previously undocumented, both on the BIS wiki and elsewhere. | If simulation is disabled on objects (this enablesimulation false), they do not send updates across the network, drastically reducing traffic across the network by an order of magnitude. What this means in practicality is that it is possible to have huge mission maker created cities with no or negligible impact on mission performance. Mission placed objects is the most common cause of performance woes - so this is huge news, and was previously undocumented, both on the BIS wiki and elsewhere. | ||
| Line 59: | Line 53: | ||
This also has importance in a technical sense: bandwith is the most significant factor in mission performance. The lower the server bandwith, the better the performance. | This also has importance in a technical sense: bandwith is the most significant factor in mission performance. The lower the server bandwith, the better the performance. | ||
}} | |||
{{Note | |||
|user= Rocket | |||
|timestamp= 20110908142000 | |||
|text= Objects with disabled simulation are not calculated for lightsources beyond the global light (moon/sun), so any light sources you create will not light them. | |||
}} | |||
{{Note | |||
|user= Killzone_Kid | |||
< | |timestamp= 20141021153300 | ||
|text = Units that have been previously subjected to [[enableSimulation]] false; or [[enableSimulationGlobal]] false; may stay unrecognised for a long time even after simulation was re-enabled, returning [[objNull]] as [[cursorTarget]]. Force revealing units with [[reveal]] command usually solves the problem. For example: | |||
<sqf>{ player reveal _x } forEach allUnits;</sqf> | |||
}} | |||
{{Note | |||
|user= Waffle SS. | |||
|timestamp= 20150523162800 | |||
|text= After using '''enableSimulation''' [[false]] or [[enableSimulationGlobal]] [[false]] on an object, [[setPos]] will still update its position across the network in MP. | |||
}} | |||
{{Note | |||
|user= Pierre MGI | |||
|timestamp= 20151202185500 | |||
|text= After using enableSimulation false or enableSimulationGlobal false on a vehicle (car, helo), don't forget to re-enable simulation on this vehicle before a player jumps into it. Otherwise, he will be stuck in it, with a black screen and no way to escape! | |||
}} | |||
{{Note | |||
|user= Demellion | |||
|timestamp= 20160901165200 | |||
|text= Since '''{{arma3}} 1.56''' the object can also be returned with [[cursorObject]] even if the simulation is not enabled. | |||
}} | |||
Latest revision as of 16:58, 28 October 2025
Description
- Description:
- Enables / disables simulation for the given entity, e.g its animation and physics; it will still be able to take damage and report enemies. This command will affect entity simulation only locally. For a global and JIP enabled alternative, see enableSimulationGlobal.
- Groups:
- Object Manipulation
Syntax
- Syntax:
- entity enableSimulation state
- Parameters:
- entity: Object
- state: Boolean
- Return Value:
- Nothing
Examples
- Example 1:
Additional Information
- See also:
- enableSimulationGlobal simulationEnabled enableDynamicSimulationSystem dynamicSimulationSystemEnabled enableDynamicSimulation dynamicSimulationEnabled setDynamicSimulationDistance dynamicSimulationDistance setDynamicSimulationDistanceCoef dynamicSimulationDistanceCoef triggerDynamicSimulation canTriggerDynamicSimulation
Notes
-
Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
- Posted on Jul 20, 2011 - 04:39 (UTC)
-
Nou/Jaynus have discovered something quite important about the Arma 2 engine:
Orient yourself to the enableSimulation command in Arma 2:
If simulation is disabled on objects (this enablesimulation false), they do not send updates across the network, drastically reducing traffic across the network by an order of magnitude. What this means in practicality is that it is possible to have huge mission maker created cities with no or negligible impact on mission performance. Mission placed objects is the most common cause of performance woes - so this is huge news, and was previously undocumented, both on the BIS wiki and elsewhere.
There are some quirks.
While an object which has enableSimulation false set on it will take damage, it will not display any animations or damage states until enableSimulation is enabled back onto it. If you want to disable simulation on a unit and then show it as dieing once it is hit or damaged, add an eventhandler onto it which enables simulation on the object when it is hit or killed. Hit handler for best visual, killed handler for best performance.
This discovery will be the basis of a new unit caching script by Jaynus.
This also has importance in a technical sense: bandwith is the most significant factor in mission performance. The lower the server bandwith, the better the performance.
- Posted on Sep 08, 2011 - 14:20 (UTC)
- Objects with disabled simulation are not calculated for lightsources beyond the global light (moon/sun), so any light sources you create will not light them.
- Posted on Oct 21, 2014 - 15:33 (UTC)
- Units that have been previously subjected to enableSimulation false; or enableSimulationGlobal false; may stay unrecognised for a long time even after simulation was re-enabled, returning objNull as cursorTarget. Force revealing units with reveal command usually solves the problem. For example:
- Posted on May 23, 2015 - 16:28 (UTC)
- After using enableSimulation false or enableSimulationGlobal false on an object, setPos will still update its position across the network in MP.
- Posted on Dec 02, 2015 - 18:55 (UTC)
- After using enableSimulation false or enableSimulationGlobal false on a vehicle (car, helo), don't forget to re-enable simulation on this vehicle before a player jumps into it. Otherwise, he will be stuck in it, with a black screen and no way to escape!
- Posted on Sep 01, 2016 - 16:52 (UTC)
- Since Arma 3 1.56 the object can also be returned with cursorObject even if the simulation is not enabled.