Charm Gacha Predictor (REFramework)

What this mod does

The Shooting Gallery charm gacha in Resident Evil 4 (2023) is not random at the moment you pull the lever. When you start a new playthrough, the game rolls one hidden seed for each of the four token combinations, and from then on the order of charms coming out of each combination is fixed. This mod reads those seeds after you load a save and shows you the exact upcoming charm order for all four combinations, so you can spend your tokens on the combination that actually gives you the charm you want.

It is a read-only information tool. It does not edit your save, does not touch the seeds, does not give you charms or tokens, and does not affect achievements. Delete the script to uninstall.

Main features

• []Full upcoming queue for all four combinations. Press F9 after loading a save. The script enumerates the next 30 charms for each combination (adjustable up to 2000 in the REFramework menu) and shows them in an on-screen overlay.[/]

  []On-screen overlay, no menu key needed. The overlay shows each combination's seed and how many draws you have already made. After an export it also lists the Epic and Legendary charms with how many draws away each one is, the next 5 charms of every combination, and your latest real draws checked against the prediction. Those numbers update live as you draw, and if you load a different save the overlay tells you to press F9 again instead of showing stale predictions. It resizes itself to fit. F8 shows or hides it. You never need to open the REFramework menu unless you want the draw-count slider or the longer per-combination preview.[/]

  []"Where is my charm?" summary. Along with the JSON, every F9 press writes

  charm_gacha_summary_<timestamp>.txt: every charm sorted by rarity, with the combination and draw number where it shows up first, its position in the other three combinations, and a list of charms that do not appear within the enumerated draws. Open it in Notepad.[/]

  []JSON export. Every F9 press also writes

  charm_gacha_enum_<timestamp>.jsonwith all four queues, item IDs, English and Chinese names, rarity, a charm catalog, and the same first-appearance data. Handy for planning outside the game or for sharing your seed's queue.[/]

  []English or Chinese output. F7 switches the language of the summary txt (EN/CN) and the choice is remembered between sessions. The JSON always contains both names. The on-screen overlay itself stays English because REFramework's default font has no CJK glyphs.[/]

  []Built-in verification. Every real gacha draw you make is logged to

  reframework/data/charm_gacha_real_draws.jsontogether with what the script predicted for that draw and a match flag, so you can check the predictions yourself.[/]

  []Configurable. A JSON config is created in

  reframework/dataon the first start: hotkeys (F1-F12 or virtual-key codes), whether the overlay is visible on start, the real-draw log on/off, and how many draws to enumerate per combination. Invalid values fall back to the defaults and are reported in the REFramework console.[/]

  []Safe by design. The only thing the script writes is an in-memory draw counter, which it advances during enumeration and restores to the original value before returning. Every step is verified, and the script aborts and restores the counter if anything looks wrong. Nothing is written to your save file.[/]

Installation

• []Install REFramework (its dinput8.dll goes in the game folder) if you have not already.[/]

  []Fluffy Mod Manager: drop the zip into the manager and enable it like any other mod.[/]

  []Manual: copy

  reframework/autorun/charm_gacha_enum.luafrom the zip into your game folder so that it ends up at

  <game folder>/reframework/autorun/charm_gacha_enum.lua.[/]

  []Start the game, load a save, press F9. The overlay shows the four queues, and the files land in

  <game folder>\reframework\data\(the game's install folder, not Documents; the data folder is created on the first export).[/]

charm_gacha_enum.luafrom

reframework/autorun. The JSON files in

reframework/datacan be deleted too.

How to read the overlay

"table" is the token combination, numbered by how many gold tokens you insert:

[]table 0 = 3 silver tokens[/]

[]table 1 = 1 gold + 2 silver[/]

[]table 2 = 2 gold + 1 silver[/]

[]table 3 = 3 gold tokens[/]