HiddenChest RGSS Player Executable

[kyonides]

Version 1.2.04 Has Been Uploaded!

Codename: KeyMaster

Avaiable Platforms

• Linux
  
• Windows
  

Highlights

• Support for mapping keys from Ruby has been improved.
  
• KChangeKeys HC scripts for All RGSS-based Engines have been uploaded.
  
• Added Input.trigger_exclude? singleton method.
  

The Main Section

This release came into existence when I finally noticed that it was not very easy to implement a GUI for remapping keys via Ruby / RGSS scriptas in RM XP or VX ACE. The previous release only allowed you to change a button via changing its current name, and this is excellent for parsing scripts like the one incorporated by HiddenChest. Yet, it would be pretty much impossible to ever get data like the virtual button's value (like C or L) or its SDL counterpart.

Now the engine is capable of communicating such data between C / C++ to Ruby as well, enabling us to quickly define any sort of key mapping scene like I did for RM XP an VX or VX ACE. You can find them in the extras directory.

The KeyBindings related MD help files have been updated with some minor changes those classes have endured to make this possible. Most of the changes are internal and they should remain so. Otherwise, people would keep breaking the system for any reason they can come up with.

Input Module's New Methods

• trigger_exclude?
  
• save_key_bindings
  
• text_input=
  
• trigger_type
  
• trigger_gp_value
  
• trigger_gp_dir
  
• trigger_gp_clear
  

Input.trigger_exclude? accepts 1+ arguments at any given call. It makes it easy to ask the module if any group of buttons have not been triggered so far. Additionally, it returns false if no key or button of any kind has been triggered.

Input.text_input= accepts 1 out of 3 values, namely 0, 1 or 2.

• 0 - Normal Key Bindings Behavior
  
• 1 - Enter Text Behavior
  
• 2 - Map Your Custom Keys at Will
  

Input.trigger_type returns the key's class value based on SDL's and the KeyBinding's specifications.

Input.trigger_gp_value returns the real gamepad's button's or axis's or hat's internal values. The keyboard bindings do not rely on this but on Input.trigger_last introduced some time ago to get the actual SDL scan codes it needs.

The last 2 functions are used internally whenever you set a new key or button by value.

[kyonides]

Version 1.2.05 Has Been Uploaded!

Codename: KeyMaster

Avaiable Platforms

• Linux
  
• Windows
  

Recent Changes:

• Modified the way Input.text_input's value can be modified by RGSS scripts.
  
• Added new methods to the Input module.
  
• Updated the KChangeKeys HC scripts.
  
• Updated the KEnterText HC scripts.
  - Bitmap#draw_text and #fill_rect can now accept a :rect symbol as first parameter.
  It will use the bitmap's own rect object by default.
  
• Added some basic documentation for the Input module to the extras/help directory.
  
• Fixed a very uncommon issue that happened on Linux only that prevented the game window from being displayed after resizing the window or by calling the Game.show_window method.
  

The Main Section

While testing HiddenChest's gamepad support, I soon noticed that it did not recognize all of the buttons as expected. That need forced me to add new "Default Buttons" to the usual RM game engine's own list. By doing this, I was able to rewrite the C++ Input class and Ruby's Input module to let it ALWAYS find such buttons at any given time while in the Key Mapping Mode.
I won't list the new methods I added to the Input module in this release because you can find a large list of methods explained in the Input module's MD help file.
Concerning the game window issue, I will only add the strange fact that the OS windowing system just need some extra milliseconds to adapt the game window's display before showing us the final result, namely your game's title scene on screen.

[kyonides]

Version 1.2.06 Has Been Uploaded!

Codename: KeyMaster
Stable Version?

Avaiable Platforms

• Linux
  
• Windows
  

Recent Changes:

• Rewrote several lines of code related to Key Bindings processes, eliminating bloat code and variable duplication.
  The data files obtained after parsing the gamepad profile INI files will be moved to the user's profile + saved games directory. [Cleanup]
  
• Fixed Windows builds not loading Key Mapping files even if the engine had parsed the INI files multiple times. [Bug Fix]
  
• Fixed some key mappings not being recognized by the F1 menu after being parsed by Ruby or set via the KChangeKeys HC script. [Bug Fix]
  
• SHIFT, CTRL & ALT buttons can now be repeated and caught by the Input.repeat? method. [Bug Fix]
  
• Bitmap's methods draw_text, text_size, text_width, & text_height now let you pass a numeric value as a string.
  It will internally convert the value into a string. [New Feature for RMXP-based Games]
  

Notes

The reason why the key bindings already stored in Ruby files were not loaded properly was that the USERPROFILE environmental variable contained \ backslashes. Ruby can only handle / forward slashes as file paths, so they had to be temporarily **sub*stituted by the parser to let it use some of DIr class's methods with ease.

The F1 menu's key mapping issues were caused by some of its mkxp's old code that treats SHIFT as LeftShift internally. The keypad could also cause some problems there from time to time, but this has been corrected in this release.

HiddenChest's philosophy has always been to add as many features as possible and make them available for all 3 RGSS versions. That is why I removed the limitation it had in place for strings in RMXP games when passed to certain Bitmap's methods. There is no need to alter old XP scripts at all, they will still work normally. Only new scripts for the HiddenChest engine can benefit from it.