Multiseat

Local multiplayer input assignment. Maps input devices (keyboards, gamepads) to player slots and seats players into vehicles. Supports up to 64 simultaneous players.

Public Functions

Device Assignment Rules

• Keyboard and mouse are always assigned to player 0
• Each additional controller (xinput, etc.) gets the next player number
• Player count = min(maxPlayers, controllerCount)
• Wraps around when more controllers than vehicles

Usage Example

-- Get current device-to-player mapping
local devices = WinInput.getRegisteredDevices()
local assignments = core_multiseat.getAssignedPlayers(devices, true, true)
-- Result: { keyboard0 = 0, mouse0 = 0, xinput0 = 1, xinput1 = 2 }

-- Cycle player 1 to the next vehicle
core_multiseat.enterNextVehicle(1)

Seating Logic

When seatPlayers is true and multiseat mode is active:

1. Count seats used per vehicle
2. Find players without vehicles ("on foot")
3. Assign on-foot players to the least-occupied vehicle
4. Players beyond the controller count are exited from vehicles

Action Map

The MultiseatActionMap is pushed/popped based on the multiseat setting:

• Enabled: Pushes the multiseat action map
• Disabled: Pops it

Notes

• Max players is hardcoded at 64 (matching the steering fast-path limit in the engine).
• When not in multiseat mode, max players is 1.
• Non-player-0 controllers can be unassigned (cycled to false via enterNextVehicle).
• Uses assignPlayerToDevice() engine binding for low-level assignment.

See Also

• multiseatCamera - Camera for multiseat view
• virtualInput - Virtual input devices