emulator: mkxp-z
type: libretro
core_classification: game_engine
source: "https://github.com/white-axe/mkxp-z"
source_ref: "branch: libretro (PR #255 to mkxp-z/mkxp-z)"
upstream: "https://github.com/mkxp-z/mkxp-z"
profiled_date: "2026-03-24"
core_version: "f4bc5aa"
display_name: "RPG Maker XP/VX/VX Ace (mkxp-z)"
cores:
  - mkxp-z
systems:
  - rpgmaker

notes: |
  Game engine implementing RGSS 1/2/3 (Ruby Game Scripting System) for
  RPG Maker XP, VX and VX Ace. Fork of Ancurio/mkxp. Libretro port by
  white-axe, not yet merged upstream.

  All entries are directories, not individual files. No hashable BIOS.
  RTPs are shared asset packages needed only when a game references stock
  assets instead of bundling its own. MIDI soundfont (GMGSx.sf2) is
  embedded in the binary.

files:
  - name: "Standard"
    description: "RPG Maker XP Run-Time Package"
    category: game_data
    path: "mkxp-z/RTP/Standard/"
    required: false
    source_ref: "core.cpp:1042-1085, core.cpp:1087-1158"

  - name: "RPGVX"
    description: "RPG Maker VX Run-Time Package"
    category: game_data
    path: "mkxp-z/RTP/RPGVX/"
    required: false
    source_ref: "core.cpp:1042-1085, core.cpp:1087-1158"

  - name: "RPGVXAce"
    description: "RPG Maker VX Ace Run-Time Package"
    category: game_data
    path: "mkxp-z/RTP/RPGVXAce/"
    required: false
    source_ref: "core.cpp:1042-1085, core.cpp:1087-1158"

  - name: "Fonts"
    description: "Fallback font directory (.otf/.ttf)"
    category: game_data
    path: "mkxp-z/Fonts/"
    required: false
    source_ref: "core.cpp:1160-1172"

  - name: "Preload"
    description: "Ruby scripts loaded before game scripts"
    category: game_data
    path: "mkxp-z/Scripts/Preload/"
    required: false
    source_ref: "core.cpp:876-907"

  - name: "Postload"
    description: "Ruby scripts loaded after game scripts (RGSS3 only)"
    category: game_data
    path: "mkxp-z/Scripts/Postload/"
    required: false
    source_ref: "core.cpp:886-917"