Let RPG Maker MV/MZ Games are also available on Android with support In-app Purchase Tutorial

This tutorial article I will no longer continue to update or maintain it, and I am completely open-sourcing it, allowing anyone to modify, use, and republish it as they see fit. However, please do not ask me any further questions regarding this tutorial article. I have been providing these educational resources for free all along, yet no one has been willing to sponsor or support me.

This article was translated using "DeepL Translator".

The main purpose of this tutorial is that in August this year, Google announced that new apps will be uploaded in AAB format instead of the APK and OBB file formats that have been used in the past.

＊ For more details, please refer to this Google announcement:
https://android-developers.googleblog.com/2021/06/the-future-of-android-app-bundles-is.html

In short, this tutorial will teach you to export to AAB format to get you on the Google Play Store release App, as well as the implementation of In-App Purchases and Admob ads.

• 2022/02/28 Update
  Update plugin terms of use, and add information about "Supported Platforms"
  and optimize some code, etc.
• 2021/08/10 Update
  Fixed the problem that some Android devices could not run properly, and added Extra tutorials.

◆ Step 1

Go to the following link to download Android Studio.

→ https://developer.android.com/studio

After checking the box, click Download Android Studio to start downloading and installing Android Studio.

After installing and running Android Studio, expand the menu item in the upper right corner and select SDK Manager.

Select SDK Platforms to install the latest version of Android, here I checked Android 11.0®.

In SDK Tools, check all the necessary tools marked by the red checkboxes in the picture.
Press OK and it will download and install the checked packages.

◆ Step 2

Open the RPG Maker MV/MZ game project and click "File" → "Deployment…", select "Web Browsers / Android / iOS".
When using RPG Maker MV, select "Web Browsers" and then click "OK" to wait for the deployment to complete.

[RPG Maker MZ]

[RPG Maker MV]

Remember that folder names can only be alphanumeric and do not contain a half-line margin. If you need to use a half-line margin, please replace it with a ( _ ).

◆ Step 3

Download the required Android Studio project (MyApplication.7z) from the following GitLab link, and the sample project (ProjectIAP_MV or ProjectIAP_MZ) In-app purchase .
The NekoGakuen_AndroidPlus.js plugin is also included in the sample project.

→ https://gitlab.com/MiraiSoSad/android-studio-for-rpg-maker-mvmz/-/tree/en_US

Go back to Android Studio and click Open at the top.
Choose to extract the downloaded Android Studio project folder (MyApplication) and click OK, then open the project and wait for the progress bar in the lower right corner to finish the project sync.

◆ Step 4

Under File → Project Structure…, select SDK Location. Click Gradle Setting and select Download JDK… from the Gradle JDK menu.

After selecting the latest version in Version, click** Download**. Select Oracle OpenJDK in Vendor and click Download.

◆ Step 5

If you want to release on the Google Play Store, please select the IAP section, on the other hand, if you just want to play game on your Android phone, please select the Only section.

■ Only

Put your exported RPG Maker MV/MZ project in the MyApplication\Only\src\main\assets\www folder.

Under Only, mouse right-click res → values → strings.
After selecting Open Translations Editor,
you can change app_name in Default Value to set your APP game name and other string parameters.

Select Build → Build Bundie(s) / APK(s) → Build APK(s) output.

After the output is finished, in the folder MyApplication\Only\build\outputs\apk\debug, you can find three apk files, just install Only-universal-debug.apk to your Android phone and play game.

■ IAP

Put the RPG Maker MV/MZ project you just exported Put it in the MyApplication\RPGAssets\src\main\assets folder.

In File → Project Structure… in Modules, modify the three parameters of Default Config, which are Application ID, Version Code and Version Name respectively.

■ Change APP Icon

Mouse right-click mipmap and select Delete… to change the icon of the APP.

Mouse right-click on res and select New → Image Asset.

Set the APP icon in Source Asset and Scaling of Foreground Layer.

Set the background color of the APP icon in the Source Asset of Background Layer.

Mouse right-click on Strings under IAP and select Open Translations Editor to set some advanced parameters.

app_name sets the name of your app game.
license_key sets your app license key.

And license key section can be found in the bottom left of Google Play Console under Monetization setup.

The test_mode setting is for test mode, but remember to set this to false when you publish in the Google Play Store.

The remaining five items are for the AdMob ads units, which are currently filled in as test ads units by default.

If you use AdMob ads units, remember to change them to the AdMob ads units of your own account.

And the use of AdMob ads here I will not explain in particular.

Finally, under Build → Generate Signed Bundle / APK…, select Android App Bundle and click Next.
Select Android App Bundle and click Next, then create or use your signature key.
When finished, upload the exported AAB file to Play Store.
Of course, I won't explain the two parts of signing key and uploading to Play Store.

■ Extra

● How to make RPG Maker MV support touch UI?

Add that although RPG Maker MV itself does not have a built-in button UI features for cell phone touch, but you can use the official TouchUI.js plugin to solve the problem of cell phone operation game.

And the TouchUI.js plugin is placed in the folder of D:\Steam\steamapps\common\RPG Maker MV\dlc\KadokawaPlugins_New\js\plugins.

● How do change the Splash image? (ex: Made by MV image.)

In MyApplication\IAP\src\main\res\drawable, replace logo.png with the image file of your own Splash.

If it is Only, the path is MyApplication\Only\src\main\res\drawable.

● How do I change the orientation of my Android phone screen to Portrait?

This will show you how to modify the display direction of your phone in Android Studio project, while the resolution setting of RPG Maker MV/MZ should not need me to teach you specially.
First of all, make changes in the files manifests/AndroidManifest.xml and res/layout/activity_main.xml respectively.
In the AndroidManifest.xml file, change "sensorLandscape" to "sensorPortrait" in the 21st code.
In the activity_main.xml file, switch to Design and change the parameter of orientation to vertical in main.

● Why does my RPG Maker MZ game keep stopping on a black screen when I play it on my Android device?

You can try changing the syntax around line 2109 in js/rmmz_managers.js in the project folder.

SceneManager.isGameActive = function() {
    // [Note] We use "window.top" to support an iframe.
    try {
        return window.top.document.hasFocus();
    } catch (e) {
        // SecurityError
        return true;
    }
};

Modify to

 SceneManager.isGameActive = function () { return true; };

Mirai - Patreon：
https://www.patreon.com/MiraiDiary

Mirai - Twitter(X)：
https://twitter.com/Mirai_so_Sad

Mirai - itch.io：
https://miraisosad.itch.io

Mirai - Instagram
https://www.instagram.com/miraisosad/

tags: 貓咪學園 NekoGakuen RPG Maker RPG Maker MV RPG Maker MZ Android Studio