easyrpg-player - Man Page

--autobattle-algo ALGO

Which AutoBattle algorithm to use. Possible options:

• 'RPG_RT'     - The default RPG_RT compatible algo, including RPG_RT bugs
• 'RPG_RT+'    - The default RPG_RT compatible algo, with bug fixes
• 'ATTACK'     - Like RPG_RT+, but only physical attacks, no skills

-c,  --config-path PATH

Set a custom configuration path. When not specified, the configuration folder in the users home directory is used. The default configuration path is '$XDG_CONFIG_HOME/EasyRPG/Player'.

--encoding ENCODING

Instead of autodetecting the encoding or using the one in 'RPG_RT.ini', the specified encoding is used. 'ENCODING' is the number of the codepage used in Windows. Common encodings:

• '932'  - Japanese (Shift-JIS)
• '936'  - Simplified Chinese (GB2312)
• '949'  - Korean (Unified Hangul)
• '950'  - Traditional Chinese (Big5)
• '1250' - Central European
• '1251' - Cyrillic
• '1252' - Western European (Latin 1)

Note

For games that only use ASCII (English games) use '1252'.

--enemyai-algo ALGO

Which EnemyAI algorithm to use. Possible options:

• 'RPG_RT'      - The default RPG_RT compatible algo, including RPG_RT bugs
• 'RPG_RT+'     - The default RPG_RT compatible algo, with bug fixes

--engine ENGINE

Disable autodetection of the simulated engine. Possible options:

• 'rpg2k'       - RPG Maker 2000 (v1.00 - v1.10)
• 'rpg2kv150'   - RPG Maker 2000 (v1.50 - v1.51)
• 'rpg2ke'      - RPG Maker 2000 RPG Maker 2000 (English release, v1.61)
• 'rpg2k3'      - RPG Maker 2003 (v1.00 - v1.04)
• 'rpg2k3v105'  - RPG Maker 2003 (v1.05 - v1.09a)
• 'rpg2k3e'     - RPG Maker 2003 RPG Maker 2003 (English release, v1.12)

--language LANG

Loads the game translation in language/'LANG' folder.

--load-game-id ID

Skip the title scene and load SaveID.lsd ('ID' is padded to two digits).

--new-game

Skip the title scene and start a new game directly.

--no-log-color

Disable colors in terminal log.

--no-rtp

Disable support for the Runtime Package (RTP). Will lead to checkerboard graphics and silent music/sound effects in games depending on the RTP.

--patch PATCH_A [PATCH_B ...]

Instead of autodetecting patches used by this game, force emulation of certain patches.

• 'common-this' - Support for This Event in common events
• 'dynrpg'      - DynRPG patch by Cherry
• 'key-patch'   - Key Patch by Ineluki
• 'maniac'      - Maniac Patch by BingShan
• 'pic-unlock'  - Pictures are not blocked by messages
• 'rpg2k3-cmds' - Support RPG Maker 2003 event commands in all engines

--no-patch

Disable all engine patches.

--project-path PATH

Instead of using the working directory, the game in 'PATH' is used.

--record-input FILE

Record all button inputs to 'FILE'.

--replay-input FILE

Replays button input from 'FILE', as generated by --record-input. If the RNG seed (--seed) and the state of the save file directory are the same as it was when the log was recorded, this should reproduce an identical run to the one recorded.

--rtp-path PATH

Adds 'PATH' to the RTP directory list and use this one with highest precedence.

--save-path PATH

Instead of storing save files in the game directory they are stored in 'PATH'. The directory must exist.
Note

When using the game browser all games will share the same save directory!

--seed SEED

Seeds the random number generator.

--fps-limit

In combination with --no-vsync sets a custom frames per second limit. If unspecified, the default is 60 fps. Set to 0 or use --no-fps-limit to disable the frame limiter. This option may not be supported on all platforms.

--fps-render-window

Render the frames per second counter in both fullscreen and windowed mode. Can be disabled with --no-fps-render-window.

--fullscreen

Start in fullscreen mode.

--game-resolution RESOLUTION

Force a different game resolution. RPG Maker games are designed for 320x240. This option fakes certain metrics to make games run at higher resolutions. Rendering in a different resolution can cause graphical glitches or break games entirely. Possible options:

• 'original'    - 320x240 (4:3), the default resolution
• 'widescreen'  - 416x240 (16:9)
• 'ultrawide'   - 560x240 (21:9)

--scaling MODE

How the video output is scaled. Possible options:

• 'nearest'    - Scale to screen size using nearest neighbour algorithm. This is fast, but causes scaling artifacts.
• 'integer'    - Like 'nearest' but scales to a multiple of the game resolution to avoid artifacts.
• 'bilinear'   - Like 'nearest' but apply a bilinear filter to avoid the artifacts.

--show-fps

Enable display of the frames per second counter. Can be disabled with --no-show-fps.

--stretch

Ignore the aspect ratio and stretch video output to the entire width of the screen. Can be disabled with --no-stretch.

--vsync

Enables vertical sync. Vsync may or may not be supported on all platforms. Check the engine log to verify whether or not vsync actually is being used. Can be disabled with --no-vsync.

--window

Start in windowed mode.

--disable-audio

Disable audio (in case you prefer your own music).

--music-volume VOLUME

Set the volume of background music to a value from 0 to 100.

--sound-volume VOLUME

Set the volume of sound effects to a value from 0 to 100.

--soundfont FILE

Adds 'FILE' to the list of soundfonts used for playing MIDI files and use this one with highest precedence. The soundfont must be in SF2 format.

--battle-test MONSTERPARTY

Starts a battle test with the specified monster party. This is for starting battle tests in RPG Maker 2000.

--battle-test MONSTERPARTY FORMATION CONDITION TERRAIN

Starts a battle test with the specified monster party, formation, start condition and terrain. This is for starting battle tests in RPG Maker 2003.

--hide-title

Hide the title background image and center the command menu.

--start-map-id ID

Overwrite the map used for new games and use MapID.lmu instead ('ID' is padded to four digits).
Note

Incompatible with --load-game-id.

--start-position X' 'Y

Overwrite the party start position and move the party to position ('X', 'Y').
Note

Incompatible with --load-game-id.

--start-party A [B ...]

Overwrite the starting party members with the actors with IDs 'A', 'B', '...'
Note

Incompatible with --load-game-id.

--test-play

Enable TestPlay (Debug) mode.

-v,  --version

Display program version and exit.

-h,  --help

Display help and exit.

For compatibility with the original RPG Maker runtime the following legacy arguments are supported:

BattleTest ID

HideTitle

Same as --hide-title.

TestPlay

Same as --test-play.

Window

Same as --window.

Sets game specific settings to alter the engine behaviour. It follows a simple Key=Value syntax in multiple sections.

Options in section 'Game':

NewGame=1

Same as --new-game.

FakeResolution=1

When 'WinW'/'WinH' in 'RPG_RT.ini' are used, enable the metric faking algorithm used by --game-resolution.

Engine=ENGINE

Same as --engine.

Options in section 'Patch' (see also --patch):

CommonThisEvent=1

Same as --patch common-this.

DynRPG=1

Same as --patch dynrpg.

KeyPatch=1

Same as --patch key-patch.

Maniac=1

Same as --patch maniac.

PicUnlock=1

Same as --patch pic-unlock.

RPG2k3Commands=1

Same as --patch rpg2k3-commands.
Note

Providing any patch option disables the patch autodetection of the engine.

Example:

[Game]
NewGame=1
Engine=rpg2k

[Patch]
CommonThisEvent=1
Maniac=1

The game configuration file. It follows a simple Key=Value syntax in multiple sections.

Options in section 'RPG_RT':

GameTitle=TITLE

Title shown in the titlebar. The string must have the same encoding as the game (see also --encoding).

FullPackageFlag=1

Indicates that the game does not use assets from the Runtime Package (RTP).

WinW=WIDTH

Set a custom screen width in pixel. Use this in combination with WinH. The x and y coordinate are at the top-left corner. This behaviour can be altered with FakeResolution.

WinH=HEIGHT

Set a custom screen height.
Note

These resolution options invented by the Maniac Patch but they are processed even when the patch is disabled. Using a custom resolution disables --game-resolution.

Options in section 'EasyRPG':

Encoding=ENCODING

Same as --encoding.

Example:

[RPG_RT]
GameTitle=My Game
FullPackageFlag=1
WinW=640
WinH=480

[EasyRPG]
Encoding=1252

'Encoding=1252' sets the correct encoding for most english games.