Stardew Valley
0 of 0

File information

Last updated

Original upload

Created by


Uploaded by


Virus scan

Safe to use

About this mod

Creates some custom tokens for use in Content Patcher to extend what can be done.

Permissions and credits
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

Marriage Tokens:
  • Anniversary of the player, split into two tokens, AnniversaryDay and AnniversarySeason
  • YearsMarried, total number of years 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.

See the README on github for more information about tokens

Using Custom Tokens:

- SMAPI 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

Getting old or current save files up to speed:

Old or current save files require some additional set-up. This isn't strictly necessary but may result in incorrect token values.

A per-save JSON file will be generated after the day is started for each save so the mod can track values not tracked by the game. This is found in the data folder located in the mod folder. These values can be adjusted as needed as they will have an initial value of 0, which may not be accurate for older saves. Ensure the old tracker value is also updated to the same value as the current tracker value when changing values.

While the mod can determine whether most quests have been completed, some quest ids from previously completed quests in old save files need to be added manually to the save's JSON file in AdditionalQuestsCompleted. Custom quest ids can also be added here.

 Depending on what quests have previously been completed, the field should look something like this:  "AdditionalQuestsCompleted": [6,16,128,130] 

  • If you have completed "Getting Started", add 6
  • If you have entered the Adventurer's Guild, add 16
  • If you have done secret note 25 (Abigail), add 128
  • If you have done secret note 25 (Caroline), add 129
  • If you have finished "The Pirate's Wife", add 130

- AllowDebugging adds a single debug command so the values of the tokens can be viewed in the SMAPI console. When enabled typing "tracker" in the console will display a list of token values
- ResetDeathCountMarriedWhenDivorced will cause the DeathCountMarried token to reset to 0 when divorced, default is true

New in version 1.3.0
- Added 4 new tokens
- Tokens have been updated to allow different values in split-screen co-op

- Added DeepestMineLevel token
- Manifest updated to require SMAPI 3.8.0 or greater

Source code