Quest Summary Delivery¶

Field Research quests rotate daily and can match in large numbers, so a busy quest filter can flood your Discord DMs. Quest summary delivery collects matching quests into a single digest and delivers it on a schedule you choose -- one tidy message per day instead of dozens of individual alerts.

The feature has two parts that work together:

1. A per-alarm Daily summary toggle that marks which quest alarms should be buffered instead of delivered immediately.
2. A per-user delivery schedule that decides when the buffered quests are sent.

Both are required: the toggle says which quests to collect, and the schedule says when to deliver them.

How it works¶

flowchart LR
    A[Quest webhook] --> B{Matches a quest alarm
with Daily summary on?}
    B -- no --> C[Delivered immediately]
    B -- yes --> D[(Buffered)]
    D --> E{Your delivery
schedule fires}
    E -- scheduled time --> F[Grouped summary DM]
    G[Send summary now] --> F

When a quest matches an alarm that has Daily summary turned on, PoracleNG holds the match in a per-user buffer instead of sending it right away. The buffer is flushed -- rendered into one grouped message and delivered -- when your delivery schedule fires, or when you press Send summary now. Quest alarms without the toggle continue to deliver individually as usual.

Step 1 -- Turn on Daily summary for a quest alarm¶

Open a quest alarm's add or edit dialog and enable Daily summary. This marks the alarm so its matches are buffered for the digest rather than sent one-by-one. The setting is remembered even if you originally set it from the bot -- editing the alarm in the web UI will not clear it.

Step 2 -- Set your delivery schedule¶

Open the Quests page, then the ⋮ (more) menu in the toolbar, and choose Quest summary delivery. The dialog shows your current schedule and lets you edit, clear, or trigger it.

Editing the schedule¶

Choose Edit schedule to open the schedule editor -- the same editor used for profile active hours:

1. Select days with the circular day buttons (M T W T F S S). Quick presets are available:
   • Weekdays -- Monday through Friday
   • Weekends -- Saturday and Sunday
   • Every day -- all seven days
2. Choose a time with the hour and minute dropdowns.
3. Choose Add to create entries for all selected days at that time.
4. Repeat to add more delivery times, then Save.

Saved delivery times appear as amber pills in the dialog (for example, "Mon-Fri 8:00 AM"), grouped by day pattern. A short note beneath them explains what Send summary now does.

Validation rules¶

The schedule uses the same structure and limits as profile active hours:

Send summary now¶

The Send summary now button flushes and delivers whatever is currently buffered, immediately -- handy for testing or for getting the digest early. It is the equivalent of the bot's !summary quest now command.

To prevent accidental double-delivery, the button has a short cooldown after each use.

Clearing the schedule¶

Choose Remove schedule in the dialog to delete your delivery schedule. Quest alarms with Daily summary still buffer, but without a schedule they fall back to PoracleNG's default delivery timing. Removing the schedule does not change the per-alarm toggle.

For server operators¶

Quest summary delivery is gated by PoracleNG, not by PoracleWeb.NET. The web UI is hidden unless the connected bot reports the feature as enabled.

To enable it, set the following in your PoracleNG config.toml and restart the processor:

[tracking]
quest_summary_enabled = true
# Optional: how long a buffered quest survives if the schedule never fires (default 24).
quest_summary_buffer_ttl_hours = 24

Troubleshooting¶

See the dedicated entries in Troubleshooting:

• Quest summary delivery menu is missing
• Send summary now delivers nothing