Celeste (Open World): Implement New Game (#4937)

* APWorld Skeleton

* Hair Color Rando and first items

* All interactable items

* Checkpoint Items and Locations

* First pass sample intermediate data

* Bulk of Region/location code

* JSON Data Parser

* New items and Level Item mapping

* Data Parsing fixes and most of 1a data

* 1a complete data and region/location/item creation fixes

* Add Key Location type and ID output

* Add options to slot data

* 1B Level Data

* Added Location logging

* Add Goal Area Options

* 1c Level Data

* Old Site A B C level data

* Key/Binosanity and Hair Length options

* Key Item/Location and Clutter Event handling

* Remove generic 'keys' item

* 3a level data

* 3b and 3c level data

* Chapter 4 level data

* Chapter 5 Logic Data

* Chapter 5 level data

* Trap Support

* Add TrapLink Support

* Chapter 6 A/B/C Level Data

* Add active_levels to slot_data

* Item and Location Name Groups + style cleanups

* Chapter 7 Level Data and Items, Gemsanity option

* Goal Area and victory handling

* Fix slot_data

* Add Core Level Data

* Carsanity

* Farewell Level Data and ID Range Update

* Farewell level data and handling

* Music Shuffle

* Require Cassettes

* Change default trap expiration action to Deaths

* Handle Poetry

* Mod versioning

* Rename folder, general cleanup

* Additional Cleanup

* Handle Farewell Golden Goal when Include Goldens is off

* Better handling of Farewell Golden

* Update Docs

* Beta test bug fixes

* Bump to v1.0.0

* Update Changelog

* Several Logic tweaks

* Update APWorld Version

* Add Celeste (Open World) to README

* Peer review changes

* Logic Fixes:

* Adjust Mirror Temple B Key logic

* Increment APWorld version

* Fix several logic bugs

* Add missing link

* Add Item Name Groups for common alternative item names

* Account for Madeline's post-Celeste hair-dying activities

* Account for ignored member variable and hardcoded color in Celeste codebase

* Add Blue Clouds to the logic of reaching Farewell - intro-02-launch

* Type checking workaround

* Bump version number

* Adjust Setup Guide

* Minor typing fixes

* Logic and PR fixes

* Increment APWorld Version

* Use more world helpers

* Core review

* CODEOWNERS
This commit is contained in:
PoryGone
2025-08-31 17:31:09 -04:00
committed by GitHub
parent cdf7165ab4
commit c753fbff2d
16 changed files with 53225 additions and 0 deletions

View File

@@ -0,0 +1,98 @@
# Celeste Open World
## What is this game?
**Celeste (Open World)** is a Randomizer for the original Celeste. In this acclaimed platformer created by ExOK Games, you control Madeline as she attempts to climb the titular mountain, meeting friends and obstacles along the way.
This randomizer takes an "Open World" approach. All of your active areas are open to you from the start. Progression is found in unlocking the ability to interact with various objects in the areas, such as springs, traffic blocks, feathers, and many more. One area can be selected as your "Goal Area", requiring you to clear that area before you can access the Epilogue and finish the game. Additionally, you can be required to receive a customizable amount of `Strawberry` items to access the Epilogue and optionally to access your Goal Area as well.
There are a variety of progression, location, and aesthetic options available. Please be safe on the climb.
## Where is the options page?
The [player options page for this game](../player-options) contains all the options you need to configure and export a config file.
## What does randomization do to this game?
By default, the Prologue, the A-Side levels for Chapters 1-7, and the Epilogue are included in the randomizer. Using options, B- and C-Sides can also be included, as can the Core and Farewell chapters. One level is chosen via an option to be the "Goal Area". Obtaining the required amount of Strawberry items from the multiworld and clearing this Goal Area will grant access to the Epilogue and the Credits, which is the goal of the randomizer.
## What items get shuffled?
The main collectable in this game is Strawberries, which you must collect to complete the game.
16 Crystal Heart items are included as filler items (Heart Gates are disabled in this mod). Any additional space in the item pool is filled by Raspberries, which do nothing, and Traps.
The following interactable items are included in the item pool, so long as any active level includes them:
- Springs
- Dash Refills
- Traffic Blocks
- Pink Cassette Blocks
- Blue Cassette Blocks
- Dream Blocks
- Coins
- Strawberry Seeds
- Sinking Platforms
- Moving Platforms
- Blue Clouds
- Pink Clouds
- Blue Boosters
- Red Boosters
- Move Blocks
- White Block
- Swap Blocks
- Dash Switches
- Torches
- Theo Crystal
- Feathers
- Bumpers
- Kevins
- Badeline Boosters
- Fire and Ice Balls
- Core Toggles
- Core Blocks
- Pufferfish
- Jellyfish
- Double Dash Refills
- Breaker Boxes
- Yellow Cassette Blocks
- Green Cassette Blocks
- Bird
Additionally, the following items can optionally be included in the Item Pool:
- Keys
- Checkpoints
- Summit Gems
- One Cassette per active level
Finally, the following Traps can be optionally included in the Item Pool:
- Bald Trap
- Literature Trap
- Stun Trap
- Invisible Trap
- Fast Trap
- Slow Trap
- Ice Trap
- Reverse Trap
- Screen Flip Trap
- Laughter Trap
- Hiccup Trap
- Zoom Trap
## What locations get shuffled?
By default, the locations in Celeste (Open World) which can contain items are:
- Level Clears
- Strawberries
- Crystal Hearts
- Cassettes
Additionally, the following locations can optionally be included in the Location Pool:
- Golden Strawberries
- Keys
- Checkpoints
- Summit Gems
- Cars
- Binoculars
- Rooms
## How can I get started?
To get started playing Celeste (Open World) in Archipelago, [go to the setup guide for this game](../../../tutorial/Celeste%20(Open%20World)/guide/en)

View File

@@ -0,0 +1,20 @@
# Celeste (Open World) Setup Guide
## Required Software
- The latest version of Celeste (1.4) from any official PC game distributor
- Olympus (Celeste Mod Manager) from: [Olympus Download Page](https://everestapi.github.io/)
- The latest version of the Archipelago Open World mod for Celeste from: [GitHub Release](https://github.com/PoryGoneDev/Celeste-Archipelago-Open-World/releases)
## Installation Procedures (Windows/Linux)
1. Install the latest version of Celeste (v1.4) on PC
2. Install `Olympus` (mod manager/launcher) and `Everest` (mod loader) per its instructions: [Olympus Setup Instructions](https://everestapi.github.io/)
3. Place the `Archipelago_Open_World.zip` from the GitHub release into the `mods` folder in your Celeste install
4. (Recommended) From the main menu, enter `Mod Options` and set `Debug Mode` to `Everest` or `Always`. This will give you access to a rudimentary Text Client which can be toggled with the `~` key.
## Joining a MultiWorld Game
1. Load Everest from the Olympus Launcher with the Archipelago Open World mod enabled
2. Enter the Connection Menu via the `Connect` button on the main menu
3. Use the keyboard to enter your connection information, then press the Connect button
4. Once connected, you can use the Debug Menu (opened with `~`) as a Text Client, by typing "`!ap `" followed by what you would normally enter into a Text Client