Skip to content

mriot/prep-alert

Repository files navigation

PrepAlert

latest release downloads total downloads

A Guild Wars 2 Nexus addon that reminds you when important buffs such as Enhancements and Sigils are missing.

Buff reminders demo

Features

In Dungeons and Fractal CMs, these reminders show up dynamically based on your current position.
They will only appear when the respective buff is missing.

Here in the Sorrow's Embrace, the player is reminded to take Inquest slaying buffs upon entering the P1 area.
Buff reminders demo gif

You can also pick which buffs to show; for example, if you don't care about Slaying Sigils, you can disable those.

If no special buffs are available for the current encounter, you’ll be alerted to replace any lingering buffs.

Buff Choices

The buff choices are based on the Instanced Species List and focus on general usefulness rather than aiming for the absolute tryhard setup.
Let me know if you think anything should be changed.

Current definitions can be viewed using the interactive mapping tool.

Options

Tip

Hovering the (?) in-game will show additional information.

Prep Alert Options

Positioning

For simple positioning, the overlay anchor is synced with the overlay content origin.
This means that if you move the overlay for example to the bottom-right corner of your screen, the reminders will also expand from the bottom-right corner, ensuring they are always visible.

If you want more control, you can disable syncing and adjust the anchor and origin separately.

The X and Y offset sliders can be clicked and dragged to quickly adjust the position. They specify the distance in pixels from the selected anchor point.

Limitations

  • Detection is position-based only and does not account for:
    • Boss phases or mechanics
    • Selected dungeon paths
    • Normal vs. challenge mode fractals

📥 Installation

Caution

Modifying Guild Wars 2 through any third-party software is not supported by ArenaNet.
Use this addon at your own risk.

You can install the addon directly through the in-game Nexus library with a single click.

Manual installation:

  1. Download the latest PrepAlert.dll
  2. Put the file into your Guild Wars 2 Nexus addons folder (e.g., C:/Program Files/Guild Wars 2/addons)
  3. Enable the addon in-game in Nexus

Technical Stuff

The addon is written in C++20 for the Nexus addon platform.
The scripts for map data fetching and processing are written in Python 3.11.

Note

In order to have the addon open source, some sensitive parts were moved to a closed-source dependency.

Memory Reading ⚠️

A small portion of the addon relies on memory reading to

  • retrieve currently active buffs on the player
  • get the current map floor the player is on

Map Data

Map data, originally fetched from the GW2 Wiki, is processed by the map data patcher to produce src/maps.json.
During this step, the patcher updates sector definitions by adding buff information, or creating additional sectors where necessary.

Custom sectors were created using an interactive mapping tool.

Currently, custom floors for some maps are not displayed correctly in the mapping tool

Dependencies

Credits

  • Raidcore's Nexus addon platform and community (especially Delta)
  • The Gw2 Wiki, for a usable map data API and map widgets
  • The folks who created the Instanced Species List
  • Elis, Baste, Everless, and especially Bird for support and testing
  • The [ty] guild and especially Devin for all stuff regarding Dungeons ♡