Skip to content

TreeFidyDad/deathclock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

92 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

deathclock

deathclock

An Ashita v4 addon for FFXI that tells you, at a glance, when each mob you killed is about to repop and where to run back to catch it.

⚠️ Respawn windows and entity behavior differ between servers — YMMV. Tune the defaults for your environment.

Current version: 0.4.2

deathclock crystal markers floating in-world

Floating "Rebirth" crystals mark each mob's spawn point, colored by time-to-pop — the default in-world marker as of v0.3.39.


What it does

  • Tracks mob deaths via HPP-scan — no packet hooks, no chat scrape. It watches the entity table for HP 0 with a previous non-zero, on mob entities only.
  • Only your kills — by default, only mobs claimed by you or your party/alliance at time of death are tracked. Random mobs killed by passers-by don't get added to the list. Toggle in the config tab or with /dc mine.
  • Predicts respawn using a configurable default window (349s — based on observed claim-mob respawns; tune for your server) and per-name overrides. Quick preset buttons (349s / 960s) and /dc preset let you switch in two keystrokes.
  • Color-tiered ETA bars — fully configurable. By default: 6 bands from "Fresh Kill" red through orange / yellow / green / cyan / white at pop.
  • NMs tab — auto-detects Notorious Monster kills from the death chat (FFXI omits the "The " article for NMs) and keeps a persistent kill counter with ToD per mob. NMs now also appear in the kills tab with their own respawn timer so you can track the window.
  • PH auto-queue — when an NM kill is recorded (via chat), the addon automatically adds a respawn entry for its known Placeholder so you never have to manually start the PH timer.
  • Sound alert — plays a sound when a tracked PH kill has 30 seconds left on its respawn timer. Only fires for confirmed PH kills, not every tracked mob.
  • Kill persistence — respawn timers are saved to disk on every change and restored on load/reload/crash. A 5-minute PH timer survives a crash; so does an 8-hour NM window tracked before bed.
  • Placeholder learning — records the server-side spawn slot (server_id) of every kill, so once the addon has seen the same slot host both an NM and a non-NM, it knows that non-NM is the NM's placeholder. PH kills then get a [PH] tag on the kills tab, a chat callout ([PH for Spiny Spipi]), and tooltip naming the NM. Use /dc target to inspect a live target's slot history before you swing.
  • In-world spawn markers point from your character to each mob's claim spot — the position it was at the frame you claimed it, snapshotted as a respawn proxy (mobs rarely wander far before being claimed, but can be kited hundreds of yalms before they die, so this beats the corpse location for run-backs). Colored by the same palette so a glance tells you what's about to pop. Crystals are the default flavor as of v0.3.39 — a floating FF-style "Rebirth" gem that bobs over the spot and pulses faster as the pop nears (/dc crystal). Prefer something else? Switch to classic 3D return-arcs (/dc lines/default), an animated tracer (/dc fx), or a vertical light pillar (/dc beacon). Arc machinery vendored from targetlines.
  • Floating mob labels that ride the apex of each return-arc so you can identify which marker goes to which mob — even when you've kited halfway across the zone.
  • "Keep pop visible" window — kills stay in the list for N seconds after they pop so you have time to actually look at them.
  • Session-only ignore set — mute noise mobs (/dc ignore Svana Rarab) without persisting the choice across reloads.

Screenshots

Config tab

Default respawn, tracking + arc toggles, per-mob overrides, and a fully editable color/threshold table.

config

Kills tab

Live mob list with ETA bars, direction + yalms to corpse, single-click clear.

kills

NMs tab

Auto-populated kill counter for Notorious Monsters with ToD timestamp. Right-click a row to reset the counter or un-flag the mob.

nms

Placeholder learning

Same kills tab, but now slot 0x01074130 has been observed hosting Spiny Spipi — so the third Crawler row (the one at that slot) is tagged [PH]. Hover for the NM name; identical-name mobs at other slots stay untagged.

placeholders


Install

  1. Drop the deathclock/ folder into Ashita\addons\.
  2. In game: /addon load deathclock.
  3. /dc to toggle the window. /dc help is not a thing — see commands below.

deathclock is fully standalone. Its 3D-line machinery (drawArc, world-to-screen projection) is vendored under vendor/targetlines/ — see vendor/targetlines/NOTICE.md for attribution.


Commands

/dc                          toggle window
/dc show | hide
/dc list                     print pending kills + ETAs to chat
/dc tell [Name]              share pending timers to party chat (/p)
                             optional Name filters to one mob (substring, case-insensitive)
/dc clear [Name]             clear all, or just this mob
/dc add "Mob Name" <secs>    per-mob respawn override
/dc default <secs>           change global default respawn
/dc preset 349 | 960         quick-switch global default to claim (349s) or outdoor (960s) preset
/dc ignore [Name]            mute this mob for the session
/dc unignore [Name]          unmute (or clear all)
/dc lines                    toggle 3D return-arcs
/dc fx                        marker flavor: animated tracer arc to the spawn
/dc beacon                    marker flavor: vertical light pillar at the spawn
/dc crystal                   marker flavor: floating FF "Rebirth" gem (DEFAULT)
/dc mine                     toggle "only my kills" filter
/dc all                      toggle "always show arcs" (bypass elapsed-pct threshold)
/dc nm list                  print tracked NMs + counts to chat
/dc nm add <Name>            manually flag a mob as NM (sweeps it from kills tab)
/dc nm reset <Name|all>      reset kill counter for one NM, or all
/dc nm forget <Name>         un-flag a mob as NM (so it goes back to the respawn list)
/dc lottery [Name]           show measured PH-kills-per-pop + estimated pop odds for lottery NMs
/dc lottery reset [Name|all] clear collected lottery stats
/dc target                   inspect current target: name, server_id, slot history (NM/PH evidence)
/dc slots                    summary of slots with PH evidence (slot has hosted both an NM and a non-NM)
/dc slots verbose            full dump of every slot observed + per-name kill counts
/dc slots tag <id> <Name>    manually seed a slot/NM pair (accepts decimal or 0xHEX server_id)
/dc slots clear              wipe slot_map (start placeholder learning over)
/dc mobdb                    toggle mobdb integration (auto-detect Notorious via its data files)
/dc test                     drop a TestMob entry to verify rendering
/dc diag                     dump last label-render error (if any)
/rt <subcmd>                 short alias for /dc <subcmd>

Configuration

Everything below is editable from the config tab — no need to hand-edit XML:

Setting What it does
tracking Master on/off for kill tracking
only my kills When on, skip mobs claimed by others. Uses GetClaimStatus low 16 bits vs. party/alliance server IDs at the frame before death
return arcs Master on/off for 3D arcs
arc: X% elapsed Don't draw arcs until X% of the respawn window has elapsed. 0 + "always on" = always draw
keep pop visible (s) How long popped (Ready) mobs stay in the list before auto-clearing
default respawn (s) Global default if no per-mob override exists
use mobdb When mobdb is installed, read its zone data files to detect Notorious mobs and auto-route them to the NMs tab on first kill. Respawn timers stay HorizonXI-tuned (349s default), since mobdb data is retail/AirSkyBoat-era
bg opacity Window background transparency (0.0 = fully transparent, 1.0 = opaque)
per-mob overrides Named exceptions to the default
colors & thresholds Number of color bands + the percent-elapsed boundary + display color for each

Changelog

v0.4.2

  • NM detection fixed — the auto-detector now requires a real mob entity (spawn flags 16) before adding an NM. Previously it recorded any "<name> falls to the ground." line, which also fires for KO'd players (your own character) and pets — that's why the NM tab filled with PC names. Also now reads the "<Killer> defeats <Mob>." kill-credit line as a more reliable signal.
  • NM tab auto-cleanup — on first load after updating, legacy non-mob entries (players/pets) are stripped automatically. Manual re-run via /dc nm clean. "Mob evidence" = currently a mob entity, or previously logged in the spawn-slot map.

v0.4.1

  • Lottery odds tracker (/dc lottery) — empirically measures how many placeholders you kill per NM pop on your server. Each PH kill is counted toward every NM it's a placeholder for; each NM kill banks that count as a sample and resets the counter. The readout shows pops, total PH kills, average PH-per-pop, estimated per-respawn pop chance, and the min/max/last run. Requires a known PH→NM link (kill the NM once at the slot, or declare it with /dc ph). Reset with /dc lottery reset [Name|all].
  • [PH] tag on in-world labels — floating spawn labels now prefix known placeholders with [PH], matching the kills tab.

v0.4.0

  • Kill persistence — respawn timers survive crashes, /lua reload, and game restarts. Timers are saved to disk on every change and restored on load.
  • NMs in kills tab — NM kills now appear in the kills tab with a respawn timer in addition to the NMs tab kill counter.
  • PH auto-queue — after an NM kill is recorded via chat, the addon automatically queues a respawn entry for the known Placeholder.
  • Sound alert — 30-second warning sound fires when a tracked PH kill is about to respawn. Only PH kills trigger this, not every tracked mob.
  • Respawn presets — 349s and 960s preset buttons in the config tab; /dc preset 349|960 command.
  • Outdoor preset corrected — measured at 439s on HorizonXI (was 960s retail default).

v0.3.39

  • Crystal markers as default in-world flavor.
  • Initial public release.

  • vendor/targetlines/ (the drawArc machinery and worldToScreen helper) is vendored from the targetlines addon — see vendor/targetlines/NOTICE.md for full attribution.

License

GPL-3.0-or-later. See LICENSE.

About

No description or website provided.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages