Contort Helper

Contort Helper is here!

Contort Helper is a code mod that allows you to contort and bend Celeste to your will! With a variety of effects, entities, controllers, and triggers, you can explore to your heart's content!

This helper includes the most stable teleportation placements, given and verified by Marshall, the creator of Glyph! With many options and levels of detail, you can have a simple gameplay-style teleport to a cinematic play.

There are flashing, photosensitive, and potentionally dangerous effects that can be used in here. You can enable or disable them in the Mod Options if needed.

If your game crashes or a room isn't loading, consult the error.log or log.txt. If you still don't have a clue, you can message me on Discord at Mün#0001 or ping me in the Official Celeste Discord Server.

Update 1.1 is here: overhauling everything and adding more distorting placements that allow you to wild in your maps! This update also added some internal code that can help code mods that use this as a dependency, so everyone can benefit from this update!

Update 1.2 is here: adding more content such as attachers, wind multipliers, more light sources, and High Resolution Backdrops!

Update 1.3 is here: made some changes to allow a more user-friendly experience, as well as adding more content: Burst Remover, Specific Lightning Strike Trigger, Anxiety & Glitch Effect Controllers, and much more.

Update 1.4 is here: overhauled the effect/shader manager and now has some template effects to mess around with! More coming in the future.

Update 1.5 is here: added lots of confetti entities and general optimizations to other existing entities.

How to Install

To use this helper in your map, you will need to add it as a dependency, so players who install your map will also install this helper. To do so, add this helper to your dependencies in your everest.yaml, as below:

• Name: YourModName

Version: 1.0.0 Dependencies:

• Name: ContortHelper

Version: 1.5.0

Backdrops

High-Resolution backdrops is one of *Contort Helper*'s specialties! Although only one is implemented, it is planned that there will be a system for creating your own high-resolution backdrops, as well as more high-resolution backdrops for mappers to use!

As of update 1.3, Contort Helper has its own backdrop system that your code mod can use! Make sure your class extends Celeste.Backdrop and you have the CustomBackdrop attribute associated with your class (you'll need to put the ids for the backdrop, similar to how CustomEntity works).

You'll also need a constructor with the following signatures: MapData, BinaryPacker.Element, BinaryPacker.Element (map, child, above), Mapdata, BinaryPacker.Element (map, child), MapData (map), and BinaryPacker.Element (child).

Lastly, you need the BackdropsManager.LoadNamespace and BackdropsManager.Unloadnamespace methods in your module class so you can load and unload your backdrops.

• High-Resolution Particle Backdrop: A backdrop that uses a texture (overlay) and a particle texture (snow) to create a snowy theme in the highest resolution.

Entities

Some entities have special variants, such as a Path Variant. This type of variant works identical to the original, except that it can move along a path (its position to its node). These are very useful for having moving distortions instead of having only static variants.

• Alpha-Lerp Lights & Path: A custom light with extra variables for lerping the alpha/transparency.

• Anxiety Effect & Origin Controller: A controller for modifying the anxiety effect and the origin of it.

• Burst Attacher (and Controller): An extension from a burst effect that attaches to another entity.

• Burst Effect & Path: A displacement that spawns a ripple-like effect.

• Burst Zone (and Controller): A given range that allows lots of burst effects to spawn within it.

• Confetti Attacher (and Controller): An extension from the confetti spawner that attaches to another entity.

• Confetti Spawner & Path: A spawner that, of course, spawns confetti on its position.

• Confetti Zone (and Controller): A given range that allows lots of confettis to spawn within it.

• Light Occlude Zone: A zone that occludes light.

• Color-Lerp Lights & Path: A custom light with extra variables for lerping the color.

• Custom Effect Controller: A controller for adding a custom effect/shader into a room.

• Custom Memo & Note: A cutscene-like entity that has memos/notes interaction.

• Flickering Lights & Path: A custom light with extra variables for flickering the light on and off.

• Glitch Effect Controller: A controller for modifying the glitch effect.

• Lightning Strikes Controller: A controller for having a bunch of probabilities to spawn lightning strikes.

• Custom Lights & Paths: A customizable vertex-light and bloom-point.

• Custom Light Zones: A given range that allows custom lights to spawn within it.

• Teleportation Target: An entity with a tag that is for teleportation.

Triggers

Almost all triggers have the One-Use, Persistent, and Occur On Enter properties so you can modify how the generic trigger behaves on its invoke and when it will invoke.

Internally, there are several types of trigger abstract classes: AbstractTrigger, AbstractCoroutineTrigger, AbstractStayTrigger, AbstractCutsceneTrigger, and AbstractPoemCutsceneEntity. These are useful for having the default options each trigger should have, plus an easy way to have an invoking method.

• Anxiety Effect Trigger: A trigger for modifying the anxiety effect.

• Bloom Renderer Modifier Trigger: A trigger that allows you to modify