EngineRequestModel - Revision history

FileEX: Undo revision 81812 by Fernando187 (talk)

2025-02-17T16:05:54Z

Undo revision 81812 by Fernando187 (talk)

← Older revision		Revision as of 16:05, 17 February 2025
Line 22:		Line 22:
	{{New feature/item\|3.0158\|1.5.7\|20147\| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}		{{New feature/item\|3.0158\|1.5.7\|20147\| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}
	Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.		Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.

	~~==Ready solution==~~
	For most cases, you will probably want to add models to your server that are synced with all clients automatically. This is possible with this '''community resource''': [https://forum.multitheftauto.com/topic/133212-rel-add-new-models-library/ newmodels] created by [[User:Fernando187\|Fernando]].

	==Example==		==Example==

Fernando187: add info about newmodels resource

2025-02-17T15:13:15Z

add info about newmodels resource

← Older revision		Revision as of 15:13, 17 February 2025
Line 22:		Line 22:
	{{New feature/item\|3.0158\|1.5.7\|20147\| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}		{{New feature/item\|3.0158\|1.5.7\|20147\| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}
	Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.		Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.

			==Ready solution==
			For most cases, you will probably want to add models to your server that are synced with all clients automatically. This is possible with this '''community resource''': [https://forum.multitheftauto.com/topic/133212-rel-add-new-models-library/ newmodels] created by [[User:Fernando187\|Fernando]].

	==Example==		==Example==

FileEX: Added changelog

2025-02-16T18:59:53Z

Added changelog

← Older revision		Revision as of 18:59, 16 February 2025
Line 3:		Line 3:
	{{New feature/item\|3.0158\|1.5.7\|20147\|This function is used to assign the next available model ID to a certain element type.}}		{{New feature/item\|3.0158\|1.5.7\|20147\|This function is used to assign the next available model ID to a certain element type.}}

	{{~~note~~\|~~After release '''1.6~~.~~0 r22868'''~~ this ~~function supports "object-damageable".}}~~		{{Tip\|For most cases, you will probably want to add models to your server that are synced with all clients automatically. This is possible with this '''resource''': [https://forum.multitheftauto.com/topic/133212-rel-add-new-models-library/ newmodels]}}
	~~{{note\|Before release~~ '''~~1.5.8 r20716~~''' ~~this must be "ped"~~. ~~After release '''1.5.8 r20716''' this function supports "vehicle" and "object" too~~.}}
	{{note\|Vehicle unique features may be unsupported, see [https://github.com/multitheftauto/mtasa-blue/issues/1861 issue 1861] for examples and details}}		{{note\|Vehicle unique features may be unsupported, see [https://github.com/multitheftauto/mtasa-blue/issues/1861 issue 1861] for examples and details}}

	{{Important Note\|Unlike some other functions, the side-effects of this function aren't reverted on resource stop, so you must manually call [[engineFreeModel]] in [[onClientResourceStop]] (Just like the example below does)}}		{{Important Note\|Unlike some other functions, the side-effects of this function aren't reverted on resource stop, so you must manually call [[engineFreeModel]] in [[onClientResourceStop]] (Just like the example below does)}}
	==Syntax==		==Syntax==
Line 21:		Line 22:
	{{New feature/item\|3.0158\|1.5.7\|20147\| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}		{{New feature/item\|3.0158\|1.5.7\|20147\| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}
	Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.		Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.

	~~==Ready solution==~~

	For most cases, you will probably want to add models to your server that are synced with all clients automatically. This is possible with this '''community resource''': [https://forum.multitheftauto.com/topic/133212-rel-add-new-models-library/ newmodels] created by [[User:Fernando187\|Fernando]].

	==Example==		==Example==
Line 61:		Line 58:
	addEventHandler("onClientResourceStop", resourceRoot, onStop)		addEventHandler("onClientResourceStop", resourceRoot, onStop)
	</syntaxhighlight>		</syntaxhighlight>

			==Changelog==
			{{ChangelogHeader}}
			{{ChangelogItem\|1.5.8-1.20716\|Added support for '''vehicle''' and '''object''' types.}}
			{{ChangelogItem\|1.6.0-9.22868\|Added support for '''object-damageable''' type.}}

	==See Also==		==See Also==
	{{Engine functions}}		{{Engine functions}}

Fernando187: add info about newmodels resource

2025-02-14T11:22:57Z

add info about newmodels resource

← Older revision		Revision as of 11:22, 14 February 2025
Line 2:		Line 2:
	{{Client function}}		{{Client function}}
	{{New feature/item\|3.0158\|1.5.7\|20147\|This function is used to assign the next available model ID to a certain element type.}}		{{New feature/item\|3.0158\|1.5.7\|20147\|This function is used to assign the next available model ID to a certain element type.}}

	{{note\|After release '''1.6.0 r22868''' this function supports "object-damageable".}}		{{note\|After release '''1.6.0 r22868''' this function supports "object-damageable".}}
	{{note\|Before release '''1.5.8 r20716''' this must be "ped". After release '''1.5.8 r20716''' this function supports "vehicle" and "object" too.}}		{{note\|Before release '''1.5.8 r20716''' this must be "ped". After release '''1.5.8 r20716''' this function supports "vehicle" and "object" too.}}
Line 20:		Line 21:
	{{New feature/item\|3.0158\|1.5.7\|20147\| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}		{{New feature/item\|3.0158\|1.5.7\|20147\| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}
	Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.		Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.

			==Ready solution==

			For most cases, you will probably want to add models to your server that are synced with all clients automatically. This is possible with this '''community resource''': [https://forum.multitheftauto.com/topic/133212-rel-add-new-models-library/ newmodels] created by [[User:Fernando187\|Fernando]].

	==Example==		==Example==

TheNormalnij: There is no parentId limits

2025-01-05T14:48:40Z

There is no parentId limits

← Older revision		Revision as of 14:48, 5 January 2025
Line 15:		Line 15:
	===Optional Arguments===		===Optional Arguments===
	*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects, 994 - damageable objects).		*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects, 994 - damageable objects).
	{{Important Note\|~~Here is~~ the ~~parentID limit for each element~~ type~~:<br>~~		{{Important Note\|parentID should be the same model type to prevent crashes.}}
	*'''ped''': 0 - 26315
	*'''vehicle''': 400 - 611
	*'''object''': 615 - 11681
	*'''timed-object''': 615 - 11681
	*'''clump''': 615 - 11681
	~~If you try~~ to ~~use higher values than the limit, your client may crash~~.}}

	===Returns===		===Returns===

TheNormalnij at 14:44, 5 January 2025

2025-01-05T14:44:39Z

← Older revision		Revision as of 14:44, 5 January 2025
Line 2:		Line 2:
	{{Client function}}		{{Client function}}
	{{New feature/item\|3.0158\|1.5.7\|20147\|This function is used to assign the next available model ID to a certain element type.}}		{{New feature/item\|3.0158\|1.5.7\|20147\|This function is used to assign the next available model ID to a certain element type.}}
			{{note\|After release '''1.6.0 r22868''' this function supports "object-damageable".}}
	{{note\|Before release '''1.5.8 r20716''' this must be "ped". After release '''1.5.8 r20716''' this function supports "vehicle" and "object" too.}}		{{note\|Before release '''1.5.8 r20716''' this must be "ped". After release '''1.5.8 r20716''' this function supports "vehicle" and "object" too.}}
	{{note\|Vehicle unique features may be unsupported, see [https://github.com/multitheftauto/mtasa-blue/issues/1861 issue 1861] for examples and details}}		{{note\|Vehicle unique features may be unsupported, see [https://github.com/multitheftauto/mtasa-blue/issues/1861 issue 1861] for examples and details}}
Line 10:		Line 11:
	</syntaxhighlight>		</syntaxhighlight>
	===Required Arguments===		===Required Arguments===
	*'''elementType''': "ped", "vehicle", "object", "timed-object", "clump"		*'''elementType''': "ped", "vehicle", "object", "timed-object", "clump", "object-damageable"

	===Optional Arguments===		===Optional Arguments===
	*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects).		*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects, 994 - damageable objects).
	{{Important Note\|Here is the parentID limit for each element type:<br>		{{Important Note\|Here is the parentID limit for each element type:<br>
	*'''ped''': 0 - 26315		*'''ped''': 0 - 26315

Fernando187: Remove obsolete Requirements section

2024-11-07T17:14:50Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:14, 7 November 2024
Line 61:		Line 61:
	addEventHandler("onClientResourceStop", resourceRoot, onStop)		addEventHandler("onClientResourceStop", resourceRoot, onStop)
	</syntaxhighlight>		</syntaxhighlight>

	~~==Requirements==~~
	~~{{Requirements\|n/a\|1.5.7-9.20147\|}}~~

	==See Also==		==See Also==
	{{Engine functions}}		{{Engine functions}}

LordHenry: Limit warning.

2024-02-07T20:02:45Z

Limit warning.

← Older revision		Revision as of 20:02, 7 February 2024
Line 10:		Line 10:
	</syntaxhighlight>		</syntaxhighlight>
	===Required Arguments===		===Required Arguments===
	*'''elementType''': "ped", "~~object~~", "~~vehicle~~", "timed-object", "clump"		*'''elementType''': "ped", "vehicle", "object", "timed-object", "clump"

	===Optional Arguments===		===Optional Arguments===
	*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects).		*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects).
			{{Important Note\|Here is the parentID limit for each element type:<br>
			*'''ped''': 0 - 26315
			*'''vehicle''': 400 - 611
			*'''object''': 615 - 11681
			*'''timed-object''': 615 - 11681
			*'''clump''': 615 - 11681
			If you try to use higher values than the limit, your client may crash.}}

	===Returns===		===Returns===

CrosRoad95 at 10:13, 3 September 2023

2023-09-03T10:13:16Z

← Older revision		Revision as of 10:13, 3 September 2023
Line 10:		Line 10:
	</syntaxhighlight>		</syntaxhighlight>
	===Required Arguments===		===Required Arguments===
	*'''elementType''': "ped", "vehicle" or "object".		*'''elementType''': "ped", "object", "vehicle", "timed-object", "clump"

	===Optional Arguments===		===Optional Arguments===
	*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds).		*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects).

	===Returns===		===Returns===

Pirulax: Add note about having to call engineFreeModel in onClientResourceStop

2023-08-26T18:02:05Z

Add note about having to call engineFreeModel in onClientResourceStop

← Older revision		Revision as of 18:02, 26 August 2023
Line 4:		Line 4:
	{{note\|Before release '''1.5.8 r20716''' this must be "ped". After release '''1.5.8 r20716''' this function supports "vehicle" and "object" too.}}		{{note\|Before release '''1.5.8 r20716''' this must be "ped". After release '''1.5.8 r20716''' this function supports "vehicle" and "object" too.}}
	{{note\|Vehicle unique features may be unsupported, see [https://github.com/multitheftauto/mtasa-blue/issues/1861 issue 1861] for examples and details}}		{{note\|Vehicle unique features may be unsupported, see [https://github.com/multitheftauto/mtasa-blue/issues/1861 issue 1861] for examples and details}}
			{{Important Note\|Unlike some other functions, the side-effects of this function aren't reverted on resource stop, so you must manually call [[engineFreeModel]] in [[onClientResourceStop]] (Just like the example below does)}}
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">