server/commands - Camera & Input Commands

Reference for server/commands.lua. Provides camera management functions - switching between free/game cameras, positioning, and deprecated global camera accessors.

Exports

Deprecated Global Functions

These exist for backward compatibility and log deprecation warnings:

• setCameraPosRot(), setCameraFovDeg/Rad/(), getCameraPosition(), getCameraUp(), getCameraRight(), getCameraForward(), getCameraQuat(), getCameraFovDeg/Rad/()

All redirect to core_camera.* equivalents.

Internals

• Camera object: The game camera is scenetree.findObject("gameCamera"), a scene object managed by the render view system.
• Free camera: Uses core_camera.setByName(0, 'free') - retains current position/rotation.
• Vehicle drop: dropPlayerAtCamera computes rotation from camera forward vector (zeroing Z for level orientation), then uses vehicleSetPositionRotation.
• No-reset drop: dropPlayerAtCameraNoReset uses setClusterPosRelRot to move the vehicle cluster without resetting physics, preserving damage/deformation state.

How It Works

Camera management is split between this module (high-level operations) and core_camera (low-level state). This module handles the user-facing operations like toggling cameras, placing vehicles, and providing backward-compatible global functions.

-- Toggle to free camera
commands.setFreeCamera()

-- Check mode
if commands.isFreeCamera() then
  -- Move vehicle to where camera is looking
  commands.dropPlayerAtCamera(0)
end

-- Get camera transform for serialization
local json = commands.getCameraTransformJson()
-- Returns: "[100.50, 200.30, 50.00, 0, 0, 0.707, 0.707]"

Exported Variables

• getGame - Exported variable - initialized as getGame -- retrocompat
• onSettingsChanged - Exported variable - initialized as onSettingsChanged
• setCameraFree - Exported variable - initialized as setFreeCamera -- retrocompat
• setCameraPlayer - Exported variable - initialized as setGameCamera -- retrocompat