Page 1 of 1

[ADDON] KeepSupplyTimer

Posted: Wed Jun 10, 2026 8:40 am
by kpihuss
KeepSupplyTimer 1.0.0 – State of Realm supply and decay helper

Hi everyone,

I’m releasing the first public version of KeepSupplyTimer, a small State of Realm helper addon for Return of Reckoning.

The addon is designed to make keep supply tracking easier during RvR. It adds extra information directly to the State of Realm window, so you can quickly see what is happening without having to manually track timers.

DOWNLOAD
Get the latests version from Idrinth website:
https://tools.idrinth.de/addons/keep-supply-timer/

Main features
  • Shows the time since the last observed supply delivery to each keep.
  • Adds estimated countdowns for BO supply generation.
  • Shows a keep decay risk indicator.
  • Adds tooltips explaining the current decay risk.
  • Shows friendly keep upgrade information when available.
  • Tracks Divine Favor Altar charges when detected.
  • Allows keep upgrade information to be shared outside of guild chat.
  • Works directly inside the State of Realm UI.
The decay risk system is an estimate based on observed State of Realm data. It should be treated as an operational warning tool, not as an exact server-side timer.

Who is this addon useful for?

Solo players:
If you enjoy playing in low-population zones, the addon helps you keep better track of your own BOs and enemy BOs. It also makes it easier to know when a keep may be about to decay, so you can act accordingly, and gives you a timer for the next estimated supply spawn.

Warband leaders:
You can better plan BO captures and RvR movements, either to prevent the enemy from upgrading their keep or to help improve your own.

General RvR players:
You can get a clearer view of available friendly keep upgrades, which are shared by the whole realm, such as NPC Healer, Improved Respawns, Divine Favor Altar, and other useful keep services.

This addon is mainly intended for players who actively follow campaign movement, supply flow, keep progress and BO control during RvR.

KeepSupplyTimer – Quick User Guide

What you will see in State of Realm
  • Keep supply timer: shows how long it has been since the last observed supply delivery to the keep.
  • BO countdowns: shows an estimated timer for the next supply generated by secured BOs.
  • Decay risk indicator: shows the estimated risk of a keep losing progress.
    Image
  • Decay tooltip: hover the decay risk indicator to see why the addon considers the keep safe, aging, armed or critical.
  • Keep upgrades tooltip: hover the keep upgrade text to see known friendly keep upgrades and Divine Favor Altar charge information when available.
    Image
    Right click on the "Keep upgrades" to open the Keep upgrades share menu.
    Image
Important note about decay risk

The decay risk system is an estimate based on observed State of Realm data. It is not a guaranteed server-side timer.

Use it as a practical warning tool to help decide when to defend BOs, escort supplies, attack enemy BOs or prepare for a possible keep progress reset.

Basic commands

Code: Select all

/ksupply help
/ksupply status
/ksupply botimers on
/ksupply botimers off
/ksupply risk on
/ksupply risk off
/ksupply upgrades
Command explanation
  • Code: Select all

    /ksupply help
    shows the available addon commands.
  • Code: Select all

    /ksupply status
    shows the current addon status.
  • Code: Select all

    /ksupply botimers on
    enables BO supply countdowns.
  • Code: Select all

    /ksupply botimers off
    disables BO supply countdowns.
  • Code: Select all

    /ksupply risk on
    enables keep decay risk indicators.
  • Code: Select all

    /ksupply risk off
    disables keep decay risk indicators.
  • Code: Select all

    /ksupply upgrades
    prints the currently known friendly keep upgrade information.
Recommended use
  • Use BO countdowns to know when supplies are likely to spawn.
  • Use the decay risk indicator to know when your realm should retake BOs or deliver supplies.
  • Use the same information offensively to keep enemy BO control below the required level.
  • Check friendly keep upgrades to know which services are currently available.
How the decay prediction works

There is currently no official public formula for keep decay available in the forum or the wiki. Because of that, KeepSupplyTimer’s decay prediction has been built through direct observation and data collection.

The current model is based on more than 5,000 observed events, including:
  • Supply deliveries.
  • BO captures and ownership changes.
  • BO supply generation behaviour.
  • Keep progress changes.
  • Keep decay events.
KeepSupplyTimer does not read an official server decay timer. Instead, it builds an estimated risk level from the information visible in State of Realm.

The addon mainly looks at:
  • The last observed supply delivery to the keep.
  • The current keep progress.
  • The keep rank.
  • How many BOs are currently controlled by the keep realm.
  • How many BOs are required for that keep rank to keep generating supplies safely.
  • How long the keep has been below that BO requirement.
If the keep has no progress, there is nothing to decay yet.

If the keep has progress but the addon has not observed a previous supply delivery, the timer is shown as unknown until the next supply is detected.

When the keep realm controls enough BOs, the keep is considered stable or safe. To mantain safe a keep, your realm need hold enough BOs to generate supplies (2 BOs for 0-2 stars keeps, 3BOs for 3 stars and 4 BOs for 4-5 BOs)

When the keep realm drops below the required BO count, the addon starts estimating decay risk. The longer the keep remains below the requirement, the higher the risk becomes.

The risk levels are:
  • Safe / OK: the BO requirement is currently met.
  • Unknown: the addon does not yet have enough supply data.
  • Aging: the keep is below the BO requirement, but decay is not expected immediately.
  • Armed: the keep has been below the BO requirement long enough that decay risk is high.
  • Critical: the keep may lose progress on a server update if the situation does not change.
  • Stabilized: the keep has recovered enough BO control and the immediate risk has been cancelled.
The accuracy rate of decay prediction is close to 99%.

The prediction should be treated as a practical warning system, not as an exact countdown. Data collection is still ongoing, and the model may be adjusted in future versions as more supply, BO and keep decay events are recorded.

If you download the addon, please comment here any problem you find on it when you use it!!!

We hope you enjoy the addon!

Developed by Kpihuss and Gingerbel.