OnPlayerDimensionChange

onPlayerDimensionChange

AVAILABLE FROM UPDATE 0.1.8

This event is available in G1R:MP 0.1.8 and later. The contract below includes the compatibility guarantees introduced in that update.

Emitted after an actual successful server-side dimension change of a player.

Availability

This event is available in server-side scripts.

Callback signature

function(playerId, oldDimension, newDimension)

Parameters

Name	Type	Description
playerId	number	Numeric ID of the connected player.
oldDimension	number	Previous dimension.
newDimension	number	New dimension accepted by the server.

Examples

addEventHandler("onPlayerDimensionChange", root,
    function(playerId, oldDimension, newDimension)
        outputDebugString("Dimension " .. oldDimension .. " -> " .. newDimension)
    end)

Notes

• Available since 0.1.8 / Protocol 40. Both client and server must update together.
• Register on root. This is a server-local event, not a client rendering or transition-readiness acknowledgement.
• Not emitted for an unchanged dimension, rejected setter, initial spawn or ordinary connection.
• See Character dimensions. Avoid unbounded recursive dimension changes inside this handler.