Modding:Console commands

⚠

Console commands aren't meant for general use. Be very careful using them.
They can have permanent side-effects on your save data, break your save, or have other unintended effects. If you don't understand the command, don't use it on a save you care about.

SMAPI provides access to hundreds of console commands with a wide variety of effects, ranging from useful tools to cheats to specialized test commands. These are documented on this page.

Format used on this page

To avoid repeating text, this page uses a few conventions to convey common information:

Required parameters are listed in angle brackets, and optional parameters are listed in square brackets. For example, speed <I:value> [I:duration] means the command requires an integer value parameter and has an optional integer duration parameter. Details such as default values should be listed in the description.
The command names are case-insensitive, but their parameters might be case-sensitive.
If a command description says that a parameter uses "fuzzy" match, that means that it can match on a case-insensitive partial name. For example, abi would match Abigail if it's fuzzy.

Console commands

How to enter console commands

You can enter console commands directly into the SMAPI console window. You can type help to get a list of console commands (including commands added by other mods).

Items & money

Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Player

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

World

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Other

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Mods may also add their own commands. For example, Content Patcher adds the patch command, documented here.

Advanced

⚠️ These may corrupt or make permanent changes to your save. DO NOT USE THESE unless you're absolutely sure.

Template:/cmd Template:/cmd Template:/cmd

command	description

Debug commands

🅧

Don't use these commands unless you're aware of the possible consequences.
These are meant for the game developers, not players. They may crash your game, permanently corrupt or break your save, or cause other problems. Using these in a save you care about is not recommended.

How to enter debug commands

The game itself has hundreds of hidden debug commands used to test the game. These require the Console Commands mod too, but every command should be prefixed with debug like this:

debug where Robin
> Robin is at Farm, 21,4

The example above returned output, but many commands don't. If there's no output, SMAPI will say Sent debug command to the game, but there was no output.

Macros

Instead of entering each command directly into the SMAPI console, you can also use the debug runmacro command to a list of debug commands from a text file. (This doesn't work with the non-debug commands.) Here's how to use it:

Create a text file in your game folder (with a .txt extension).
Type commands in this file, one command per line. Each command should start with a slash character (/), but should not include debug .
To run the macro, type debug runmacro <filename> in the SMAPI console, replacing <filename> with the name of your command file with the .txt extension.

For example, let's say you have a quickstart.txt file with these commands:

/backpack 12
/Money 10000
/levelup 0 1
/weapon 5

Entering debug runmacro quickstart in the SMAPI console will execute all the commands, resulting in a backpack upgrade, money set to 10000g, farming skill set to level 1, and a Bone Sword added to the player's inventory. (Note: Money is capitalized in this example because if it is all lowercase it triggers a special chat response instead of executing the command.)

Actions and queries

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Items and inventory

General item search and spawning

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Backpack and inventory

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Clothing and tailoring

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Tools and weapons

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Wallet items

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Miscellaneous items

Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Player

Appearance

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Health, stamina, buffs, and currency

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Movement and warping

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Skills and XP

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Statistics and achievements

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Collections and quests

Cooking and crafting

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Fishing, museum, and secret notes

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Mail

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Quests and Special Orders

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

NPCs

Children

Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Spawning and removal

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Relationships

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Dialogue

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Movement and warping

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Farm animals

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Pets, horses, and monsters

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Festivals and events

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Minigames and cutscenes

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Shops

Template:/cmd Template:/cmd

command	description

Locations

Terrain, trees, and crops

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Objects and lights

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Farm buildings

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Farmhouse

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Special farm setups

Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Community center and bundles

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Other location-specific functions

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

World

Date and time

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Weather and world state

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Game settings and meta info

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Multiplayer

General multiplayer

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Logging

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Player relationships

Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Shared/split money

Template:/cmd Template:/cmd Template:/cmd

command	description

Audio and visual effects

Animations

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Camera, lighting, and effects

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Audio

Template:/cmd Template:/cmd

command	description

Outdated, unimplemented, or unknown

Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd Template:/cmd

command	description

Modding:Console commands

Format used on this page

Console commands

How to enter console commands

Items & money

Player

World

Other

Advanced

Debug commands

How to enter debug commands

Macros

Actions and queries

Items and inventory

General item search and spawning

Backpack and inventory

Clothing and tailoring

Tools and weapons

Wallet items

Miscellaneous items

Player

Appearance

Health, stamina, buffs, and currency

Movement and warping

Skills and XP

Statistics and achievements

Collections and quests

Cooking and crafting

Fishing, museum, and secret notes

Mail

Quests and Special Orders

NPCs

Children

Spawning and removal

Relationships

Dialogue

Movement and warping

Farm animals

Pets, horses, and monsters

Festivals and events

Minigames and cutscenes

Shops

Locations

Terrain, trees, and crops

Objects and lights

Farm buildings

Farmhouse

Special farm setups

Community center and bundles

Other location-specific functions

World

Date and time

Weather and world state

Game settings and meta info

Multiplayer

General multiplayer

Logging

Player relationships

Shared/split money

Audio and visual effects

Animations

Camera, lighting, and effects

Audio

Outdated, unimplemented, or unknown

See also

Navigation menu

Search