Attendance, caught live
An addon that marks who was in your alliance at the pop, so attendance is recorded from the game itself instead of typed into a spreadsheet after midnight. It reports outward and never acts on the game.
What it is
The addon reads the names of the people in your party and alliance through the standard Windower party API, the same one dozens of common addons use, and sends a signed report to Lootryx. When an officer has check-in open on an event, that report records who was present. It can also fetch your linkshell's records back into your chat log, and post to the world-wide Party Finder.
Works with Windower today
The addon runs on Windower 4 right now. Ashita support is planned but not yet available, so if you play on Ashita, sit tight or use a check-in PIN or an officer-approved screenshot in the meantime.
What it does, and never does
No gameplay actions. It never sends anything to the game server.
The addon performs no memory writes, no packet injection, and no gameplay automation. It reads the game and makes HTTP requests to Lootryx, and it can read and write your own local macro files to keep them in step with the web. Editing your own macros through a local file is the same class of action as editing them in-game: local-config editing, never a server action. The addon is open source, so you or a GM can read every line before loading it.
It does
- Read your own character name, and the job you are currently on.
- Read the names of your party and alliance members.
- Read whether you are logged in, and nothing else about your session, so it never claims to have saved settings that Windower discarded at the character select screen.
- Read your own local macro files, and write them back when you pull a web edit.
- Write its own local settings file, to remember your connection and sync state.
- Send things YOU TYPE: an attendance snapshot, a Time of Death, a drop you saw awarded, an event signup, a sealed bid, a wishlist change, a poll vote, your declared jobs, and Party Finder listings.
- Fetch your linkshell's records on your own typed command (balances, standings, auctions, events, bounties, loot, the bank, polls, HNM windows) and print them to your chat log.
- Report your current zone, but only if you switch it on with
//lootryx heartbeat on. It is off by default. - Sign every report, so only your linkshell can accept it.
It does not
- Move, target, claim, cast, or use items.
- Write to game memory, send anything to the game server, or modify packets.
- Automate any part of playing the game, or act without you typing something.
- Write any file other than your own macro files and its own settings file, ever.
- Read anything beyond party and alliance names, your own character, and your own macro files.
- Detect drops or lots by itself. A drop is reported because you typed it.
Some of those commands spend points or change records, so they are listed here rather than buried in the reference: //lootryx bid and //lootryx allin commit DKP to a sealed auction, and //lootryx tod can be configured by your shell to award it. Everything the addon reads is either available to any player through the standard Windower party API, or a file already on your own disk.
Install for Windower
- Place the addon folder in your Windower install at
Windower4/addons/lootryx/, so you haveWindower4/addons/lootryx/lootryx.lua. - In game, load it with
//lua load lootryx. - Confirm it loaded with
//lootryx help. Every command is also a button in//lootryx window.
Connect in one command
Get a code on the web, type it in game. That is the whole thing: the code fetches your credentials and links the character you are logged in as, in a single step. Your credentials are your own, tied to your membership, and revocable at any time.
- In the web app, open My Characters from the account menu, then find Connect your addon.
- Choose Get a setup code. It lasts ten minutes and works once.
- In game, on the character you are linking, run
//lootryx setup <code>.
No linkshell? You can still use it.
Run //lootryx setup world instead. It pairs against nothing but the character you are logged in as, with no account and no linkshell, and the Party Finder and the linkshell directory work immediately. That identity lives only in the addon's own settings file, so if you later make an account, run //lootryx claim and enter the code it prints under My Addon on the website to keep it, along with your listings, parties and reputation.
The manual route still works if you prefer it. //lootryx key <id> <secret> takes credentials directly, or you can edit the <global> block in Windower4/addons/lootryx/data/settings.xml and reload:
<settings>
<global>
<key_id>mem_xxxxxxxxxxxxxxxxxxxx</key_id>
<secret>your-generated-secret</secret>
<api_base>https://lootryx.com/api/ingest</api_base>
<shell_slug>your-shell</shell_slug>
<interval>300</interval>
<auto>false</auto>
</global>
</settings>Windower keeps settings per character, so an alt inherits whatever the shared block holds. The addon notices and refuses rather than reporting under the wrong name: run //lootryx setup <code> on each character you play.
The //lootryx commands
Generated from the addon's own help text, so this list is exactly what version 0.39.0 responds to. You can print the same thing in game with //lootryx help all.
Getting set up
//lootryx setup <code> | ONE command: fetch your key and link this character |
//lootryx key <id> <secret> | the manual alternative, if you prefer |
//lootryx link <code> | verify your character with a site link code |
//lootryx setup world | no linkshell, no account: party finder only |
//lootryx claim | get a code to keep this character on your lootryx.com account |
Attendance
//lootryx snap | post an alliance attendance snapshot now |
//lootryx show | print the alliance read (no network) |
//lootryx auto on|off | toggle auto snapshots |
//lootryx roster +A,B -C | count people the 18-slot alliance cannot show (or `clear`) |
//lootryx tod <target name> | report a Time of Death you just witnessed (you get the credit) |
Loot and DKP
//lootryx drop <item> <winner> | report a drop you saw awarded (winner is the LAST word) |
//lootryx auctions | what is open for bidding right now |
//lootryx bid <n> <amount|N%> | bid on auction <n> (add "low" for the low lane) |
//lootryx allin <n> | offer your whole balance on auction <n> (asks you to confirm) |
//lootryx auction <item> | OFFICER: open an auction on a pool drop |
//lootryx dkp | your own DKP balance (every wallet, never summed) |
//lootryx standings [pool] | top 10 by current balance |
//lootryx wish [add|remove] <item> | your loot wishlist (no argument lists it) |
//lootryx wishlist | the same thing, spelled out |
//lootryx wish max <amount|off> <item> | your standing sealed pre-bid on it |
//lootryx item <name> | what it is, and what your shell values it at |
Your linkshell
//lootryx events | what is scheduled, and whether a check-in is open |
//lootryx signup <n> <going|late|maybe|out> | answer event n, as the job you are on |
//lootryx windows | tracked HNM targets, next window + a countdown |
//lootryx bounties | what the shell is paying DKP to have brought in |
//lootryx loot | the most recent drops and where they went |
//lootryx bank | what the shell is holding, and what of it is sellable |
//lootryx polls | what the shell is deciding, and how the vote stands |
//lootryx poll | the same list, singular |
//lootryx vote <poll> <choice> | answer one; the same choice again takes it back |
//lootryx myjobs [job|here|-] [2nd] [3rd] | your ranked jobs; "here" = the job you are on |
//lootryx jobs | the same thing, shorter |
Finding people
//lootryx shells | linkshells recruiting on your world (no account needed) |
//lootryx pf list | open Party Finder listings on your world (no account needed) |
//lootryx pf post <CAT> <ROLE> [comment] | post a listing |
//lootryx pf join <id> [role] | join a listing |
//lootryx statics | who is recruiting a static, and who is looking |
//lootryx seekers | the same board, from the other side |
//lootryx unseek | take yourself off the seeker board |
The window and the overlay
//lootryx window | tabs, boards, and most of this list as buttons |
//lootryx theme [name] | recolour the window (Vana'diel, Bastok, San d'Oria, ...) |
//lootryx hud on|off | a small overlay with whatever is most urgent, no network |
Your macros
//lootryx macros push | read + push changed macro books to Lootryx |
//lootryx macros pull <activeBookIndex> | pull + write web-edited books to your local files |
When something looks wrong
//lootryx status | connection + the last ingest result |
//lootryx selftest | check everything that works without the network, and report |
//lootryx heartbeat on|off | report your zone so the shell can see who is where (off by default) |
//lootryx show is a safe way to see exactly what the addon reads without sending anything: it prints your alliance locally and makes no network request. //lootryx selftest checks everything that works offline and reports what it found.
Your data
A snapshot sends your own character name, the names of the alliance members around you at that moment, and a timestamp. Other commands send what you would expect them to: a bid sends an amount, a signup sends your answer and the job you are on, a Party Finder post sends the text you typed. Your signing secret never leaves your local settings; it is used to sign requests, never sent.
//lootryx macros pushreads your own macro book files and sends only the ones that changed: your character name and each book's title, page layout, and macro lines. //lootryx macros pull <activeBookIndex> is the only command that writes to your macro files. It is restricted in code to your own mcr*.dat/mcr.ttl files, backs up the previous file before every overwrite, and always refuses the book you tell it you currently have open in-game.
You can rotate or revoke your credentials at any time from My Characters, and a revoked key stops working immediately. Your linkshell's own records stay behind its membership permissions; only public listings appear in the Party Finder and the linkshell directory.