canEnter

Triggered when a player attempts to enter a property through the pre-check callback flow.

This is executed from nolag_properties:server:property:canEnter, which runs before shell/IPL enter transition logic.

lua

{
    source = playerId,       -- The player's server ID
    propertyId = propertyId, -- Property identifier
    propertyType = type,     -- Property type: 'shell', 'ipl', or 'mlo'
    owner = ownerIdentifier, -- Current property owner identifier
    ownerType = ownerType,   -- Owner type: 'user' or 'society'
    property = propertyObj   -- ServerProperty instance
}

source (number): The server ID of the player trying to enter
propertyId (string/number): Unique identifier of the target property
propertyType (string): Type of property (shell, ipl, mlo)
owner (string): Current owner identifier
ownerType (string): Ownership context (user or society)
property (table): ServerProperty object for advanced checks

lua

exports.nolag_properties:registerHook('canEnter', function(data)
    if data.propertyType ~= 'shell' and data.propertyType ~= 'ipl' then
        return true
    end

    if not canPlayerEnterProperty(data.source, data.propertyId) then
        return false -- Cancel enter before transition starts
    end

    return true
end)

true or nil: Allow enter to continue
false: Cancel player enter flow