Gravity Helper

GravityHelper

A Celeste mod for controlling gravity in realtime (yes, actually real GravityHelper).

How does it work?

Madeline's Speed vector always represents the direction to the floor, regardless of gravity. This means that while inverted, her Speed.Y will be the opposite sign of her actual velocity as displayed in CelesteTAS. It was done this way to ensure that any tech will work on the ceiling since the game thinks it's the floor, and most third-party mods "just work".

The majority of hooks in GravityHelper (over 100!) are for entity interaction compatibility, or to ensure that collisions are done in the correct direction and from the correct corner of the hitbox.

Implementing floor and corner correction were tricky, since it needs to check collisions in the opposite direction to movement and nudge Madeline in the opposite direction she would normally go.

The biggest hurdle by far was implementing dash correction on upside-down jumpthrus (both MaxHelpingHand's and GravityHelper's own). It's possible that there are still slight inconsistencies with it.

What happens when gravity flips?

Any Entity that supports inverted gravity will have a tracked GravityComponent that indicates how GravityHelper should perform the flip. The default procedure is:

1. The Entity's position is moved to the opposite side of the current hitbox (this means it could be stuck in the ceiling or floor).
2. The hitbox is moved such that it has the same absolute coordinates as it did prior to the flip (hopefully unsticking it).
3. Sprites are moved and flipped to correspond to the new position and direction.
4. If the entity is an Actor, the Y component of the Speed property (if it exists) is inverted so that momentum is preserved.

A GravityComponent can be added to any entity to allow it to flip visually on demand, but movement will only be affected for Actors that provide an UpdateSpeed action.

Grabbing a Holdable while inverted will also invert that entity, even if you then release it. Gravity for that entity will reset after a short period of time (default is 2 seconds), but is configurable with a BehaviorGravityController.

Adding a GravityListener component to an entity will trigger an action when gravity changes for Madeline or another entity. This can be filtered by type using GravityListener(typeof(SomeEntity)) or for a specific entity with GravityListener(someEntity). There is a convenience PlayerGravityListener class that will specifically listen for changes to Madeline's gravity.

There is also a TriggerComponent component that acts in a similar way to Trigger entities but adds support for collisions with any entity. A GravityTriggerComponent is provided that will set the gravity on a supported entity. This is currently only used by GravityTrigger and GravityField.

How do I make my entities support GravityHelper?

To add support for GravityHelper, add a GravityComponent to your entity that implements the following actions. Note that these will be executed in the order listed.

• UpdatePosition: Update the position of the entity.

By default this will move the entity to the opposite side of the current Collider.

• UpdateColliders: Update the position and size of any colliders in your entity.

By default this will move the current Collider such that Top = -Bottom, restoring the absolute bounds that were affected by UpdatePosition. This also applies to Holdable.PickupCollider.

• UpdateSpeed: Required for Actors that have a speed affected by gravity.

Update the Speed property (or similar) to invert the Y component and multiply by MomentumMultiplier. Actors do not have a common interface for this property, so it needs to be done manually.

• UpdateVisuals: Update the position and scaling of any sprites etc. in your entity. GravityHelper cannot safely guess this.

Which Celeste actors are supported?

• Player (of course).

• TheoCrystal

• Glider (jellies)

Which third party entities/mods are already supported?

Extended Variants

• "Dash trail all the time" is correctly supported while inverted.

FancyTileEntities

• FancyFallingBlock

FrostHelper

• CustomSpring

Hyperline

• It just works, no changes required.

MaddyCrown

• Crowns are rendered in the correct place and upside-down.

MaxHelpingHand

• UpsideDownJumpThru

OutbackHelper

• Portal

SpeedrunTool

• Gravity is correctly maintained between save states.

Crowneline

• It just works, no changes required.

Cateline

• Added hooks to correctly invert the tail. Also fixes the missing tail trail.

What entities/triggers are provided?

All entities provided follow a common theme of blue = normal, red = inverted, purple = toggle.

GravityTrigger

An invisible trigger that will change a supported Actor's gravity when it enters. Can be configured to support Madeline and/or any holdable/non-holdable Actor.

SpawnGravityTrigger

An invisible trigger that will set Madeline's initial gravity if placed over a player spawn entity. Will optionally apply this gravity setting when returning from a berry/cassette bubble, since return bubbles will always set regular gravity when triggered. This was the safest solution given that return bubbles do not work well while inverted. When placing a spawn on the ceiling, nudge the player spawn entity 5 pixels upward to ensure Madeline is standing and doesn't fall upward.

GravityBadelineBoost

A BadelineBoost (Badeline orb) that supports going downward instead of upward, and can optionally change Madeline's gravity on touch. Gravity types can be defined per node.

GravityBooster

A Booster (bubble) that will change Madeline's gravity when she is released.

GravityBumper

A Bumper that will change Madeline's gravity upon touch.

##