Entity::freezePosition: Difference between revisions

From RAGE Multiplayer Wiki
No edit summary
Line 1: Line 1:
{{ClientsideJsFunction}}
{{JSContainer|
===Required Params===
*'''toggle:''' {{RageType|boolean}} — A boolean value indicating whether to freeze (true) or unfreeze (false) the entity's position.
===Return value===
*'''void''' — This function does not return a value.


==Syntax==
==Syntax==
<syntaxhighlight lang="javascript">entity.freezePosition(toggle);</syntaxhighlight>
=== Required Arguments ===
*'''toggle:''' Boolean
===Return value===
*'''Undefined'''
==Example==
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
// Freeze player position on pressing F2 key
// Function to freeze the player's position
let freeze = false;
function freezePlayerPosition(toggle) {
mp.keys.bind(0x71, true, function() {
     let player = mp.players.local; // Reference to the local player
     freeze = !freeze;
    player.freezePosition(toggle); // Freeze or unfreeze the player's position
    mp.players.local.freezePosition(freeze);
     mp.gui.chat.push("Player position " + (toggle ? "frozen" : "unfrozen") + ".");
     mp.gui.chat.push(`FreezePosition status: ${freeze}`);
}
 
// Bind the function to the "E" key
mp.keys.bind(69, false, function() { // 69 is the key code for "E"
    let isFrozen = player.isPositionFrozen; // Check if the player's position is already frozen
    freezePlayerPosition(!isFrozen); // Toggle freeze state
});
});
</syntaxhighlight>
</syntaxhighlight>
}}
==See also==
==See also==
{{Entity_definition_c}}
{{Entity_functions_c}}
[[Category:Clientside API]]
[[Category:Clientside API]]
[[Category:TODO: Example]]
[[Category:TODO: Example]]

Revision as of 22:12, 6 October 2024

Client-Side
Function

 JavaScript



JavaScript Syntax


Required Params

  • toggle: boolean — A boolean value indicating whether to freeze (true) or unfreeze (false) the entity's position.

Return value

  • void — This function does not return a value.

Syntax

// Function to freeze the player's position
function freezePlayerPosition(toggle) {
    let player = mp.players.local; // Reference to the local player
    player.freezePosition(toggle); // Freeze or unfreeze the player's position
    mp.gui.chat.push("Player position " + (toggle ? "frozen" : "unfrozen") + ".");
}

// Bind the function to the "E" key
mp.keys.bind(69, false, function() { // 69 is the key code for "E"
    let isFrozen = player.isPositionFrozen; // Check if the player's position is already frozen
    freezePlayerPosition(!isFrozen); // Toggle freeze state
});


See also

Retrieved from "https://wiki.rage.mp/w/index.php?title=Entity::freezePosition&oldid=26769"