bbhelper

BBHelper is a daily task automation assistant for players on the official Honkai Gakuen 2 server. It is driven by MaaFramework and runs in the MuMu emulator at 1280x720 landscape, requiring the game to be logged in and able to enter the lobby normally. The core design philosophy is "cherish your main account": all operations that consume resources or are irreversible are disabled by default and must be explicitly enabled by the user in the interface before they will execute. The daily cleanup flow runs in a fixed order, and each step can be toggled individually in the interface: - Startup: cold-start the game, dismiss the daily sign-in and game announcement popups, and enter the lobby - Mail collection: tap "One-tap Claim" to collect attachments - Familiar exploration: claim completed rewards and refill the number of accepted expeditions - Familiar's Love: the Multidimensional Rift stage, using quick battle, consuming 30 stamina - The World Is So Big: any stage in the Imaginary Axis Court, using quick battle, using free attempts - Combat Power Boost: purchase "Zero Hour Gift" from the gift pack shop, priced at zero, free - Stamina spending: farm "Meow King's Welfare" to accumulate stamina consumption, completing three cumulative tasks at once, 10 stamina each time - Power of Resonance: refresh Resonance House goods, no consumption within the free attempts - Claim rewards for the above tasks: return to the Presence page to collect milestone rewards The stamina spending module contains sub-options: stage source (the preset stage is currently only "Meow King's Welfare"; custom stages are marked as not implemented), number of stage runs, and stamina target (180/200/300, which reads "stamina cost N" from the stage details page and converts it into the number of runs). Consumable options that are disabled by default include: Power of Resonance (consumes Zero Hour Seeds after free attempts are used up), use double vouchers (consumables exchanged for double rewards), and do not claim stamina mail (claiming when stamina is overflowing wastes it). The script is fairly conservative in its safety checks: Resonance House refresh only recognizes the case where the popup body text is "Free Refresh"; in all other cases it taps cancel. When the quick battle button is grayed out (not unlocked), it skips and records it as incomplete. The "One-tap Delete" on the mail page is not within any recognition area. The to-do items listed in the README include: weekly tasks are not yet implemented; custom stages are implemented (select an event slot, enter the page number, and select a stage by stage name or coordinates); the character birthday popup is a placeholder node; the monthly card reward popup has been handled; stages without quick battle lack a general battle script; stage navigation currently only has one chain, "Meow King's Welfare"; the stamina target conversion does not deduct the amount already consumed that day, so it may run a few extra times; the daily sign-in flow is wired up but has not yet been verified on a real device. The project uses the MIT license.