PlayerEnterColshape: Difference between revisions

From RAGE Multiplayer Wiki
m (mistyped category)
No edit summary
Line 3: Line 3:
Default dimension for Colshapes is 0, and the player must be in the same dimension as the Colshape for them to collide.
Default dimension for Colshapes is 0, and the player must be in the same dimension as the Colshape for them to collide.
{{ServersideCsJsEvent}}
{{ServersideCsJsEvent}}
{{CSharpContainer|1=
See [https://wiki.gtanet.work/index.php?title=OnPlayerEnterColShape on GTA Network Wiki].
}}


{{JSContainer|
{{JSContainer|
{{Parameters}}
{{Parameters}}
* '''player''' - player which entered the colshape
* '''player''': {{RageType|Player}} - The player which entered the colshape
* '''shape''' - the colshape the player entered
* '''shape''': {{RageType|ColShape}} - The [[:Category:ColShape API|colshape]] the player entered


{{Example}}
{{Example}}
Line 34: Line 38:


{{Example}}
{{Example}}
<syntaxhighlight lang="c#">
<syntaxhighlight lang="csharp">
Events.OnPlayerEnterColshape += OnPlayerEnterColshape;
Events.OnPlayerEnterColshape += OnPlayerEnterColshape;
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="c#">
<syntaxhighlight lang="csharp">
public void OnPlayerEnterColshape(RAGE.Elements.Colshape colshape, RAGE.Events.CancelEventArgs cancel)
public void OnPlayerEnterColshape(RAGE.Elements.Colshape colshape, RAGE.Events.CancelEventArgs cancel)
{
{
Line 46: Line 50:


{{JSContainer|
{{JSContainer|
{{Parameters}}
* '''shape''': {{RageType|ColShape}}
{{Example}}
<pre>
<pre>
mp.events.add('playerEnterColshape', (shape) => {
mp.events.add('playerEnterColshape', (shape) => {

Revision as of 12:40, 23 May 2019

This event is triggered when a player enters a colshape.

Default dimension for Colshapes is 0, and the player must be in the same dimension as the Colshape for them to collide.

Server-Side
Event

 C#  JavaScript




C# Syntax


JavaScript Syntax

Parameters

  • player: Player - The player which entered the colshape
  • shape: ColShape - The colshape the player entered

Example

let someColShape = mp.colshapes.newRectangle(0, 0, 100, 100);

function playerEnterColshapeHandler(player, shape) {
  if(shape == someColShape) {
    console.log(`${player.name} entered the colshape`);
  }
}

mp.events.add("playerEnterColshape", playerEnterColshapeHandler);


Client-Side Event

 C#  JavaScript


C# Syntax

public delegate void OnPlayerEnterColshapeDelegate(Colshape colshape, CancelEventArgs cancel);

Parameters

  • colshape: colshape, expects RAGE.Elements.Colshape type.
  • cancel: cancel, expects RAGE.Events.CancelEventArgs type.

Example

Events.OnPlayerEnterColshape += OnPlayerEnterColshape;
public void OnPlayerEnterColshape(RAGE.Elements.Colshape colshape, RAGE.Events.CancelEventArgs cancel)
{
    RAGE.Chat.Output($"You entered colshape id:{colshape.Id}");
}


JavaScript Syntax

Parameters

  • shape: ColShape

Example

mp.events.add('playerEnterColshape', (shape) => {
    mp.game.graphics.notify(`You entered a colshape with id "${shape.id}".`);
});


See also

Checkpoint

Colshape

Entity

Player

Streaming

Vehicle

Waypoint