Modding:Location data - Revision history

imported>BarleyZP: /* Music */ Change link from the migrate to 1.6 page to Modding:Audio

2025-06-14T16:16:42Z

Music: Change link from the migrate to 1.6 page to Modding:Audio

← Older revision		Revision as of 16:16, 14 June 2025
Line 327:		Line 327:
	\|-		\|-
	\| <samp>Track</samp>		\| <samp>Track</samp>
	\| The [[Modding:~~Migrate to Stardew Valley 1.6#Custom audio~~\|audio track ID]] to play.		\| The [[Modding:Audio\|audio track ID]] to play.
	\|-		\|-
	\| <samp>Condition</samp>		\| <samp>Condition</samp>

imported>BarleyZP: /* Contents */ Add DisplayName field to FishAreas. See FishAreaData.csfor reference.

2025-05-13T19:49:25Z

Contents: Add DisplayName field to FishAreas. See FishAreaData.csfor reference.

← Older revision		Revision as of 19:49, 13 May 2025
Line 144:		Line 144:
	! field		! field
	! effect		! effect
			\|-
			\| <samp>DisplayName</samp>
			\| ''(Optional)'' A [[Modding:Tokenizable strings\|tokenizable string]] for the translated area name, if any.
	\|-		\|-
	\| <samp>Position</samp>		\| <samp>Position</samp>

imported>OnionNinja: /* Basic info */ +CanHaveGreenRainSpawns parameter

2025-03-12T00:59:12Z

Basic info: +CanHaveGreenRainSpawns parameter

← Older revision		Revision as of 00:59, 12 March 2025
Line 72:		Line 72:
	\| <samp>CanPlantHere</samp>		\| <samp>CanPlantHere</samp>
	\| ''(Optional)'' Whether crops and trees can be planted and grown here by default, unless overridden by their plantable rules. Defaults to true for farms and false for other locations.		\| ''(Optional)'' Whether crops and trees can be planted and grown here by default, unless overridden by their plantable rules. Defaults to true for farms and false for other locations.
			\|-
			\| <samp>CanHaveGreenRainSpawns</samp>
			\| ''(Optional)'' Whether green rain trees and debris can spawn here by default. Default true.
	\|-		\|-
	\| <samp>ExcludeFromNpcPathfinding</samp>		\| <samp>ExcludeFromNpcPathfinding</samp>

imported>Abagaianye: Added explanation for overlapping FishArea priority

2025-02-20T07:14:01Z

Added explanation for overlapping FishArea priority

← Older revision		Revision as of 07:14, 20 February 2025
Line 145:		Line 145:
	\| ''(Optional)'' The tile position and size covered by this fishing area, specified as an object with <samp>X</samp>, <samp>Y</samp>, <samp>Width</samp>, and <samp>Height</samp> fields. This area will apply for crab pots placed within it, or when the fishing rod bobber lands within it. Default null (anywhere).		\| ''(Optional)'' The tile position and size covered by this fishing area, specified as an object with <samp>X</samp>, <samp>Y</samp>, <samp>Width</samp>, and <samp>Height</samp> fields. This area will apply for crab pots placed within it, or when the fishing rod bobber lands within it. Default null (anywhere).

	Areas with a <samp>Position</samp> value have priority over those without.		Areas with a <samp>Position</samp> value have priority over those without. If two areas with a <samp>Position</samp> overlap, the tiles that are overlapping will be treated as part of the first FishArea listed, effectively making the other area smaller than its <samp>Position</samp> values indicate.
	\|-		\|-
	\| <samp>CrabPotFishTypes</samp>		\| <samp>CrabPotFishTypes</samp>

imported>Pathoschild: use {{Content Patcher example}}

2025-02-01T19:21:09Z

use {{Content Patcher example}}

← Older revision		Revision as of 19:21, 1 February 2025
Line 124:		Line 124:
	<syntaxhighlight lang="js">		<syntaxhighlight lang="js">
	"ArtifactSpots": [		"ArtifactSpots": [
	{		{
	"Condition": "LOCATION_SEASON Here summer",		"Condition": "LOCATION_SEASON Here summer",
	"ItemId": "(O)128",		"ItemId": "(O)128",
	"MinStack": 2,		"MinStack": 2,
	"MaxStack": 4		"MaxStack": 4
	}		}
	]		]
	</syntaxhighlight>		</syntaxhighlight>
Line 376:		Line 376:
	<li>[[Modding:Editing XNB files#unpacking\|Unpack the game assets]], then copy & paste a similar vanilla map into your content pack's <samp>assets</samp> folder.</li>		<li>[[Modding:Editing XNB files#unpacking\|Unpack the game assets]], then copy & paste a similar vanilla map into your content pack's <samp>assets</samp> folder.</li>
	<li>Edit the <samp>content.json</samp> to add the location data:		<li>Edit the <samp>content.json</samp> to add the location data:
	~~{{#tag:syntaxhighlight\|<nowiki>~~		{{Content Patcher example\|<nowiki>
	{
	~~"Format": "</nowiki>~~{{Content Patcher ~~version}}~~<nowiki>",
	"Changes": [		"Changes": [
	// add location data		// add location data
Line 409:		Line 407:
	}		}
	]		]
	}		</nowiki>}}
	</nowiki>~~\|lang=json~~}}
	</li>		</li>
	</ol>		</ol>

imported>VulpesLucida at 09:19, 18 January 2025

2025-01-18T09:19:14Z

← Older revision		Revision as of 09:19, 18 January 2025
Line 772:		Line 772:
	\|-		\|-
	\|}		\|}

			==See also==
			* [[Modding:Location contexts]]

	[[Category:Modding]]		[[Category:Modding]]

imported>Pathoschild: /* Contents */ update Data/Objects field name

2024-12-15T19:20:52Z

Contents: update Data/Objects field name

← Older revision		Revision as of 19:20, 15 December 2024
Line 86:		Line 86:
	\| ''(Optional)'' The items that can be found when digging [[Artifact Spot\|artifact spots]] in this location.		\| ''(Optional)'' The items that can be found when digging [[Artifact Spot\|artifact spots]] in this location.

	An artifact spot is selected by combining this field with the equivalent field on the <samp>Default</samp> entry, sorting by <samp>Precedence</samp> value, and then choosing the first entry whose fields match. (Artifact spot drops can also be listed in [[Modding:Objects\|<samp>Data/Objects</samp>]]'s <samp>~~Miscellaneous~~</samp> field; those are applied by the <samp>RANDOM_ARTIFACT_FOR_DIG_SPOT</samp> entry in <samp>DefaultArtifactSpots</samp>.)		An artifact spot is selected by combining this field with the equivalent field on the <samp>Default</samp> entry, sorting by <samp>Precedence</samp> value, and then choosing the first entry whose fields match. (Artifact spot drops can also be listed in [[Modding:Objects\|<samp>Data/Objects</samp>]]'s <samp>ArtifactSpotChances</samp> field; those are applied by the <samp>RANDOM_ARTIFACT_FOR_DIG_SPOT</samp> entry in <samp>DefaultArtifactSpots</samp>.)

	This consists of a list of models with these fields:		This consists of a list of models with these fields:

imported>Pathoschild: update link

2024-12-15T19:19:35Z

update link

← Older revision		Revision as of 19:19, 15 December 2024
Line 86:		Line 86:
	\| ''(Optional)'' The items that can be found when digging [[Artifact Spot\|artifact spots]] in this location.		\| ''(Optional)'' The items that can be found when digging [[Artifact Spot\|artifact spots]] in this location.

	An artifact spot is selected by combining this field with the equivalent field on the <samp>Default</samp> entry, sorting by <samp>Precedence</samp> value, and then choosing the first entry whose fields match. (Artifact spot drops can also be listed in [[Modding:~~Items#~~Objects\|<samp>Data/Objects</samp>]]'s <samp>Miscellaneous</samp> field; those are applied by the <samp>RANDOM_ARTIFACT_FOR_DIG_SPOT</samp> entry in <samp>DefaultArtifactSpots</samp>.)		An artifact spot is selected by combining this field with the equivalent field on the <samp>Default</samp> entry, sorting by <samp>Precedence</samp> value, and then choosing the first entry whose fields match. (Artifact spot drops can also be listed in [[Modding:Objects\|<samp>Data/Objects</samp>]]'s <samp>Miscellaneous</samp> field; those are applied by the <samp>RANDOM_ARTIFACT_FOR_DIG_SPOT</samp> entry in <samp>DefaultArtifactSpots</samp>.)

	This consists of a list of models with these fields:		This consists of a list of models with these fields:

imported>Pathoschild: /* Simple location */ add link to Modding:Maps; tweak warp example to simplify testing

2024-12-10T19:50:32Z

Simple location: add link to Modding:Maps; tweak warp example to simplify testing

← Older revision		Revision as of 19:50, 10 December 2024
Line 405:		Line 405:
	"Target": "Maps/Town",		"Target": "Maps/Town",
	"AddWarps": [		"AddWarps": [
	"~~10 10~~ {{ModId}}_ExampleCave 0 30" // warp from town (~~tile 10, 10~~) to custom location (tile 0, 30)		"29 67 {{ModId}}_ExampleCave 0 30" // warp from town (center of plaza) to custom location (tile 0, 30)
	]		]
	}		}
Line 415:		Line 415:
	That's it! If you load your game and walk onto tile (10, 10) in town, you should warp to your custom location.		That's it! If you load your game and walk onto tile (10, 10) in town, you should warp to your custom location.

	You can then add more fields to your <samp>Data/Locations</samp> entry ~~to change~~ music, forage, artifact spots, fish, etc as needed.		You can then add more fields to your <samp>Data/Locations</samp> entry (for music, forage, artifact spots, fish, etc) or [[Modding:Maps\|edit the map]] as needed.

	==FAQs==		==FAQs==

imported>Pathoschild: /* Simple location */ add step for map file

2024-12-10T19:46:54Z

Simple location: add step for map file

← Older revision		Revision as of 19:46, 10 December 2024
Line 374:		Line 374:
	<ol>		<ol>
	<li>[[Modding:Content Patcher\|Create an empty Content Patcher content pack]].</li>		<li>[[Modding:Content Patcher\|Create an empty Content Patcher content pack]].</li>
			<li>[[Modding:Editing XNB files#unpacking\|Unpack the game assets]], then copy & paste a similar vanilla map into your content pack's <samp>assets</samp> folder.</li>
	<li>Edit the <samp>content.json</samp> to add the location data:		<li>Edit the <samp>content.json</samp> to add the location data:
	{{#tag:syntaxhighlight\|<nowiki>		{{#tag:syntaxhighlight\|<nowiki>
Line 392:		Line 393:
	},		},

	// add map file		// add the map file
	~~// (you can copy a vanilla map file and edit it)~~
	{		{
	"Action": "Load",		"Action": "Load",