・Installation Guide (Basic Introduction)
* Before installing, recommend that make full backup of SD card just to be safe. (so that can restore them)
First, check the required tools.
-----
[Necessary tools]
1. Hyper Screen Generator (for Hyper Cube)
--> hyper_cube_gen.html, script.js
2. ZFBimagesToolSparda (for Hyper Screen)
3. Tool for rebuild game list (frogtool, or frogtool GUI, or Qs_tool(*Included in the custom theme), etc)
-----
[Installation instruction]
1. Open "
Hyper Screen Generator" (
hyper_cube_gen.html).
... Windows Edge browser is recommended, Chrome browser will probably work too.
2. Click the button next to "*Game files:".

... Find the folder containing the target game files and select all the game files in it, (Press Ctrl+A key) and click the OK button. The number of files will now be displayed on the screen. You will also see a preview of the actual game menu status on the left side of the screen.
3. Press the "Generate!" button, this completes the generation of the HyperScreen. Press OK on the completion message to download the ZIP file. ("merged_images.zip")
4. All that remains is to create a ZFB file using the HyperScreen pngs in the ZIP file.
... Once have extracted all the pngs in the ZIP file, run the ZFBimagesToolSparda mod. Specify the above png folder as the Input folder and specify "
640x400" as the image size without the "Fullscreen" mode checked. Specify the core name and file extension, and click the "Create ZFB Files" button to complete the zfb file generation.

(* Please refer to the screenshot above. For stock core arcade games, use the
ZFBimagesToolSpardaARCADE mod, or turn on the "ARCADE" checkbox on screenshot above.)
5. Copy the resulting zfb file to the target folder on the SD card. (FC/SFC/MD/GBA, etc. folder)
... Also, modify the following file:
"/Resources/Foldername.ini"
Change the second line from the bottom to the following.
---Before change (example) ---
24 184 144 208
---After change ---
0 80 640 400
* Just change the 4 numbers (x x 144 208) to 0 80 640 400.
At end, run tool (frogtool or frogtool GUI or Qs_tool) to rebuild game listings.
-----
With the above 5 steps, the installation is complete🆗
Start GB300 and enjoy the new Hyper Cube Menu!
・Installation Guide (Advanced)
Once have successfully verified the operation of HyperScreen in the "
Basic Introduction", let's add
cover images (thumbnails),
cube panel, and
information text.👾
-----
[Necessary tools]
・Skraper --> tool to get cover art and game logo (please see Skraper tutorial for how to use)
・cube_panel_converter.py --> tool to transform game logo images to fit into a cube shape (batch generation of cube panel pngs)
* If would like to use Windows exe instead of py, can download it from the URL below.
https://github.com/Q-ta-s/SF2000-Custom-Themes/raw/refs/heads/main/%23plugins/Hyper%20Cube%20Game%20Menu/cube_panel_converter_v0.1.exe
* Other tools are the same as in "Basic Introduction".
Prepare
the cover image No.1 and No.2 png images and
the game logo png images for the cube panel using Skraper or other tools.
(Each of the three folders should contain png image files with the same name as the game file name (excluding the file extension)).
Also, if necessary, store
info text files (*.txt) with the same name in the fourth folder as well. In the info text file, fill in the game maker name, release date, and game features using a text editor and save it.
-----
[Instruction]
I. First the steps are same 1~2 of the "
Basic Introduction", but to add
cube panel (game logos), use the
cube_panel_converter.py tool (or
cube_panel_converter_v0.1.exe) to specify the folder where the
game logo png image is stored, and convert it to a
cube panel (bulk transformed png images that fits into the cube).

(The "cubes" folder will be automatically created in the input folder.)

Then, click the button to the right of "Cube panels:" on the browser screen, select all the png images in the above "cubes" folder (press Ctrl+A key), and press OK.
This will also allow to see the cube panels added in the preview if the game files were already selected in step 2 of the "
Basic Introduction".
II. If necessary, select all the image/text files by pressing the respective buttons for
cover images 1 and 2, and for the
info text in the same way as above. (Open each folder, press Ctrl+A key and press OK.)
Can also check the status of each addition in the preview.
III. The rest of the steps are the same as those described in "
Basic Introduction" 3~5.
-----
With the above 3 steps, HyperScreen integration is complete.🆗
Start GB300 and enjoy the new Hyper Cube Menu!