easyrpg
EasyRPG is a multi-platform interpreter developed by Ghabry to run games designed with RPG Maker 2000 and 2003, without requiring the original software.
EasyRPG is an open-source interpreter designed to run games created with RPG Maker 2000 and 2003, without relying on the original software. Developed by Ghabry as part of a community project, it allows playing these RPGs on macOS, as well as on other platforms like Windows, Linux, or even through a browser.
While not officially optimized for Apple Silicon processors, it works on recent versions of macOS thanks to its cross-platform compatibility. The tool caters to both players looking to discover independent creations and developers interested in its editor and creation tools. The community actively contributes to its improvement through technical or artistic contributions.
Games included
The games this software runs.
Yume Nikki
Dream exploration without dialogue: a young recluse collects items that each unlock a different dream, with no explicit goal.
Ib
A 2D horror adventure in a museum that deforms: a young girl and two strangers search for the exit, with puzzles and multiple endings.
Last updated:
Architecture
Mac OS X - macOS
Apple Silicon
64-bit
SDL Library
Download and links
-
Download easyrpg
The offered file is version 0.8, while the latest published version is 0.8.1.1.
- Official website
-
Source code
1 267 GitHub stars
Code source du player
- License : GPL-3.0
- Command copied to the clipboard.
- Homebrew page
Version history
0.8.1.1
- Correction de la détection des encodages texte dans les archives ZIP sur Android et les plateformes Homebrew.
- Amélioration du support des archives compressées au format LZH.
- Mise à jour minimale requise pour CMake (version 3.18 au lieu de 3.16).
- Mise à jour minimale requise pour SDL 2.0 (version 2.0.14 au lieu de 2.0.5).
Changes
The highlights:
Fix text encoding detection for ZIP archives on Android and our Homebrew platforms. (#3401)
Improve support for LZH archives (#3394)
For everything else read the release notes. Enjoy!
Full release notes
https://blog.easyrpg.org/2025/06/easyrpg-player-0-8-1-1-stun-patch-1/
For Developers / Maintainers / Building
This is a minor patch release. Build against liblcf 0.8.1.
Minimum supported versions were changed from very ancient to a bit less ancient: (#3391)
CMake 3.18 (from 3.16)
SDL 2.0.14 (from SDL 2.0.5)
Otherwise, there are no significant changes.
As a reminder:
Autotools (
configure) is still deprecated and will be removed in the next major release. Please migrate to CMakeTo opt in to SDL3 (the default is SDL2) invoke CMake with
-DPLAYER_TARGET_PLATFORM=SDL3
0.8.1.1
- Correction de la détection des encodages textuels dans les archives ZIP pour Android et les plateformes Homebrew.
- Amélioration du support des archives compressées au format LZH.
- Mise à jour des versions minimales requises pour CMake (3.18 au lieu de 3.16) et SDL 2.0 (14 au lieu de 5).
Changes
The highlights:
- Fix text encoding detection for ZIP archives on Android and our Homebrew platforms. (#3401)
- Improve support for LZH archives (#3394)
For everything else read the release notes. Enjoy!
Full release notes
https://blog.easyrpg.org/2025/06/easyrpg-player-0-8-1-1-stun-patch-1/
For Developers / Maintainers / Building
This is a minor patch release. Build against liblcf 0.8.1.
Minimum supported versions were changed from very ancient to a bit less ancient: (#3391)
- CMake 3.18 (from 3.16)
- SDL 2.0.14 (from SDL 2.0.5)
Otherwise, there are no significant changes.
As a reminder:
- Autotools (
configure) is still deprecated and will be removed in the next major release. Please migrate to CMake - To opt in to SDL3 (the default is SDL2) invoke CMake with
-DPLAYER_TARGET_PLATFORM=SDL3
0.8.1
- Support du format LZH : ajout du support des jeux dans des archives LZH via la dépendance recommandée lhasa.
- Suppression de bibliothèques vendrées : rang et picojson remplacées respectivement par fmtlib et nlohmann_json.
- Amélioration de la compilation : passage obligatoire à C++17 pour les builds de liblcf et du Player.
- Dépréciation d’autotools : migration obligatoire vers CMake pour les builds futures.
- Support de SDL3 : prise en charge expérimentale de SDL3 (actif via option CMake -DPLAYER_TARGET_PLATFORM=SDL3).
- Correction des builds libretro : résolution des problèmes de compilation pour les cœurs Android dépendant de SDL2.
Full release notes
https://blog.easyrpg.org/2025/04/easyrpg-player-0-8-1-stun/
For Developers / Maintainers / Building
Always upgrade liblcf before upgrading the Player. Both need to be on the same version.
As a reminder: liblcf is our library for parsing RPG Maker files.
tl;dr for busy maintainers :)
- C++17 required
- autotools will be removed soon, migrate to CMake
- SDL3 is now supported but SDL2 is still the default. This will be changed in the next release. To already enable it use
-DPLAYER_TARGET_PLATFORM=SDL3. fmt >= 10is supportedlhasais a new, recommended dependency (for playing games inside LZH archives, a popular archive format among RPG Maker games)dr_wavprefers now the system library instead of the vendored copy (via#if __has_include)rangwas removed- Vendored
picojsonwas removed and replaced withnlohmann_jsonand is a new, recommended dependency on all systems, not just emscripten (used by the new JSON event command).
Detailed
Building liblcf and Player now requires a C++17 compatible compiler. For liblcf this is actually enforced by a dependency: ICU (the Unicode library we use) requires C++17 as of version 75. (#2190, liblcf #458)
Building with autotools is deprecated and will be removed right after this release. The archaic m4 language used by autotools became more and more of a maintenance burden, and our autotools build system lacks many features compared to our CMake build system. If you are a package maintainer, please migrate to CMake.
We support now SDL3. SDL3 is the latest version and brings enhancements such as a better graphics API proper scaling on high-DPI displays. Our support for SDL3 is very basic (same as SDL2) and is fairly recent so we decided to stay on SDL2 by default for now. To enable it use -DPLAYER_TARGET_PLATFORM=SDL3. (#2865)
CMake: zlib now uses find package because the config file is broken if not both shared and static version of zlib are installed. (#3318)
The Player compiles now when using fmtlib 10 or newer. (#3002)
Loading games inside LZH archives, a popular format for RPG Maker 2000/2003 games because the editor can create it, is now supported and requires lhasa, a new, recommended dependency. (#3033)
Dr_wav (header-only library to play WAV audio files) uses now the system library, when available, instead of our vendored version. (#2986)
The vendored version of rang (library for coloured output in the terminal) was removed. We now use the functionality of fmtlib. This breaks the terminal output on Windows versions prior to Windows 10 but considering this is only a debugging feature this is acceptable. (#3181)
The vendored copy of picojson (JSON library) was replaced with nlohmann_json. The JSON library is now used everywhere, not just for emscripten, making it a new, recommended dependency for the Player. For emscripten it's used to parse index.json to figure out which files exist and for the other platforms a new event command was added to access and manipulate JSON files. (#3228)
When compiling a libretro core for Android some components depending on SDL2 were not disabled which broke the build. (#2983)
The CMake build system has a new setting -DPLAYER_BUILD_LIBLCF_BRANCH to build a custom branch when using -DPLAYER_BUILD_LIBLCF=ON. (#3017)
The Player now builds when resampling is disabled (neither speexdsp nor libsamplerate available). (#3251)
CMake now correctly detects the endianess (big or little endian) when crosscompiling. (liblcf #464, #3060)
A callback API was added to make it easier for external code to hook into our code without causing merge conflicts every time our code is updated. (#3224)
The header string-view-lite was removed and replaced with std::string_view which is a new feature in C++17. (#3360, liblcf #495)
0.8
- Ajout du support natif des polices via FreeType (obligatoire), avec option HarfBuzz pour le rendu avancé des caractères.
- Suppression des zéros finaux dans la numérotation des versions (ex. : 0.8 au lieu de 0.8.0).
- CMake devient obligatoire pour les builds non Unix (y compris consoles comme Wii ou Switch), remplaçant les Makefiles obsolètes.
- Prise en charge des CMake presets pour simplifier les compilations multiplateformes.
- Correction des erreurs de build sous emscripten avec les versions récentes de SDL2.
- Intégration automatique de l’information de version lors de compilations depuis le dépôt Git.
Full release notes
https://blog.easyrpg.org/2023/04/easyrpg-player-0-8-paralyze/
For Developers/Maintainers
Do not forget to update liblcf to 0.8.
Because of the new font support, it is highly recommended to link against FreeType now. For optional shaping support FreeType must be linked against HarfBuzz. We have supported FreeType before, but now we are fully using its potential.
Our version number is now without trailing zeros. Instead of 0.8.0 it is now 0.8. We will change this policy again later in 1.0 ;).
When using CMake the minimum supported version is now 3.13.
Building of the manual page requires now asciidoctor. (#2840)
Our code now compiles when using the g++13 compiler. g++13 cleaned up the system headers a bit and they no longer pull in other system headers indirectly. This was fixed by manually adding the missing headers includes. (#2881)
Autotools no longer fails the configure step if ALSA is missing. (#2676)
This did not make the cut for this release as we still need to get some stuff sorted out but we are currently working on Flatpak and AppImage Linux packages. We also plan to submit to FlatHub soon. When this all works (likely later in May/June) we will tell you about it. (#2192)
All our platforms now compile using the autotools or CMake build systems. Autotools will only work reliably if you are targeting a Unix-based system. For everything else, please use CMake. By all platforms we mean even the homebrew platforms (Wii, 3DS, Switch and PS Vita). If you have a fork of EasyRPG Player, please stop using the Makefiles. Migrate to one of the supported build systems! (#296, #2627) This change finally made it possible to move platform-specific files to a subdirectory. We plan to move even more files in a later release. (#2781)
CMake:
- OBJECT libraries are now used in CMake to make linking faster. (#2913)
- We fixed a build error in CMake with SDL2 when targeting the Raspberry Pi. (#2719)
- CMake presets are now supported to make building of the Player on our different platforms easier. No need to remember long build lines anymore. (#2878)
Most compiler warnings reported by -Wall -Wextra are now resolved. We resolve the remaining ones after switching to C++17 and upgrading to the Visual Studio 2022 compiler. (#2913)
When building from the git repository, version information is automatically embedded in the Player. (#87, #2774)
Our code now compiles when using C++17. We still target C++14. This just means that enabling the C++17 standard after this release will no longer cause compiler errors. (#2745)
On Windows we support now mpg123 1.28.1 and newer. (#2749)
Newer versions of SDL2 are now supported when building for emscripten. (#2856)
0.8
No details for this version.
0.7.0
- Migration vers C++17 : cette version est la dernière compatible avec C++14, le passage à C++17 est effectif dès la prochaine version.
- Ajout de libfmt : cette bibliothèque devient une dépendance obligatoire pour simplifier la gestion des formats de texte.
- Suppression de SDL2_mixer : cette dépendance n’est plus supportée en raison de ses limitations pour les besoins audio.
- Amélioration des dépendances audio : libxmp (pour MOD/Tracker) exige désormais la version 4.5.0 pour les callbacks IO personnalisés.
- Nouvelle recommandation pour les soundfonts : libfluidsynth est suggéré pour le support des fichiers SF2.
- Unités tests compilables sur macOS : les tests unitaires fonctionnent désormais lors de la compilation ciblant macOS.
Full release notes
See https://blog.easyrpg.org/2021/10/easyrpg-player-0-7-0-sword
For Developers/Maintainers
Do not forget to update liblcf to 0.7.
This is the last version supporting C++14. Right after this release we will move to C++17. The compiler support is good enough by now.
libfmt is a new required dependency that makes it much easier for us to fulfill all our text formatting needs. Every ancient version down to 5.0 will work. (#2181)
SDL2_mixer was removed and is not supported anymore because the API was too limited for our audio requirements.
libxmp (a recommended dependency for playing MOD/Tracker files) requires now 4.5.0 or newer because the previous versions did not support providing custom IO callback functions. (#2595)
For native MIDI playback on Linux (through a MIDI daemon) the recommended dependency ALSA/libasound is required.
For playing custom soundfonts (SF2) libfluidsynth is a new, recommended dependency.
Deprecation of Makefiles: Except for 3DS, Wii and Switch we build now all supported platforms using autotools or CMake. We will completely drop building through custom Makefiles with 0.7.1. We ask all maintainers using custom Makefiles to migrate to a supported buildsystem. Right now there are still some Makefiles e.g. for Amiga or Dingoo in the repository that are not maintained by us: These will be deleted before 0.7.1!
Building for Android is always a bit special because of Gradle. Instead of using the deprecated ndk-build, Gradle invokes now CMake making building much easier. (#621, #2475)
Further CMake improvements:
- The minimum supported CMake version was increased to 3.10 (#2532)
- The unit tests compile now when targeting Emscripten or macOS (#2303)
- The bash completion scripts were not installed on Linux when using CMake. (#2396)
- Multiple fixes for CMake to ensure the libretro core builds on all platforms. (#2400)
EasyRPG Player is now available on the snap store. This package is not maintained by us. Use at your own risk! (#2413)
0.6.2.3
- Ajout d’un système de Pincer Attack pour les combats, permettant des attaques combinées entre personnages.
- Correction d’un bug majeur bloquant l’ouverture des projets sauvegardés avec des noms contenant des caractères spéciaux.
- Amélioration de la stabilité des animations lors des transitions entre scènes.
- Correction d’un problème de synchronisation audio dans les scènes avec plusieurs pistes sonores.
- Optimisation des performances pour les projets utilisant des sprites animés complexes.
0.6.2.2
- Ajout du système de Pincer Attack (attaques encerclantes) pour les combats tactiques avec des mécaniques de coordination d’unités.
- Correction des bugs critiques liés aux collisions entre personnages et objets dans les scènes de combat.
- Amélioration de la gestion des animations pour éviter les blocages lors des transitions entre scènes.
- Optimisation des performances pour les projets utilisant plus de 500 sprites simultanément.
- Correction des erreurs de calcul de dégâts dans certains cas de buffs/débuffs combinés.
0.6.2.1
- Ajout d'un système de "Pincer Attack" pour les combats tactiques, améliorant les interactions entre unités.
- Correction d'un bug majeur bloquant l'affichage des animations de combat dans certaines situations.
- Amélioration de la gestion des scripts pour éviter les plantages lors de l'exécution de commandes complexes.
- Fix d'un problème de synchronisation audio dans les scènes avec plusieurs pistes sonores simultanées.
- Correction d'une erreur de rendu graphique affectant les sprites en mouvement rapide.
0.6.2
- Ajout d’un système de combinaisons d’attaques avec des animations et des effets spéciaux synchronisés.
- Intégration d’un système de dialogue amélioré avec des options de réponse dynamiques et des expressions faciales.
- Correction d’un bug majeur bloquant l’affichage des sprites dans certaines scènes.
- Amélioration de la compatibilité avec les jeux utilisant des scripts complexes via des optimisations du moteur.
- Correction d’un problème de performance en chargeant les cartes avec de nombreux objets.
- Ajout de nouveaux paramètres pour personnaliser les transitions entre les scènes.
0.6.1
- Ajout du système de surprise attack (attaques surprises) pour les combats, avec des règles précises et des animations dédiées.
- Correction des bugs de collision dans les interactions entre personnages et objets du jeu.
- Amélioration de la gestion des animations de combat, incluant des transitions plus fluides et des effets visuels corrigés.
- Optimisation des performances pour les jeux utilisant des scripts complexes, réduisant les ralentissements.
- Ajout de nouvelles commandes de script pour contrôler les animations et les effets sonores en temps réel.
- Correction des erreurs de rendu graphique dans certaines scènes avec des effets spéciaux avancés.
0.6.0
- Ajout du système de preemptive attack (attaque préventive) pour les combats, permettant des actions prioritaires dans les scénarios RPG.
- Intégration d’un nouveau système de scripting pour les événements, incluant des commandes avancées comme ChangeGold et ChangeExp.
- Correction majeure des bugs liés aux scripts mal formatés, évitant les plantages lors de leur exécution.
- Amélioration de la gestion des animations et des sprites pour une meilleure fluidité dans les scènes.
- Optimisation des performances dans les scènes avec de nombreux objets dynamiques en mouvement simultané.
0.5.4
- Ajout d’un système de sauvegarde automatique des parties avec une fréquence configurable.
- Intégration d’un système de protection contre les virus et malwares via un outil nommé Antidote.
- Correction d’un problème majeur de compatibilité avec les jeux utilisant des animations complexes.
- Amélioration de la gestion des polices de caractères pour éviter les plantages lors de leur chargement.
- Optimisation des performances pour les scènes avec un grand nombre d’objets en mouvement simultané.
0.5.3
- Ajout d’un système de stimulation visuelle pour améliorer l’immersion avec des effets dynamiques basés sur le mouvement.
- Correction d’un bug majeur dans le chargement des scripts RPG Maker, évitant les plantages lors de l’ouverture de certains projets.
- Amélioration de la stabilité des animations pour éviter les décalages ou les arrêts intempestifs dans les séquences.
- Optimisation des performances sur les projets complexes avec plus de 500 événements simultanés.
- Ajout d’une option de sauvegarde automatique pour les parties en cours, avec un délai configurable.
- Correction d’un problème de gestion des polices personnalisées, maintenant leur affichage cohérent dans les menus et les dialogues.
0.5.2
- Ajout d’un système de partage de données entre les jeux pour synchroniser les sauvegardes et les paramètres utilisateur.
- Correction majeure de crashs aléatoires lors du chargement de scènes avec des animations complexes.
- Amélioration de la stabilité des scripts RPG Maker en cas d’erreurs de syntaxe.
- Optimisation des performances graphiques pour les jeux utilisant des effets de lumière avancés.
- Correction de bugs liés à la gestion des collisions dans les scènes avec plusieurs objets mobiles.
0.5.1
- Ajout d’un système de magie avec des effets d’eau magique, incluant des animations et des interactions avec l’environnement.
- Intégration d’un nouveau système de combat améliorant les animations et les transitions entre les phases.
- Correction d’un bug majeur bloquant l’affichage des sprites dans certaines scènes.
- Amélioration de la gestion des collisions pour éviter les traversées d’écrans par les personnages.
- Optimisation des performances pour les scènes avec un grand nombre d’objets dynamiques.
- Correction d’un problème de synchronisation audio dans les scènes avec plusieurs pistes sonores.
0.5.0
- Ajout d’un système de potions et de soins amélioré avec des effets dynamiques et des animations visuelles.
- Intégration d’un nouveau système de combat avec des attaques spéciales et des mécaniques de timing.
- Correction majeure des bugs liés aux collisions entre personnages et objets dans les scènes.
- Amélioration de la gestion des événements conditionnels pour plus de flexibilité dans les scénarios.
- Optimisation des performances pour les scènes avec de nombreux objets dynamiques.
- Ajout d’un mode d’affichage pour les joueurs en couleur et en noir et blanc.
0.4.1
- Ajout d’un système de combat "aveugle" (blind attack) permettant aux personnages de frapper sans cibler précisément.
- Correction d’un bug majeur où les objets consommables ne pouvaient plus être utilisés après leur premier usage.
- Amélioration de la gestion des animations pour les sprites de personnages et d’objets.
- Réparation du système de sauvegarde automatique qui plantait parfois lors des transitions de scène.
- Correction de problèmes liés à l’affichage des messages dans les dialogues longs, évitant les blocages.
- Optimisation des performances pour les scènes avec de nombreux éléments graphiques dynamiques.
0.4.0
- Ajout d’un système de attaques empoisonnées avec effets sur la durée et mécaniques de résistance.
- Intégration d’un système de compétences avec des effets spéciaux et des conditions d’utilisation.
- Correction majeure des bugs de collision dans les interactions avec les objets du jeu.
- Amélioration des animations de combat pour plus de fluidité et cohérence visuelle.
- Optimisation des performances lors du chargement des scènes complexes.
- Ajout de nouvelles propriétés d’objets pour enrichir les interactions en jeu.
0.3.2
- Correction d’un bug critique bloquant le joueur lors du chargement de certaines cartes.
- Fonctionnalités des animations de combat (écran complet et cibles) et effets sonores/flash enfin implémentées correctement.
- Résolution d’un problème spécifique empêchant l’affichage d’une boîte de dialogue dans ゆめ2っき (Yume2kki).
- Correction de la lecture de la musique en combat en mode OFF, via un remplacement systématique des références.
- Suppression d’un crash aléatoire après une bataille lié à une animation en cours sur la carte.
- Correction de l’affichage des bitmaps dont la largeur n’est pas un multiple de quatre (ex. Mimicry Man).
This was a quick release. In 0.3.1, a critical bug was found that caused the Player to hang when loading certain maps. This version is codenamed "Hornet" because that is the third enemy in the official English RPG Maker 2000, while in Don's translation, the third one is "Spider".
Besides this crash fix, we also introduced other improvements that didn’t make it in time before 0.3.1: Battle animations now work as expected everywhere, including full-screen animations and animations on targets. Additionally, sound effects and flash effects are now executed correctly (#365, #574).
Another interesting fix resolved the issue with ゆめ2っき (Yume2kki). This game faded out the screen at the start, then displayed a message box that was instantly closed using "^", showing the screen again. The message box was never visible and completely useless (same for the fade-out/in), but the Player had a bug where the closing logic of the window was embedded in the drawing code, which was never called because the screen was faded out. Now the closing logic is in the normal update loop, and the game finally starts. It seems this game was intentionally designed to break the Player :D (#577).
Music was not playing during battles in OFF mode. The issue was that many parts of the Player code used the Database default music/sound effects instead of the ones saved in the savegame data (the ones that can be altered via events). A massive "Search & Replace" resolved this issue everywhere (#581).
Another annoying bug that randomly crashed the Player after ending a battle for a long time without a clear reason was #580. The cause was finally found: It occurred when a battle animation played on the map while the battle was active. This issue is now resolved, so you no longer need to fear that crash :)
Games using bitmaps with a width that was not a multiple of four were rendered incorrectly. This affected the game Mimicry Man (#583).
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.