AG NOTIFICATION PLUGIN

AGNotification.js -- Local Push Notifications for RPG Maker MZ

Schedule notifications to the player's phone even after the game is closed. All notification types are controllable directly from the Event Editor. No server. No internet required.

Compatible with AG APK Builder (automatic permission injection during build) and also supports manual Android Studio integration via the AGBridge interface pattern. Full documentation included.

---

Demo vs Full Version

Feature	Demo	Full
Send Notification Now	✔	✔
Cancel Notification	✔	✔
Cancel All Notifications	✔	✔
Cancel All on Game Start	✔	✔
Debug Log & Alert	✔	✔
Send Delayed Notification	✘	✔
Schedule Daily Notification	✘	✔
Schedule Interval Notification	✘	✔
Request Notification Permission	✘	✔
Check Permission to Switch	✘	✔
Repeat Options (daily / weekly)	✘	✔
Debug Status Command	✘	✔
Auto Request Permission on Start	✘	✔

---

Available Versions

File Name	Version	Language	Plugin Name in Event Editor
AGNotification_Demo_EN.js	Demo	English	AGNotification_Demo_EN
AGNotification_Demo_ID.js	Demo	Indonesian	AGNotification_Demo_ID
AGNotification_Full_EN.js	Full	English	AGNotification_Full_EN
AGNotification_Full_ID.js	Full	Indonesian	AGNotification_Full_ID

Use only one version at a time. The plugin name in the Event Editor must match the file name exactly.

---

What Are Local Push Notifications?

Local notifications are messages that appear in the device status bar -- even after the game has been fully closed. This plugin schedules them directly from inside the game, with no internet or server needed.

Popular use cases in mobile games:

• "Your energy is full! Come back and play now."
• "Your daily login bonus is waiting!"
• "Your building is finished."
• "Limited event ends in 1 hour!"

---

Plugin Commands

Send Notification Now -- Demo & Full
Notification appears immediately when the command is called.
Parameters: ID (1-999), Title, Message

Cancel Notification -- Demo & Full
Cancel a specific notification by its ID.

Cancel All Notifications -- Demo & Full
Cancel all notifications scheduled from this game.

Send Delayed Notification -- Full only
Notification appears after a set delay from the current time.
Parameters: ID, Title, Message, Delay (seconds), Repeat
Example: 3600 = 1 hour, 86400 = 1 day

Schedule Daily Notification -- Full only
Fires every day at a specific hour and minute. Ideal for login bonuses and daily rewards.
Parameters: ID, Title, Message, Hour (0-23), Minute (0-59)

Schedule Interval Notification -- Full only
Repeats every X seconds. Ideal for stamina or energy refill reminders.
Parameters: ID, Title, Message, Interval (seconds)

Request Notification Permission -- Full only
Shows the permission dialog to the user (Android 13+). Call once at game start or during tutorial.
Result is stored to a Switch -- ON means permission granted.

Check Notification Permission to Switch -- Full only
Check whether notification permission has been granted. Switch ON = granted, OFF = denied or not yet asked.

---

Features

• Auto Permission Injection -- Using AG APK Builder: required Android permissions are added automatically during build. No need to edit AndroidManifest manually.
• Android Studio Support -- Can also be integrated manually via the AGBridge pattern. Full Kotlin implementation docs included in the download package.
• Plugin Command Support -- All notification actions controlled from RPG Maker MZ Event Editor without any script calls.
• Survives Device Restart -- Scheduled notifications remain active after the phone is restarted (RECEIVE_BOOT_COMPLETED). Full version only.
• PC and Browser Safe -- All notification calls are silently ignored outside an Android APK. No errors in editor or browser preview.
• Switch Callbacks -- Permission check and request results feed directly into RPG Maker Switches. Full version only.
• Debug Overlay -- Optional on-screen status display during development. Disable before release.

---

Setup -- AG APK Builder

1. Place the plugin file into your game's js/plugins/ folder.
2. Enable it in RPG Maker MZ Plugin Manager.
3. In AG APK Builder, go to the Notif Plugin tab, enable the AGNotification toggle, then click Save Configuration.
4. Build APK as usual. Check the build log for [AGNotification] ENABLED.
5. The plugin name in the Event Editor must match the file name exactly -- see the Available Versions table above.

Setup -- Android Studio (Manual)

1. Add POST_NOTIFICATIONS, RECEIVE_BOOT_COMPLETED, and SCHEDULE_EXACT_ALARM permissions to AndroidManifest.xml.
2. Create AGBridge.kt and register it to WebView via addJavascriptInterface(agBridge, "AGBridge").
3. Implement notification methods with the @JavascriptInterface annotation.

Full Android Studio integration docs with complete Kotlin source code are included in the download package.

---

Quick Code Reference

Send Now (Demo & Full)

Plugin Command: AGNotification_Demo_EN > Send Notification Now
  ID = 1
  Title = "Welcome back!"
  Message = "Your adventure continues here."

Daily login bonus reminder (Full only)

-- In the event when the player presses Exit:
Plugin Command: AGNotification_Full_EN > Cancel All Notifications
Plugin Command: AGNotification_Full_EN > Schedule Daily Notification
  ID = 1, Title = "Login Bonus!", Message = "Claim your daily reward now"
  Hour = 9, Minute = 0

Energy full notification (Full only)

-- When player energy runs out:
Plugin Command: AGNotification_Full_EN > Send Delayed Notification
  ID = 10, Title = "Energy Full!"
  Message = "Your energy has refilled. Let's keep playing!"
  Delay (seconds) = 10800, Repeat = None
-- When energy is manually refilled:
Plugin Command: AGNotification_Full_EN > Cancel Notification
  ID = 10

Request permission at game start (Full only, once only)

-- Autorun on title screen:
Conditional Branch: Switch 99 = OFF
  Plugin Command: AGNotification_Full_EN > Request Notification Permission
    Result Switch = Switch 100
  Wait: 30 frames
  Control Switches: Switch 99 = ON

---

Tips & Best Practices

• Always cancel notifications when the game is opened to avoid stacking
• Use unique IDs per notification type -- e.g. 1 for login bonus, 10 for energy, 20 for events
• Don't send notifications too frequently -- users may revoke permission
• Best times to notify: morning 08-09 and afternoon 17-18
• Keep notification text short, clear, and enticing
• Turn off Debug Alert before publishing to the Play Store

---

Required Android Permissions

Permissions are added automatically by AG APK Builder during build:

• POST_NOTIFICATIONS -- Required for Android 13 and above (Demo & Full)
• RECEIVE_BOOT_COMPLETED -- Keeps scheduled notifications active after device restart (Full only)
• SCHEDULE_EXACT_ALARM -- Ensures notifications fire at the exact scheduled time (Full only)

---

Compatibility

• Engine: RPG Maker MZ/ MV (Soon)
• Builder: AG APK Builder v1.2+ (recommended) or Android Studio manual integration
• Platform: Android only, APK and AAB
• Android: Minimum Android 8.0, full support Android 13+

---

Troubleshooting

Notifications not appearing:

• Check that the user has granted notification permission
• Check device settings -- make sure notifications are not disabled for the app
• Check build log: must contain [AGNotification] ENABLED
• Make sure the AGNotification toggle is active in AG APK Builder before building
• Notifications only work in Android APK -- not on PC or browser preview

Plugin Command not listed in Event Editor:

• The plugin name MUST match the file name exactly -- see the Available Versions table above
• Make sure the plugin is enabled in Plugin Manager

---

Terms of Use

• Free to use in personal and commercial RPG Maker MZ projects
• Allowed to use in games distributed on Google Play Store
• Do not redistribute or reupload the plugin file
• Do not remove the author signature inside the plugin
• Do not claim as your own or sell the plugin itself

---

Feedback, Bug Reports and Support

If you experience issues, encounter bugs, or have suggestions, leave a comment on this page or contact directly.

Contact: anaryxproject@gmail.com

---

AGNotification.js -- part of the Anaryx Plugin ecosystem.
Built for RPG Maker MZ developers targeting Android via AG APK Builder or Android Studio.
Every plugin carries an integrity signature -- do not remove or alter it.
anaryx-plugin.itch.io