I have designed this to be generic so it applies to the most common tools (like Tiled, various Resource Managers, or dedicated viewer scripts).
This solution requires Python 3 and the Pillow (PIL) library.
To install the dependency: pip install pillow
Save the following code as rpg_inspector.py:
import tkinter as tk
from tkinter import filedialog, ttk, messagebox
from PIL import Image, ImageTk, ImageDraw
import json
import os
class RPGAssetInspector:
def __init__(self, root):
self.root = root
self.root.title("RPG Maker Asset Inspector v1.0")
self.root.geometry("900x700")
# Variables
self.current_image_path = None
self.original_image = None
self.zoom_level = 1.0
self.show_grid = tk.BooleanVar(value=True)
# RPG Maker Standard Grid Sizes (for reference)
self.grid_modes =
"MV/MZ Character (48x48)": (48, 48),
"MV/MZ Tileset (48x48)": (48, 48),
"VX Ace Character (32x32)": (32, 32),
"Custom": None
self.setup_ui()
def setup_ui(self):
# Main Container
main_frame = ttk.Frame(self.root, padding="5")
main_frame.pack(fill=tk.BOTH, expand=True)
# Control Panel (Top)
control_frame = ttk.Frame(main_frame)
control_frame.pack(fill=tk.X, pady=(0, 5))
ttk.Button(control_frame, text="Open PNG", command=self.load_file).pack(side=tk.LEFT, padx=5)
ttk.Label(control_frame, text="Grid Mode:").pack(side=tk.LEFT, padx=(10, 2))
self.grid_combo = ttk.Combobox(control_frame, values=list(self.grid_modes.keys()), state="readonly", width=20)
self.grid_combo.set("MV/MZ Character (48x48)")
self.grid_combo.bind("<<ComboboxSelected>>", self.update_view)
self.grid_combo.pack(side=tk.LEFT)
ttk.Checkbutton(control_frame, text="Show Grid", variable=self.show_grid, command=self.update_view).pack(side=tk.LEFT, padx=10)
ttk.Button(control_frame, text="Zoom In", command=lambda: self.zoom(1.2)).pack(side=tk.RIGHT, padx=2)
ttk.Button(control_frame, text="Zoom Out", command=lambda: self.zoom(0.8)).pack(side=tk.RIGHT, padx=2)
# Info Panel (Bottom)
self.info_var = tk.StringVar(value="No file loaded.")
info_label = ttk.Label(main_frame, textvariable=self.info_var, relief=tk.SUNKEN, anchor=tk.W)
info_label.pack(fill=tk.X, pady=(5, 0), side=tk.BOTTOM)
# Canvas Area (Center)
canvas_frame = ttk.Frame(main_frame, relief=tk.SUNKEN, borderwidth=1)
canvas_frame.pack(fill=tk.BOTH, expand=True)
# Scrollbars
h_scroll = ttk.Scrollbar(canvas_frame, orient=tk.HORIZONTAL)
h_scroll.pack(side=tk.BOTTOM, fill=tk.X)
v_scroll = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL)
v_scroll.pack(side=tk.RIGHT, fill=tk.Y)
self.canvas = tk.Canvas(canvas_frame, bg='#2b2b2b', xscrollcommand=h_scroll.set, yscrollcommand=v_scroll.set)
self.canvas.pack(fill=tk.BOTH, expand=True)
h_scroll.config(command=self.canvas.xview)
v_scroll.config(command=self.canvas.yview)
def load_file(self):
file_path = filedialog.askopenfilename(filetypes=[("PNG Files", "*.png"), ("All Files", "*.*")])
if not file_path:
return
try:
self.current_image_path = file_path
# Load image ensuring RGBA mode for transparency
self.original_image = Image.open(file_path).convert("RGBA")
self.zoom_level = 1.0
self.update_view()
self.analyze_metadata(file_path)
except Exception as e:
messagebox.showerror("Error", f"Failed to load image:\ne")
def analyze_metadata(self, path):
"""Scans for associated JSON or calculates grid dimensions"""
filename = os.path.basename(path)
w, h = self.original_image.size
# Check for JSON file (RPG Maker MV/MZ style)
json_path = os.path.splitext(path)[0] + ".json"
json_data = "None"
if os.path.exists(json_path):
try:
with open(json_path, 'r') as f:
data = json.load(f)
# Specific logic for Tilesets
if "tilewidth" in data:
json_data = f"JSON Found: data.get('tilewidth')xdata.get('tileheight')"
except:
json_data = "JSON Found (Parse Error)"
# Calculate suggested sprite dimensions
# Standard characters are 4 columns x 2 rows (spritesheet) or 3 columns x 4 rows (animation)
cols, rows = 4, 2 # Default assumption for character sheets
cell_w = w // cols
cell_h = h // rows
self.info_var.set(f"File: filename | Size: wxhpx | Detected Cell: cell_wxcell_hpx | Meta: json_data")
def zoom(self, factor):
self.zoom_level *= factor
self.update_view()
def update_view(self, event=None):
if not self.original_image:
return
# 1. Resize Image
w = int(self.original_image.width * self.zoom_level)
h = int(self.original_image.height * self.zoom_level)
resized_img = self.original_image.resize((w, h), Image.NEAREST) # Pixel art needs NEAREST
# 2. Draw Grid (if enabled)
if self.show_grid.get():
selected_mode = self.grid_combo.get()
grid_w, grid_h = self.grid_modes[selected_mode]
# Handle Custom Logic here if implemented
draw = ImageDraw.Draw(resized_img)
# Calculate scaled grid size
scaled_gw = int(grid_w * self.zoom_level)
scaled_gh = int(grid_h * self.zoom_level)
# Draw vertical lines
for x in range(0, w, scaled_gw):
draw.line([(x, 0), (x, h)], fill="red", width=1)
# Draw horizontal lines
for y in range(0, h, scaled_gh):
draw.line([(0, y), (w, y)], fill="red", width=1)
# 3. Convert to Tkinter format
self.tk_image = ImageTk.PhotoImage(resized_img)
# Update Canvas
self.canvas.delete("all")
self.canvas.create_image(0, 0, anchor=tk.NW, image=self.tk_image)
self.canvas.config(scrollregion=self.canvas.bbox(tk.ALL))
if __name__ == "__main__":
root = tk.Tk()
app = RPGAssetInspector(root)
root.mainloop()
1. "The application failed to start because side-by-side configuration is incorrect."
2. Black backgrounds on sprites.
3. Plugin doesn't show up in the list.
sat hunched over his keyboard, the blue light of the monitor reflecting in his glasses. It was 2:00 AM, and his dream project—a sprawling fantasy epic—was stalled. He had dozens of custom character sprites, meticulously drawn in pixel art, but they were trapped in a folder, invisible to his game. Every time he tried to import them into , the preview window was a blank void.
He needed a way to see his progress without launching the entire engine. He searched for an "RPG Maker PNG Viewer," a lightweight tool to bridge the gap between his art software and the game world. He found a community-made plugin on a dusty forum, downloaded the zip file, and began the installation.
First, he navigated to his project’s root directory. Following the instructions, he opened the Resource Manager
(Tools > Resource Manager) to ensure his file paths were correct. He dragged the new "Viewer.js" script into the js/plugins folder of his RPG Maker MV directory.
With a click of the "Plugin Manager" button, he set the status to "ON." He took a deep breath and hit the test key. Suddenly, a new window popped up. There they were—his heroes, walking in place, their capes fluttering in the simulated wind. No more guessing. No more broken imports. Leo smiled, cracked his knuckles, and got back to building his world. 🛠️ Quick Installation Guide
If you are looking to manage or view PNGs in RPG Maker, here is the standard process: Standard Import Resource Manager
(Folder icon in the top bar) to bring in character sheets or tilesets. Manual Folder Game > Open Folder and drop your images directly into img/pictures img/characters Runtime Packages : Ensure you have the RTP (Runtime Package)
installed so the engine can actually render standard assets. Plugin Setup : For custom viewers, place the file in your js/plugins folder and activate it via the Plugin Manager inside the editor.
If you'd like to get this working for your specific project, let me know: of RPG Maker are you using? (MV, MZ, VX Ace?) standalone tool for your desktop? Are your PNGs appearing as broken icons or just not showing up at all? rpg maker png viewer install
How to Install and Use an RPG Maker PNG Viewer RPG Maker engines, including MV and MZ, primarily use PNG as the standard format for all visual assets. While the engine has a built-in Resource Manager for basic viewing, many developers use external "PNG Viewers" or decryption tools to manage assets, especially when dealing with encrypted game files like .rpgmvp or .png_. 1. Using the Built-in Resource Manager
Before installing third-party software, you can use the built-in tool to view your project's PNG files.
Open the Resource Manager: Click the folder-shaped icon on the top toolbar or go to Tools > Resource Manager.
Select a Category: Choose a folder (e.g., characters, faces, tilesets) on the left.
Preview: Click on an asset name and select Preview to see the image within the editor. 2. Installing a Third-Party PNG Viewer/Decrypter
If you need to view encrypted PNG files from a compiled game, tools like the RPG-Maker-MV & MZ Decrypter by Petschko are popular choices.
Download: Obtain the script or tool from a reputable source like GitHub or GitLab.
Extraction: Unzip the downloaded file to a location of your choice—no formal "installation" is usually required as these are often web-based or standalone scripts.
Execution: Open the index.html file in a modern browser (Chrome, Firefox, Edge, or Safari). View Files: Go to the Restore-Images (No-Key) tab. Select your encrypted .rpgmvp or .png_ files.
Click Restore Original Files to view or save them as standard PNGs. 3. Alternative Viewers and Editors
For standard project management and asset editing, many developers prefer dedicated graphic software over simple viewers: RPG-Maker-MV & MZ Decrypter by Petschko
To view or extract assets from RPG Maker projects, you generally need a tool that handles encrypted formats like .rpgmvp (MV) or .png_ (MZ), which are bitshifted versions of standard PNG files used to prevent spoilers. Popular RPG Maker PNG Viewers and Decrypters
Several tools allow you to view or convert these specialized image files:
Petschko's RPG-Maker-MV & MZ Decrypter: A highly popular web-based and local tool that can restore images from encrypted projects without needing a decryption key. I have designed this to be generic so
RPGMVP2PNG: A lightweight Python CLI and web tool specifically for batch-converting .rpgmvp files into standard PNGs.
RPGViewer: An utility app that provides a runtime environment for RPGMV projects, allowing users to experience and verify project results.
RM2K/3 PNG Fix Watcher: A specialized tool for older versions (2000/2003) that monitors and fixes PNG transparency issues in real-time. How to Install and Use a PNG Decrypter/Viewer
For most modern RPG Maker extraction tools, the "installation" is typically a simple extraction process. 1. Download and Extract
Navigate to a trusted source like Petschko’s GitHub or DrRyanHuang's RPGMVP2PNG.
Download the .zip or .jar file from the "Assets" or "Releases" section. Right-click the downloaded folder and select Extract All. 2. Running the Tool
For Web-Based Tools: Simply visit the site (e.g., Petschko's Decrypter) and upload your .rpgmvp or .png_ files directly to view them in the browser. For Desktop Tools:
Java-based (.jar): Ensure you have Java installed, then double-click the file to run it.
CLI (Python): If using rpgmvp2png.py, run the command python rpgmvp2png.py [input_directory] to batch-convert all images in a folder to viewable PNGs. 3. Identifying the Decryption Key (If Required)
While some tools can "Restore Original Files" without a key, others may need one for re-encryption or full extraction: [feature request] PNG_ viewer codec/plugin #1514 - GitHub
This report covers the installation and usage of PNG assets within the
ecosystem. It is important to note that RPG Maker is a game development engine that natively supports PNG files for graphics; therefore, a separate "PNG viewer" is typically not a standalone software you install, but rather a built-in function of the engine or a specific utility used to manage these assets. 1. RPG Maker Native PNG Support Most modern versions of the engine, including RPG Maker XP , , , and
, use the PNG format for virtually all visual elements, including sprites, tilesets, and UI components.
Importing PNGs: To "view" or use PNGs in your project, use the Resource Manager (usually accessed via F10 or the Tools menu). This allows you to import custom images into the correct project folders. This solution requires Python 3 and the Pillow
Transparency: RPG Maker relies on the alpha channel of PNG files to handle transparency. When importing, ensure your files are saved as 32-bit PNGs to preserve background transparency. 2. Essential Installation: The Runtime Package (RTP)
If you are unable to view or load standard graphics (PNGs) in an RPG Maker game or the editor, you likely need to install the Runtime Package (RTP). This contains the base PNG assets used by the engine. Installation Steps for RTP (e.g., ):
Download the RTP installer from the Official RPG Maker Website. Extract the RPGVXAce_RTP.zip file. Open the folder and run Setup.exe. Follow the prompts to complete the installation. 3. Specialized Utilities & Plugins
For advanced users looking for specific "viewer" or "cheat" functionality related to game assets:
Asset Viewers: Many developers use external image editors like GIMP or Aseprite to view and edit PNG tilesets.
Cheat Menus: Some third-party plugins, like the Cheat Menu Plugin for MV, allow users to view and interact with internal game variables and assets during playtest. Version Comparison for Graphics Scripting Language Primary Image Format RPG Maker XP Ruby (RGSS) RPG Maker VX Ace Ruby (RGSS3) RPG Maker MV JavaScript RPG Maker MZ JavaScript RPG Maker RTP Downloads | RPG Maker | Make A Game!
I'll help you create a text-based guide for installing a PNG viewer specifically for RPG Maker files. Since you didn't specify an operating system, I'll cover Windows (most common for RPG Maker) and mention alternatives.
Before diving into the installation, it is crucial to understand why you need a specialized viewer.
| Extension/Format | Game Maker Version | Description |
|-------------------|--------------------|-------------|
| .rgss2a | RPG Maker VX | Encrypted archive containing images, audio, and scripts. |
| .rgss3a | RPG Maker VX Ace | Stronger encryption than RGSS2. |
| .rpgmvp | RPG Maker MV | Encrypted PNG-like files. Not actual PNGs until decrypted. |
| .xyzzy (no ext) | Various | Raw image data with a custom header. |
A standard PNG viewer (like Windows Photos or Preview on macOS) will either show an error, a blank screen, or corrupted colors when trying to open these files. The RPG Maker PNG Viewer bridges this gap by:
| Issue | Solution | |-------|----------| | PNG won't open | File may be corrupted or encrypted | | Transparency looks wrong | Use Photoshop, GIMP, or IrfanView | | Batch viewing needed | XnView MP or FastStone Image Viewer |
Many RPG Maker users utilize the map editor Tiled as a robust PNG viewer for tilesets.
If you are extending this feature, here is how the logic works:
analyze_metadata function specifically looks for the .json file often found alongside MV/MZ tilesets. If present, it parses the JSON to confirm if the user has defined specific collision or animation settings (though currently, it just displays the parsed grid size).