This software stopped working after late July 2025 when Habitica started enforcing x-client requirements.
Information about the API change can be found at Application Programming Interface.
Description
A Google Apps Script project which monitors your Party chat, to:
- For Healers: "Boss damage healer": Instantly heal damage by Quest Boss by casting Blessing preceded by casting required number of Protective Auras. Buys Mana potion if out of Mana, at cost of GP = MP. But the call to the healing function is locked in the code so that there are lesser number of Healers using this powerful script. The script doesn't have any handling for your avatar being low on Gold, so you need to keep enough reserve of Gold to be able to buy Mana potion.
- For everyone: "Party chat alert": Notify via email to oneself (should be having Gmail on this Google account) when anyone (Quest starter or Party Leader) aborts Quest, and when any Transformation Item is used on you.
Usage
- Open the project. In the leftmost bar menu, click on ⓘ (Overview). At the top-right click the copy symbol. After a short while a new window (web-browser tab) will open. You've created your copy of the project. Can change the name at top to remove text "Copy of " or rename it all to whatever you want.
- Insert your User ID and API Token in the appropriate places at the start of the code, inside the double quote marks. In the next line, can change the true/false depending on which script(s) you want to use.
- Next, if you want to use "Party chat alert" then enter your Habitica display name (not username).
- Next field is for if you want to use "Boss damage healer", you must be a Healer to be able to use it. You need to enter respective equipments' stat bonus having the class bonus added to it, you need to do the addition, these values can be obtained from the "Stats" tab in your Habitica user profile. If you keep changing your Equipments (not talking about Costume) then can enter the lower value for safe side. You can even leave these values at 0 but then your Mana (and Gold) may be wasted, and Party chat crowded, by casting extra Protective Aura(s), as the script may think you need to caste more.
- Don't enter a value for WEB_APP_URL yet.
- If want to use "Boss damage healer", then you need to figure out how to unlock the call to healing.
- Deploy the code as a web app, using these settings:
- "Description": you can ignore this, or enter any text that you want
- "Execute as": choose "Me"
- "Who has access": choose the last option called "Anyone" or "Anyone, even anonymous", depending on whether you are using the new or old design of Google Apps Script.
- Click the "Deploy" button and wait a while.
- Click the "Authorize access" button.
- Select your Google account.
- You will see a warning that "Google hasn’t verified this app". This is expected since you have just created the app yourself. Click "Advanced", then click the link labelled "Go to ...".
- Click the "Allow" button.
- You will see a screen containing a Deployment ID and the web app's URL. Copy the URL to your clipboard then click "Done".
- Paste the URL into the starting of the script inside the double quote marks where it says WEB_APP_URL. We had previously left it.
- Run the function "setup". If you are using the new design of Google Apps Scripts, it will show you "Execution completed". The "setup" function creates a webhook in your Habitica account, to inform this script of every new party chat message. If you want you can check the webhook by visiting the user icon > Settings > API page in Habitica; the webhook for this script should show the web app URL.
- If later you want to delete the script then delete this webhook too.