API ReferenceGE ExtensionscorecameraModes
Camera Mode: Big Map
Top-down camera for the big map overview. Supports mouse drag panning, scroll zoom with cursor anchoring, WASD movement, and map boundary clamping.
Top-down camera for the big map overview. Supports mouse drag panning, scroll zoom with cursor anchoring, WASD movement, and map boundary clamping.
Class API
| Method | Signature | Description |
|---|---|---|
C:init | () | Initializes with default FOV range, angle, movement speed |
C:reset | () | Resets manual zoom |
C:setLevelProperties | () | Re-initializes for current level |
C:onCameraChanged | (focused) | Adjusts vehicle render distance; resets zoom |
C:setCustomData | (data) | Sets initial camera pose and look-at point |
C:zoom | (value) | Handles scroll wheel zoom with cursor anchoring |
C:getZoomStage | (fov) | Returns zoom stage (0, 0.5, or 1) for icon sizing |
C:update | (data) | Applies position, rotation, zoom, panning, boundary clamping |
C:onMouseButton | (buttonDown, mouseDragging) | Starts/stops mouse drag panning |
C:onSerialize | () | Serializes map boundaries |
C:onDeserialized | () | Restores map boundaries as Box3F |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
isGlobal | boolean | true | Singleton global camera |
fovMin | number | 25 | Minimum FOV (max zoom in) |
fovMax | number | 42 | Maximum FOV (min zoom) |
movementSpeed | number | 20 | WASD movement base speed |
nearClipValue | number | 100 | Near clip for high-altitude rendering |
mapBoundaries | Box3F | nil | Level extents for position clamping |
Zoom Behavior
- Scroll wheel zooms with cursor anchoring (camera shifts to keep mouse point stable)
- Zoom speed ramps up with continued scrolling (
stopZoomingcounter) - Three discrete zoom stages control icon merge radius via
freeroam_bigMapMode
Movement
- WASD/arrow keys move camera in screen-relative directions
- Speed scales with map size and current zoom level
- Mouse drag (left button) pans the camera
Usage Examples
-- Activated by the big map system
core_camera.setGlobalCameraByName("bigMap", false, {
initialCamData = { pos = vec3(0, 0, 500), rot = someQuat }
})
-- Big map sets boundaries externally:
-- camera.mapBoundaries = levelBBoxSee Also
- Camera Mode: Autopoint - Related reference
- Camera Mode: Autozoom - Related reference
- Camera Mode: Chase - Related reference
- Core Systems Guide - Guide
Camera Mode: Autozoom
Filter camera that automatically adjusts FOV based on distance to target. Uses discrete zoom steps with smooth transitions, plus user zoom override via numpad 9/3.
Camera Mode: Chase
Third-person chase camera that follows vehicle direction with automatic forward/backward switching. Features smoothed direction tracking, configurable roll smoothing, and collision detection.