Rpg Maker Developers Group

---

Introduction

This post collects two addon scripts for WoodPenguin's Simple Map Display system. Each addon is independent and can be installed on its own. They share the same base requirement of WoodPenguin's Simple Map Display script, and each has its own additional requirements described in the relevant section below.

AI Disclaimer: Generative AI was used to refine the documentation and presentation of these scripts, as I am not a native English speaker. Additionally, AI was used for naming conventions in some places and for general beautification of the scripts.

mkxp-z Disclaimer: Simple Map Display × Input Toggle supports mkxp-z-exclusive input features including controller button input, SDL scancode key bindings, and VK integer key bindings. These features will not work on standard RPG Maker VX Ace without mkxp-z. Standard RGSS3 symbol bindings work on both. See the mkxp-z section below for more information.

---

Addon Overview

• Simple Map Display × Performance Enhancements - Rotation matrix pre-computation to reduce redundant trigonometric calculations for the Type 3 minimap
• Simple Map Display × Input Toggle - Keyboard and controller toggle to cycle through map display modes without requiring an event

---

mkxp-z

mkxp-z is an open-source, cross-platform player for RPG Maker XP, VX, and VX Ace games. It is a heavily modified fork of mkxp originally built to run games based on Pokémon Essentials, which depends heavily on Windows APIs. It is best described as MKXP but supercharged - capable of running all but the most demanding RGSS projects with a bit of porting work.

mkxp-z supports Windows, Linux (x86, ARM, and POWER), and both Intel and Apple Silicon versions of macOS. Because it ships with Ruby 3.1 rather than the original Ruby 1.9.2 bundled with RPG Maker VX Ace, scripts written for mkxp-z can take advantage of modern Ruby syntax and standard library features.

Controller button input and SDL scancode or VK integer key bindings in Simple Map Display × Input Toggle require mkxp-z and will not work on default RPG Maker VX Ace.

---

▼ Simple Map Display × Performance Enhancements

Introduction

This performance optimization addon enhances WoodPenguin's Simple Map Display script with a pre-computation strategy for marker rotation in RPG Maker VX Ace. It reduces redundant trigonometric calculations when the map rotation flag is active during vehicle travel.

The optimizations include rotation matrix pre-computation for the Type 3 circular minimap, sin and cos calculated once per frame and shared across all visible markers, and an identical visual result to the original implementation at significantly reduced per-frame cost.

Requirements

• WoodPenguin - Simple Map Display

Features

Performance Enhancement Features

• Rotation matrix pre-computation for Type 3 marker rotation
• sin/cos calculated once per update instead of once per visible marker
• Identical visual result to the original Simple Map Display implementation

Installation

• Place this script BELOW Simple Map Display
• If using Vehicle Pseudo-3D Database, place this script BELOW it
• If using Vehicle Pseudo-3D Main Script, place this script BELOW it

Credits

• WoodPenguin's Simple Map Display system

Download

Download from GitHub

---

▼ Simple Map Display × Input Toggle

Introduction

This input addon enhances WoodPenguin's Simple Map Display script with direct player input handling for RPG Maker VX Ace. It allows the player to cycle through a configurable sequence of map display modes via keyboard or controller without requiring an event or variable change through the event system.

The system supports a configurable cycle order and mode selection, keyboard input via Input.trigger? on vanilla VX Ace and Input.triggerex? on mkxp-z, raw SDL scancode and Windows Virtual-Key support for unmapped keys, and an optional controller button mapping via Input::Controller.triggerex?.

Requirements:

• WoodPenguin - Simple Map Display

Optional Compatibility

• Hammy - MKXP-Z Input Constants (place this script BELOW it when used)

Features

Input Toggle Features

• Configurable map display cycle order via TOGGLE_CYCLE
• Keyboard toggle support through RGSS3 and mkxp-z input routing
• Explicit RGSS and SDL routing via tagged key arrays
• Optional Windows Virtual-Key integer support on mkxp-z
• Optional controller button toggle support on mkxp-z

Configuration

Edit the constants in the Hammy::SimpleMapInput module to configure the cycle order, keyboard key, and controller button.

Input Toggle Settings
TOGGLE_CYCLE
Array of mode values to cycle through in order.

Include 0 to pass through the hidden state as part of the cycle. Remove 0 to keep the map visible and only cycle between modes. Set to [] to disable the toggle entirely.

- Valid values: Array of integers corresponding to WdTk::SimpMap keys
- Default: [0, 1, 2, 3]

Example

TOGGLE_KEY
Keyboard key used as the map display toggle trigger.

Bare RGSS3 symbols are routed through Input.trigger?. Tagged arrays can force routing with [:rgss, :SYM] or [:sdl, :SYM]. SDL routing and bare VK integers are mkxp-z only and use Input.triggerex?.

- Valid values: RGSS symbol, tagged array, or VK integer
- Default: :CTRL

Example

TOGGLE_BUTTON
Controller button used as map display toggle trigger.

Only needed when TOGGLE_KEY has no default controller binding, such as an SDL-only key or a raw VK integer. Set to nil to disable the separate controller trigger.

- Valid values: Any controller button symbol, or nil
- Default: :BACK

Example

Installation

• Place this script BELOW Simple Map Display
• If using Hammy - MKXP-Z Input Constants, place this script BELOW it

Credits

• WoodPenguin's Simple Map Display system

Download

Download from GitHub

---

Compatibility

All scripts in this collection are made strictly for RPG Maker VX Ace. It is highly unlikely that they will run with RPG Maker VX without adjusting. Controller button input and SDL scancode or VK integer key bindings in Simple Map Display × Input Toggle additionally require mkxp-z and will not work on default RPG Maker VX Ace without it.

---

License

MIT License - Free for commercial and non-commercial use.

---

Why VX Ace?

You might wonder why I'm still making scripts for VX Ace instead of MV/MZ. The answer is simple: Ruby is pure beauty, while JavaScript is a terrible language. Ruby's elegant syntax, intuitive design, and expressive power make scripting a joy. JavaScript, on the other hand, is a chaotic mess of inconsistencies and quirks that I simply despise.

I work with RPG Maker VX Ace for my own game project, and I share the scripts I create with the community. If you're still using VX Ace, you're in good company!

---

Download

Demo: Download from GitHub

---