Skip to main content

Ephemeris Logo

Aberoth Ephemeris

A Python module that provides information about upcoming scroll events and moon phases in the MMORPG Aberoth. If you're looking for an easy way to get the predictions from this module in a more human readable form without creating having to your own application, check out the Ephemeris Discord Bot.

Installing

The module can be downloaded from PyPI using

pip install aberoth-ephemeris

or you can download the latest release from GitHub

Use Example

Once you've installed the module, it can be used like so

from aberoth_ephemeris import Ephemeris
import time

# number of milliseconds in a day
ms_1day = 86400000
# four days before the current time
startTime = round((time.time() * 1000) + -4 * ms_1day)
# 35 days after the current time
endTime = round((time.time() * 1000) + 35 * ms_1day)

ephemeris = Ephemeris(
    # the epoch time in ms that prediction calculations will start from
    start=round((time.time() * 1000) + -4 * 86400000),
    # the epoch time in ms that scroll prediction calculations will stop at
    end=round((time.time() * 1000) + 35 * 86400000),
    # the number of cycles into the future that the moon phases are calculated for
    numMoonCycles=8, 
    # adds discord timestamp to ephemeris event information if True
    discordTimestamps=False,
    # indicates that calculations should be split between multiple processes/cores
    multiProcess=True,
    # indicates number of cores to use, automatically uses all cores if None
    numCores = None,
    # None indicates that the built in orb variables should be used
    varFile = None
    )

The start and stop times are just examples and any time may be used so long as the start time is before the stop time.

By default, built in orb variables are used for predictions. If you wish to use your own variables you can pass the path to your own variables file into varFile as a string. See the gathering your own variables section for details on how you might gather your own variables.

Optionally, a web server may be run to intake auto-calibration data from a separate script. To do so, run the following code on a separate thread or process

from waitress import serve
from aberoth_ephemeris import app

# serve on separate thread or process
serve(app, host="0.0.0.0", port=5000, threads=1)

When valid calibration data is received over HTTP request, the variables used to predict alignments are updated and used the next time an ephemeris object is created or the ephemeris event cache is recreated.

Make sure to configure a .env file containing a pass key named UPDATE_KEY for the http server request. Example .env

UPDATE_KEY={verification key for HTTP server}

An excellent separate script that can be used to gather and send live calibration data to this module is the Ephemeris Overheard Hook made by GitHub user jvandag. It is built on GitHub user ashnel3's Overheard Scraper which scrapes the Aberoth overheard page to find changes in scroll state, moon phase, time of day, and number of players online.

For formatting of this HTTP message refer to this example fetch request.

Event Structure

The calculated scroll events are stored in the Ephemeris.scrollEventsCache property which is formatted as follows

[
    (
        timestamp,
        {
            "newGlows": glowList, # list of orb names
            "newDarks": darkList, # list of orb names
            "returnedToNormal": returnedToNormal, # list of orb names
            "discordTS": f"<t:{int(np.floor(timestamp/1000))}:D> <t:{int(np.floor(timestamp/1000))}:T>"
        }
    ),
    ...
]

# Possible orb names: ["Shadow", "White", "Black", "Green", "Red", "Purple", "Yellow", "Cyan", "Blue"]
# discordTS is only present if enabled when creating the Ephemeris instance

The calculated moon phases are stored in the Ephemeris.moonCyclesCache property which is formatted as follows

[
    (
        currentTime,
        {
            "phase": phase,
            "discordTS": f"<t:{int(np.floor(currentTime/1000))}:D> <t:{int(np.floor(currentTime/1000))}:t>",
        },
    ),
    ...
]

# Possible phases: ["new", "waxing_crescent", "first_quarter", "waxing_gibbous", "full", "waning_gibbous", "third_quarter", "waning_crescent"]
# discordTS is only present if enabled when creating the Ephemeris instance

Gathering your own variables

If you do not already have a moderate understanding of how Aberoth events happen, it would be helpful to read the wiki page on the Aberoth solar system.

Most variables are close to the real-life values provided by NASA but not exact. These make a good starting point for calibrating variables. Conversely, you could also gather experimental data from the Aberoth orb room as well as some reference points using the Ephemeris Overheard Hook or something similar. Some notes on how to do this with experimental data can be found here. When it comes to refining/calibrating these variables, it is important to create a system that can tell you how a change affects the whole system, not just the specific alignment event you're looking at. Here is an example spreadsheet that shows how you might set up such a system. To help better your understanding of this spreadsheet, it would still be useful to read the notes on gathering the variables with experimental data as it covers some of the more in-depth details on how the solar system works that aren't mentioned elsewhere.

Metadata

Release files for aberoth-ephemeris 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aberoth-ephemeris 1.0.2
File Size Uploaded Provenance Actions
aberoth-ephemeris-1.0.2.tar.gz 21.1 kB Without provenance Details for aberoth-ephemeris-1.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aberoth-ephemeris 1.0.2
File Interpreter ABI Platform Actions
aberoth_ephemeris-1.0.2-py3-none-any.whl Python 3 none any Details for aberoth_ephemeris-1.0.2-py3-none-any.whl

Total release size: 41.4 kB

Release files / aberoth-ephemeris-1.0.2.tar.gz

Download URL aberoth-ephemeris-1.0.2.tar.gz
Size 21.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c466ff1f82dad02e4bc150ec63dd23b24f5d12c852722a482fa2fd4a1246d851
BLAKE2b-256 checksum
How to use checksums
82fcfa866fbb5f3782bb203d65bda7b6bd07fa18113f707cea12bb3dd41519ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.4

Release files / aberoth_ephemeris-1.0.2-py3-none-any.whl

Download URL aberoth_ephemeris-1.0.2-py3-none-any.whl
Size 20.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a101155123973dee6b758df79f5d28c424a46ea495ee00a551d2b0f94e5c06b8
BLAKE2b-256 checksum
How to use checksums
9e46eb46c0921b5ee85868dded47998ca0f4951cad9cc0ee7053f1969b4fcb1c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.4

Security for aberoth-ephemeris 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page