README.md

celeste-hunt

A shared-seed bingo scavenger hunt randomizer for Celeste speedruns!

Usage

Powered by Slim and SeedSpring, Bingo runs a seeded pesudo-RNG that provides bingo cards for Celeste speedruns. Common usage instructions can be found on the website itself, here.

API Endpoint

An API endpoint is available if you wish to obtain data and embed it in your own website/app/stream layout.

Calling the URL https://oneninefour.cl/celeste/ via a POST request will return a JSON with the following format:

{
    "seed":"fc56b42f3835b662",
    "list":{
        "Forsaken City":"Collect 5 strawberries",
        "Old Site":"Collect Crystal Heart",
        "Celestial Resort":"Collect a winged strawberry",
        "Golden Ridge":"Take the hidden path to Cliff Face",
        "Mirror Temple":"Kill a seeker",
        "Reflection":"Collect Cassette Tape",
        "Summit":"Take the rightmost path at 1000m"
    },
    "lang": "en"
}

You can later call it again passing the seed as part of the URL (ex: https://oneninefour.cl/celeste/fc56b42f3835b662)

You may pass the following arguments as JSON body to either request and they will be returned if present with the assigned value at the request:

{
    "lang": "es" (es, en. default "en"),
    "exclude_pico": true (default false),
    "exclude_berries": true (default false),
    "allow_cheat": true (default false)
}

Supported languages

['de', 'en', 'es']

License

Source code is licensed under the MIT License.

Special Thanks

Thanks to the Celeste development team for making a game I will never forget.
Thanks to several friends that provided UX testing and assistance with front-end design.
Special thanks to Mathemagician for seed logic. Special thanks to SebasContre for additional coding and fixes.
Special thanks to Nameguy for German translation