Notify Quest Latecomers

Notify Quest Latecomers
	Google Apps Script
Maintainer:	Turac Ramotar
Release:	1.2.1 / 06.12.2025
Habitica API:	API v3
License:	GPL-3.0
Website:	GitHub
See Also
Extensions, Add-Ons, and Customizations, Habitica GAS Template

The script Notify Quest Latecomers allows you to keep track of the quest attendance in your party.

Whenever your party goes on a new quest, the script will check, if all party members joined the quest. If this is not the case, it will notify the party, its leader or the missing members - depending on your configuration.

Features

• check the delay between invitation and quest start
• notify party, leader, or individual members
• notify on a Discord channel via webhook

Installation

Follow the installation instructions for the Habitica GAS Template.
Additional information on the configuration is given below.

Source Code

The source code of the script is available on

• GitHub
• Google Apps Script

Configuration

The behavior of the script can be configured via simple switches, which can either be true or false:

• MESSAGE_TO_PARTY to configure, whether the summary message is sent to the party chat
• PM_TO_PARTY_LEADER_IF_LATECOMERS to configure, whether the summary message is sent to the party leader, when somebody is not on the quest
• PM_TO_PARTY_LEADER_IF_NO_LATECOMERS to configure, whether the summary message is sent to the party leader, when everybody is on the quest
• PM_TO_LATECOMERS to configure, if latecomers are notified individually
• since v1.2.0: NAME_QUEST_OWNER to configure, if the name of the quest owner appears in any messages

All combinations are possible, so choose what helps your party the most!

Discord notifications (since v1.1.0)

In addition, you can configure the script to send notifications to your Discord channel. The corresponding configuration items are in the optional section of the script.
To enable Discord notifications, follow these steps:

1. Open the Discord Intro to Webhooks and go to the first section "Making a Webhook".
2. Follow the instructions on your own Discord server until you've got your Webhook URL. Basically you create an Avatar, that will post the messages the script sends to the Webhook URL to the channel you selected.
3. Go back to the configuration of your script.
4. Set MESSAGE_TO_DISCORD to true.
5. Replace the dummy URL after DISCORD_WEBHOOK_URL with your personal Webhook URL.

That's it, you have successfully configured an integration between three different platforms!

Result

If everything works correctly, you should be sending out messages similar to the ones below:

Summary

The quest The Basi-List by Turac Ramotar (@Turac) was started 321 seconds after the invitation.
The following party members don't participate in the quest, because their Auto Accept script didn't respond in time:

• Turac Ramotar (@Turac)

or, if everybody joined the quest in time,

The quest The Feral Dust Bunnies by Turac Ramotar (@Turac) was started 654 seconds after the invitation.
All party members participate in the quest 🎉

Personal Message

The quest The Basi-List by Turac Ramotar (@Turac) was started 321 seconds after the invitation.
Your Auto Accept script failed to accept the quest invite within this time frame.
Please check, whether it is working correctly!

Changelog

Version 1.2.1

• minor improvements

Version 1.2.0

• add option to include the quest owner in messages

Version 1.1.2

• retrieve quest names from the Habitica API

Version 1.1.1

• add check for library reference

Version 1.1.0

• add finer configuration for messages to the party leader via ..._IF_LATECOMERS and ..._IF_NO_LATECOMERS suffixes
• enable notifications on a Discord channel via a Discord Webhook