public

Rpg Maker Developers Group

Simple enough for a child, powerful enough for a developer

2 Followers
Log in to follow

VXACEVXAce Hammy - Window Headers

BMM Archive · July 15, 2026

BMM_Archive
LEVEL 14 Crown 47,300
Preserved forum archive. This topic stores the original first post and locally mirrored RPG Maker Web attachments when available. It is posted by the BMMPlay archive account, not by the original creator.

Original Source

  • Original title: VXAce Hammy - Window Headers
  • Original author: buddysievers
  • Original date: October 24, 2025
  • Source thread: https://forums.rpgmakerweb.com/threads/hammy-window-headers.180682/
  • Source forum path: Game Development Engines > Ruby Game System (RGSS) Scripts > RGSS3 Scripts (RMVX Ace)

Summary

Hammy - Window Headers v1.02 Add labels to your game's windows with customizable headers​ Introduction This script provides a customizable header system for all windows in RPG Maker VX Ace. It automatically adds headers above windows to display titles, labels, or decorative graphics that enhance your game's user interface.

Archived First Post

Hammy - Window Headers v1.02
Add labels to your game's windows with customizable headers​


Introduction

This script provides a customizable header system for all windows in RPG Maker VX Ace. It automatically adds headers above windows to display titles, labels, or decorative graphics that enhance your game's user interface.

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


Features

Core Header Features
  • Automatic header creation for configured windows
  • Text and image header support with dual content types
  • Per-window-class header configuration with custom settings

Customization System
  • Configurable text styling (font, size, color, outline, shadow)
  • Configurable header positioning (horizontal and vertical offsets)
  • Support for custom header graphics from Graphics/System/Headers folder

Technical Features
  • Automatic header property updates (position, visibility, and z-index)
  • Guard mechanism to prevent multiple header creation in inherited classes
  • Viewport compatibility for all scene types and window configurations


Screenshots

1OJfp36.png



Configuration

Edit the constants in the Hammy::WindowHeaders module to configure the header positioning offsets, text header settings, and individual window headers.

Header Positioning Offsets
Configure the positioning offset for header sprites relative to their parent window. These values control where headers appear in relation to the window borders.

HEADER_OFFSETS
Hash containing offset settings for window types.

- :default: Default offsets for standard windows.

The following window types require the FF9 Windowskin System:
- :frame: Offsets for frame-type windows.
- :topbar: Offsets for topbar-type windows.
- :help: Offsets for help windows.

Each type contains:
- text_offset_x: Horizontal offset for text headers.
- text_offset_y: Vertical offset for text headers.
- image_offset_x: Horizontal offset for image headers.
- image_offset_y: Vertical offset for image headers.

- Valid values: Hash with Symbol keys and Hash values
- Default: { :default => { ... }, ... }

Example
Ruby: 
HEADER_OFFSETS = {
  :default => {
    :text_offset_x => 10,
    :text_offset_y => -4,
    :image_offset_x => 10,
    :image_offset_y => -2
  },
  :frame => {
    :text_offset_x => 10,
    :text_offset_y => -4,
    :image_offset_x => 10,
    :image_offset_y => -2
  },
  :topbar => {
    :text_offset_x => 10,
    :text_offset_y => -4,
    :image_offset_x => 10,
    :image_offset_y => -2
  },
  :help => {
    :text_offset_x => 10,
    :text_offset_y => -4,
    :image_offset_x => 10,
    :image_offset_y => -2
  }
}

Text Header Settings
Configure the appearance of text-based headers including font properties and color settings. Colors are stored as RGB arrays and converted to Color objects at runtime for better memory efficiency.

TEXT_SETTINGS
Hash containing text header configuration.

- font_name: Font family name for header text.
- font_size: Font size in pixels for header text.
- font_bold: Boolean flag for bold text styling.
- font_italic: Boolean flag for italic text styling.
- font_outline: Boolean flag for text outline effect.
- font_shadow: Boolean flag for text shadow effect.
- color: RGB array for main text color [R, G, B] (0-255).
- outline_color: RGB array for text outline color [R, G, B] (0-255).

- Valid values: Hash with Symbol keys and specific value types
- Default: { :font_name => "Arial", :font_size => 13, ... }

Example
Ruby: 
TEXT_SETTINGS = {
  :font_name => "Arial",
  :font_size => 13,
  :font_bold => false,
  :font_italic => false,
  :font_outline => true,
  :font_shadow => false,
  :color => [255, 255, 255],
  :outline_color => [0, 0, 0]
}

Window Header Configuration
Configure header settings for specific window classes. Each window class can be assigned either a text header or an image header with custom display content.

HEADERS
Hash mapping window classes to their header configuration.

- Window class => { :type => :type, :string => "content" }

:type options:
- :text: Display text header using TEXT_SETTINGS configuration.
- :image: Display image-based header from Graphics/System/Headers.

:string content:
- For :text type: The text string to display in the header.
- For :image type: Filename (without extension).

- Valid values: Hash with Window Class keys and Hash values
- Default: { Window_Gold => { ... }, ... }

Example
Ruby: 
HEADERS = {
  Window_Gold => {:type => :text, :string => "Gold"},
  Window_MenuCommand => {:type => :text, :string => "Main Menu"},
  Window_MenuStatus => {:type => :text, :string => "Party"},
  Window_SkillList => {:type => :text, :string => "Skills"},
  Window_ChoiceList => {:type => :image, :string => "ChoiceList"}
}


Installation

  • Copy the script to an open slot below ▼ Materials but above ▼ Main
  • Create a Graphics/System/Headers folder for your header image files
  • Configure your desired headers in the script's configuration section
  • Recommended: Install Text Cache v1.04 by Mithran for optimal text rendering


Compatibility

This script is made strictly for RPG Maker VX Ace. It is highly unlikely that it will run with RPG Maker VX without adjusting.


License

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


Credits

No credits are required.


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

Script: Download from GitHub
Demo: Download from GitHub

Features Mentioned

  • Core Header Features
  • Automatic header creation for configured windows
  • Text and image header support with dual content types
  • Per-window-class header configuration with custom settings
  • Customization System
  • Configurable text styling (font, size, color, outline, shadow)
  • Configurable header positioning (horizontal and vertical offsets)
  • Support for custom header graphics from Graphics/System/Headers folder
  • Technical Features
  • Automatic header property updates (position, visibility, and z-index)
  • Guard mechanism to prevent multiple header creation in inherited classes
  • Viewport compatibility for all scene types and window configurations

Downloads / Referenced Files

Log in to download

Log in, then follow the RPG Maker Developers Group to see these download links.

Log in to download

License / Terms Note

License MIT License - Free for commercial and non-commercial use. Credits No credits are required.

Creator Claims / Removal

If you are the original creator and want this listing reassigned, edited, or removed, join BMMPlay and contact the moderators with proof that matches the original RPG Maker Web profile, linked GitHub, itch.io page, or another public creator identity.

#039#rgss3#script-archive

Replies (0)

No replies yet.

0 replies 1 view

Log in to reply.

User Avatar