Hinge Module

The hinge module allows the user to control hinges on the grid. Hinges are particularly vulnerable to phantom forces and the Almighty Clang, so we leverage the Activity Monitor to ensure hinges are stopped and locked when not in use. Players can simply define an angle and speed of rotation without worrying about direction, upper/lower limits, or their grid ripping itself apart.

Commands

rotate

Rotate a hinge or group of hinges to a specific angle between -90 degrees and 90 degrees.

hinge/rotate <Hinge|Group> <Angle> [--options]

Options

Option	Values	Unit	Description
`speed`	[-5.0, 5.0]	RPM	Set the speed of the hinge. Negative values will reverse the hinge. Default is 1 RPM.
`add`	`true`, `false`	`bool`	Indicates that the provided angle should be added to the current angle. Allows incremental changes to angle.
`sub`	`true`, `false`	`bool`	Indicates that the provided angle should be subtracted from the current angle. Allows decremental changes to angle.
`share`			Indicates that the angle should be shared across all hinges in the group. This means that if you have 3 hinges in a group and set an angle of 90 degrees with sharing enabled, each hinge will rotate to 30 degrees. If sharing is disabled, each hinge will rotate to the full 90 degrees.

Example Rotate the landing gear hinge to 90 degrees.

Terminal
hinge/rotate LandingGearHinge 90;

Reduce the angle of the landing gear hinge by 10 degrees.

Terminal
hinge/rotate LandingGearHinge 10 --sub;

Share an angle of 90 degrees across 3 hinges in the "Turret Hinges" group:

Terminal
hinge/rotate "Turret Hinges" 90 --share;

ulimit

Set the upper angle limit of a hinge or group of hinges in degrees.

hinge/ulimit <Hinge|Group> <Angle>

Example

Terminal
hinge/ulimit LandingGearHinge 45;

llimit

Set the lower angle limit of a hinge or group of hinges in degrees.

hinge/llimit <Hinge|Group> <Angle>

Example

Terminal
hinge/llimit LandingGearHinge -15;

lock

Lock a hinge or group of hinges.

hinge/lock <Hinge|Group>

Example

Terminal
hinge/lock LandingGearHinge;

unlock

Unlock a hinge or group of hinges.

hinge/unlock <Hinge|Group>

Example

Terminal
hinge/unlock LandingGearHinge;

reset

Reset a hinge or group of hinges to their original position (0 degrees).

hinge/reset <Hinge|Group>

Example

Terminal
hinge/reset LandingGearHinge;

attach

Attach the head of a hinge or group of hinges.

hinge/attach <Hinge|Group>

Example

Terminal
hinge/attach LandingGearHinge;

detach

Detach the head of a hinge or group of hinges.

hinge/detach <Hinge|Group>

Example

Terminal
hinge/detach LandingGearHinge;

speed

Set the speed of a hinge or group of hinges in RPM.

hinge/speed <hinge|Group> <Speed> <Options>

Options

Option	Values	Unit	Description
`free`	`true`, `false`	`bool`	Indicates whether the hinge should be free to rotate or not. Default is `false`.
`add`	`true`, `false`	`bool`	Indicates that the provided speed should be added to the current speed. Allows incremental changes to speed.
`sub`	`true`, `false`	`bool`	Indicates that the provided speed should be subtracted from the current speed. Allows decremental changes to speed.

Example

Set speed to 2 RPM and allow hinge to rotate freely:

Terminal
hinge/speed LandingGearHinge 2 --free;

Increase speed by 2.5 RPM:

Terminal
hinge/speed LandingGearHinge 2.5 --add;

Decrease speed by 1 RPM:

Terminal
hinge/speed LandingGearHinge 1 --sub;

Hooks

The following hooks can be define in the block's Custom Data, and will be triggered when the corresponding command is called:

Key	Trigger
`onMoving`	Activated when a hinge is put into motion by the `hinge/rotate` command.
`onStop`	Activated when a hinge stops from the `hinge/rotate` command.
`onAttach`	Activated when a hinge head is attached.
`onDetach`	Activated when a hinge head is detached.