Modathon
BirthdayCTGSQ | Birthday Conversation Topic and Game State Query mod for Stardew Valley
Latest01 Apr 2026
Uploaded31 Mar 2026
Version1.1.0
30.61 KB
Total Files Sizes
0
Unique DLs
0
Total DLs
2
Total Files

BirthdayCTGSQ

File Size23.62 KB
Game Image for Stardew Valley
Framework


Mods that use this framework:

Tilly the librarian Birthday dialogue and event

BirthdayCTGSQ Vanilla Content Pack All the vanilla NPCs will have birthday dialogue

NPC Pei Ming I love this npc! Very funny and silly. Adds dialogue


Feel free to let me know if you want to add your mod to this list.


Translations:

PTBR by Maatsuki

Zh by Shenyifan


Clarification:


My mod has nothing to do with the original birthday mod. It is completely different. I don't recommend having the original birthday mod if you use this mod.


- Is this compatible with the original Bday mod?


Technically yes. But the original Bday mod will break vanilla by itself.


Explanation: The original Bday overwrites dialogue, so any first dialogue you interact with the NPC (such as gifts, or conversation

topics) will be completely overwritten. This is not because of my mod.


- Differences between the original Bday mod?


There is no gift giving or letters by default. You can have birthdays on festival days, unlike the original birthday mod. This is a framework/tool lets modders do their own custom version using the GSQ. If you are a modder and want to add those features I will explain how to do it below.


What this mod does:

- Gives the player a birthday

- Lets modders easily do events and dialogue related to the birthday

- Doesn't overwrite NPC dialogue



How to use the mod for Modders only:


- You can use the conversation topic "boxosoup.birthday_birthday" Use the CTs for Vanilla for reference!


- the game state query is called "boxosoup.birthday_IS_BIRTHDAY"


Let's say you're a modder that wants to add a gift to their dialogue:


1. use the item token in your dialogue.


{

"Action": "EditData",
"Target": "Characters/Dialogue/YourNPC",
"Entries": {
"boxosoup.birthday_birthday": "Hi have a rock! #[(O)39]"
}
}


If you want to add the letter thing from the original birthday mod:


2. Use a trigger action "ondaystarted" with condition


{
"Action": "EditData",
"Target": "Data/TriggerActions",
"Entries": {
"{{ModId}}_birthdayletter": {
"Id": "{{ModId}}_birthdayletter",
"Trigger": "DayStarted",
"Condition": "boxosoup.birthday_IS_BIRTHDAY",
"Actions": [
//Your actions here, you would put addmail or whatever you want here
]
}


For making a birthday event, you'd just use the same thing as any other condition.


You can read more about conversation topics and game state queries in the stardew wiki.



Credits:


(hyperlinks will change if they use GGmods)


Alpha_Omegasis for the inspiration, and bits of the birthday UI

mushymato for encouraging me to do it in the first place, and a reference point

atravita for some guidance and fixing the config code


Source code: https://github.com/boxosoup/Birthday

Instructions

How to use the mod for players only:


This doesn't work on multiplayer!

= When you load a new save, without your birthday register, a menu will pop up once you are in the game

- Simply click the month, and date, and click okay.

- If you want to change your birthday, then you can do F7 to bring up the menu, (changeable via config.json)


To summarize: just install and it'll work.


How to use the mod for Modders in the description

Requirements

Permissions and credits

  • Do all the assets in this mod belong to you and/or do you have permission to redistribute these assets?

    Yes

  • Do you allow others to upload fixes, compatibility patches or updates for your mods as a separate mod page?

    Yes, but only if I am retired / unresponsive / inactive

  • Do you allow others to upload edits to your mods as a separate mod page?

    Only if you contact me to ask permission first

  • Do you allow others to use assets in your mods in their own mod pages with credit?

    Only if you contact me to ask for permission first

  • Do you allow translations for your mod?

    Yes, no need to contact me first. Earning GGP is allowed

  • If you consented to derivative works (updates, translations, assets being in another mod), can they be made through the use of AI?

    No. I do not allow any derivative work of mine to use Generative AI in any way

BirthdayCTGSQ

Type: Main
Date uploaded31 Mar 2026
File Size23.62 KB
Unique DLs0
Total DLs0
Version1.1.0

Feel free to let me know if you use this framework for your mod, I can put it on the list.

BirthdayCTGSQ CTs for Vanilla

Type: Main
Date uploaded31 Mar 2026
File Size6.99 KB
Unique DLs0
Total DLs0
Version1.0.2

Adds BirthdayCTGSQ CTs for vanilla npcs.