• Created for fabric 1.17 (Might backport later)
• Work in progress

---

Overview

Adds 6 directional gravity to entities, dimensions, and fields with a variable strength, time, reference gravity, and rules.

Directions defaults to Down and includes: Up, Down, North, East, South, and West.

Strength defaults to 1 and acts differently depending if the value is positive, negative, or zero. Generally, strength values closer to zero are weaker and those further from zero are stronger, while a strength of zero prevents movement. Negative gravity values act as antigravity and repel entities while keeping their direction intact, and thus an entitiy with an upwards gravity of -1 strength would visually appear like Dinnerbone does.

Time defaults to -1 (Permanent), and is measured in ticks. For entities, gravity will revert to the default upon running out.

Reference Gravity does not exist by default and is another instance of Gravity that the current gravity is relative to. (VERY Work in progress)

Rules are only for dimensions and Fields, and allow Gravity to act in special ways, such as inverting based on coordinates or changing to something else whenever the time runs out. (Work in progress)

Adds Fields, which are essentially boxes that store extra information, and thanks to CCA, can apply components such as gravity. (This means a field can apply any CCA component, not just gravity, although it was designed such that it is most useful for gravity)

Also attempts to fix MC-119369 by making the behavior of falling boats consistent.

---

Future Plans:

• Special gravity effects for swimming and riptide such that swimming in zero gravity unlocks the pitch rotation of the camera.
• Per dimension config for gravity. (Would allow for something like: higher gravity in the nether and lower gravity in the end, and the required changes might make clothconfig unnessesary)
• Priority levels for gravity fields (Gravity fields will overwrite dimension specific gravity by default)
• Priority levels for entity gravity (Gravity fields will overwrite entity gravity by default) [Higher priority on entity gravity would result in an entity ignoring the gravity field, an equal priority would make the gravity relative to the gravity field, and a lower priority on on entity gravity would result in the gravity field replacing the entity's gravity]
• Completing relative gravity :)
• Make translations work

---

Extra Information: (Constantly Changing)

Command Syntax: (Currently Work in progress; All commands with type are not implemented and reference has been left out)

/gravity <get, reset, rotate, set> <target> ...

/gravity <get, reset, rotate, set> <target> [<type>] ...

/gravity get <target> [<attribute>]

/gravity get <target> [<type>] [<attribute>]

/gravity reset <target> [<attribute>]

/gravity reset <target> [<type>] [<attribute>]

/gravity rotate <target> <rotation> [<time>]

/gravity rotate <target> <type> <rotation> [<time>]

/gravity set <target> <direction> [<strength>] [<time>] [<reference>]

/gravity set <target> <strength> [<time>|<reference>]

/gravity set <target> <reference>

/gravity set <target> <attribute> (<direction>|<strength>|<time>|<reference>)

/gravity set <target> <type> <direction> [<strength>] [<time>] [<reference>]

/gravity set <target> <type> <strength> [<time>|<reference>]

/gravity set <target> <type> <reference>

/gravity set <target> <type> <attribute> (<direction>|<strength>|<time>|<reference>)

Command Arguments:

<target> = (entity <target>|block <targetPos>)

<type> = (base, target, motion, drops, projectiles, special)

<attribute> = (direction, strength, time, reference)

<direction> = (UP, DOWN, NORTH, EAST, SOUTH, WEST)

<strength> = (float <value>)

<time> = (int <ticks>)

<reference> = (entity <target>|block <targetPos>|dimension <id>)

<rotation> = (forward, backwards, left, right)

Gravity Types:

base - all other types combined

target - the gravity used for rendering, hitbox rotation, camera rotation, eye height, aim, etc.

motion - the gravity used for movement of the entity/block

drops - the gravity of items dropped by the entity/block

projectiles - the gravity of projectiles shot by the entity/block

special - the gravity of other entities in special cases where an entity/block's gravity is tied to another's (entities with the same gravity as the nearest player or the opposite gravity of a random player for example)

Special Cases:

/gravity reset <target> time - refreshes the remaining time of the currently applied gravity back to it's maximum

In general, block entities will only be affected by direction, as such strength and time will not be an option if a coordinate is chosen as the target.