Gravity Unit

Block is 1 meter in diameter and 1/8m in width

**Gravity Units** are systems blocks that create artificial gravity on an entity.

## Overview

Designed to apply gravity to any entity that players create, all entities with an interior should require one.

Gravity units are in use all across the Galaxy. NPCs will use them extensively in their Stations and Ships.

### Setup

When selected in the toolbar, gravity units will display the default direction that it will apply gravity with an arrow.

Gravity units can be placed on any entity. They can not be scaled or stretched and come in one size. They require a small amount of energy to function and will produce a small amount of heat. When selected on the toolbar, the gravity unit will display a large arrow on its placement ghost. This arrow indicates the default direction that it will apply gravity. Once placed, the gravity unit automatically activates and generates a gravity field. Having a gravity unit selected on the hot bar also allows players to see the gravity boundaries of all gravity units in the vicinity.

Pressing **[F]** on the gravity unit will bring up the unit menu. This menu allows players to alter the way the gravity field works. The field type will change the range of the gravity field. By default, it is set at **"Bounds."** The affecting area is bounded by the dimension inputs of the min/max bounds. The maximum allowable inputs in all three dimensions are 16 units in positive and negative numbers. The alternative setting is **"Ship-Wide."** This mode will instead make the gravity unit apply its field to the entirety of the entity's dimensions. The setting has a significantly more extensive range than the "bounds" setting and is intended for ship-wide gravity generation.

The final setting is the "Strength (in g)" stat. This parameter affects the direction and intensity of the gravitational force applied to entities within the gravity unit's range. The default setting will depend on the gravity unit's orientation. Each input field will affect the direction in that gravity is applied. Gravitational force is measured in "G"s, and 1g is enough to keep the player planted onto a surface. Causing objects to fall faster and restricting the player's ability to jump, increasing that number will intensify the force of gravity. The player's ability to walk and run in high G fields will mostly be unaffected. Players can mitigate gravity entirely by activating their jetpacks.

### Usage

Once placed on an entity, the gravity unit will immediately generate a strong gravitational field around itself. Entities entering this field will be forced into the direction that the gravity unit is applying. Players who enter will automatically be reoriented toward the gravity unit's "Ground" even if they have activated their jetpacks. Gravity will pull larger entities like Ships and Hovercrafts in the direction of gravity's flow, provided they lack a Starter Block. Entities with starter blocks will be unaffected by the gravity well of another entity.

Gravity is immensely helpful for ships large and small as it can prevent players and vessels from being left behind should they somehow get ejected from them. As long as entities stay within the boundaries of a gravity unit, then they will always be subject to its influence. Entities that leave the gravity boundaries will be free and operate as they do in the void. Players that stay within the bounds of a gravity unit will be "attached" to the entity that hosts it. Players will move with the entity even as it flies through space.

Small items such as ore chunks and Handhelds are affected by the force of gravity generated by gravity units. They, much like players, will fall towards the "ground" when entering the gravity boundaries. They can be picked up and moved around freely by the player or any other entity. This aspect of gravity units plays a heavy role in crafting as raw materials will need to move to and from the various crafting units.

### Menu

The three input fields correspond to the XYZ axis.
 **Field Type** | Effects the range gravity is applied to the entity.
* **Bounds**-Uses the min/max bounds inputs. Has limited range.
 **Strength (in g)** | Effects the intensity of the force of gravity as well as the direction it is applied.

## Logic

   Slider | Adjusts Strength (in g) stat threshold.

## Tips

* Gravity units can be configured to be just like Jump Pads.
	+ However, since gravity units are designed to reorient players, the effect is not as optimal.
* Since Logic can turn Gravity units off and on, players can create all kinds of creative gravity contraptions.
	+ Gravity elevators are a handy alternative to mechanism-based ones.
	+ "Tractor Beams" can be made with the correct configuration.
* Multiple overlapping Gravity Units can stack their gravitational pull.
* The gravity well of Gravity Units are only applied within the dimensions of an entity. If a gravity well bleeds through the entity boundaries then it will not attract objects.
	+ "Tractor Beam" setups require this aspect of gravity units in order to work. A potential work around for this is to use Logic Fields to extend an entity's boundaries while allowing everything to pass through it.
* The minimum amount of Gs that the Gravity Unit can be set to and still attract objects is 0.01gs. The maximum is 10,000gs.
	+ The lowest Gs that the Gravity Unit can be set to is 0.001 however its effects are equal to that of 0gs
* Gravity units can be used to create gravity catapults for Players, Hovercrafts, and unmanned Ships lacking Starter Blocks.