Custom Tokens
🟠 Updated over a year ago⚠️ Install Order · 3 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview

🔍 Analysis
- 👍 1.9% endorsement rate — high engagement, a strong quality signal
- 🏆 #36 of 119 Modding Tools mods in this game by downloads
📋 About This Mod
Custom Tokens
Custom Tokens is a mod that provides some additional tokens for Content Patcher, extending what can be done.Custom Tokens registers the following tokens:
Location Tokens:
-
[]MineLevel, minelevel the player is currently on
[
]VolcanoFloor, volcanofloor the player is currently on[]DeepestMineLevel, the deepest minelevel reached by the player, this includes Skull Cavern floors
[]DeepestVolcanoFloor, the deepest volcano floor reached by the player
[]DeepestNormalMineLevel, the deepest normal minelevel reached by the player
[]DeepestSkullCavernMineLevel, the deepest skull cavern minelevel reached
Marriage Tokens:
-
[]Anniversary of the player, split into two tokens, AnniversaryDay and AnniversarySeason
[
]YearsMarried, total number of years married[]DaysMarried, total number of days married
Quest Tokens:
-
[]QuestIDsCompleted, a list of quest ids that the player has completed
[]QuestsCompleted, the total number of quests completed
[]SOIDsCompleted, a list of the special orders the player has completed, this includes qi challenges
[]SOCompleted, total number of different special orders completed
Death and Exhaustion Tokens:
-
[]DeathCount, total number of times the player has died
[]DeathCountMarried, an extension of DeathCount that tracks how many times a player has died after being married.
[]DeathCountPK, (provides a more accurate value than the DeathCount token for use in the PlayerKilled event)
[]DeathCountMarriedPK, an extension of DeathCountPK that tracks how many times a player has died after being married.
[]PassOutCount, how many times a player has passed out.
Advanced Tokens:
- Child, holds information about the player's children, requires input arguments to work.
See the README on github for more information about tokens
Version 1. 6. 0:
- Updated for 1. 6 compatibility
Version 1. 5. 1:
- This version adds a few more location tokens for deepest levels in the normal mines, skull cavern and volcano.
Using Custom Tokens:
- SMAPI 4. 0 or above must be installed.
- Ensure Custom Tokens is listed as a dependency in your content pack
- Tokens used must be prefixed with the mod's unique ID e.g TheMightyAmondee. CustomTokens/MineLevel
- Many tokens require an update rate of OnLocationChange, OnTimeChange or both in order to work properly
The Child Token:
This token takes exactly 3 input arguments. They are not case sensitive.
The first argument, player, gives the player type. It must be one of host (the main player) or local (the current player that
-
[]DeathCount, total number of times the player has died
-
[]QuestIDsCompleted, a list of quest ids that the player has completed
-
[]Anniversary of the player, split into two tokens, AnniversaryDay and AnniversarySeason
Custom Tokens is a modding tool for Stardew Valley that adds custom tokens for use with Content Patcher, allowing modders to extend what can be done with their mods. With over 12,000 endorsements and 639,000 downloads, it's a widely used utility for mod creators.
✨ Key Features
📊 Pros & Cons
✅ Pros
- Huge community trust with 12,310 endorsements and 639k downloads
- Essential for modders who want to push Content Patcher further
- Actively maintained with a recent update in March 2025
⚠️ Cons
- Not for casual players – requires knowledge of Content Patcher
- Requires Content Patcher to be installed, which adds setup steps
For Stardew Valley modders who create or edit Content Patcher mods and want to add custom logic. Skip if you're just a player looking for gameplay changes – this is a developer tool.
💡 Beginner Tips
- Make sure you have Content Patcher installed and updated before adding Custom Tokens.
- Check the mod's documentation or forum posts for examples of how to use the custom tokens in your own Content Patcher packs.
- If you're new to modding, start with a simple Content Patcher mod to understand the basics before using this tool.
📊 Mod Details
- Game
- Stardew Valley Mods
- Author
- TheMightyAmondee
- Version
- 1.6.2
- Downloads
- 639,794
- Endorsements
- 12,310
- Category
- Modding Tools
- Created
- 1/5/2021
- Updated
- 3/9/2025
🧩 Commonly Used Together
Users add these mods to the same collections — a real compatibility signal, not an AI guess.
🔧 How to Install Stardew Valley Mods
Download from Nexus.
📖 Full step-by-step install guide for Stardew Valley →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Stardew Valley commands, item IDs, and more.
Keep browsing — more Stardew Valley mods await