Docs / Discord bot
Discord bot

Your linkshell, in your server

Standings, DKP, events, auctions, and HNM windows, answered with a slash command. Same numbers as the website, no tab-switching.

Add Lootryx to your server

Sign in, open your linkshell's Settings, and connect Discord in one step: the bot joins already bound to your shell, so standings, events, and RSVP buttons answer with your data from the first command.

  1. Sign in with Discord at lootryx.com.
  2. Open your linkshell's Settings.
  3. Select Connect Discord and approve the install.

What it is

The Lootryx bot reads from the same database as the web app, so what you see in Discord and what you see on the site never disagree. It is a console: almost every command just shows you something. Only /event is interactive, posting an event with buttons people can click.

Times are rendered with Discord’s own time tags, so a countdown like “closes in 12 minutes” stays correct in each person’s own timezone without the bot re-posting anything.

One bot, every server

A single Lootryx bot deployment serves every connected linkshell: each Discord server is bound to exactly one shell, and commands answer from that shell’s data only, never another server’s.

Sign in and open your linkshell’s Settings to add the bot to your server and bind it in one step: go to your linkshells.

How attendance works

RSVP is intent, not attendance

/event posts an event with five buttons: Attending, Bench, Late, Tentative, and Absent. Tapping one records that a member plans to show up (or not) and updates the counters and the attending list right there in the post.

Clicking a button never awards DKP. An RSVP is a heads-up, nothing more. DKP for showing up is only ever awarded from a verified in-game presence check, not from a button press. So the buttons tell your officers who intends to come, and the game itself confirms who actually did.

Reference

Every command

The bot ships these commands today. If a command is not on this list, the bot does not have it yet. Reads commands show information; Posts commands add something new to the channel (an event, a poll, an announcement, a public roll). Options in <angle brackets> are required; options in [square brackets] are optional.

DKP

/standingsThe top 10 members by current DKP.Reads
/dkp<character>One character’s DKP: balance, total earned, total spent.Reads
/mydkpYour own DKP: balance, total earned, total spent, and your rank. Replies privately.Reads

Events

/eventsUpcoming events, soonest first, in each viewer’s local time.Reads
/event[id]Posts an event with RSVP buttons. Leave the id blank for the next one.Posts
/signup<event> <status> [job]Signs you up for an event by name, no need to hunt for the RSVP post. Replies privately.Reads
/signed[id]Who has signed up to an event, grouped by status.Reads
/unsigned[id]Active members who have not answered an event yet.Reads
/poll<question> <options> [hours] [cap]Posts a poll with vote buttons; tallies update live as people vote.Posts
/timepoll<question> <slots> [hours] [autocreate]Posts a poll for the best time; the winning slot creates the event automatically. Officers only.Posts

Treasury

/auctionsOpen loot auctions and when each one closes. Bid amounts stay sealed.Reads
/bankWhat the guild bank holds, with totals for items and sellable gil.Reads
/bountiesOpen bounties, the DKP each pays, and how many slots are left.Reads
/lootThe last 10 loot drops and where each one went.Reads

HNM windows

/windowsLive HNM spawn windows (camp now, opens at, missed) plus pop-item stock.Reads

Account

/rosterHow many active members you have in each role, plus the total.Reads
/whoamiYour Lootryx identity: role, main character, and DKP balance. Replies privately.Reads
/linkHow to link your Discord account to Lootryx, and whether you already have. Replies privately.Reads
/applyStart a guild application, if the linkshell is accepting them right now. Replies privately.Reads
/applicationsPending join requests waiting on review. Officers only, replies privately.Reads
/announce[message] [title] [event] [template]Posts an officer announcement to the events channel, or here. Officers only.Posts

Fun and help

/roll[max] [for]Rolls dice (0 to 999 by default), publicly. Optional max and a reason.Posts
/helpLists the commands the bot has.Reads

Most Reads commands post their answer where you run them, so the whole channel sees it. A handful reply privately instead, because the answer is personal or officer-only: /mydkp, /whoami, /link, /signup, /apply, /applications, plus the note when /dkp cannot find a character and the nudge when someone who has not linked taps an RSVP button.

Trust

Privacy and GM safety

The bot is built to be safe to run in an FFXI community and easy for a GM to audit.

  • It reads no message content. It uses only Discord’s basic connection, the same one slash commands and buttons need. It cannot read your channels’ chat.
  • It takes no in-game actions. It only shows information and records button clicks. It never touches the game.
  • Bids stay sealed. /auctions tells you an auction is open, its tier, and how many bids are in, but never what anyone bid. Bidding itself happens on the web app.