Skip to content

CylindricalForceVolumeInfo

Celestial Body Schema / Definitions / CylindricalForceVolumeInfo
Schema Type: JSON Type: object

No Description Found

force

Type: number

The force applied by this volume. Can be negative to reverse the direction.


alignmentPriority

Type: integer Default: 1

The priority of this force volume for the purposes of alignment.

Volumes of higher priority will override volumes of lower priority. Volumes of the same priority will stack like normal.
Ex: A player in a gravity volume with priority 0, and zero-gravity volume with priority 1, will feel zero gravity.

Default value here is 1 instead of 0 so it automatically overrides planet gravity, which is 0 by default.


inheritable

Type: boolean

Whether this force volume is inheritable. The most recently activated inheritable force volume will stack with other force volumes even if their priorities differ.


layer

Type: integer Default: 0

The layer of this volume.

Layers separate the priority system. The priority of volumes in one layer will not affect or override volumes in another. The highest priority volume in each layer will stack like normal.
The exception is layer 0. A higher-priority volume in layer 0 will override lower-priority volumes in ALL other layers. A lower-priority volume in layer 0 will stack with other layers like normal.

Ex: A player could be affected by the sun on layer 9 priority 0 and planet gravity on layer 3 priority 2. They would experience the gravity of both volumes since they are on different layers.
If there was a zero-g volume on layer 0 priority 1, since it is on layer 0 it will override the gravity from the sun (priority 0 which is less than 1) but they will still feel the
gravity of the planet (priority 2 is greater than 1). The zero-g volume will also still be applied because it is on a different layer.

Default value here is 0 which means this volume's priority will be evaluated against all other priority volumes regardless of their layer.


priority

Type: integer Default: 1

The priority of this volume.

Volumes of higher priority will override volumes of lower priority. Volumes of the same priority will stack like normal.
Ex: A player in a gravity volume with priority 0, and zero-gravity volume with priority 1, will feel zero gravity.

Default value here is 1 instead of 0 so it automatically overrides planet gravity, which is 0 by default.


radius

Type: number Default: 1

The radius of this volume, if a shape is not specified.


shape

Type: ShapeInfo

The shape of this volume. Defaults to a sphere with a radius of `radius` if not specified.

See Definitions/ShapeInfo

rotation

Type: MVector3

Rotation of the object

See Definitions/MVector3

alignRadial

Type: boolean or null

Do we try to automatically align this object to stand upright relative to the body's center? Stacks with rotation.
Defaults to true for geysers, tornados, and volcanoes, and false for everything else.


position

Type: MVector3

Position of the object

See Definitions/MVector3

isRelativeToParent

Type: boolean

Whether the positional and rotational coordinates are relative to parent instead of the root planet object.


parentPath

Type: string

The relative path from the planet to the parent of this object. Optional (will default to the root sector).


rename

Type: string

An optional rename of this object


normal

Type: MVector3

The direction that the force applied by this volume will be perpendicular to. Defaults to up (0, 1, 0).

See Definitions/MVector3

playGravityCrystalAudio

Type: boolean

Whether to play the gravity crystal audio when the player is in this volume.