# Officer Commands
Source: https://docs.throney.gg/commands/officer-commands
Comprehensive guide to commands available for officers in Throney, allowing advanced management of guilds, alliances, and members.
Officers in Throney have access to advanced commands that facilitate better guild and alliance management. These commands provide tools for editing data, tracking members, and optimizing group efficiency.
## ๐ Command Overview
| Command | Description |
| ---------------------------- | ---------------------------------------------------------------------------------------------- |
| `/attendance` | Take attendance for events, logging participation automatically. |
| `/upload [image] [user]` | Upload an image for another member, allowing officers to update their gear data. |
| `/stats [image] [user]` | Upload an image for another member's stats, updating their build details. |
| `/edit` | Manually edit a user's data in case of OCR errors. |
| `/delete` | Remove a user's data from the system, typically used when a member leaves the guild. |
| `/alliance info` | Provides an overview of all guilds in the alliance, including gear averages and composition. |
| `/alliance members` | Displays a sortable list of all members across the entire alliance. |
| `/guild info` | Displays a breakdown of a specific guildโs members and their statistics. |
| `/guild members` | Lists all members within a specific guild and sorts them by a variable such as combat power. |
| `/remind [days]` | Sends a DM reminder to members who have not updated their gear within the specified timeframe. |
| `/alliance check` | Displays a list of members in the alliance who have not uploaded their gear. |
| `/events` | Lists all upcoming events and their assigned DKP values. |
| `/say` | Send a custom embed message as the bot with color, title, footer, and image options. |
| `/adjust [award]` | Grants DKP points to a user. |
| `/adjust [deduct]` | Deducts DKP points from a user. |
| `/topwishlist` | Displays the most desired items based on wishlist data. |
| `/checkwishlist` | Allows officers to check a specific user's wishlist. |
| `/bonus` | Take attendance not tied to a specific event type (ad-hoc DKP awards). |
| `/bulkadjust [award/deduct]` | Award or deduct DKP for all registered members at once. |
| `/loadout` | Display alliance loadout party compositions in Discord. |
| `/absent set` | Mark a member as absent/on leave for a date range. |
## `/attendance`
Logs attendance at the end of an event and tracks member participation. Officers can choose an event from a custom list created by the officer core. This command also integrates DKP values by assigning a configurable 'weight' to each event, allowing officers to track contributions effectively.
```bash theme={null}
/attendance
```
## `/edit`
Manually edit a user's data input in case of OCR errors. While we strive to make sure Throney is as accurate as possible, mistakes happen. this command is to correct them!
Officers can modify gear information if it was misread by the OCR. This is particularly useful for names with non-English characters.
```bash theme={null}
/edit
```
### ๐ธ **Example of an Edit Panel**
## `/delete`
Remove a user's data from the system, typically when they leave the guild.
```bash theme={null}
/delete
```
This command ensures that former members are no longer included in guild statistics.
## `/alliance info`
Provides an overview of all guilds in the alliance, including gear averages and composition.
```bash theme={null}
/alliance info
/alliance info [guilds] [classes]
```
### ๐ธ **Example of a `/alliance info` output**
Below is an example of a properly executed /alliance info command with guilds and classes enabled:
## `/alliance members`
Displays a sortable list of all members across the entire alliance.
```bash theme={null}
/alliance members
/alliance members [sort] [class]
```
### ๐ธ **Example of a `/alliance members` output**
Below is an example of a properly executed /alliance members command with the class Infiltrator as a filter and combat power as a metric
## `/guild info`
Displays a breakdown of a specific guildโs members and their statistics.
```bash theme={null}
/guild info
/guild info [name] [classes]
```
### ๐ธ **Example of a `/guild info` output**
Below is an example of a properly executed /guild info command with Guild A chosen
## `/guild members`
Lists all members within a specific guild and sorts them by a metric such as combat power.
```bash theme={null}
/guild members
/guild members [name] [sort] [classes]
```
### ๐ธ **Example of a `/guild members` output**
Below is an example of a properly executed /guild members command with Guild A and Ravager chosen sorting by combat power.
## `/remind [days]`
Sends a DM reminder to members who have not updated their gear within the specified timeframe.
```bash theme={null}
/remind
```
Officers can specify the number of days since the last update, and the bot will notify members who have not refreshed their gear. This helps ensure all player data remains up-to-date.
## `/alliance check`
Displays a list of members in the alliance who have not uploaded their gear.
```bash theme={null}
/alliance check
```
### ๐ธ **Example of an Alliance Check Report**
in this case, Vig from Guild A has not yet uploaded their gear and you can DM them to do so. the bot will not automatically DM them.
## `/events`
Lists all upcoming events and their assigned DKP values.
```bash theme={null}
/events
```
### ๐ธ **Example of Event List**
The points next to each event is the DKP value of the event.
## `/say`
Send a custom embed message as the bot in the current channel. Useful for announcements, reminders, or formatted guild messages.
```bash theme={null}
/say [description] [color]
/say [description] [color] [title] [footer] [image]
```
**Required:**
* **description** - The main text content of the embed. Use `\n` for line breaks.
* **color** - Choose from: Random, White, Aqua, Green, Blue, Yellow, Purple, Gold, Orange, Red, Navy, and more.
**Optional:**
* **title** - A title for the embed
* **footer** - Custom footer text
* **image** - Attach an image to display in the embed
The message is posted by the bot but shows your name as the author.
## `/adjust [award]`
Allows officers to manually **award** DKP points to a user.
```bash theme={null}
/adjust [award] [user] [amount]
/adjust award @user 50
```
This command is used to reward members for participation, achievements, or any custom criteria set by the guild.
## `/adjust [deduct]`
Allows officers to manually deduct DKP points from a user.
```bash theme={null}
/adjust [deduct] [user] [amount]
/adjust deduct @user 50
```
This command is used to remove DKP points for penalties, missed events, or other guild-related reasons.
## `/checkwishlist`
Allows an officer to check a specific users wishlist in discord
```bash theme={null}
/checkwishlist @user
```
This command helps officers track what users are looking for and better manage loot distribution.
## `/topwishlist`
Allows the officers to check the top 10 most desired items with prioritized requests
```bash theme={null}
/topwishlist
```
This provides officers with insight into which items are in the highest demand.
## `/bonus`
Take attendance for members in the voice channel without tying it to a specific event type. Useful for ad-hoc activities like helping with guild tasks, donations, or off-schedule participation.
```bash theme={null}
/bonus
```
Works identically to `/attendance` but records as a "bonus" attendance type.
## `/bulkadjust`
Award or deduct DKP for all registered members in your alliance at once.
```bash theme={null}
/bulkadjust award 50
/bulkadjust deduct 25
```
All bulk operations are logged in the audit trail with the officer who executed them.
## `/loadout`
Display alliance loadout party compositions directly in Discord. Shows party breakdowns with character names and roles.
```bash theme={null}
/loadout
```
Skips empty parties or loadouts with no members. Replaces the older `/party` command which has been removed.
# User Commands
Source: https://docs.throney.gg/commands/user-commands
Comprehensive guide to commands available for all Throney users, facilitating effective guild management and personal profile enhancements.
Throney offers a suite of commands empowering users to manage their profiles, gear, and engage seamlessly within their guilds. Below is a detailed guide to each command, its usage, and benefits.
## ๐ Command Overview
| Command | Description |
| ----------------- | ------------------------------------------------------------------------------------------- |
| `/upload` | Upload your gear by attaching a full screenshot of your character's profile page. |
| `/profile` | View your own or another user's gear set by mentioning them. |
| `/stats` | Upload your build stats, including Hit Chance, Critical Hit Chance, Evasion, and Endurance. |
| `/builds` | Display available class names and their associated weapon combinations. |
| `/questlog` | Add your build link to your character profile. |
| `/help` | Show a list of available commands for both members and officers. |
| `/absent` | Mark yourself as absent for a set timeframe and provide a reason. |
| `/return` | Return from an absence early and restore your active status. |
| `/wishlist` | Add an item to your wishlist with a priority level and an optional note. |
| `/dkp` | Check your current DKP balance. |
| `/mywishlist` | View your personal wishlist. |
| `/removewishlist` | Remove an item from your wishlist. |
| `/roll` | Roll dice with custom ranges or standard dice types (d4, d6, d8, d10, d12, d20, d100). |
| `/ping` | Check the bot's latency. |
| `/invite` | Get the bot invite link to add Throney to another server. |
| `/website` | Get the link to the Throney website and dashboard. |
## `/upload`
Upload your current gear to Throney's database, allowing for accurate tracking and display within your guild.
```bash theme={null}
/upload
/upload [user] *Officer Only Command*
```
## `/profile`
View your own gear setup or inspect another guild member's equipment
```bash theme={null}
/profile
/profile @username
```
## `/stats`
Upload and display your build statistics, providing leadership with insights into member capabilities.
```bash theme={null}
/stats
/stats [user] *Officer only Command*
```
Attach a screenshot that displays your Hit Chance, Critical Hit Chance, Evasion, and Endurance. While optional, this command is highly recommended as it allows officers to analyze guild statistics and determine build trends.
## `/builds`
Explore available classes and their corresponding weapon combinations.
```bash theme={null}
/builds
```
### ๐ Example Class & Weapon Combinations
| Class | Weapons |
| ------------- | ----------------------------- |
| **Crusader** | Greatsword + Sword and Shield |
| **Seeker** | Longbow + Wand |
| **Berserker** | Sword and Shield + Daggers |
| **Ravager** | Greatsword + Daggers |
| **Templar** | Sword and Shield + Wand |
## `/absent`
Use this command to mark yourself as absent for a specific timeframe. This will be logged in your profile and eventually reflected on the Throney dashboard and Dynamic Events (Signups).
typing /absent opens up a form, which asks for information related to your leave of absence.
```bash theme={null}
/absent
```
Absences automatically prevent you from appearing in Signups (Dynamic Events).
Officers can view absences in user profiles after T2 launch.
## `/return`
Allows you to return from an absence early, restoring your active status.
```bash theme={null}
/return
```
This will update your status back to active in the system.
Your participation in Signups (Dynamic Events) will be back to normal when this feature is fully integrated.
๐ Future Enhancements for Absence Tracking
* Officers will see absences on the dashboard after T2 launch.
* Users marked as absent will automatically be removed from event signups.
* Possible automated role adjustments for absent players.
## `/wishlist`
The `/wishlist` command allows users to add items they want to a wishlist with a priority level and an optional note.
```bash theme={null}
/wishlist [Optional: note]
```
### **Priority Levels**
* archboss ๐ฃ
* high ๐ด
* medium ๐ก
* low ๐ข
Items are found by searching for the name of the item.
Optional: Users can add a note for more details.
## `/dkp`
View your DKP balance as an ephemeral message.
```bash theme={null}
/dkp
```
## `/mywishlist`
View your wishlist as an ephemeral message.
```bash theme={null}
/mywishlist
```
## `/removewishlist`
Remove an item from your wishlist.
```bash theme={null}
/removewishlist
```
Search for the item name and select it. The item is removed from your wishlist immediately.
## `/questlog`
Link your build or specialization info to your character profile so officers and members can see it.
```bash theme={null}
/questlog
```
The link appears on your `/profile` embed and on the dashboard player profile.
## `/roll`
A simple dice roller for loot rolls, tiebreakers, or just for fun.
```bash theme={null}
/roll
/roll [min] [max]
/roll [sides]
```
* Default range is 0-100
* Optionally set custom min/max values
* Or pick a standard dice type: d4, d6, d8, d10, d12, d20, d100
## `/ping`
Check the bot's current latency (client and websocket ping).
```bash theme={null}
/ping
```
## `/invite`
Get the invite link to add Throney to another Discord server.
```bash theme={null}
/invite
```
## `/website`
Get a quick link to the Throney website and dashboard.
```bash theme={null}
/website
```
# Attendance Tracking
Source: https://docs.throney.gg/features/attendance
Track event participation, assign DKP values, and manage attendance records.
The Attendance Tracking system lets officers record who attended events and automatically integrates with the **DKP System** to assign rewards based on participation.
## ๐ Custom Server Events
Officers can **create and edit custom server events** directly from the **Throney Dashboard** under their alliance settings. Events can be configured with:
* **Custom Names:** Label the event appropriately (e.g., "Guild Meeting," "World Boss," "Siege", "Nodewar (Boon) or (Rift)").
* **DKP Values (Weight System):** Assign a weight to each event, allowing it to impact the **DKP System**.
* **Tracking & Logs:** Attendance records are stored and can be reviewed later for accuracy using these same values created.
***
## ๐ ๏ธ How to Use Attendance
### **1. Creating a Custom Event**
To create or edit a custom event, follow these steps:
* Go to the **Throney Dashboard** and select your **alliance**.
* Navigate to **"Attendance Tracking" โ "Manage Event Types"**.
* Click **"Add New Event"** and enter the event details.
* Set the **DKP weight** for the event.
* Save the event.
### **2. Taking Attendance via Command**
At the end of an event, use the following command in Discord:
```bash theme={null}
/attendance [event]
```
* Select the event from the available list.
* The system will automatically track members present in the `same voice channel` as the officer using the command or event chat.
All users who attended the event must be in the same voice channel as the officer using the attendance command. If they are not in the VC at the time of the command, they will not be credited with the attendance or be given DKP.
### 3. Editing or Adjusting Types of Events
* Go to Throney Dashboard โ Attendance Tracking โ Manage Event Types.
* Click on an existing event to edit its details.
* Modify the event name, DKP weight, or schedule.
* Save the changes.
This edited or newly created event will now show in the "options" when prompting the `/attendance` command and `/events` command
## **๐ Managing Attendance Records**
Officers can **edit event details, modify attendance records, or delete events** using the **Throney Dashboard**.
### **1. Accessing Attendance Records**
* Navigate to the **Alliance Dashboard**.
* Locate the **Events Panel** and click **"View Server Events"**.
* This will display a list of all attendance records collected via the `/attendance` command.
### **2. Editing Attendance Records**
* Find the event you wish to modify and click **"Manage Event"**.
* Here, you can:
* **Edit Participants**: Add or remove users who may have left early or were mistakenly credited.
* **Modify Event Type**: Adjust the event type in case the wrong one was selected during attendance.
* **Delete Event**: Completely remove the attendance record from the system if necessary.
Changes made in the **Manage Event** section will be reflected in all attendance logs and DKP records.
By using these tools, officers keep event tracking and DKP distribution accurate and clean.
***
## `/bonus` Command
The `/bonus` command works identically to `/attendance` but is not tied to a specific event type. Use it for ad-hoc DKP awards like helping with guild tasks, donations, or off-schedule participation.
```bash theme={null}
/bonus
```
***
## Access Code System
Officers can generate a secret keyword when taking attendance. Members who missed the voice channel check can enter this code afterward to register their attendance.
Attendance types in the system:
* **automatic**: Recorded via `/attendance` (voice channel detection)
* **manual**: Added by an officer through the dashboard
* **access\_code**: Submitted by a member using the event keyword
* **bonus**: Logged via the `/bonus` command
***
## Absent Player Highlighting
On event detail pages, absent players are highlighted with an alert banner showing the count of members who did not attend. This makes it easy to spot who was missing at a glance.
***
## Bulk Event Deletion
Select multiple attendance events from the table using checkboxes and delete them in one action. A confirmation dialog prevents accidental deletions. All related records (attendance entries, DKP adjustments) are removed atomically.
# Audit Logs
Source: https://docs.throney.gg/features/audit-logs
Track every action taken in your alliance with a detailed, searchable activity log.
**Audit Logs** give officers full visibility into every action taken across the alliance. Every DKP adjustment, attendance call, application review, settings change, and member action is recorded with timestamps and who performed it.
Audit Logs are **officer-only**. Members cannot access this page.
***
## What Gets Logged
| Category | Actions Tracked |
| ---------------- | ------------------------------------------------------------------------ |
| **DKP** | Point awards, deductions, bulk adjustments, decay events, auction awards |
| **Attendance** | Attendance calls, bonus events, member check-ins |
| **Applications** | Application submissions, approvals, rejections, blocklist changes |
| **Events** | Event creation, deletion, signup changes |
| **Members** | Character uploads, edits, deletions, guild transfers |
| **Settings** | Channel changes, role updates, feature toggles |
***
## Using Audit Logs
Navigate to **Audit Logs** in the sidebar.
### Searching
Use the search bar to find specific entries by keyword. Search matches against the log message text.
### Filtering by System
Filter logs by system category using the dropdown. Each system has a color-coded badge for quick visual scanning:
* **DKP** - Point and loot system actions
* **Attendance** - Event attendance tracking
* **Applications** - Recruitment pipeline actions
* **Events** - Scheduled event management
* **Members** - Character and roster changes
* **Settings** - Configuration changes
### Log Details
Each entry shows:
* **Timestamp** - When the action occurred
* **System badge** - Which feature area the action belongs to
* **Description** - What happened, including who did it and what was affected
***
## Best Practices
Check audit logs regularly if multiple officers manage the alliance. It's the fastest way to understand what changed and who changed it.
* Review logs after major events (attendance calls, DKP distributions) to verify everything was recorded correctly
* Use system filters to focus on a specific area when investigating an issue
* Audit logs are read-only and cannot be deleted or modified
# Guild Member Profiles
Source: https://docs.throney.gg/features/characters
The Character System in Throney
Throney's **Character System** automates player data tracking so guild leadership always has accurate, up-to-date information without manual input.
Members upload their character data with a few simple commands.
***
## ๐ `/upload` โ The Core Command
The `/upload` command **automatically captures** the following details from a player's **in-game character profile**:
* **Character Name**
* **Class**
* **Level**
* **Stats (Strength, Dexterity, Wisdom, Perception, Fortitude)**
* **Gear Setup**
**Guild Affiliation** is assigned by the member role set during `/setup`, automatically linking members to the correct guild based on Discord roles.
### ๐ท How to Upload a Profile
1. Open the **Character Profile Page** (`P` by default).
2. Take a **screenshot** of your characterโs profile.
3. Paste the **image** into the `/upload` command in Discord.
Throney will **extract and update all relevant data** using AI-powered OCR (GPT-5.2).
### Language Support
`/upload` natively supports **English and Portuguese** class names. For players using other languages (German, French, Spanish, Japanese, Korean, etc.), the system detects the class from the weapon combination shown in the screenshot. All 35 classes are supported regardless of language.
***
## ๐ธ Example Character Profile Upload
**No manual data entry is required.** Once uploaded, your **Character name, class, combat power, and stats** are automatically updated within Throney.
***
## ๐ `/stats` โ Build Tracking
Members can **add additional build stats** by using the `/stats` command.
This **optional** command allows users to **attach a screenshot** showing deeper stat information like **Evasion**, **Endurance**, **Critical Hit Chance**, and **Hit Chance**.
### ๐ท Where to Find This Image?
The build stats are found on the **Character Page**, accessible by clicking the **small stat button**.
### Example of a Proper `/stats` Upload
๐ก **`Why Use /stats?`**
* Complements the character profile.
* **Website breakdowns** analyze build focuses across the guild (Endurance-heavy, Evasion-heavy, Crit-focused, etc.).
* Reflected in **individual profiles** for easy officer reference.
๐ **Recommendation:** Ensure that your `/stats` upload closely matches the example format above for best OCR accuracy.
***
## ๐ท๏ธ `/profile` โ View Full Character Details
The `/profile` command provides a **quick snapshot** of any guild memberโs information.
### ๐ What `/profile` Displays:
* **Class & Combat Power**
* **Guild Name**
* **Gear Overview**
* **Stats Overview**
* **Quest Log Build Input** (NEW!) โ Player-submitted build links via `/questlog`
***
### ๐ธ Example of a `/profile` Embed
***
### How to Use `/profile`
* `/profile` โ View your own profile.
* `/profile @user` โ View another guild memberโs profile.
๐ ๏ธ Clicking **Gear** or **Stats** toggles the embed view.
๐ If the user has a **Quest Log** (build input), it will also be shown.
***
## ๐ `/questlog` โ Build Input (NEW)
The `/questlog` command allows players to link their questlog that contains information about their builds, specialization, or focus.
```bash theme={null}
/questlog
```
This link appears on the playerโs profile.
Officers and members can easily view intended builds and specializations.
## ๐ฏ `/wishlist` โ Item Wishlist (NEW)
The `/wishlist` command allows members to indicate high-priority items they are interested in acquiring during loot distribution.
```bash theme={null}
/wishlist
```
Priority levels:
* ๐ด High Priority
* ๐ Medium Priority
* ๐ข Low Priority
* ๐ฃ Archboss Item
Officers can view wishlists via the dashboard or Discord commands.
Wishlists help guide DKP loot decisions and item distributions fairly.
๐ Wishlists are fully integrated into player profiles for quick viewing.
Members can also remove wishlist items using `/removewishlist`.
***
## ๐ Gear Progression Tracking
Every time a member uses `/upload`, Throney records a stat snapshot. This powers the **Gear Progression Chart** on player profiles in the dashboard.
* View Combat Power history over time on an interactive chart
* Click any data point to see the full stat breakdown at that moment
* Compare changes between snapshots with delta values
Snapshots are only created when combat power changes, so duplicate uploads do not clutter the history.
# Loot Systems
Source: https://docs.throney.gg/features/dkp
Detailed breakdown of Throneyโs two loot distribution systems: DKP Item Listings and DKP Loot Auctions.
Throney offers three systems for managing loot in your alliance:
1. **Loot Bank**: Upload guild storage screenshots and AI extracts items for routing to auctions or listings.
2. **DKP Item Listings**: Simple upgrade/trait/litho bidding via Discord reactions.
3. **DKP Loot Auctions**: Live, DKP-based bidding with automatic deductions.
All systems are fully integrated with the Throney Dashboard and Discord.
***
## ๐ฆ Loot Bank (AI-Powered Item Import)
The Loot Bank lets officers upload screenshots of their guild's item storage chest. Throney's AI extracts all visible items and matches them against the full game database (2000+ items).
### How It Works
1. Go to **Loot Bank** on the dashboard
2. Upload one or more screenshots of your guild storage
3. AI extracts item names and fuzzy-matches them to the database
4. Review the results. Search and reassign items if the AI got one wrong.
5. Select items and route them to **Auctions** or **Item Listings** in bulk
Multi-screenshot support means you can upload your entire storage chest at once.
***
## ๐ฆ DKP Item Listings (Upgrade / Trait / Litho)
This system lets officers post an item to Discord and have users respond by selecting one of three interest categories:
* ๐บ **Upgrade** โ High-priority gear for your main build.
* ๐งฌ **Trait** โ Secondary spec or trait-related interest.
* ๐ **Litho** โ Desired for lithograph crafting or exchange.
### ๐ How to Create a DKP Item Listing
1. Go to the **[Throney Dashboard](https://www.throney.gg)**.
2. Navigate to your **Alliance Dashboard**.
3. Under the **Item Panel**, click **Manage Items**.
4. Hit **"Add New Item"** and fill out the following:
* **Channel** โ Where the item post will appear in Discord.
* **Item** โ Choose from your guildโs loot list.
* **Notes** โ Optional explanation or rules.
Once submitted, the bot posts the item to Discord with reactions for Upgrade, Trait, and Litho.
### ๐ง System Behavior
* Once a member reacts, the bot **marks them as responded**.
* Officers can **award the item** via the dashboard โ the system will:
* **Deduct DKP**
* **Reject all other bidders automatically**
You can also use our internal "roll" system to roll the item between the reacted members.
> โ ๏ธ Always delete listings from the dashboard โ not from Discord โ to avoid sync issues.
***
## ๐ฆ DKP Loot Auction System (Live Bidding)
This is a **separate, advanced system** designed for real-time, competitive bidding.
### ๐ Features
* Officers can:
* Set **starting bid**
* Set **bid increment**
* Configure the **Discord channel**
* Define the **auction end time** (manual or auto)
* Members can:
* Click **Bid** in Discord
* Have DKP **automatically deducted**
* Re-bid as long as they have balance (configurable soon)
### โ๏ธ Staff Tools
* End auction manually from the dashboard
* Delete auction listings (also removes the Discord message)
* Void individual bids from the dashboard
* Auction visibility & history stored on the dashboard
> Auctions created on the dashboard take \~1-2 minutes to sync to Discord.
### Blind Auctions
Blind auctions (Vickrey-style) keep all bid information private. Bidder names, bid amounts, and real-time updates are hidden from other members. Only the winner is revealed when the auction ends.
### Outbid Notifications
When someone places a higher bid on an auction, the previous highest bidder receives a DM notification so they can bid again if they choose.
### Anti-Sniping Protection
If a bid is placed near the end of an auction, the timer extends automatically:
* Bid with less than **1 hour remaining**: adds **+1 minute**
* Bid with less than **5 minutes remaining**: adds **+2 minutes**
This prevents last-second sniping and gives all members a fair chance to respond.
### Bid Safety
All bids use atomic database transactions to prevent DKP double-spend during race conditions. If two members bid at the same time, the system processes them safely in order.
Users **cannot outbid themselves**. You must wait for another member to place a bid before bidding again.
***
## โ๏ธ Which Should I Use?
| Feature | DKP Item Listings | DKP Loot Auction |
| -------------- | ------------------------- | ---------------------- |
| Bidding Type | Reaction-based | Live auction system |
| Member Control | Single reaction | Real-time DKP bidding |
| DKP Deduction | On item award | Immediate per bid |
| Staff Control | Dashboard only | Dashboard (full tools) |
| Use Case | Simpler loot, fewer users | High-competition loot |
***
***
## ๐ DKP Decay
DKP decay prevents point hoarding by automatically reducing balances on a schedule. This keeps the economy active and encourages members to spend their points.
### How It Works
* Officers set a **decay percentage** (e.g., 10%) and **schedule** (weekly or monthly)
* On each decay cycle, every member's DKP balance is reduced by the configured percentage
* Decay events are logged in the audit trail
* Members are not notified individually, but officers can see the aggregate impact
### Configuration
Navigate to **Settings > DKP Settings** to configure:
* **Decay Rate** - Percentage deducted per cycle (0% to disable)
* **Decay Schedule** - Weekly or monthly application
A 5-10% weekly decay keeps the economy healthy without punishing members who can't attend every event. Adjust based on your alliance's activity level.
### DKP Analytics
The **DKP Analytics** page shows:
* Balance distribution across members
* Spending trends over time
* Auction activity and win rates
* Top earners and spenders
Navigate to **DKP > Analytics** in the sidebar.
***
## `/bulkadjust` (Officer Command)
Award or deduct DKP for all registered members in your alliance at once. Useful for season resets, weekly bonuses, or alliance-wide penalties.
```bash theme={null}
/bulkadjust award 50
/bulkadjust deduct 25
```
All bulk operations are logged in the audit trail.
***
For all loot systems and documentation updates, visit the [Throney Dashboard](https://www.throney.gg) or check the [Changelog](https://docs.throney.gg/updates/changelog).
# Leaderboard
Source: https://docs.throney.gg/features/leaderboard
View alliance rankings by DKP, activity, attendance, and member statistics.
The Leaderboard feature provides a comprehensive view of member rankings across multiple metrics.
## ๐ Accessing the Leaderboard
Navigate to **Alliance Dashboard โ Leaderboard** to view rankings.
***
## ๐ Ranking Categories
### DKP Rankings
* **Lifetime DKP** โ Total DKP earned all-time
* **Current Balance** โ Available DKP for bidding
### Activity Rankings
* **Events Attended** โ Total event participation count
* **Last Active** โ Most recent activity timestamp
### Statistics
* **Gear Score** โ Character power level
* **Combat Power** โ Overall combat effectiveness
***
## Role-Based Leaderboards
Filter the leaderboard by role to see top players per category:
* **Tank** leaders
* **MDPS** leaders
* **RDPS** leaders
* **Healer** leaders
* **Bomber** leaders
Role cards display in a 2-column layout for easier comparison.
If your alliance uses custom class role mappings (configured in Alliance Settings), the leaderboard respects those overrides.
***
## ๐ Features
* **Search & Filter**: Find specific players quickly
* **Sortable Columns**: Click headers to sort by any metric
* **Role Indicators**: Visual badges for roles (Tank, Healer, DPS, etc.)
* **Server Selection**: Switch between alliance servers
***
## ๐ Use Cases
* Identify most active members for officer promotions
* Track DKP leaders for loot priority
* Monitor member engagement over time
* Recognize top contributors to the alliance
# Players Management
Source: https://docs.throney.gg/features/players
View and manage alliance members, their stats, DKP history, and attendance records.
The Players Management system provides officers with a comprehensive view of all alliance members and their data.
***
## ๐ Players Overview
Navigate to **Management โ Players** to see all alliance members in a sortable, searchable table.
### Displayed Information
* **Discord Name** โ Member's Discord identity
* **Characters** โ Linked in-game characters
* **Gear Score** โ Current gear level
* **DKP Balance** โ Available points
* **Events Attended** โ Attendance count
* **Last Active** โ Recent activity timestamp
***
## ๐ Search & Filter
* **Search by Name** โ Find specific players
* **Filter by Role** โ Tank, Healer, MDPS, RDPS, Bomber
* **Sort Columns** โ Click headers to sort by any field
***
## ๐ค Individual Player Profiles
Click on any player to view their detailed profile:
### Profile Sections
**Character Info**
* All linked characters
* Gear score per character
* Primary role/class
**DKP History**
* Full transaction log
* Points earned from events
* Points spent on items
* Manual adjustments by officers
**Attendance Record**
* Events attended with dates
* Event types breakdown
* Attendance percentage
**Wishlist**
* Items on their priority list
* Priority levels for each
**Gear Progression**
* Interactive Combat Power chart showing history over time
* Click any data point for a full stat snapshot at that moment
* Delta comparisons between snapshots
**Recent Events**
* Last 5 attendance events and signup events the player participated in
* Direct links to each event page
***
## ๐ ๏ธ Officer Actions
From a player's profile, officers can:
* **Adjust DKP** โ Add or subtract points manually
* **View Full History** โ See all transactions
* **Check Attendance** โ Review participation
* **Review Wishlist** โ See their item priorities
All DKP adjustments create an audit trail visible in the player's history with the reason provided.
***
## ๐ Bulk Management
The Players page supports:
* **Export to CSV** โ Download member data
* **Bulk Selection** โ Select multiple members
* **Quick Stats** โ Alliance-wide statistics summary
# Recruitment & Applications
Source: https://docs.throney.gg/features/recruitment
Build custom application forms, post recruitment embeds, and review applicants through Discord threads and the web dashboard.
The **Recruitment System** gives officers a complete pipeline for handling guild applicants. Build custom forms, post recruitment embeds in Discord, and review applications through Discord threads or the web dashboard.
This is a **premium** feature. Free-tier alliances cannot access recruitment tools.
***
## How It Works
1. **Officers create forms** with custom questions on the web dashboard
2. **Officers post recruitment embeds** in Discord channels with Apply buttons
3. **Applicants fill out forms** via the public apply page or Discord buttons
4. **A review thread is created** in your designated channel with the applicant's responses
5. **Officers review** using Accept/Deny buttons in Discord or on the web dashboard
6. **Applicants get notified** via DM with the decision and any message from officers
***
## Creating Application Forms
Navigate to **Dashboard > Recruitment > Forms** and click **Create Form**.
### Form Settings
* **Title** - The name applicants see when choosing which form to fill out
* **Description** - Optional context shown at the top of the form
* **Active** - Toggle whether the form accepts new submissions
* **Review Channel** - Where review threads are created (overrides the default)
* **Cooldown** - Days an applicant must wait after rejection before reapplying
* **Minimum Account Age** - Reject accounts younger than this (in days)
* **Required Roles** - Discord roles the applicant must have to submit
### Question Types
Forms support 8 block types:
| Type | Description |
| ----------------- | ------------------------------------------------ |
| **Short Text** | Single-line text input |
| **Long Text** | Multi-line paragraph input |
| **Number** | Numeric input |
| **Yes/No** | Boolean toggle |
| **Single Select** | Dropdown with one choice |
| **Multi Select** | Checkboxes for multiple choices |
| **Image** | Image upload field |
| **Info** | Read-only text block (instructions, rules, etc.) |
Each question can be marked as **required** or optional, and has an optional description field for extra context.
Drag blocks to reorder them. The form builder has a **live preview** on the right side showing exactly how your form will look to applicants.
***
## Posting Recruitment Embeds
Navigate to **Dashboard > Recruitment > Embed Builder**.
The embed builder is a WYSIWYG editor that lets you design Discord messages with:
* **Text blocks** - Plain message content with Discord markdown support
* **Embed blocks** - Rich embeds with color, title, description, author, images, fields, and footer
* **Separator blocks** - Visual spacing between sections
* **Button blocks** - Link buttons with custom labels
### Form Buttons
Below the editor, toggle which application forms appear as buttons on the embed. Each button can have:
* A custom label (defaults to the form title)
* A style: Primary (purple), Secondary (gray), or Success (green)
### Posting
1. Select a text channel from the dropdown
2. Click **Post Embed**
3. The message appears in Discord with your form buttons attached
To edit an existing embed, click **Edit** on any active embed in the list, make changes, and click **Update Embed**.
***
## Public Apply Page
Every alliance gets a shareable apply link:
```
https://throney.gg/apply/YOUR_SERVER_ID
```
Find your link in **Dashboard > Recruitment > Settings**.
When applicants visit the link:
1. They log in with Discord (if not already)
2. They see all active forms and pick one
3. They fill out the form with validation
4. They review their answers before submitting
5. They see a confirmation page
Applicants can also view and withdraw their pending applications.
***
## Discord Review Threads
When an application is submitted, Throney creates a **thread** in your review channel with:
* The applicant's Discord username and ID
* All their responses formatted as embed fields
* Four action buttons:
| Button | Action |
| ---------------- | --------------------------------------------------------------------------------- |
| **Accept** | Opens a modal for an optional message and notes, then approves the application |
| **Deny** | Opens a modal for an optional message and notes, then rejects the application |
| **DM Applicant** | Opens a modal to send a custom message to the applicant without making a decision |
| **View on Web** | Links to the full application review page on the dashboard |
After a decision:
* The thread embed changes color (green for accepted, red for denied)
* Buttons are disabled
* A summary message is posted in the thread
* The applicant receives a DM with the decision
***
## Web Dashboard Review
Navigate to **Dashboard > Recruitment > Applications** to see all submissions.
### Filtering
* Filter by status: Pending, Approved, Rejected
* Search by applicant username
* View counts for each status
### Reviewing an Application
Click any application to see:
* Applicant info (avatar, username, Discord ID)
* All form responses rendered by type
* Application timeline
* Previous applications from the same user
Use the **Accept** or **Deny** buttons on the right sidebar. Both open a dialog where you can:
* Write a **message to the applicant** (sent via DM)
* Add **internal notes** (visible only to officers)
***
## Applicant Blocklist
Navigate to **Dashboard > Recruitment > Blocklist**.
Block specific Discord users from submitting applications. Blocked users see an error when they try to apply. Each entry shows who blocked them and when.
***
## Settings
Navigate to **Dashboard > Recruitment > Settings**.
* **Default Review Channel** - Where application review threads are created (can be overridden per form)
* **Public Application Link** - Copy and share your alliance's apply URL
***
## Bot Commands
| Command | Description | Access |
| ---------------------- | -------------------------------------- | -------- |
| Accept/Deny/DM buttons | Review applications in Discord threads | Officers |
The entire review flow works from Discord. Officers never need to open the web dashboard unless they want to search, filter, or view application history.
# Settings & Configuration
Source: https://docs.throney.gg/features/settings
Configure your alliance defaults, Discord channels, class roles, DKP decay, and member permissions from one place.
The **Settings Hub** consolidates all alliance configuration into one place. Officers can manage default channels, class role mappings, DKP settings, and member access controls.
***
## Accessing Settings
Navigate to **Settings** in the sidebar. The settings page is organized into sections:
* **Alliance Settings** - Rename your alliance, manage guilds
* **Default Channels** - Configure where the bot posts events, attendance, and announcements
* **Class Roles** - Map Throne & Liberty classes to siege/war roles
* **DKP Settings** - Configure decay rates, auction rules, and point systems
* **Import Members** - Bulk import member data from external sources
***
## Default Channels
Set the Discord channels Throney uses by default for each feature:
| Channel | Purpose |
| ------------------------- | -------------------------------------------------- |
| **Attendance Channel** | Where `/attendance` results are posted |
| **Events Channel** | Where scheduled event signups are posted |
| **Announcements Channel** | Where bot announcements appear |
| **Loot Channel** | Where item listings and auction results are posted |
These defaults can be overridden when creating individual events or listings.
***
## Class Roles
Customize how the 36 Throne & Liberty classes map to your guild's role system. This affects:
* Loadout party composition
* Leaderboard role filters
* Guild statistics breakdowns
* Player profile role display
The default mapping groups classes into **Mainball**, **Flex**, **Cannon Team**, **Elephant Rider**, **Shai**, and **Defense** roles, but you can customize these to match your alliance's terminology.
***
## DKP Settings
Configure how the DKP point system works for your alliance:
* **Decay Rate** - Percentage of DKP deducted on a schedule (weekly/monthly) to keep the economy active
* **Decay Schedule** - How often decay is applied
* **Auction Duration** - Default duration for new auctions
* **Minimum Bid** - Minimum starting bid for auctions
* **Bid Increment** - Minimum bid increase amount
* **Anti-Sniping** - Extend auction timer when last-second bids are placed
***
## Member Permissions
Control which dashboard pages guild members can access when they log in.
By default, **all pages are off** for members. Officers toggle each page individually:
| Page | What Members See |
| -------------------- | -------------------------------------------- |
| **Leaderboard** | Rankings by DKP, attendance, stats, and role |
| **Guild Statistics** | Class and role distribution charts |
| **Calendar** | Upcoming events with details |
| **Scheduled Events** | Event list with signup buttons |
| **Attendance** | Their own attendance history |
| **Auctions** | Active auctions with bid buttons |
| **Listings** | Available items with request buttons |
| **Wishlists** | Their own wishlist management |
| **Loadouts** | Party compositions (read-only) |
Members see all data on enabled pages but **cannot** create, edit, delete, or manage anything. All officer controls are hidden.
When auction or listing pages are enabled for members, Discord embeds automatically show **"Bid on Website"** and **"Request on Website"** buttons so members can interact from Discord.
***
## Alliance & Guild Management
* **Rename Alliance** - Change your alliance display name
* **Manage Guilds** - Add, rename, or remove guilds in your alliance (max 4 guilds)
* **Import Members** - Bulk import from CSV or external sources
The initial setup wizard covers most of these settings. You only need the Settings Hub for ongoing adjustments.
# Scheduled Events (Signups)
Source: https://docs.throney.gg/features/signups
Create future events for players to sign up to, manage parties, and plan ahead with calendar views.
**Scheduled Events** (previously called "Dynamic Events" or "Signups") let members indicate their availability for upcoming events. Officers get a structured way to manage event participation through both the dashboard and Discord.
**This feature is NOT a substitute for `/attendance`** โ it does **not** take attendance automatically. Officers must still **use `/attendance` after the event** to log actual participation.
***
## ๐ Accessing Scheduled Events
To access the **Scheduled Events** panel:
1. **Go to the Throney Dashboard** and navigate to **Scheduled Events** in the sidebar.
2. Click on **"Manage Events"** to open the event management section.
3. In the **top right corner**, click the **"Add Event"** button to create a new event.
You can switch between **List view** and **Calendar view** using the tabs at the top of the page.
***
## ๐ ๏ธ Creating a Dynamic Event
When adding a new event, officers must configure the following settings:
* **Event Title** โ The name of the event.
* **Description & Notes** โ Any additional information regarding the event.
* **Signup Time** โ The exact time the signup notification will be posted in Discord.
* **Event Time** โ The scheduled start time of the event.
* **Recurring Event Settings** โ Option to schedule repeating events every X days.
* **Event Role Requirement** โ Restrict signups to specific roles (e.g., Tanks, DPS, Healers).
* **Ping Role** โ The role that will be mentioned when the signup goes live.
* **Signup Channel** โ The Discord channel where signups will be posted.
* **Updates Channel** โ The Discord channel where event reminders and updates will be sent.
* **Voice Channel Selection** โ Specify the voice channel where participants should gather.
Once all settings are filled out, click **"Save"** to finalize the event.
***
## ๐งฉ Signup Buttons on Discord
After a signup is posted in Discord, the following buttons will appear:
* `โ Signups` โ Displays attending, absent, tentative, ineligible, and unknown members.
* `๐ Parties` โ Displays each party and the characters in them.
* `๐ Website` โ Redirects to the respective signupโs page on the Throney Dashboard.
* `๐ฃ Ping Unknown` โ Allows officers to send a customizable reminder message to members who havenโt responded. The message appears as a reply to the original signup embed and is labeled with the staff member who sent it.
***
## โป๏ธ Recurring Events
When creating a signup, you can now configure the event to repeat every X days. Throney will automatically duplicate the signup and post it at the same interval.
This is ideal for daily/weekly siege planning, static content, and other repeatable events.
***
## ๐ง Party Builder (Loadouts)
Party creation is now fully integrated with Dynamic Events!
### Create Loadouts
You can create two types of templates:
* **Player Templates** โ Build parties using specific players.
* **Class Templates** โ Use role tags like Tank, Healer, RDPS, MDPS, Bomber.
### Loadout Import Behavior
* Importing a loadout clears your current party setup.
* Parties will be built based on your selected template.
* **Player Templates** โ Fills in members if they're attending.
* **Class Templates** โ Randomly fills in roles from the attendee pool.
* Parties may be partially or fully empty if users are not available.
After importing, you can freely **edit the loadout, move players**, or **import a new template**.
***
## ๐ New Command: `/loadout`
This new command shows party loadouts for your alliance directly in Discord.
```bash theme={null}
/loadout
```
Skips loadouts that are empty or have no members.
Replaces the older /party command (now removed).
***
## ๐ Dynamic Events vs. Attendance Tracking
| Feature | Dynamic Events (Signups) | Attendance Tracking (`/attendance`) |
| -------------------- | ------------------------------------ | ------------------------------------- |
| **Purpose** | Pre-event signup tracking | Post-event attendance logging |
| **Functionality** | Allows members to sign up for events | Tracks actual participation in events |
| **Recurring Events** | โ Supports scheduling | โ Not applicable |
| **Integration** | Loadouts, reminders, ping roles | DKP & participation logs |
| **Required for DKP** | โ No, must use `/attendance` | โ Yes, logs attendance for DKP |
***
## ๐ฏ Benefits of Signups (Dynamic Events)
โ๏ธ **Pre-Event Organization** โ Know who is attending before an event starts.\
โ๏ธ **Recurring Events** โ Automatically manage routine events.\
โ๏ธ **Loadout Templates** โ Create structured parties in seconds.\
โ๏ธ **Streamlined Management** โ All from your Discord or dashboard.\
โ๏ธ **Officer Tools** โ Ping unknowns, view role eligibility, filter participants.
***
***
## Bulk Event Management
Select multiple events from the table using checkboxes and delete them in one action. Each event row also has a dropdown menu with quick actions: View Details, Archive, and Delete.
***
## Inline Quick Actions
Every event row in the table has a three-dot dropdown menu with:
* **View Details**: Open the event page
* **Archive**: Archive the event and move the Discord message to the archive channel
* **Delete**: Remove the event with a confirmation dialog
***
Give feedback or check updates in our [Discord](https://discord.gg/KkhwKu4ns6).
# Guild & Alliance Statistics
Source: https://docs.throney.gg/features/statistics
Guide to viewing and analyzing statistics for alliances, guilds, and individual members in Throney, including composition breakdowns and performance metrics.
The **Statistics System** in Throney provides detailed insights into **alliances, guilds, and individual members**, allowing leadership to analyze **composition breakdowns**, **performance trends**, and **gear distributions**. These statistics are available through both **Discord commands** and the **Throney Dashboard**.
***
## ๐ Alliance Statistics
### `/alliance info`
Provides an **overview of the alliance**, including:
* **Member Count** โ Displays the total number of members in each guild.
* **Class Breakdown (If Enabled)** โ Shows the number of each class type in the alliance.
* **Average Combat Power** โ Calculates the mean combat power across the alliance and if enabled, per class
### `/alliance members`
This command allows officers to **sort and filter** members within the alliance:
* **Sort by a metric such as Combat Power** โ Identify the strongest and weakest members.
* **Filter by Class** โ See the exact number of each class in the alliance, which member they are and the metric it is sorted by.
These **Alliance Statistics** are also available on the **Throney Dashboard**.
***
## ๐ Guild Statistics
### `/guild info`
Provides an **overview of a specific guild**, including:
* **Total Combat Power** โ The combined strength of the guild.
* **Member Count** โ Displays the number of members in the guild.
* **Class Breakdown (If Enabled)** โ Shows the class distribution within the guild.
### `/guild members`
This command allows officers to **analyze their guildโs roster**:
* **Sort by a metric such as Combat Power** โ View the strongest and weakest members in the guild.
* **Filter by Class** โ Identify class balance issues within the guild.
Additionally, in the **Throney Dashboard**, guild officers can access:
* **๐ Class Balance Information** โ Visualize if the guild is Tank-heavy or Meele/Range DPS-heavy.
* **๐ Event Participation Logs** โ Track which members actively attend events.
* **๐ Gear Progression Tracking** โ See individual member gear improvements over time.
***
## ๐ Guild Statistics Page (Dashboard)
The dashboard now has a dedicated **Guild Statistics** page with detailed analytics:
### Alliance-Wide Analytics
* **Role Composition Charts**: Expandable breakdowns showing Tank, MDPS, RDPS, Healer, and Bomber distribution
* **Combat Power Trends**: Average gear progression tracked over time
* **DKP & Event Tracking**: Which guilds and members earn the most DKP
### Per-Guild Analytics
* **Event Performance Metrics**: How each guild performs across event types
* **Engagement Scores**: Activity levels based on attendance and uploads
* **Activity Stats**: Toggle between different time periods (7 days, 30 days, all time)
* **Attendance Reports**: Which members consistently participate in events
### Gear Progression
* Individual player gear progression charts on profile pages
* Click any data point to see full stat snapshots at that moment
* Delta comparisons show exactly what changed between uploads
***
## ๐ฏ Benefits of the Statistics System
โ๏ธ **Real-time Composition Breakdown** โ Easily analyze guild/class distribution.\
โ๏ธ **Performance Tracking** โ Identify top performers and underperformers.\
โ๏ธ **Data-Driven Decisions** โ Helps officers plan recruitment and event strategies.\
โ๏ธ **Seamless Dashboard & Discord Integration** โ View data in both **Commands & UI**.
For more details, visit the **[Throney Dashboard](https://www.throney.gg)** or join our **[Discord Community](https://discord.com/invite/KkhwKu4ns6)**.
# Loadouts (War Party Management)
Source: https://docs.throney.gg/features/war-parties
Guide to managing parties using Throney's Loadouts system, the evolution of the original War Party system.
Throney's **Loadouts System** is the next evolution of the original **War Party Management** feature.
This feature replaces the older War Party system. Loadouts provide significantly more flexibility, including static templates, class-based party assignments, and dynamic party editing.
***
## ๐ Transition from War Parties
Previously, War Parties allowed officers to manually organize members into preset static groups and post them to Discord.\
With the new **Loadouts System**, officers now have even greater automation and control:
* Create **Player-Based Templates** or **Class-Based Templates**.
* Automatically fill parties based on event signups.
* Freely edit or re-import loadouts as needed.
* Post party setups directly to Discord with the `/loadout` command.
Party setup happens faster, more accurately, and with less manual effort.
***
## ๐ How Loadouts Work
### ๐ Creating a Loadout
1. Navigate to your **Alliance Dashboard**.
2. Select **Loadouts**.
3. Choose to create a **Player Template** or a **Class Template**.
4. Set up parties:
* **Player Template**: Assign specific players to each party slot.
* **Class Template**: Assign role types (Tank, MDPS, RDPS, Healer, Bomber) to each slot.
### ๐งฉ Importing a Loadout
When you **import** a loadout into a Event Signup:
* **Current party data is wiped**.
* The system generates parties based on your selected template.
**Player Templates**:
* Checks if the player is attending.
* If absent, leaves the slot empty.
**Class Templates**:
* Randomizes the attending list.
* Fills roles in party order, prioritizing earlier parties.
* Later parties may remain partially empty if there aren't enough players.
After importing:
* You can **manually adjust parties**, **move players**, or **re-import** another loadout if needed.
***
## ๐ Features in Loadouts
* โ **Role-Based Party Visuals** โ Players show colored bands based on their role (Tank, Healer, MDPS, RDPS, Bomber).
* โ **Character Role Legend** โ Always visible to understand color codes.
* โ **Hover Tooltips** โ Hover over role icons to see their meaning.
* โ **User Search & Class Filter** โ Quickly find players in the unsorted pool.
* โ **Support for Dynamic Events** โ Loadouts directly integrate with Signups.
* โ **Officer `/loadout` Command** โ Displays **current party setups inside Discord**, allowing officers to post parties similar to the original War Party system.
***
## ๐ Deprecated
* โ The old `/party` command has been **removed**.
* โ The original "War Party" feature is now **archived** for historical reference only.
All future static party management should use the **Loadouts System** and `/loadout` command.
***
## ๐ฏ Benefits of Loadouts
โ๏ธ **Save Time** โ Set up parties automatically based on signups.\
โ๏ธ **Adapt Quickly** โ Edit and reorganize on the fly.\
โ๏ธ **Better Visibility** โ Visual party displays with color coding and labels.\
โ๏ธ **Discord Posting** โ Post finalized party setups directly to your server with `/loadout`.\
โ๏ธ **Flexibility** โ Build static groups or flexible dynamic groups easily.
***
๐ For more info, visit the [Throney Dashboard](https://www.throney.gg) or check the [Documentation Hub](https://docs.throney.gg).
# Wishlists
Source: https://docs.throney.gg/features/wishlists
Manage item priority lists for fair and transparent loot distribution.
The Wishlist system allows members to declare their desired items with priority levels, helping officers make informed loot decisions.
***
## ๐ How Wishlists Work
Members can add items to their wishlist with one of four priority levels:
* **Low** โ Nice to have
* **Medium** โ Would like this item
* **High** โ Strongly desired upgrade
* **Archboss** โ Top priority, essential item
***
## ๐ ๏ธ Managing Your Wishlist
### Adding Items
1. Navigate to **DKP โ Wishlists** on the dashboard
2. Click **"Add Item"**
3. Search for the item from the database
4. Select your priority level
5. Save the wishlist entry
### Editing Priority
* Click on any wishlist item to change its priority
* Remove items you no longer need from the dashboard
### Removing Items via Discord
Use the `/removewishlist` command to remove an item from your wishlist directly in Discord.
```bash theme={null}
/removewishlist
```
***
## ๐ Officer View
Officers can view all member wishlists to:
* See who wants specific items
* Compare priority levels across members
* Make fair loot distribution decisions
* Remove individual items from a member's wishlist if needed
Wishlist data is used alongside DKP balance when deciding item awards. Higher priority + higher DKP typically wins.
***
## ๐ Wishlist in Loot Distribution
When an item drops:
1. Officer posts item via DKP Item Listing
2. Members react based on interest
3. Officer checks who has the item on their wishlist
4. Priority level + DKP balance determines winner
***
## ๐ฏ Best Practices
* Keep your wishlist updated as you get gear
* Use **Archboss** sparingly for truly essential items
* Remove items after receiving them
* Check class-appropriate items for your build
# Frequently Asked Questions
Source: https://docs.throney.gg/frequently-asked-questions
Answers to common questions about Throney's features, usage, and troubleshooting.
Below are answers to some of the most **commonly asked questions** about **Throney's features, commands, and systems**.
## ๐ General Questions
Throney is an **advanced guild management platform** designed to help **guilds and alliances** organize events, track attendance, distribute loot with DKP, and manage war parties.
Invite Throney to your server using [this link](https://discord.com/oauth2/authorize?client_id=1290730050362278008). You must have `Admin` permissions.
Join our [Discord Support Server](https://discord.gg/ecrYsMDvSf) to ask questions, request features, and see the latest updates.
## โ๏ธ Setup & Dashboard Access
After adding Throney, create an **"Officer" role**, assign it to yourself, and run the `/setup` command in Discord.
Visit [throney.gg](https://www.throney.gg) and log in with Discord. Click on your **alliance** to access settings.
Yes, by clicking **"Update Guild"** in the **Throney Dashboard**, you can edit guild names or add more guilds.
## ๐ DKP System & Loot Distribution
Officers can assign **DKP values** to events. Members **earn DKP** when **attendance is logged** via `/attendance`.
Use `/adjust award @user [amount]` to **add DKP** or `/adjust deduct @user [amount]` to **remove DKP**.
1. Go to the **Alliance Dashboard** and navigate to **Item Listings**.
2. Click **"Add New Item"**.
3. Select the **text channel**, **item name**, and any notes.
4. Click **Submit** to post the item to Discord.
You can also upload guild storage screenshots through the **Loot Bank** to extract and route items in bulk.
## ๐ Event & Attendance Tracking
1. Go to the **Alliance Dashboard** โ **Scheduled Events**.
2. Click **"Manage Events"** โ **"Add Event"**.
3. Configure **event time, signup roles, channels, and DKP weight**.
4. Save the event, and it will **automatically post in Discord**.
After an event ends, type `/attendance` and select the event. Attendance will be **tracked and credited** to each user in the voice channel, and DKP will be **automatically awarded** to attendees.
## ๐ Recruitment & Applications
1. Go to the **Alliance Dashboard** > **Recruitment** > **Forms**.
2. Create a form with your questions.
3. Go to the **Embed Builder** tab, design a recruitment embed, attach your form as a button, and post it to a Discord channel.
4. Set a **review channel** in **Settings** where application threads will be created.
Applicants can apply two ways:
* Click an **Apply button** on a recruitment embed you posted in Discord
* Visit your public apply page at `throney.gg/apply/YOUR_SERVER_ID`
Both require logging in with Discord.
When someone applies, a **thread is created** in your review channel with their responses and **Accept/Deny/DM** buttons. You can also review from the web dashboard under **Recruitment > Applications**.
Yes. Go to **Recruitment > Blocklist** and add their Discord ID. You can also set **cooldown periods** and **minimum account age** on individual forms.
## ๐ง Troubleshooting & Support
* Ensure the **entire character screen is visible** in your screenshot, including class name, level, and stats.
* Try re-uploading using `/upload` with a slightly different screenshot (different aspect ratio or zoom level).
* If it still fails, an officer can use `/edit` to correct any mistakes.
* Throney supports **English and Portuguese** class names natively. Other languages are detected through weapon combination matching.
Yes, use `/upload [image] @user` to upload a character profile on behalf of another member.
Contact **support in our [Discord Server](https://discord.gg/ecrYsMDvSf)** for assistance.
Check out the [demo video on YouTube](https://www.youtube.com/embed/03mD0ku_BRU) and the setup guide in our [Tutorials section](/tutorials/setup).
The `/upload` command natively supports **English and Portuguese** class names. Players using other game languages (German, French, Spanish, Japanese, Korean, etc.) will still have their class detected correctly through weapon combination matching. Player names with special characters may need manual correction via `/edit`.
The Loot Bank lets officers upload screenshots of their guild's item storage chest. Throney's AI extracts all visible items and matches them against the game database. You can then route extracted items directly to auctions or item listings in bulk.
## ๐ฏ Final Notes
Throney is constantly improving! Keep an eye on [throney.gg](https://www.throney.gg) for updates, or **join our Discord community** for the latest changes.
๐ **Got more questions? Ask in our [support server](https://discord.gg/ecrYsMDvSf)!**
# Introduction
Source: https://docs.throney.gg/introduction
Welcome to Throney's Documentation. The guild and alliance manager for Throne and Liberty.
Ditch the spreadsheets and focus on the game with Throney.
## What is Throney?
Throney is an **all-in-one guild and alliance management system** for **Throne and Liberty**.
With **automated tools and simple commands**, Throney replaces spreadsheets and manual tracking so guilds can **focus on gameplay instead of administration**.
* **No Accounts Required**: Members do not need to create accounts or access dashboards.
* **One Command Setup**: `/upload` integrates a member instantly into the Throney system.
* **Officer Tools**: Officers get powerful management tools with automated tracking and full control.
### Language Support
Throney's OCR supports **English and Portuguese** class names natively. Players using other languages (German, French, Spanish, Japanese, Korean, etc.) will still have their class detected correctly through weapon combination matching.
For best results, **set your in-game language to English**. Non-English or special characters in player names (e.g., Korean, Russian) may cause name detection errors, which officers can fix with `/edit`.
***
## Core Features
### Alliance-Wide Management
* Throney works across multiple guilds in your alliance, letting leadership manage everything from one place.
### Automated Gear & Character Tracking
* **One command does it all.** `/upload` records gear, stats, and character data in real time using AI-powered OCR.
### Automated Attendance Tracking
* Type `/attendance`, select an event, and Throney records attendance for all members in the voice channel. No more spreadsheets.
### Loadouts (War Party Management)
* Create and manage party compositions for guild activities.
* Build loadout templates by player or by class role, then auto-fill parties from event attendees.
### DKP System
* Two loot distribution methods: **Item Listings** (reaction-based) and **Live Auctions** (real-time DKP bidding).
* **Loot Bank**: Upload guild storage screenshots and AI extracts items for you. Route them to auctions or listings in bulk.
* Members bid for items and DKP is automatically deducted from the winner.
* **Bulk DKP adjustments** for awarding or deducting points across all members at once.
### Scheduled Events (Signups)
* Post event signups in Discord through Throney.
* **Party Builder**: Create loadout templates by player or by class role, then auto-fill parties from attendees.
* Recurring events, ping roles, and calendar view for planning ahead.
### Guild Recruitment
* Build custom application forms with 8 question types and a drag-to-reorder form builder.
* Post recruitment embeds to Discord with a WYSIWYG editor and live preview.
* Applications create review threads with Accept/Deny/DM buttons for officers.
* Applicants apply through a public web page or Discord buttons.
* Blocklist, cooldown, and account age requirements to filter applicants.
### Guild Statistics
* Role composition charts, combat power trends, event performance metrics, and engagement scores.
* Per-guild and alliance-wide analytics on the dashboard.
### Gear Progression
* Track Combat Power over time with interactive charts on player profiles.
* Click any point to see full stat snapshots and compare changes.
***
## Active Development
Throney is actively developed with continuous updates based on community feedback. Feature requests are welcome.
Check the [Changelog](/updates/changelog) for the latest updates.
# Quickstart
Source: https://docs.throney.gg/quickstart
Set up Throney for your Guild & Alliance in just a few minutes.
Welcome to **Throney**, the ultimate guild management solution! Follow this guide to **set up Throney in minutes** and unlock powerful features for your guild and alliance.
## **Step 1: Add Throney to Your Server**
Click here to invite Throney to your Discord server and begin the setup process.
Join our support server for help, feature requests, and the latest updates!
**Important:** You must have `Admin` permissions in your Discord server to set up Throney.
***
## **Step 2: Set Up Roles for Throney**
After adding Throney, create a **dedicated role** that will serve as the **"Officer"** role. This role grants access to the **Throney Dashboard** for managing your guild and alliance.
### **Required Roles & Permissions**
| Role | Description |
| ------------------------ | ------------------------------------------------- |
| ๐๏ธ **Alliance Officer** | Full access to the dashboard and all guilds. |
| โ๏ธ **Guild Officer** | Manage a specific guildโs dashboard and commands. |
| ๐ฅ **Member** | Required for assigning users to a guild. |
Ensure that the **Officer role** is positioned **above all member roles** and that the `Throney bot role` is at the top of the role hierarchy.
***
## **Step 3: Initialize Throney in Your Server**
Once roles are created, use the following command in Discord to start the setup process:
```bash theme={null}
/setup [alliance officer]
```
* Select the newly created **Alliance Officer** role.
* This will activate your **2-week trial** of Throney.
* You will see a **setup confirmation panel** like this:
**Note:** After the trial period, a subscription will be required to continue using Throney.
***
## **Step 4: Access the Dashboard**
Once setup is complete, head over to the [Throney Dashboard](https://www.throney.gg) and log in.
* Click on your **Alliance**.
* You will see an interface similar to this:
* Click **"Update Guild"** and select the **correct member role** for each guild.
* By default, only **one guild** is created. You can **rename it** or **add additional guilds** as needed.
Any updates to roles or changes in who has the officer roles will take up to 5 minutes to reflect. Alternatively, you can re-run the `/setup` command with the same role to apply the changes immediately. This is due to an efficiency limitationโthank you for your patience!
## **Step 5: Upload Your Character Data**
To start tracking members and event participation, **upload your character profile** by running the following command in Discord:
```bash theme={null}
/upload
```
* Attach a **clear screenshot** of your character page, ensuring all relevant details are visible.
* A valid character profile should look like this:
Ensure that **your class, level, and name** are clearly visible on the left-hand side of the screen.
***
## โ **Congratulations! You're All Set!** ๐
Throney will now:
* **Automatically track attendance, events, and participation. for each user in the ecosystem**
* **Log data into the dashboard for officers to manage.**
* **Provide insights into guild and alliance composition.**
Explore the full potential of Throney and enjoy **seamless guild management**! ๐
# Advanced Setup Guide
Source: https://docs.throney.gg/tutorials/setup
Detailed walkthrough for configuring your alliance after the initial quickstart.
This guide covers everything after the [Quickstart](/quickstart). If you haven't added the bot and run `/setup` yet, start there first.
***
## Step 1: Configure Your Guilds
After `/setup`, you have one guild with a default name. To customize:
1. Go to **Settings** in the sidebar
2. Under **Guild Management**, rename your guild or add more (up to 4)
3. Each guild can have its own name and member roster
***
## Step 2: Set Default Channels
Navigate to **Settings** and configure where the bot posts by default:
* **Attendance Channel** - Where `/attendance` results appear
* **Events Channel** - Where scheduled event signups get posted
* **Loot Channel** - Where item listings and auction results go
You can override these per-event or per-listing, but setting defaults saves time.
***
## Step 3: Configure Class Roles
Navigate to **Settings > Class Roles** to map the 36 T\&L classes to your alliance's role system (Mainball, Flex, Cannon, etc.). This affects loadout compositions, leaderboard filters, and guild statistics.
***
## Step 4: Enable Member Access (Optional)
By default, only officers can see the dashboard. To let guild members log in:
1. Go to **Settings > Member Permissions**
2. Toggle which pages members can see (leaderboard, calendar, wishlists, etc.)
3. Members log in at [throney.gg](https://throney.gg) with Discord and see only the pages you've enabled
Members can view data but cannot create, edit, or manage anything.
***
## Step 5: Set Up DKP (Optional)
If your alliance uses a point-based loot system:
1. Go to **DKP Settings** and configure decay rates and auction rules
2. Create your first item listing or auction from the **DKP** section
3. Use `/attendance` to automatically award DKP based on event weights
***
## Step 6: Set Up Recruitment (Optional)
1. Go to **Recruitment > Forms** and create an application form
2. Go to **Recruitment > Settings** and set a review channel
3. Use the **Embed Builder** to post a recruitment message in Discord
4. Share your public apply link: `throney.gg/apply/YOUR_SERVER_ID`
***
## Step 7: Have Members Upload
Tell your guild members to run `/upload` in Discord with a screenshot of their character profile. That's it. One command and they're in the system with their class, gear, and stats tracked.
Officers can also upload on behalf of members using `/upload [image] @user`.
***
## What's Next?
Learn about the character tracking system
Set up event tracking and DKP
Configure auctions and listings
Build application forms
# Changelog
Source: https://docs.throney.gg/updates/changelog
All updates, improvements, and features added to Throney.
A chronological list of all updates to the bot and dashboard.
***
## April 8th, 2026 | v3.0.0
**Guild Recruitment System**
### Application Forms
* Build custom application forms with 8 question types (text, number, select, multi-select, yes/no, image upload, info blocks)
* Drag-to-reorder form builder with live preview
* Set required fields, descriptions, cooldown periods, and minimum account age
* Duplicate forms to quickly create variations
### Embed Builder
* WYSIWYG Discord embed editor with live Discord-accurate preview
* Add text, embeds, separators, and buttons to compose recruitment messages
* Attach application form buttons with custom labels and styles
* Post and update embeds directly to any Discord channel from the dashboard
* Import/export embed JSON for sharing templates
### Discord Review Threads
* Automatic thread creation in your review channel when someone applies
* Full Q\&A responses displayed as embed fields
* Accept, Deny, and DM Applicant buttons on every thread
* Thread embed updates with color and status after a decision
* Applicants receive a DM with the decision and officer message
### Application Dashboard
* Filter applications by status (pending, approved, rejected)
* Search by applicant username
* Full application review page with response rendering, timeline, and previous applications
* Accept/Deny with message to applicant and internal officer notes
* Applicant blocklist management
### Public Apply Page
* Shareable link at `throney.gg/apply/YOUR_SERVER_ID`
* Discord OAuth login with server branding
* Multi-step flow: form selection, fill out, review, submit
* Applicants can view and withdraw pending applications
### Other Improvements
* Discord avatars now update on every login (previously only saved on first sign-in)
* Broken avatar fallback to Discord's default colored avatars
* "What's New" button in the header now pulses when there's an unseen update
***
## March 27th, 2026 | v2.9.0
**Leave of Absence & Calendar Improvements**
### Leave of Absence
* Members on leave are now excused from attendance, so missed events don't drop their participation stats
* `/absent request` to submit a leave, `/absent cancel` to undo, `/absent set` for officers to mark others
* Date validation: correct format, end-after-start, no past dates, max 90 days
### Calendar & Events
* Officers see a "New Event" button in the calendar header and day detail panel
* Weekly attendance embed now shows excused (LOA) count
* Participation calculated from eligible events only
* Summary tables and CSV exports exclude excused records
***
## February 17th, 2026 | v2.8.0
**Member Dashboard & Web Bidding**
### Member Dashboard Access
* Guild members with a registered character can log in with Discord and browse enabled pages
* Officers toggle which pages members can see from the new Member Permissions settings page
* All officer-only controls (create, edit, delete, award) are hidden for members
### Web Bidding & Requests
* Members can place bids on item auctions directly from the website
* Members can request items from listings on the web
* "Bid on Website" and "Request on Website" buttons appear on Discord embeds when permissions are enabled
### Improvements
* Auction pages auto-refresh every 10 seconds for near-real-time bid updates
* Current price, bid details, and winner info hidden from members on blind auctions
* Auction and listing tables show "View & Bid" or "View & Request" quick actions for members
***
## February 5th, 2026 | v2.7.0
**UX Overhaul**
### Onboarding & Setup
* New alliances now see a step-by-step setup checklist on the alliance home page
* Setup progress card tracks guild configuration, default channels, roles, and timezone
* Checklist auto-hides once all steps are complete
### Event Management
* Bulk select and delete events from both Scheduled Events and Attendance Tracking tables
* Event rows now have dropdown menus with quick actions (View, Archive, Delete)
* Calendar view toggle added to event pages (List and Calendar tabs)
* Absent players are highlighted with an alert banner on event detail pages
### Navigation & Terminology
* "Signup Events" renamed to "Scheduled Events"
* "Attendance Events" renamed to "Attendance Tracking"
* Tooltips added to sidebar sections explaining each feature
* New Settings Hub consolidates all configuration pages into one place
* Billing link added to the sidebar for quick subscription access
* "Configure defaults" links added to event creation forms
### Dashboard
* Recent Activity feed shows the latest events across all alliances
* Player profiles now show recent attendance and signup history
* Empty states now include action buttons and helpful descriptions
### Bot Fixes
* Fixed class detection returning weapon combos instead of class names for non-English game clients
* Added programmatic weapon-to-class fallback for all 35 classes
### Bug Fixes
* Fixed broken item links in wishlists, auctions, and listings (URLs pointed to wrong path)
***
## January 28th, 2026 | v2.6.0
**Loot Bank System**
### Loot Bank
* Upload guild storage screenshots and AI extracts all items automatically
* Fuzzy matching against 2000+ game items corrects OCR artifacts
* Multi-screenshot support for large storage chests
* Select extracted items and route them directly to auctions or listings
* Manual search and reassignment when AI matching needs correction
* New UI with hero sections and sortable tables
### Bot Updates
* `/removewishlist` command lets members remove items from their wishlist in Discord
* DKP breakdown now shown in profile embeds
* Improved error messages across all bot interactions
***
## January 27th, 2026 | v2.5.0
**Auction System Overhaul**
### Auctions
* All bids now use atomic database transactions to prevent DKP double-spend during race conditions
* Blind auctions fully private: bidder names, amounts, and real-time updates hidden from other members
* Outbid DM notifications sent to members when someone places a higher bid
* Redesigned auction creation form with grouped sections and item preview
### Bot Updates
* Auction embeds updated to reflect blind auction privacy
* Fixed edge cases where auction status checks failed on closed auctions
***
## January 24th, 2026 | v2.4.0
**Gear Progression & UI Improvements**
### Gear Progression
* Interactive Combat Power history chart on player profiles
* Click any point on the chart to see full stat snapshots at that moment
* Delta comparisons show changes between snapshots
### Dashboard Improvements
* Leaderboard role cards display in 2 columns
* Officers can remove individual items from member wishlists
* Player profile page redesigned with role-based gradients and quick stats
* Audit logs now have search, system filters, and color-coded badges
### Bot Updates
* Bot now creates gear progression snapshots on each `/upload`
* Snapshots only recorded when combat power changes (no duplicate data)
***
## January 23rd, 2026 | v2.3.0
**Alliance Customization & Leaderboards**
### Class Role Customization
* Per-alliance class role settings: customize which classes map to which roles
* Overrides apply across all Throney features (leaderboards, party builder, statistics)
### Leaderboards
* Alliance-wide leaderboards by role, DKP, attendance, and combat power
* Filter and sort across all members in your alliance
### Alliance Settings
* New dedicated settings page for default channels and form configuration
* Sidebar redesigned with better organization and grouping
### Bot Updates
* Orb weapon added with 8 new classes: Crucifix, Enigma, Guardian, Justicar, Lunarch, Oracle, Polaris, Scryer
* Class role overrides synced between dashboard and bot
* Updated class emote IDs
***
## Late 2025 | v2.0 through v2.2
**Major Platform Updates**
### Portuguese Language Support
* `/upload` now correctly detects Portuguese class names and translates them to English
* Full Portuguese class name mapping for all 35 classes
* Multi-language class detection for screenshots in any language
### GPT-5.2 OCR Integration
* Character screenshot extraction upgraded to GPT-5.2 for better accuracy
* Regex-based stats extraction with spatial analysis as verification layer
* Combat power, stats, and hit chance values parsed more reliably
### Attendance System Expansion
* `/bonus` command: identical to `/attendance` but not tied to a specific event type
* Access Code system: officers generate a keyword, members enter it after the event to self-register attendance
* Attendance types expanded: automatic, manual, access\_code, bonus
* CSV attendance reports generated and sent to officers
* Officer DM notifications on attendance actions
* Redesigned attendance and bonus embeds
### Bulk DKP Management
* `/bulkadjust` command: award or deduct DKP for all registered users at once
* Full audit logging for bulk operations
### Guild Statistics Page
* Alliance-wide and per-guild analytics
* Role composition charts with expandable breakdowns
* Event performance metrics and engagement scores
* Activity stats with time period toggles
### Subscription & Pricing
* Pricing updated to \$7.50/month
* Redesigned subscription and cancellation pages
### Other Changes
* `/delete` command now requires confirmation before removing a character
* Data protection added for GameItem deletions
* Various UI polishes across all dashboard pages
***
## May 14th, 2025 | v1.73
**System Enhancements Across Loadouts, Attendance, Auctions & More**
### ๐งฉ Loadout Builder QoL Additions
* โ Added the ability to **duplicate loadouts** for faster template creation.
* โ Introduced **class filtering checkboxes** with color-coded UI.
* ๐ง Ongoing: UI refinements are in progress for a smoother Loadout experience.
***
### ๐ Signups & Loadout Enhancements
* โ Added **player/class search** in the team builder view.
* โ Signup Events page now separates events into **Current**, **Upcoming**, and **Archived**.
* โ Improved drag-and-drop logic:
* Visual previews now render while dragging.
* Clear drop zones and hover overlays.
* Tip: Drag over the "handles" of other parties for precise placement.
* โ Various UI and performance optimizations throughout.
***
### ๐ Attendance System Overhaul
* โ Introduced the `/bonus` command โ identical to `/attendance`, but not tied to a specific event.
* โ Launched the **Access Code system**:
* Allows users to enter a secret code to register attendance after the event.
* โ Attendance types now include:
* `automatic`: From `/attendance`
* `manual`: Added via dashboard
* `access_code`: Submitted by keyword
* `bonus`: Logged from `/bonus`
* โ Full **DKP History Integration** for all attendance-related actions.
* โ You can now only manually add members who are marked as **absent**.
* โ Participation stats are visible in the **website profile** and via `/profile`.
* โ Custom DMs are automatically sent when appropriate.
***
### ๐ฌ Custom Direct Message System
* โ Scalable mass DM system implemented with built-in **rate-limit protections**.
* โ Currently powers attendance alerts, absence reminders, and more.
***
### ๐ Auction System Enhancements
* โ You can now **void bids** manually from the dashboard.
* โ Integrated with the **Trait / Litho / Upgrade** system.
* โ Added support for **Blind Auctions** (Vickrey-style).
* โ Bidders can now enter **custom bid amounts**.
* โ Improved configuration UI for setting up new auctions.
***
### ๐ Audit Logs Integration
* โ Unified audit log added per alliance โ tracking:
* Attendance updates
* Loot activity
* Signup activity
* Profile changes
* Other major actions
***
### ๐ Bug Fixes
* โ Fixed a database sync issue that was preventing new auctions from being posted.
* โ Patched schema mismatch caused by the Trait/Litho/Upgrade system between Discord and the website.
***
### ๐งฎ Signups Widget Fix
* โ Fixed an issue where the Signups widget was showing incorrect attendance counts.
* โ The event summary card now also shows:
* Unknown users (have not responded)
* Ineligible users (missing the required role)
***
### ๐๏ธ Deprecated Features
* โ Removed **Guild Profiles**.
* โ Removed the legacy **Guild Party Builder** โ all party management should now use the **Loadout Builder**.
***
### โจ QoL Improvements
* โ Removed email address from the sidebar.
* โ Email on the `/account` page is now **censored for privacy**.
* โ Renamed **โAlliance Dashboardโ** to **โAlliance Homeโ** to avoid confusion with the `/dashboard` route.
***
## ๐๏ธ April 27th, 2025 โ โ๏ธ Patch v1.61
**Audit Logs Beta + Attendance, Timezone, and Loot Auction Improvements**
***
### ๐งช Initial Work โ Audit Logs (Beta Start)
* โ Alliance attendance event actions now generate an **audit log** (editing event, editing/deleting attendance records, manually adding participants via website).
* โ Audit logs will eventually connect to the upcoming **Attendance Access Code** system.
* ๐ฎ Future update: Full **Alliance-Wide Audit Logs** showing all actions performed via bot or website across the entire server.
***
### ๐ ๏ธ Minor QoL Improvements
* โ Attendance and Signup events are now **clickable** from the **Alliance page**.
* โ Alliance page widget now only displays **latest active events** (Signups, Event, or Archived).
* โ Clicking on sidebar links from the **Account page** now redirects to your **first registered alliance**.
* *(Multi-alliance switching support coming later.)*
***
### ๐ Timezone Updates (`/account` Page)
* โ Users can now **update their timezone** manually.
* โ Added **timezone search** capability.
* โ A **notification** confirms when the update is successful.
* โ Timestamps across the website now display:
* Local time
* UTC
* Paris time
* Japan time
* Relative time (hover for more detailed info)
> Let us know if you prefer different default timezone displays!
***
### โณ Member Absence System Update
* โ New **Absent Members** widget added on the **Alliance page**.
* โ Added a **Reset Alliance Absents** button โ mass reset all members to **active** if necessary.
* โ Added an **Absent status column** to the **Players page**.
* ๐ **Note:** Using `/absent` or `/return` updates may take **15โ30 seconds** to reflect fully in `/profile`.
* ๐ Future: Manual return and absence reason viewing will be added into the **User Profile page**.
**Testing Feature:**
* ๐ก **PENDING\_ABSENT** state introduced โ user is still active but scheduled to become absent soon.
***
### ๐ Loot Auction System Changes (Major)
* ๐ซ **Users can no longer outbid themselves**.
* โณ **New anti-sniping system**:
* If bidding with less than **1 hour remaining**, adds **+1 minute** to the auction timer.
* If bidding with less than **5 minutes remaining**, adds **+2 minutes** to the auction timer.
***
### ๐ค User Profile Updates
* โ **DKP History** is now starting to appear on individual user profiles.
* โก Work-in-progress โ visual updates and refinements will continue over the next few days.
***
Stay tuned for more features and thank you for helping us continue improving Throney! ๐\
๐ฅ๏ธ Check out the [Throney Dashboard](https://www.throney.gg) | ๐ Full [Documentation Hub](https://docs.throney.gg)
***
## ๐๏ธ April 17th, 2025 โ โ๏ธ Patch v1.51
**QoL & System Updates across Loot, Loadouts, Signups, and Character Tools**
***
### ๐ Character Management
* โ `/delete` command now prompts for confirmation before removing a character (no more accidental wipes!).
***
### ๐ Loot Listings System
* ๐ When rerolling an item listing, all request scores now range from **0โ100**.
* ๐ผ Listings are now **automatically sorted**:
* Priority: Upgrade > Trait > Litho
* Within each category, scores are sorted **highest to lowest**.
* ๐งพ Closed listings now feature a **"View Audit"** button:
* Shows all request scores in an **ephemeral message**.
* **Migration ongoing** to apply this to historical listings.
***
### ๐ Signups & Loadout Party Builder
* ๐ง Added a **character role legend** in parties.
* ๐จ Each player now has a **colored band** on the right side indicating role.
* ๐ **User search + class filter** added to the **Unsorted Group**.
* ๐งญ Hovering over a **role icon** now shows a **tooltip** explaining the role.
***
### ๐ก๏ธ Quest Log / Build Input
* โ๏ธ New command: `/questlog`
* Users can now input their **character builds**.
* Build data is now **visible in `/profile`** for quick reference.
***
### ๐ Signups Table Redesign
* ๐ Added a **user search bar**.
* ๐งฉ Combined all statuses (attending, absent, tentative, etc.) into **one table**.
* ๐๏ธ Added a **type filter** to toggle between statuses.
* ๐ข **Row numbers** added for easier referencing.
* ๐ Note: If someone switches from absent โ attending, they may appear **higher in the list** than new attendees.
***
### ๐ Bug Fixes
* โ Fixed **party ordering logic** in Loadouts & Signup Builder.
* โ Deleting a character no longer **breaks their Signup/Loadout references**.
***
***
## ๐๏ธ March 30th, 2025 Update โ โ๏ธ Patch v1.47 | Dynamic Events Quality of Life Overhaul + `/loadout` Launch
Weโve rolled out several **quality of life improvements** to **Dynamic Events (Signups)** โ making party management and attendance tracking even smoother ๐
### ๐ New Buttons Added to Dynamic Events (Signups)
#### โ `Parties` Button
Now shows party compositions directly within the signup embed.\
Includes:
* Party names
* Character names for each party
#### โ `Signups` Button
Displays event attendance breakdowns:
* **Attending**
* **Absent**
* **Tentative**
Also introduces:
* ๐ก **Ineligible** โ Users who do not have the required role
* โช **Unknown** โ Users with the required role but havenโt responded yet\
Currently shown as pings โ may switch to character names in a future update based on feedback.
#### โ `Website` Button
Quick redirect to the signup's event page on the **Throney Dashboard**.
#### โ `Ping Unknown` Button
An officer-only feature that:
* Sends a **custom message** to users who haven't marked attendance
* Labels the ping with the officer who sent it
* Posts as a **reply to the signup message** so it's easy to respond
### ๐ New Public Command: `/loadout`
* View **Alliance Loadouts** directly in Discord
* Displays full party breakdowns
* โ ๏ธ Skips empty parties or loadouts with no members
> ๐๏ธ `/party` command has been removed\
> The websiteโs party builder is still available for now, but will eventually be phased out.
๐ We recommend converting your static party setups into **Loadouts** for smoother party planning.
***
### ๐งช Experimental Updates
* Added redirect buttons to commands like `/loadouts`, taking users directly to the related page on the **Throney Dashboard**.
* Small QOL enhancements to streamline dashboard navigation.
***
## ๐๏ธ **March 29th, 2025 Update** โ โ๏ธ v1.37 โ Loadouts & Recurring Events for Signups
### ๐งฉ **Team Builder (Loadouts) Are Now Live!**
The long-awaited **party builder** is now fully integrated into **Signups** under the name **"Loadouts"** ๐
You can now instantly populate your war parties using two types of templates:
* **Class Templates** (Tank, MDPS, RDPS, Healer, Bomber)
* **Player Templates** (assign specific players to specific slots)
When importing a template:
* It will **clear your current build**
* **Generate parties from the template**
* Attempt to **fill available slots** based on either class role or attendance
> You can still manually edit the loadout after importing or re-import again to reset your party builds.
### ๐ **Recurring Events Now Enabled**
You can now schedule events to **automatically recur every X days**!
* Found in the **Signups** creation panel
* Simply define how often you want the event to repeat
* The bot will **duplicate the signup** and repost it on the chosen cycle
### ๐ **Ping Role Support for Signups**
Introducing **"Ping Role"** on the signup creation screen:
* Assign a **Discord role to ping** when the event is posted
* Helps boost attendance by tagging relevant groups
### ๐ **Coming Soon**
We're still finalizing the **Discord command integrations** for Signups:
* Commands to **view who's missing**
* Send DMs or pings to non-responders
* More interaction and automation directly from Discord
***
## ๐๏ธ **March 28th, 2025 Update** โ โ๏ธ Patch v1.36
**Signups Party Builder Now Live, Template System Coming Soon**
### ๐ ๏ธ Signups Party Builder (Live Now!)
The long-awaited **Party Builder** for **Signups (Dynamic Events)** is now live! ๐\
You can now visually organize members into structured parties directly from the dashboard.
๐ธ **Sneak Peek:**\
[Preview the new system here](https://gyazo.com/bca9fcd1f1af851e49b637a7d0a8f3ab)
With this update:
* โ **Party layouts** can now be created and edited per event
* โ Attending members can be assigned to parties manually or soon via templates
* โ Parties are saved per signup event
* โ Allows complete control over group structuring ahead of war content
### ๐ Coming Soon โ Template System for Party Importing
We're currently finalizing the **Template Import System** for Party Builder.
There will be **two template types**:
#### ๐ญ Player Templates
* Templates with **specific player names** for each party slot
* During import, Throney will **check who is attending** and auto-place them accordingly
* If a player isnโt attending, their slot will remain empty
#### ๐งฉ Class Templates
* Define templates by **roles** like: `mdps`, `rdps`, `tank`, `healer`, `bomber`
* Throney will **randomize the attending player list** and fill roles in order
* Early parties will get priority; later parties may remain empty if roles are unavailable
After importing:
* You can **edit the loadout**, **add/remove players**, or **re-import** a new template as needed
* The system will **delete current party progress** before applying a new template
### ๐ฎ Still In Progress
* โ Viewing built parties through Discord
* ๐ ๏ธ Discord commands to **list non-reacted users** are on the way
* ๐ ๏ธ Additional enhancements for seamless syncing between Discord and the dashboard
### ๐ฏ Other Improvements
* โ `/topwishlist` updated with a cleaner UI and error fix
* โ Minor UI/UX optimizations across the dashboard
๐ Thank you for your continued patience and support as we roll out these major updates. Weโre almost there!
๐บ๏ธ Stay informed by checking our [Throney Roadmap](https://docs.throney.gg/updates/roadmap) for whatโs next.
***
## ๐๏ธ **March 25th, 2025 Update** โ โ๏ธ Patch v1.26
**Wishlist Expansion, UI Polish & Bug Fixes**
### ๐ฏ Wishlist System Updates
* โ Added support for **Archboss** item priority in wishlists
* โ Users can now select **High**, **Medium**, **Low**, or **Archboss** priority when using `/wishlist`
* โ **Website dashboard integration** now allows officers to:
* Search by **item or player**
* View which players have which items wishlisted
* See all priority levels clearly categorized
### ๐ ๏ธ Bug Fixes & Quality of Life Improvements
* โ Fixed an issue with **manually added participants** in attendance edits not showing class information
* โ Added a new **left-hand side navigation menu** to improve dashboard usability
* โ Updated the **website gradient theme** for better visual clarity
* โ Refreshed **buttons across all dashboard pages** for a smoother, more intuitive experience
### ๐งฑ In Progress โ Signups System Finalization
* โ **Recurring events** logic is complete
* ๐ ๏ธ **Party Builder integration** is actively being finished
* ๐ Full **Signups system** (Dynamic Events) enhancements coming soon
Thank you for your continued support and feedback! ๐
***
## ๐๏ธ **March 13th, 2025 Update** โ ๐ฏ v1.24 - Wishlist & DKP Enhancements
We've expanded the **Wishlist System** and **improved DKP tracking** to make loot distribution smoother than ever!
***
### ๐ **Wishlist Update**
โ **Wishlist staff pages added to the Alliance Dashboard** โ Filter by **user** or **item** to view wishlists!\
โ **New Staff Commands:**
* `/topwishlist` โ See the most **requested items** in the guild.
* `/checkwishlist` โ Check a specific userโs **wishlist items** *(Officer Only, now ephemeral)*.\
โ **Emoji Changes:**
* High Priority โ ๐ด
* Medium Priority โ ๐
* Low Priority โ ๐ข\
โ **New User Commands:**
* `/dkp` โ Check your current **DKP balance**.
* `/mywishlist` โ View your **personal wishlist**.
***
### ๐ฐ **DKP System Improvements**
โ **Decay Percentage & Amount Feature** โ Officers can now configure **automatic DKP decay**.\
โ **DKP Column Added** โ The **Players Leaderboard** now displays **DKP totals**.\
โ **DKP Reset Button** โ Alliance leaders can **reset DKP** for expansions or new seasons.
***
### โ๏ธ **Quality of Life Additions**
โ **Item Search & Date Filtering** โ Added to:
* **Listings Page**
* **Auctions Page**\
โ **Signups Creation Improvements:**
* Default **signup time & event time** now use **current time** by default.\
โ **Better Role Picker** โ Easier **role selection** for configuring **Alliance, Guild, and Events**.
***
### ๐ **Coming Soon**
๐ **Blind Auctions (Vickrey Auction System)** โ Highest bid wins, but pays the second-highest bid amount!\
๐ **Automated Weekly DKP Decay** โ Currently **manual**, but soon officers can set a **weekly schedule**.\
๐ฆ **Mass Import of Loot** โ Pull loot data **directly from "Item Storage Chest"** for faster DKP assignments.
***
### ๐ **In Progress**
โ **Signups Party Integration & Recurring Events**\
โ **Recurring Events are finished**, but not yet pushed live.\
๐ ๏ธ **Party Integration is causing issues** and is still being worked on. Apologies for the delay!
***
## ๐๏ธ **March 5th, 2025 Update** โ โ๏ธ v1.23 - Dynamic Events & Attendance Fixes
### ๐ฏ **Dynamic Events/Signups Updates & Hotfixes**
โ **Fixed** Dynamic Events embed message update bug\
โ **Updated** Dynamic Events list page on the website\
โ **New QoL options for Signups (via Dashboard):**
* **Delete Event** โ Removes the signup message + deletes the event from the website
* **Archive Event** โ Deletes the original signup message + sends an archived message to a specified channel\
โ **Signups now clearly list user statuses:**
* Attending โ | Absent โ | Tentative โ | Unknown โ \
โ **QoL Changes:**
* **Added search functionality** when selecting channels/roles on **Alliance/Guild Pages**
* **Website toast notifications** are now **more informative**
***
### ๐ **Attendance & DKP Fixes**
โ **Fixed** attendance leaderboard search filter\
โ **Fixed** manually added participant timestamps
* โ **Note:** Unfortunately, for older events, these timestamps may not be accurate. This fix will only apply to new events moving forward.\
โ **Added** Attendance Leaderboard + **export attendance records as .CSV**\
โ **Alliance Configuration:** Added option for **Active/Absent roles** (found on the **Alliance Page**)\
โ **Fixed** `/return` bug
๐ **New DKP Reset Button**\
๐ ๏ธ A **DKP Reset button** has been added to the **Alliance Dashboard** to help reset DKP for the upcoming expansion if needed.
***
## ๐ **Pending Updates & Features in Development**
### ๐น **Signups (Dynamic Events) Upcoming Features:**
* **Recurring events**
* **Party builder integration**
* **Default signup time set to current time**
* **Signups will now display timezones more explicitly**
### ๐น **Other Upcoming Features:**
* **Attendance Bonus System**
* **DKP Leaderboard + Export Functionality**
* **Alliance Logs Channel**
* **Bulk Add Participants to Attendance**
***
## ๐๏ธ **March 5th, 2025 Update** โ โ๏ธ V1.22 - ๐ DKP Loot Auction System now Live!
### ๐ฏ **New DKP Item/Loot Auction System!**
We've expanded the **DKP system** to include a fully integrated **Auction System** for better loot distribution. This update allows **Alliance Officers** to set up auctions for items via the dashboard, while users can now **bid directly in Discord**.
***
### ๐ฆ **DKP Item/Loot Auctions Update**
โ **Alliance Officers can now create auctions from the website**
* Configure the **auction channel**, item, **starting price**, **bid increments**, and **auction end time**
โ **Bidding System**
* **Users can place bids** via a **bid button** in Discord
* **Bid amount is immediately deducted** from DKP balance
* If a higher bid is placed by another user, **previous bids are automatically refunded**
* Users can **bid multiple times in succession** (if they have enough DKP)
* ๐ Let us know if we should **restrict consecutive bids** (i.e., requiring another user to bid before bidding again)
โ **Auction Completion & Management**
* Auctions **automatically end** when the timer expires
* Alliance Officers can **manually end an auction** from the dashboard
* **Auctions can be deleted only from the dashboard**
* ๐ Deleting from the dashboard **automatically removes the Discord message**
๐ **Timing & Synchronization**\
โก๏ธ Please allow **\~1 minute** for website changes (creating auctions, ending auctions early) to reflect in Discord
***
### ๐ **Upcoming Fixes & Features**
๐ง **Currently, users cannot retract their bid, and staff cannot manually delete bids**\
๐น This feature will be **added in a near-future update**
***
## ๐๏ธ **March 4th, 2025 Update** โ โ๏ธ v1.12 - ๐ DKP System Overhaul & New Absence System (Beta)
### ๐ฏ **We've heard your feedback!**
Many members have found the **Greed** option confusing when claiming DKP items. To improve clarity, we've introduced **three new options** and **reaction-based item requests** to ensure players know **what they selected** and can easily remember their choice later.
***
### ๐ฆ **DKP Item Listings Update**
* โ **Changed from Need/Greed to Litho/Trait/Upgrade**
* โ **Moved to interactive reaction buttons**
* โ **Added ability for staff to delete listings** *(bot must have `Manage Messages` permission in that channel/server)*
* โ **Quality of Life:** Awarding a user now **automatically rejects** other users
* โ **Updated the website dashboard** โ Now more **informative and easier to understand**
* โ **Migration Info:**
* Old **Need/Greed votes** are still **visible on the website** but will need to be **re-voted** under **Litho, Trait, or Upgrade**
* Expect a **\~1-2 minute delay** for item listings created on the website to appear in the configured channel
* โ **Warning:** To avoid potential errors, always delete item listings from the **website dashboard** instead of directly in Discord.
***
### ๐งช **Experimental Updates โ Absence System (Beta)**
* ๐ ๏ธ **/absent & /return commands** are now in **beta testing**
* `/absent ` โ Allows players to mark themselves absent
* `/return` โ Allows players to return early from an absence
* Absences are reflected on **user profiles** and **announced in the configured channel**
* ๐ **Future Update (Post-T2 Launch)**:
* Absences will be **visible on the dashboard**
* Status will **automatically reflect as absent** in **Signups (Dynamic Events)**, preventing users from being listed in event participation
***
***
## ๐ March 2, 2025 Update - โ๏ธ v1.11 ๐ฏ Attendance Overhaul โ Now Live!
We're excited to introduce a major upgrade to the Attendance system, making it more seamless and efficient than ever!
### ๐ฅ What's New?
โ **Edit Participants Easily** โ Add or remove attendees on the fly without any hassle.
โ **View Absences Clearly** โ See whoโs missing directly from the attendance view.
โ **Edit Events Anytime** โ Need to make changes? You can now modify event details effortlessly.
โ **Delete Events** โ No longer needed? Clean up your schedule with a simple delete option.
โจ **Minor Changes & Improvements:**
๐น **Dynamic Events** have been renamed to **Signups**.
๐น **Attendance Summary** has been renamed to **Attendance Leaderboard**.
This update ensures a smoother experience for managing event attendance, keeping everything organized and up to date.
Try it out now! ๐
here is a sneak peek
***
## ๐๏ธ **February 18th Update** โ โ๏ธ v1.01 Patch Notes & Versioning System Update
### ๐ **Adopting Semantic Versioning**
Starting today, Throney will follow the **semantic versioning system** for updates:
* **X.Y.Z** format
* **X** โ Major Patch (Significant changes, new features, possible breaking changes)
* **Y** โ Minor Patch (New features, quality-of-life improvements, small enhancements)
* **Z** โ Patch Fixes (Bug fixes, optimizations, and minor tweaks)
This ensures **clearer communication** about what each update brings to Throney.
***
### ๐ฏ **Onboarding & UI Improvements**
* Quality-of-life improvements for the **website UI** to enhance navigation.
* **Discord onboarding process streamlined** for new users.
* Various tweaks to improve **overall user experience**.
### ๐ ๏ธ **Bug Fixes**
* Fixes applied to the **Attendance System** to improve accuracy and tracking.
* Adjustments made to **DKP System calculations** to ensure proper point distribution.
This update primarily focuses on **onboarding improvements and stability fixes** to **enhance usability and reliability** across Throney.
***
## ๐๏ธ **February 17th Update** โ ๐ Revamped Subscription Model
### ๐ **No More Payment Info Required for Trials!**
You no longer need to provide payment details to start your **2-week trial**.
Simply typing `/setup` will **automatically start your trial**, unlocking **all features for free** so you can explore everything **Throney has to offer**.
### ๐ **Website & Documentation Updates**
* The **main website** has been updated to showcase pricing.
* Support Server button and documentation have been moved to the header of the website.
* The **documentation at** [docs.throney.gg](https://docs.throney.gg/) has been **completely revamped**, providing a much **easier and more structured experience**.
Tutorial Video Series are being developed to ensure you have every tool at hand to make use of all of Throneys features
***
## ๐๏ธ **February 11th Update** โ ๐ Official Launch of Throney
**Throney is now officially launched!**
Thank you to all our beta testers for your valuable feedback and suggestions! ๐
***
## ๐๏ธ **January 31st Update** โ ๐ฅ DKP System Enters Beta
**With this update, the DKP system is now in beta and fully functional!**
Please test it and share your feedback.
### ๐ **DKP System Changes**
* **Need/Greed system**: Improved response handling and edge case coverage.
* **Live updates**: Once a user clicks Need/Greed in Discord, their request is now **immediately reflected**.
* **Winner Display**: When an item is awarded, the **winner is automatically updated in the embed**.
* **Automatic DKP Deduction**: The system now **automatically deducts DKP points** when an item is awarded.
* **UI Changes**: Various **UI improvements** for listing and requesting items.
๐ **Try it out today!** Go to **Manage Items** on the dashboard and list an item to your guild.
### ๐ /stats Command Update
* **Reduced bloat**: The `/stats` output has been **optimized** to be more concise.
* **New profile integration**: `/profile` now accurately **reflects DKP points** and displays a user's build stats.
***
## ๐๏ธ **January 26th Update** โ ๐ค Profile Preview & Command Updates
### ๐ญ **New "Preview Profile" in the Dashboard**
* A **quick user profile display** has been added.
* This is a **work-in-progress**, and weโd love to hear your **feedback!**
### ๐ **Command Changes**
โ **Added**
* /adjust award and /adjust deduct (Replaces /award and /deduct for DKP distribution).
โ **Removed**
* /gear
* /award
* /deduct
### ๐ /profile Overhaul
* `/profile` is now the **new /gear command** with added user information.
* **New feature**: Users can now **upload their base build** using `/stats` and an in-game screenshot.
* **Stats display optimization** coming in the next 2 days.
๐ **Note:** /stats is **optional** but highly recommended for **better guild management**.
***
## ๐๏ธ **January 17th Update** โ ๐ ๏ธ Dynamic Events in Beta
**Dynamic Events (Signups) are now in Beta!** Please test it and provide feedback.
### โ **Enabled Features**
โ Available from the **Alliance Page** โ Click **"Manage Dynamic Events"**
โ Creating new events
โ Signing up for events via Discord
โ Viewing signups in Discord & on the website
โ Making announcements from the **Manage Dynamic Events** page
### โ **Disabled Features (Coming Soon)**
๐ซ Recurring Events
๐ซ Team Builder
๐ซ Team Composition Templates / Party Templates
***
## ๐๏ธ **January 16th Update** โ ๐จ Dashboard UI Overhaul
The **dashboard UI has been redesigned** for a **more intuitive and streamlined experience**.
### ๐ฐ **For Alliance Officers**
๐น New features & layout changes are now visible!
***
## ๐๏ธ **December 11th Update** โ ๐ Attendance in User Profiles
* A **new attendance section** has been added to **User Profiles**.
* Officers can now **see each userโs attendance records** at a glance.
***
## ๐๏ธ **December 10th Update** โ ๐๏ธ Fortitude & Character Data Section
### ๐น **Added**
โ **Fortitude** has been added to the **Player Page**.
โ **Character Data Section** added to **User Profiles**.
***
### โ **Final Notes**
We are constantly improving Throney based on **your feedback!** If you have **suggestions or feature requests**, please share them in our [Discord Support Server](https://discord.gg/ecrYsMDvSf)**!** ๐