Hammy - FF9 Windowskin System

じ☆ve冰风

Hammy - FF9 Windowskin System v1.01
Recreate the iconic Final Fantasy IX window themes with dynamic type-based skinning​

---

Introduction

This script provides an authentic Final Fantasy IX windowskin system for RPG Maker VX Ace. It allows different window types to use specialized windowskin graphics based on their class and function.

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 Windowskin Features

• Automatic windowskin assignment based on window class and type
  
• Dual color themes (grey and blue) with runtime switching through Game_System
  
• Multiple window type support: default, frame, topbar, help
  

Customization System

• Per-window-class type configuration with tailored windowskin assignments
  
• Configurable windowskin filenames for each type and color combination
  

Technical Features

• Real-time windowskin refresh when the active theme changes
  
• Automatic window type detection with safe default fallback
  

---

Script Calls

The following script calls are available for use in events and other scripts.

Color Theme Management

$game_system.windowskin_color = :grey
Changes all windows to use the grey color theme.

$game_system.windowskin_color = :blue
Changes all windows to use the blue color theme.

Examples
                Ruby:       

1. # Change color theme to grey
2. $game_system.windowskin_color = :grey
4. # Change color theme to blue
5. $game_system.windowskin_color = :blue

复制代码

---

Configuration

Edit the constants in the Hammy::FF9WindowskinSystem module to configure the windowskin filenames, window type mapping, and background opacity.

Windowskin File Names
Configure the windowskin graphic filenames for different window types and color themes. All windowskin files should be placed in the Graphics/System folder of your project.

GREY_DEFAULT
Default grey windowskin for standard windows.
- Valid values: String containing filename without extension
- Default:"Window_Default_Grey"

Example
                Ruby:       

1. GREY_DEFAULT = "Window_Default_Grey"

复制代码

BLUE_DEFAULT
Default blue windowskin for standard windows.
- Valid values: String containing filename without extension
- Default:"Window_Default_Blue"

Example
                Ruby:       

1. BLUE_DEFAULT = "Window_Default_Blue"

复制代码

GREY_FRAME
Grey windowskin for frame-type windows.
- Valid values: String containing filename without extension
- Default:"Window_Frame_Grey"

Example
                Ruby:       

1. GREY_FRAME = "Window_Frame_Grey"

复制代码

BLUE_FRAME
Blue windowskin for frame-type windows.
- Valid values: String containing filename without extension
- Default:"Window_Frame_Blue"

Example
                Ruby:       

1. BLUE_FRAME = "Window_Frame_Blue"

复制代码

GREY_TOPBAR
Grey windowskin for topbar-type windows.
- Valid values: String containing filename without extension
- Default:"Window_Topbar_Grey"

Example
                Ruby:       

1. GREY_TOPBAR = "Window_Topbar_Grey"

复制代码

BLUE_TOPBAR
Blue windowskin for topbar-type windows.
- Valid values: String containing filename without extension
- Default:"Window_Topbar_Blue"

Example
                Ruby:       

1. BLUE_TOPBAR = "Window_Topbar_Blue"

复制代码

HELP_SYSTEM
Special windowskin for help windows.
- Valid values: String containing filename without extension
- Default:"Window_Help_System"

Example
                Ruby:       

1. HELP_SYSTEM = "Window_Help_System"

复制代码

Window Type Configuration
Configure window classes to use specific windowskin types. This allows different window classes to automatically use specialized windowskin graphics based on their designated type.

WINDOW_TYPES
Hash mapping window classes to their designated types.

Available types: :default, :frame, :topbar, :help Windows not listed here will automatically default to :default type.

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

Example
                Ruby:       

1. WINDOW_TYPES = {
2.   Window_MenuCommand => :frame,
3.   Window_MenuStatus => :topbar,
4.   Window_Gold => :frame,
5.   Window_TitleCommand => :frame
6. }

复制代码

Window Background Opacity
Configure the default background opacity for all windows in the game. This controls the transparency of the window background content area.

BACK_OPACITY
Background opacity value (0-255, 255 is fully opaque).
- Valid values: Integer from 0 to 255
- Default:255

Example
                Ruby:       

1. BACK_OPACITY = 255

复制代码

---

Installation

• Copy the script to an open slot below ▼ Materials but above ▼ Main
  
• Ensure your windowskin graphics are saved in Graphics/System with the names defined in the configuration section
  

---

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

This script is based on Jet10985's Windowskin Changer script.

---

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

---

YEA System Options Addon

This addon extends Yanfly's System Options script to include windowskin color selection directly in the system options menu. Players can toggle between grey and blue themes without using script calls.

Features

• Windowskin color toggle command in System Options menu
  
• Automatic detection of Global System Option script presence
  
• Configurable command insertion position via anchor system
  

Requirements

• Hammy FF9 Windowskin System v1.00
  
• Yanfly System Options v1.00
  
• Optional: Theolized Global System Option v1.00
  

Installation
Place this addon script BELOW both YEA-SystemOptions and the FF9 Windowskin System.

Download:Download from GitHub

Spoiler: Addon Code

                Ruby:       

1. # encoding: utf-8
2. #==============================================================================
3. # ▼ Hammy - FF9 Windowskin System - YEA System Options Addon v1.01
4. #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
5. # -- Last Updated: 25.05.2026
6. # -- Requires: Hammy FF9 Windowskin System v1.01+,
7. #              YEA-SystemOptions v1.00
8. # -- Optional: Theolized - Global System Option v1.00
9. # -- Recommended: None
10. # -- Credits: Yanfly (YEA-SystemOptions),
11. #             Theo Allen (Global System Option)
12. # -- License: MIT License
13. #==============================================================================
15. $imported ||= {}
16. $imported[:hammy_ff9_windowskin_system_system_options] = true
18. #==============================================================================
19. # ▼ Updates
20. #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
21. # 25.05.2026 - (v1.01) Applied new documentation conventions.
22. #              Migrated configuration modules to Hammy::PascalCase naming.
23. #
24. # 23.10.2025 - (v1.00) Initial release.
25. #
26. #==============================================================================
27. # ▼ Introduction
28. #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
29. # This addon extends the Yanfly System Options script to include windowskin
30. # color selection functionality for the Hammy FF9 Windowskin System. It
31. # provides seamless integration with the system options menu, allowing players
32. # to change the window color theme directly from the game's options screen.
33. #
34. # The addon automatically detects whether Theo's Global System Option script is
35. # present and adapts its save behavior accordingly, supporting both standard
36. # save file storage and global options storage.
37. #
38. # -----------------------------------------------------------------------------
39. # ► Core Integration Features
40. # -----------------------------------------------------------------------------
41. # ★ Windowskin color toggle command in System Options menu
42. # ★ Automatic detection of Global System Option script presence
43. # ★ Configurable command insertion position via anchor system
44. #
45. #==============================================================================
46. # ▼ Base Classes & Method Modifications
47. #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
48. # This script modifies the following RGSS3 base classes:
49. #
50. # -----------------------------------------------------------------------------
51. # ► Game_System (Class)
52. # -----------------------------------------------------------------------------
53. # ★ Added Getters/Setters:
54. #   - windowskin_color
55. #   - windowskin_color=
56. #
57. #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
58. # This script modifies the following 3rd party classes:
59. #
60. # -----------------------------------------------------------------------------
61. # ► OptionData (Class)
62. # -----------------------------------------------------------------------------
63. # ★ Public Instance Variables:
64. #   - windowskin_color (attr_accessor)
65. #
66. # ★ Alias Methods:
67. #   - initialize → ff9_windowskin_optiondata_initialize
68. #
69. # -----------------------------------------------------------------------------
70. # ► Window_SystemOptions (Class < Window_Command)
71. # -----------------------------------------------------------------------------
72. # ★ Alias Methods:
73. #   - draw_item → ff9_windowskin_win_sysopt_draw_item
74. #   - cursor_change → ff9_windowskin_win_sysopt_cursor_change
75. #   - make_command_list → ff9_windowskin_win_sysopt_make_comm_list
76. #
77. #==============================================================================
78. # ▼ Instructions
79. #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
80. # To install this script, open up your script editor and copy/paste this script
81. # to an open slot below ▼ Materials/素材 but above ▼ Main. Remember to save.
82. #
83. # ★ This script requires Yanfly - YEA-SystemOptions and Hammy - FF9 Windowskin
84. #   System and must be placed BELOW them.
85. #
86. # ★ If using Theolized Global System Option v1.0, windowskin color preferences
87. #   will be saved globally across all save files.
88. #
89. #==============================================================================
90. # ▼ Compatibility
91. #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
92. # This script is made strictly for RPG Maker VX Ace. It is highly unlikely that
93. # it will run with RPG Maker VX without adjusting.
94. #
95. #==============================================================================
97. #==============================================================================
98. # ** FF9 Windowskin System Configuration
99. #------------------------------------------------------------------------------
100. #  Configuration settings for the FF9 Windowskin System.
101. #==============================================================================
103. module Hammy
104.   module FF9WindowskinSystem
105.    
106.     #=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
107.     # - System Options Anchor -
108.     #=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
109.     # Configure the insertion position for the windowskin color command in
110.     # the System Options menu. The command will be inserted after the
111.     # specified anchor command.
112.     #
113.     # WINDOWSKIN_INSERT_ANCHOR: Symbol of the anchor command.
114.     #   - Valid values: Symbol representing a command in System Options
115.     #   - Default: :window_blu
116.     #=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
117.     WINDOWSKIN_INSERT_ANCHOR = :window_blu
118.    
119.     #=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
120.     # - Command Vocabulary -
121.     #=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
122.     # Configure the display text and help information for the windowskin
123.     # color toggle command in the System Options menu.
124.     #
125.     # WINDOWSKIN_VOCAB: Hash containing command text and help description.
126.     #   [0] = Command name, [1] = Grey text, [2] = Blue text, [3] = Help text
127.     #   - Valid values: Hash with Symbol key and Array of Strings
128.     #   - Default: { :windowskin_color => [...] }
129.     #=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
130.     WINDOWSKIN_VOCAB = {
131.       :windowskin_color => ["Window Color", "Grey", "Blue",
132.                             "Change the color scheme of all windows.\n" \
133.                             "Toggle between grey and blue window themes."
134.                            ]
135.     }
136.    
137.     #==========================================================================
138.     # ▼ End of Documentation
139.     #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
140.     # This marks the end of the documentation and configuration section.
141.     # Everything below this point is the actual script implementation code.
142.     #
143.     # WARNING: Modifying the code below requires advanced Ruby and RGSS3
144.     # knowledge. Improper changes may cause script errors, game crashes, or
145.     # data corruption. Only edit if you understand the consequences and have
146.     # backups of your project.
147.     #==========================================================================
148.    
149.     #--------------------------------------------------------------------------
150.     # * Merge Windowskin Color Vocabulary                              [Custom]
151.     #--------------------------------------------------------------------------
152.     if $imported["YEA-SystemOptions"]
153.       YEA::SYSTEM::COMMAND_VOCAB.merge!(WINDOWSKIN_VOCAB)
154.     end
155.    
156.   end # Hammy::FF9WindowskinSystem
157. end # Hammy
159. #==============================================================================
160. # ▼ Script Dependencies Check
161. #-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
162. # This section checks for the presence of required companion scripts.
163. # If any required scripts are missing, it displays an error message and exits.
164. #==============================================================================
166. unless $imported["YEA-SystemOptions"]
167.   msgbox("YEA-System Options v1.00 by Yanfly is required but not found!\n" \
168.          "Please install the required script before using " \
169.          "Windowskin System - System Options Addon.")
170.   exit
171. end
173. unless $imported[:hammy_ff9_windowskin_system]
174.   msgbox("Hammy FF9 Windowskin System v1.00 is required but not found!\n" \
175.          "Please install the required script before using " \
176.          "Windowskin System - System Options Addon.")
177.   exit
178. end
180. #==============================================================================
181. # ** OptionData
182. #------------------------------------------------------------------------------
183. #  This class handles global system option data. It saves option preferences
184. # globally across all save files when using Theo's Global System Option.
185. #==============================================================================
187. if $imported[:Theo_GlobalOption]
188.   class OptionData
189.     #--------------------------------------------------------------------------
190.     # * Public Instance Variables                                      [Custom]
191.     #--------------------------------------------------------------------------
192.     attr_accessor :windowskin_color
193.    
194.     #--------------------------------------------------------------------------
195.     # * Alias Method Definitions                                       [Custom]
196.     #--------------------------------------------------------------------------
197.     alias_method :ff9_windowskin_optiondata_initialize, :initialize
198.    
199.     #--------------------------------------------------------------------------
200.     # * Object Initialization                                           [Alias]
201.     #--------------------------------------------------------------------------
202.     def initialize
203.       ff9_windowskin_optiondata_initialize
204.       @windowskin_color = :grey
205.     end
206.    
207.   end # OptionData
208. end # if $imported[:Theo_GlobalOption]
210. #==============================================================================
211. # ** Game_System
212. #------------------------------------------------------------------------------
213. #  This class handles system data. It saves the disable state of saving and
214. # menus. Instances of this class are referenced by $game_system.
215. #==============================================================================
217. class Game_System
218.   #--------------------------------------------------------------------------
219.   # * Get Windowskin Color                                           [Custom]
220.   #--------------------------------------------------------------------------
221.   def windowskin_color
222.     if $imported[:Theo_GlobalOption]
223.       return $option_data.windowskin_color
224.     else
225.       return @windowskin_color
226.     end
227.   end
228.   
229.   #--------------------------------------------------------------------------
230.   # * Set Windowskin Color                                           [Custom]
231.   #--------------------------------------------------------------------------
232.   def windowskin_color=(value)
233.     if $imported[:Theo_GlobalOption]
234.       $option_data.windowskin_color = value
235.       OptionData.save
236.     else
237.       @windowskin_color = value
238.     end
239.   end
240.   
241. end # Game_System
243. #==============================================================================
244. # ** Window_SystemOptions
245. #------------------------------------------------------------------------------
246. #  This window displays system options on the options screen.
247. #==============================================================================
249. class Window_SystemOptions < Window_Command
250.   #--------------------------------------------------------------------------
251.   # * Alias Method Definitions                                       [Custom]
252.   #--------------------------------------------------------------------------
253.   alias_method :ff9_windowskin_win_sysopt_draw_item, :draw_item
254.   alias_method :ff9_windowskin_win_sysopt_cursor_change, :cursor_change
255.   alias_method :ff9_windowskin_win_sysopt_make_comm_list, :make_command_list
256.   
257.   #--------------------------------------------------------------------------
258.   # * Create Command List                                             [Alias]
259.   #--------------------------------------------------------------------------
260.   def make_command_list
261.     ff9_windowskin_win_sysopt_make_comm_list
262.     inject_windowskin_color_command
263.   end
264.   
265.   #--------------------------------------------------------------------------
266.   # * Inject Windowskin Color Command                                [Custom]
267.   #--------------------------------------------------------------------------
268.   def inject_windowskin_color_command
269.     anchor_index = @list.find_index { |item|
270.       item[:symbol] == Hammy::FF9WindowskinSystem::WINDOWSKIN_INSERT_ANCHOR
271.     }
272.    
273.     if anchor_index
274.       insert_index = anchor_index + 1
275.     else
276.       insert_index = @list.size
277.     end
278.    
279.     vocab = YEA::SYSTEM::COMMAND_VOCAB
280.    
281.     windowskin_command = {
282.       :name => vocab[:windowskin_color][0],
283.       :symbol => :windowskin_color,
284.       :enabled => true,
285.       :ext => nil
286.     }
287.    
288.     @list.insert(insert_index, windowskin_command)
289.     @help_descriptions[:windowskin_color] = vocab[:windowskin_color][3]
290.   end
291.   
292.   #--------------------------------------------------------------------------
293.   # * Draw Item                                                       [Alias]
294.   #--------------------------------------------------------------------------
295.   def draw_item(index)
296.     if @list[index][:symbol] == :windowskin_color
297.       reset_font_settings
298.       rect = item_rect(index)
299.       contents.clear_rect(rect)
300.       draw_windowskin_toggle(rect, index, @list[index][:symbol])
301.     else
302.       ff9_windowskin_win_sysopt_draw_item(index)
303.     end
304.   end
305.   
306.   #--------------------------------------------------------------------------
307.   # * Draw Windowskin Toggle                                         [Custom]
308.   #--------------------------------------------------------------------------
309.   def draw_windowskin_toggle(rect, index, symbol)
310.     name = @list[index][:name]
311.     draw_text(0, rect.y, contents.width / 2, line_height, name, 1)
312.    
313.     enabled = $game_system.windowskin_color == :blue
314.    
315.     dx = contents.width / 2
316.     change_color(normal_color, !enabled)
317.     option1 = YEA::SYSTEM::COMMAND_VOCAB[symbol][1]
318.     draw_text(dx, rect.y, contents.width / 4, line_height, option1, 1)
319.    
320.     dx += contents.width / 4
321.     change_color(normal_color, enabled)
322.     option2 = YEA::SYSTEM::COMMAND_VOCAB[symbol][2]
323.     draw_text(dx, rect.y, contents.width / 4, line_height, option2, 1)
324.   end
325.   
326.   #--------------------------------------------------------------------------
327.   # * Process Cursor Move                                             [Alias]
328.   #--------------------------------------------------------------------------
329.   def cursor_change(direction)
330.     if current_symbol == :windowskin_color
331.       change_windowskin_toggle(direction)
332.     else
333.       ff9_windowskin_win_sysopt_cursor_change(direction)
334.     end
335.   end
336.   
337.   #--------------------------------------------------------------------------
338.   # * Change Windowskin Toggle                                       [Custom]
339.   #--------------------------------------------------------------------------
340.   def change_windowskin_toggle(direction)
341.     value = direction == :left ? false : true
342.     current_case = $game_system.windowskin_color == :blue
343.    
344.     new_color = value ? :blue : :grey
345.     $game_system.windowskin_color = new_color
346.    
347.     Sound.play_cursor if value != current_case
348.     draw_item(index)
349.   end
350.   
351. end # Window_SystemOptions
353. #==============================================================================
354. #
355. # ▼ End of File
356. #
357. #==============================================================================

复制代码

---

本贴来自国际rpgmaker官方论坛作者:buddysievers处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/hammy-ff9-windowskin-system.180664/