SetWorldSpecialPropertyEnabled: Difference between revisions
		
		
		
		
		
		Jump to navigation
		Jump to search
		
				
		
		
	
mNo edit summary  | 
				mNo edit summary  | 
				||
| (31 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__  | __NOTOC__  | ||
{{  | {{Shared function}}  | ||
{{New feature/item|3.0161|1.6.0|22195|Added also as a server-side function. Previously only available as a client-side function.}}  | |||
Enables or disables a special world property.  | Enables or disables a special world property.  | ||
{{Note|  | |||
It's recommended to use server-side function with appropriate [[mtaserver.conf#minclientversion|minclientversion]] for properties like "'''underworldwarp'''", "'''burnflippedcars'''", "'''extendedwatercannons'''", "'''flyingcomponents'''", "'''vehicle_engine_autostart'''" to avoid possible data desynchronization.  | |||
}}  | |||
==Syntax==  | ==Syntax==  | ||
| Line 8: | Line 14: | ||
{{OOP||||isWorldSpecialPropertyEnabled}}  | {{OOP||||isWorldSpecialPropertyEnabled}}  | ||
[[File:Randomfoliage.jpeg|frame|right|A photo demonstrating ''randomfoliage'' enabled and disabled.]]  | [[File:Randomfoliage.jpeg|frame|right|A photo demonstrating ''randomfoliage'' enabled and disabled.]]  | ||
[[File:Roadsignstext.png|frame|right|A photo demonstrating ''roadsignstext'' enabled and disabled.]]  | |||
[[File:Extendedwatercannons.png|frame|right|A photo demonstrating ''extendedwatercannons'' enabled and disabled.]]  | |||
===Required Arguments===  | ===Required Arguments===  | ||
*'''propname:''' the name of the property to set. Possible values are:  | *'''propname:''' the name of the property to set. Possible values are:  | ||
**'''hovercars''' - equivalent of the JBGVNB cheat, and allows cars to drive on water.  | **'''hovercars''' - equivalent of the JBGVNB cheat, and allows cars to drive on water. (default: false)  | ||
**'''aircars''' - equivalent of the RIPAZHA cheat, and allows cars to fly.  | **'''aircars''' - equivalent of the RIPAZHA cheat, and allows cars to fly. (default: false)  | ||
**'''extrabunny''' - equivalent of the CJPHONEHOME or JHJOECW cheat, and allows you to bunny hop on bicycles much higher.  | **'''extrabunny''' - equivalent of the CJPHONEHOME or JHJOECW cheat, and allows you to bunny hop on bicycles much higher. (default: false)  | ||
**'''extrajump''' - equivalent of the KANGAROO cheat, and allows you to jump on foot much higher.  | **'''extrajump''' - equivalent of the KANGAROO cheat, and allows you to jump on foot much higher. (default: false)  | ||
**'''randomfoliage''' - toggle randomly generated foliage on the GTA:SA map (default: true)  | **'''randomfoliage''' - toggle randomly generated foliage on the GTA:SA map (default: true)  | ||
**'''snipermoon''' - toggle the GTA:SA easter egg, which increases the size of the moon every time you shoot it with a sniper rifle (default: false)  | **'''snipermoon''' - toggle the GTA:SA easter egg, which increases the size of the moon every time you shoot it with a sniper rifle (default: false)  | ||
**'''extraairresistance''' - toggle the vehicle speed limit on cross-country roads (default: true)  | **'''extraairresistance''' - toggle the vehicle speed limit on cross-country roads (default: true)  | ||
**{{New feature/item|3.0156|1.5.5|12286|'''underworldwarp''' - toggle warp of peds and vehicles when fall under map (default: true)}}  | **{{New feature/item|3.0156|1.5.5|12286|'''underworldwarp''' - toggle warp of peds and vehicles when fall under map (default: true)}}  | ||
**{{New feature/item|3.0160|1.5.9|21125|'''vehiclesunglare''' - toggle the vehicle sun glare effect (default: false) }}  | |||
**{{New feature/item|3.0160|1.5.9|21313| '''coronaztest''' - disable big sun lensflare effect (default: true) }}  | |||
**{{New feature/item|3.0161|1.6.0|21919| '''watercreatures''' - toggle randomly generated underwater creatures (default: true) }}  | |||
**{{New feature/item|3.0161|1.6.0|22195| '''burnflippedcars''' - toggle the vehicle to burn when upside down (default: true) }}  | |||
**{{New feature/item|3.0161|1.6.0|22199| '''fireballdestruct''' - toggle the aircraft model destruction on explosion ([[Media:FireballDestruct.jpg|preview]]) (default: true) }}  | |||
**{{New feature/item|3.0161|1.6.0|22430| '''roadsignstext''' - toggle the drawing of text on road signs. (default: true)}}  | |||
**{{New feature/item|3.0161|1.6.0|22485| '''extendedwatercannons''' - Increases the default limit of water cannons used at the same time from 3 to 30. (default: true)}}  | |||
**{{New feature/item|3.0161|1.6.0|22596| '''tunnelweatherblend''' - toggle the weather blending effect when the player is in the tunnel. (default: true)}}  | |||
**{{New feature/item|3.0161|1.6.0|22815| '''ignorefirestate''' - Allows aiming when the player is on fire and entering burning vehicles. (default: false)}}  | |||
**{{New feature/item|3.0161|1.6.0|22909| '''flyingcomponents''' - This property determines whether the detached components such as doors, bumpers, etc., should respawn after a vehicle is recreated (change model or variant) or streamed in. (default: true)}}  | |||
**{{New feature/item|3.0161|1.6.0|23223| '''vehicleburnexplosions''' - This property toggles creation of additional explosions ([[Explosion_types|type 2 - rocket]]) when plane or helicopter is burning. (default: true)}}  | |||
**{{New feature/item|3.0161|1.6.0|23237| '''vehicle_engine_autostart''' - This property toggles automatic vehicle engine state behavior. (default: true)<br>If you set it to ''false'' then vehicle engine will not start on driver enter and will not stop on driver exit. To control the engine you need to use [[SetVehicleEngineState|setVehicleEngineState]]. Helicopter rotors will spin only if the engine is on (with or without driver inside).<br>This flag also affects bikes}}  | |||
*'''enable:''' whether or not to enable the property.  | *'''enable:''' whether or not to enable the property.  | ||
| Line 25: | Line 45: | ||
==Example==  | ==Example==  | ||
'''  | This code allows you to enable/disable certain property using '''true''' or '''false'''.  | ||
<syntaxhighlight lang="lua">  | <syntaxhighlight lang="lua">  | ||
local worldSpecialProperties = {  | |||
	["hovercars"] = false,  | |||
	["aircars"] = false,  | |||
	["extrabunny"] = false,  | |||
)  | 	["extrajump"] = false,  | ||
	["randomfoliage"] = true,  | |||
	["snipermoon"] = false,  | |||
	["extraairresistance"] = true,  | |||
	["underworldwarp"] = true,  | |||
	["vehiclesunglare"] = false,  | |||
	["coronaztest"] = true,  | |||
	["watercreatures"] = true,  | |||
	["burnflippedcars"] = true,  | |||
	["fireballdestruct"] = true,  | |||
	["roadsignstext"] = true,  | |||
	["extendedwatercannons"] = true,  | |||
	["tunnelweatherblend"] = true,  | |||
	["ignorefirestate"] = false,  | |||
	["flyingcomponents"] = true,  | |||
	["vehicleburnexplosions"] = true,  | |||
	["vehicle_engine_autostart"] = true,  | |||
}  | |||
local function toggleWorldSpecialProperties()  | |||
	for propertyName, propertyState in pairs(worldSpecialProperties) do  | |||
		setWorldSpecialPropertyEnabled(propertyName, propertyState)  | |||
	end  | |||
end  | |||
addEventHandler("onClientResourceStart", resourceRoot, toggleWorldSpecialProperties)  | |||
</syntaxhighlight>  | </syntaxhighlight>  | ||
==Changelog==  | ==Changelog==  | ||
{{ChangelogHeader}}  | {{ChangelogHeader}}  | ||
{{ChangelogItem|1.5.5-3.12286|Added "underworldwarp" property}}  | {{ChangelogItem|1.5.5-3.12286|Added "underworldwarp" property}}  | ||
{{ChangelogItem|1.5.9-1.21125|Added "vehiclesunglare" property}}  | |||
{{ChangelogItem|1.5.9-9.21313|Added "coronaztest" property}}  | |||
{{ChangelogItem|1.6.0-9.21919|Added "watercreatures" property}}  | |||
{{ChangelogItem|1.6.0-9.22195|Added "burnflippedcars" property}}  | |||
{{ChangelogItem|1.6.0-9.22199|Added "fireballdestruct" property}}  | |||
{{ChangelogItem|1.6.0-9.22430|Added "roadsignstext" property}}  | |||
{{ChangelogItem|1.6.0-9.22485|Added "extenedwatercannons" property}}  | |||
{{ChangelogItem|1.6.0-9.22596|Added "tunnelweatherblend" property}}  | |||
{{ChangelogItem|1.6.0-9.22815|Added "ignorefirestate" property}}  | |||
{{ChangelogItem|1.6.0-9.22909|Added "flyingcomponents" property}}  | |||
{{ChangelogItem|1.6.0-9.23223|Added "vehicleburnexplosions" property}}  | |||
{{ChangelogItem|1.6.0-9.23237|Added "vehicle_engine_autostart" property}}  | |||
==See Also==  | ==See Also==  | ||
{{  | {{World functions}}  | ||
Latest revision as of 04:53, 31 October 2025
Enables or disables a special world property.
Syntax
bool setWorldSpecialPropertyEnabled ( string propname, bool enable )
OOP Syntax Help! I don't understand this!
- Counterpart: isWorldSpecialPropertyEnabled
 
Required Arguments
- propname: the name of the property to set. Possible values are:
- hovercars - equivalent of the JBGVNB cheat, and allows cars to drive on water. (default: false)
 - aircars - equivalent of the RIPAZHA cheat, and allows cars to fly. (default: false)
 - extrabunny - equivalent of the CJPHONEHOME or JHJOECW cheat, and allows you to bunny hop on bicycles much higher. (default: false)
 - extrajump - equivalent of the KANGAROO cheat, and allows you to jump on foot much higher. (default: false)
 - randomfoliage - toggle randomly generated foliage on the GTA:SA map (default: true)
 - snipermoon - toggle the GTA:SA easter egg, which increases the size of the moon every time you shoot it with a sniper rifle (default: false)
 - extraairresistance - toggle the vehicle speed limit on cross-country roads (default: true)
 - underworldwarp - toggle warp of peds and vehicles when fall under map (default: true)
 - vehiclesunglare - toggle the vehicle sun glare effect (default: false)
 - coronaztest - disable big sun lensflare effect (default: true)
 
 - enable: whether or not to enable the property.
 
Returns
Returns true if successful, false otherwise.
Example
This code allows you to enable/disable certain property using true or false.
local worldSpecialProperties = {
	["hovercars"] = false,
	["aircars"] = false,
	["extrabunny"] = false,
	["extrajump"] = false,
	["randomfoliage"] = true,
	["snipermoon"] = false,
	["extraairresistance"] = true,
	["underworldwarp"] = true,
	["vehiclesunglare"] = false,
	["coronaztest"] = true,
	["watercreatures"] = true,
	["burnflippedcars"] = true,
	["fireballdestruct"] = true,
	["roadsignstext"] = true,
	["extendedwatercannons"] = true,
	["tunnelweatherblend"] = true,
	["ignorefirestate"] = false,
	["flyingcomponents"] = true,
	["vehicleburnexplosions"] = true,
	["vehicle_engine_autostart"] = true,
}
local function toggleWorldSpecialProperties()
	for propertyName, propertyState in pairs(worldSpecialProperties) do
		setWorldSpecialPropertyEnabled(propertyName, propertyState)
	end
end
addEventHandler("onClientResourceStart", resourceRoot, toggleWorldSpecialProperties)
Changelog
| Version | Description | 
|---|
| 1.5.5-3.12286 | Added "underworldwarp" property | 
| 1.5.9-1.21125 | Added "vehiclesunglare" property | 
| 1.5.9-9.21313 | Added "coronaztest" property | 
| 1.6.0-9.21919 | Added "watercreatures" property | 
| 1.6.0-9.22195 | Added "burnflippedcars" property | 
| 1.6.0-9.22199 | Added "fireballdestruct" property | 
| 1.6.0-9.22430 | Added "roadsignstext" property | 
| 1.6.0-9.22485 | Added "extenedwatercannons" property | 
| 1.6.0-9.22596 | Added "tunnelweatherblend" property | 
| 1.6.0-9.22815 | Added "ignorefirestate" property | 
| 1.6.0-9.22909 | Added "flyingcomponents" property | 
| 1.6.0-9.23223 | Added "vehicleburnexplosions" property | 
| 1.6.0-9.23237 | Added "vehicle_engine_autostart" property | 
See Also
- areTrafficLightsLocked
 - getAircraftMaxHeight
 - getAircraftMaxVelocity
 - getCloudsEnabled
 - getFarClipDistance
 - getFogDistance
 - getGameSpeed
 - getGravity
 - getHeatHaze
 - getInteriorSoundsEnabled
 - getJetpackMaxHeight
 - getMinuteDuration
 - getMoonSize
 - getOcclusionsEnabled
 - getRainLevel
 - getSunColor
 - getSunSize
 - getTime
 - getTrafficLightState
 - getWeather
 - getWindVelocity
 - getSkyGradient
 - getPlayerBlurLevel
 - getZoneName
 - isGarageOpen
 - removeWorldModel
 - resetFarClipDistance
 - resetFogDistance
 - resetHeatHaze
 - resetMoonSize
 - resetRainLevel
 - resetSkyGradient
 - resetSunColor
 - resetSunSize
 - resetWindVelocity
 - restoreAllWorldModels
 - restoreWorldModel
 - setAircraftMaxHeight
 - setAircraftMaxVelocity
 - setCloudsEnabled
 - setFarClipDistance
 - setFogDistance
 - setGameSpeed
 - setGarageOpen
 - setGravity
 - setHeatHaze
 - setInteriorSoundsEnabled
 - setMinuteDuration
 - setMoonSize
 - setOcclusionsEnabled
 - setRainLevel
 - setSkyGradient
 - setSunColor
 - setSunSize
 - setTime
 - setTrafficLightState
 - setTrafficLightsLocked
 - setWeather
 - setWeatherBlended
 - setWindVelocity
 - setJetpackMaxHeight
 - setPlayerBlurLevel
 


