Modding:Maps - Revision history

imported>Nbeymer99: /* Action */

2026-07-04T03:52:38Z

Action

← Older revision		Revision as of 03:52, 4 July 2026
Line 1,127:		Line 1,127:
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>
	\| <samp>Action NPCMessage {{t\|str name}} "{{t\|str dialogueKey1}}/{{t\|str dialogueKey2}}"</samp>		\| <samp>Action NPCMessage {{t\|str name}} "{{t\|str dialogueKey1}}/{{t\|str dialogueKey2}}"</samp>
	\| If the named NPC is within 14 tiles of the player, reads dialogueKey1 from the string files and displays a dialogue box, and broadcasts a chat to multiplayer games that player was caught snooping. Otherwise, reads dialogueKey2 in a dialogue box. See [[Modding:Dialogue\|dialogue format]].<br />''Example: Action NPCMessage Marnie "Strings\\StringsFromMaps:AnimalShop.20/Strings\\StringsFromMaps:AnimalShop.21"''		\| If the named NPC is within 14 tiles of the player, reads dialogueKey1 from the string files and displays a dialogue box, and broadcasts a chat to multiplayer games that player was caught snooping if used with the following strings: <samp>Strings/StringsFromMaps:AnimalShop.20, Strings/StringsFromMaps:JoshHouse_Alex_Trash, Strings/StringsFromMaps:SamHouse_Sam_Trash,</samp> and <samp>Strings/StringsFromMaps:SeedShop_Abigail_Drawers</samp>. Otherwise, reads dialogueKey2 in a dialogue box. See [[Modding:Dialogue\|dialogue format]].<br />''Example: Action NPCMessage Marnie "Strings\\StringsFromMaps:AnimalShop.20/Strings\\StringsFromMaps:AnimalShop.21"''
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>

imported>SiTheGreat at 01:14, 16 June 2026

2026-06-16T01:14:18Z

← Older revision		Revision as of 01:14, 16 June 2026
Line 951:		Line 951:
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>
	\| <samp>Action ConditionalDoor {{t\|query}}</samp>		\| <samp>Action ConditionalDoor {{t\|query}}</samp>
	\| Place on an interior door's bottom tile. Uses a [[Modding:Game_state_queries\|game state query]] to check if the player can open the door. If a <samp>LockedDoorMessage</samp> tile property is on the same tile and the query fails, a dialogue box with the supplied text string will be dislayed; Otherwise, if the query fails then a generic "It's locked..." dialogue will be shown.<br>''Example: ConditionalDoor PLAYER_STAT Current monstersKilled 1000''		\| Place on an interior door's bottom tile. Must be used in conjunction with the <samp>Doors</samp> map property. Uses a [[Modding:Game_state_queries\|game state query]] to check if the player can open the door. If a <samp>LockedDoorMessage</samp> tile property is on the same tile and the query fails, a dialogue box with the supplied text string will be dislayed; Otherwise, if the query fails then a generic "It's locked..." dialogue will be shown.<br>''Example: ConditionalDoor PLAYER_STAT Current monstersKilled 1000''
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>

imported>SiTheGreat: Clarified OpenShop [open/close time] and [owner tile area] params as required for ClosedMessage to function

2026-04-16T02:12:16Z

Clarified OpenShop [open/close time] and [owner tile area] params as required for ClosedMessage to function

← Older revision		Revision as of 02:12, 16 April 2026
Line 1,141:		Line 1,141:
	\| Open the [[Modding:Shops\|shop]] with the given {{t\|shop id}}. All arguments besides the ID are optional:		\| Open the [[Modding:Shops\|shop]] with the given {{t\|shop id}}. All arguments besides the ID are optional:
	* {{o\|from direction}}: if specified, the player must be standing in this direction relative to the shop (one of <samp>down</samp>, <samp>up</samp>, <samp>left</samp>, <samp>right</samp>, or <samp>none</samp>). Setting this to <samp>none</samp> disables the requirement. The default for most vanilla shops is <samp>down</samp>.		* {{o\|from direction}}: if specified, the player must be standing in this direction relative to the shop (one of <samp>down</samp>, <samp>up</samp>, <samp>left</samp>, <samp>right</samp>, or <samp>none</samp>). Setting this to <samp>none</samp> disables the requirement. The default for most vanilla shops is <samp>down</samp>.
	* {{o\|open time}} and {{o\|close time}}: the start & end times in 26-hour format when the shop is ~~available~~. ~~Interacting with the tile outside those times does nothing. If omitted~~, the shop ~~will~~ be ~~open at all hours (however it is possible to close it~~ using a <samp>ClosedMessage</samp> in its [[Modding:Shops\|Data/Shops]] entry).		* {{o\|open time}} and {{o\|close time}}: the start & end times in 26-hour format when the shop is interactable. During this time, the shop can be closed using a <samp>ClosedMessage</samp> in its [[Modding:Shops\|Data/Shops]] entry. Interacting with the tile outside of {{o\|open time}} and {{o\|close time}} does nothing. If omitted, the shop will default to being open at all hours.
	* {{o\|owner tile area}}: if specified, the tile area which must contain one of the shop owners for the shop to be ~~available~~. For a custom shop, these are defined by its <samp>Owners</samp> field. This must be written as: <samp>{{t\|x}} {{t\|y}} {{t\|width}} {{t\|height}}</samp>.		* {{o\|owner tile area}}: if specified, the tile area which must contain one of the shop owners for the shop to be interactable. For a custom shop, these are defined by its <samp>Owners</samp> field. This must be written as: <samp>{{t\|x}} {{t\|y}} {{t\|width}} {{t\|height}}</samp>. If omitted, the shop menu will force open regardless of whether the shop owner is present and skip any <samp>Owners</samp> entries containing <samp>ClosedMessage</samp>.
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>

imported>DolphinIsNotaFish at 01:47, 16 April 2026

2026-04-16T01:47:31Z

← Older revision		Revision as of 01:47, 16 April 2026
Line 351:		Line 351:

	==Known map properties==		==Known map properties==
			Arguments in < > are required. Arguments in [ ] are optional; however, optional arguments must be provided sequentially and may not be skipped.
	===Building construction===		===Building construction===
	{\| class="wikitable"		{\| class="wikitable"

imported>Pathoschild: /* Plants, forage, & item spawning */ Treasure removed in 1.6.16

2026-02-16T00:32:05Z

Plants, forage, & item spawning: Treasure removed in 1.6.16

← Older revision		Revision as of 00:32, 16 February 2026
Line 436:		Line 436:
	\| <samp>Treasure {{t\|type}} {{t\|int id}}</samp><br />''(valid in any location)''		\| <samp>Treasure {{t\|type}} {{t\|int id}}</samp><br />''(valid in any location)''
	\| Adds buried treasure that the player can dig up. {{t\|type}} can be any of the following: <br /><samp>Coins, Copper, Coal, Iron, Gold, Iridium, CaveCarrot, Arch, Object</samp>.<br /> If set to <samp>Arch</samp> or <samp>Object</samp>, {{t\|id}} may be used to specify the ID of the item that is buried. - Per Esca, this is actually a Tile Property. Also, per Elizabeth, this is not fully implemented, advise against use.		\| Adds buried treasure that the player can dig up. {{t\|type}} can be any of the following: <br /><samp>Coins, Copper, Coal, Iron, Gold, Iridium, CaveCarrot, Arch, Object</samp>.<br /> If set to <samp>Arch</samp> or <samp>Object</samp>, {{t\|id}} may be used to specify the ID of the item that is buried. - Per Esca, this is actually a Tile Property. Also, per Elizabeth, this is not fully implemented, advise against use.

			{{upcoming\|1.6.16\|This property is removed in the upcoming 1.6.16.}}
	\|-		\|-
	\| <samp>Trees [{{t\|int x}} {{t\|int y}} {{t\|int type}}]+</samp><br />''(valid in any location)''		\| <samp>Trees [{{t\|int x}} {{t\|int y}} {{t\|int type}}]+</samp><br />''(valid in any location)''

imported>Abagaianye: Edited NoPath to indicate that it takes any not-null value

2026-02-03T15:44:26Z

Edited NoPath to indicate that it takes any not-null value

← Older revision		Revision as of 15:44, 3 February 2026
Line 740:		Line 740:
	\|-		\|-
	\| <samp>Back</samp>		\| <samp>Back</samp>
	\| <samp>NoPath</samp>		\| <samp>NoPath T</samp>²
	\| Excludes this tile from NPC pathing, making them go around it if necesssary.		\| Excludes this tile from NPC pathing, making them go around it if necesssary.
	\|-		\|-

imported>NotAGardener: Added the Bobbers, MasteryRoom, SkullDoor, SpecialWaterDroppable and FixRacoonStump tile property actions

2026-01-27T03:04:10Z

Added the Bobbers, MasteryRoom, SkullDoor, SpecialWaterDroppable and FixRacoonStump tile property actions

← Older revision		Revision as of 03:04, 27 January 2026
Line 905:		Line 905:
	\| <samp>Action Arcade_Minecart</samp>		\| <samp>Action Arcade_Minecart</samp>
	\| Shows the ''Junimo Kart'' arcade game.		\| Shows the ''Junimo Kart'' arcade game.
			\|-
			\| <samp>Buildings</samp>
			\| <samp>Action Bobbers</samp>
			\| Shows the Fishing Bobber customization menu.
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>
Line 1,021:		Line 1,025:
	\| <samp>Action EvilShrineRight</samp>		\| <samp>Action EvilShrineRight</samp>
	\| Toggles monster spawning for your farm.		\| Toggles monster spawning for your farm.
			\|-
			\| <samp>Buildings</samp>
			\| <samp>Action FixRaccoonStump</samp>
			\| Prompts you to use 100 Hardwood to fix the stump.
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>
Line 1,069:		Line 1,077:
	\| <samp>Action MagicInk</samp>		\| <samp>Action MagicInk</samp>
	\| Adds the Magic Ink to your wallet.		\| Adds the Magic Ink to your wallet.
			\|-
			\| <samp>Buildings</samp>
			\| <samp>Action MasteryRoom</samp>
			\| If you don't have skill 10 in every skill a dialogue box appears saying "Only a master of the five ways may enter (X/5)", If you do it warps you into the [[Mastery Cave]].
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>
Line 1,164:		Line 1,176:
	\| <samp>Action SandDragon</samp>		\| <samp>Action SandDragon</samp>
	\| Used for Part 3 of the Mysterious Mr. Qi Quest.		\| Used for Part 3 of the Mysterious Mr. Qi Quest.
			\|-
			\| <samp>Buildings</samp>
			\| <samp>Action SpecialWaterDroppable</samp>
			\| If the player is holding an [[Ancient Doll]], it will be thrown to the right of the tile and the player will receive a [[Far Away Stone]].
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>
	\| <samp>Action Shop</samp>		\| <samp>Action Shop</samp>
	\| On festival maps, opens the festival shop. No effect on non-festival maps.		\| On festival maps, opens the festival shop. No effect on non-festival maps.
			\|-
			\| <samp>Buildings</samp>
			\| <samp>Action SkullDoor</samp>
			\| Warps the player into the skull caverns if they have the [[Skull Key]] if they have it unlocked.
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>

imported>NotAGardener: added a new tile property action

2026-01-27T02:11:12Z

added a new tile property action

← Older revision		Revision as of 02:11, 27 January 2026
Line 973:		Line 973:
	\| <samp>Action ClubSlots</samp>		\| <samp>Action ClubSlots</samp>
	\| Shows the casino slots minigame.		\| Shows the casino slots minigame.
			\|-
			\| <samp>Buildings</samp>
			\| <samp>Action ForestPylon</samp>
			\| Shows the event giving you the [[Meowmere]] sword if the player is holding the [[Far Away Stone]]. If the player isn't holding the stone a dialogue box appears saying "It is a receptacle of unknown origins."
	\|-		\|-
	\| <samp>Buildings</samp>		\| <samp>Buildings</samp>

imported>Pathoschild: /* "Tilesheet paths must be a relative path without directory climbing (../)" */ update for SMAPI 4.4.0

2026-01-11T03:48:45Z

"Tilesheet paths must be a relative path without directory climbing (../)": update for SMAPI 4.4.0

← Older revision		Revision as of 03:48, 11 January 2026
Line 1,450:		Line 1,450:
	See also [[#Potential issues\|''potential issues'']] above for common issues.		See also [[#Potential issues\|''potential issues'']] above for common issues.

	==="~~Tilesheet paths must be a relative path without directory~~ climbing (../)"===		==="Directory climbing (../) is only permitted once at the start of the path"===
	~~{{SMAPI upcoming\|4.4.0\|SMAPI 4.4.0 will allow climbing once to~~ reference a ~~<samp>Content</samp> file~~ that's ~~not in~~ <samp>Content~~/Maps~~</samp>~~. Paths with directory climbing will always be relative to <samp>Content/Maps</samp>, not~~ the ~~map file~~.}}		; What does this mean?
			: You can reference a tilesheet that's either (a) within the map asset's folder, or (b) within the game's <samp>Content</samp> folder in the pipeline.

	~~; What does this mean?~~		: Your map can't use a tilesheet that's outside those folder roots. That might happen if you [[#'Save as' in Tiled\|used 'save as' in Tiled to save into a different folder]], copied & pasted tiles between maps in different folders, or manually added a tilesheet from a different folder.
	: Your map ~~uses~~ a tilesheet that's outside ~~its~~ folder ~~root~~. That might happen if you [[#'Save as' in Tiled\|used 'save as' in Tiled to save into a different folder]], copied & pasted tiles between maps in different folders, or manually added a tilesheet from a different folder.

	: For example:		: For example:

imported>Pathoschild: /* "Tilesheet paths must be a relative path without directory climbing (../)" */ + note SMAPI 4.4.0 will allow limited climbing

2025-12-26T18:32:24Z

"Tilesheet paths must be a relative path without directory climbing (../)": + note SMAPI 4.4.0 will allow limited climbing

← Older revision		Revision as of 18:32, 26 December 2025
Line 1,451:		Line 1,451:

	==="Tilesheet paths must be a relative path without directory climbing (../)"===		==="Tilesheet paths must be a relative path without directory climbing (../)"===
			{{SMAPI upcoming\|4.4.0\|SMAPI 4.4.0 will allow climbing once to reference a <samp>Content</samp> file that's not in <samp>Content/Maps</samp>. Paths with directory climbing will always be relative to <samp>Content/Maps</samp>, not the map file.}}

	; What does this mean?		; What does this mean?
	: Your map uses a tilesheet that's outside its folder root. That might happen if you [[#'Save as' in Tiled\|used 'save as' in Tiled to save into a different folder]], copied & pasted tiles between maps in different folders, or manually added a tilesheet from a different folder.		: Your map uses a tilesheet that's outside its folder root. That might happen if you [[#'Save as' in Tiled\|used 'save as' in Tiled to save into a different folder]], copied & pasted tiles between maps in different folders, or manually added a tilesheet from a different folder.

← Older revision		Revision as of 00:32, 16 February 2026
Line 436:		Line 436:
	\| <samp>Treasure {{t\|type}} {{t\|int id}}</samp><br />''(valid in any location)''		\| <samp>Treasure {{t\|type}} {{t\|int id}}</samp><br />''(valid in any location)''
	\| Adds buried treasure that the player can dig up. {{t\|type}} can be any of the following: <br /><samp>Coins, Copper, Coal, Iron, Gold, Iridium, CaveCarrot, Arch, Object</samp>.<br /> If set to <samp>Arch</samp> or <samp>Object</samp>, {{t\|id}} may be used to specify the ID of the item that is buried. - Per Esca, this is actually a Tile Property. Also, per Elizabeth, this is not fully implemented, advise against use.		\| Adds buried treasure that the player can dig up. {{t\|type}} can be any of the following: <br /><samp>Coins, Copper, Coal, Iron, Gold, Iridium, CaveCarrot, Arch, Object</samp>.<br /> If set to <samp>Arch</samp> or <samp>Object</samp>, {{t\|id}} may be used to specify the ID of the item that is buried. - Per Esca, this is actually a Tile Property. Also, per Elizabeth, this is not fully implemented, advise against use.

			{{upcoming\|1.6.16\|This property is removed in the upcoming 1.6.16.}}
	\|-		\|-
	\| <samp>Trees [{{t\|int x}} {{t\|int y}} {{t\|int type}}]+</samp><br />''(valid in any location)''		\| <samp>Trees [{{t\|int x}} {{t\|int y}} {{t\|int type}}]+</samp><br />''(valid in any location)''