Show / Hide Table of Contents

Game actions

Introduction

Game actions can be use either to start a game or to launch additional executables not related to game startup, for example configuration/mod utilities. Only actions marked as "Play" action are used to start a game, others are available to launch via game menu. If more then one Play action is available, Playnite will show selection dialog on game's startup to specify which action to use to start a game.

Include library integration play actions specifies whether integration plugin that imported a specific game, will be asked to handle game startup when the game is being launched.

Play actions can be also provided by plugins, see game actions plugin page for more details.

Bulk editing

When editing multiple games at the same time, Playnite won't show currently assigned actions from selected games. What's being assigned while in bulk edit mode will be assigned to all selected games and all existing actions will be removed.

Action properties

Property Description
Play action If enabled, Playnite will treat this action as Play action. Offering as an option when starting a game (if more than one option is available and counting play time from a started by this action.
Type Action startup type.
Tracking mode Only available for Play actions (File and URL types) since it affects how play time detection works.
Path File path (or URL) to start.
Arguments Startup arguments passed to an executable during startup.
Working directory Working directory set to an executable during startup.

Action types

Property Description
File Path is executed as a standard executable file.
URL Path is executed as an URL address.
Emulator Action is started using emulator configuration.
Script Script used to start an application. See game scripts page for more details.
Warning

Non-play actions that use Script startup method will run synchronously on main thead. This means that they will block Playnite's UI until the script is finished running. Therefore make sure you don't use any long running operations in your startup script.

Emulator settings

Property Description
Emulator Emulator to launch.
Emulator profile Emulator profile to use to launch a game. Selecting Choose on startup will give an option to select a profile

Tracking mode

Property Description
Default Playnite will try to detect and use the best tracking method automatically.
Process Playnite will track a game as running as long as original process or any of its child processes are running.
Folder Playnite will track a game as running as long as some process from Tracking path folder is running.

Troubleshooting

In rare cases (depending on an application being started) the application won't start properly unless Working directory is not set to application's installation directory. If this happens you need to specify Working directory manually to a directory that makes selected application run properly. This is not an issue in Playnite, it's an issue in the started application.

  • Improve this Doc
Back to top Generated by DocFX