Player Management

Handling players -- connecting, spawning, identifying, and occasionally removing them -- is a core part of any multiplayer world. Here's how HELIX gives you control over the player lifecycle.

Player Connections

When a player connects to your world, the server fires an event you can hook into. This is where you set up their character, load their data, or send them a welcome message.

Blueprint

Blueprint— Handle new player login: spawn and possess a characterScroll to zoom · Drag to pan · Drag nodes to move

Lua

-- Listen for new player connections
RegisterServerEvent('HEvent:PlayerReady', function(player)
    -- Player is ready to play
    print("Player connected: " .. player:GetName())
end)

JavaScript

// JavaScript uses the endpoint/call model for server communication.
// Player lifecycle events are handled through Lua or Blueprint.
// Use Helix.server() and Helix.endpoint() for server-side logic.
Helix.server(async () => {
    // Register endpoints for player-related actions
    Helix.endpoint('player:getData', async (helixId) => {
        const data = await loadPlayerData(helixId);
        return data;
    });
});

Getting Player Info

Every connected player has a unique ID, a display name, and various properties you can query.

Blueprint

Blueprint— Get player name, ID, and pingScroll to zoom · Drag to pan · Drag nodes to move

Lua

-- Access player info
local name = player:GetName()
local ping = player:GetPing()
local is_local = player:IsLocalPlayer()

print(name .. " - Ping: " .. ping .. "ms")

JavaScript

// Access player info via Helix JS
const id = Helix.Player.helixId();
// Use endpoints to request player data from the server
const data = await Helix.call('player:getInfo', id.toString());

Iterating Over Players

Need to loop through everyone online? Maybe for a scoreboard, or to apply an effect to all players:

Blueprint

Blueprint— Loop through all connected playersScroll to zoom · Drag to pan · Drag nodes to move

Lua

-- Get all connected players
local all_players = HPlayer:GetAll()

for _, p in ipairs(all_players) do
    print(p:GetName() .. " is online")
end

JavaScript

// JavaScript: use an endpoint to get player list from the server
const players = await Helix.call('player:getAll');

Kicking Players

Sometimes you need to remove someone -- whether it's for bad behavior or because the round ended.

Blueprint

Blueprint— Kick a player with a reason messageScroll to zoom · Drag to pan · Drag nodes to move

Lua

-- Kick a player from the server
player:Kick("Kicked by admin")

JavaScript

// Kick a player from the server
player.Kick("Kicked by admin");

Disconnect Handling

Don't forget to clean up when players leave. Destroy their character, save their data, and free up resources.

Blueprint

Blueprint— Save player data on disconnectScroll to zoom · Drag to pan · Drag nodes to move

Lua

RegisterServerEvent('HEvent:PlayerUnloaded', function(player)
    print(player:GetName() .. " disconnected")
    -- Save data, clean up resources
    SavePlayerData(player)
end)

JavaScript

// Player lifecycle events are handled through Lua or Blueprint.
// Use Helix.endpoint() on the server to persist player data
// when called from client-side disconnect handlers.

Always handle disconnects gracefully -- players can drop unexpectedly due to network issues, not only from intentional logouts.