Ready or Not: Blockbreakers (v0.1, UNTESTED)

Solo-only UE4SS Lua mod. Minecraft blocks and items inside Ready or Not. No Minecraft file is bundled: textures and sounds are read at runtime from your own Minecraft Java install.

Install

1. Install UE4SS into ReadyOrNot/Binaries/Win64/.
2. Copy this folder to ReadyOrNot/Binaries/Win64/Mods/Blockbreakers/ (keep enabled.txt).
3. Launch Minecraft Java once so the client jar and asset index exist. Windows 10+ (uses built-in tar.exe).

Controls (change in Scripts/config.lua)

• F6 toggle Blockbreakers on/off
• ALT+1..9 select hotbar slot (1 planks, 2 cobblestone, 3 glass, 4 dirt, 5 TNT, 6 golden apple, 7 ender pearl, 8 bow, 9 speed potion)
• F7 use/place selected slot. Bow: press to draw, press again to loose (longer draw = more range)
• F8 break the targeted block (crosshair must stay on it for the break time)

Status of each hook (nothing has been run in the game yet)

| Hook | State | |---|---| | hk_input | Written. Unverified. | | hk_camera | Written (camera aim + optional engine trace). Unverified. | | hk_spawn_cube | Written. Unverified. | | hk_dyn_material | Written, but needs a cooked base material (see below) to show textures. | | hk_audio | Sounds are resolved and cached; playing needs a native decoder (see below). Silent until then. | | hk_ai_sight | Glass ignores the Visibility channel. Real AI perception channel unknown. | | hk_hud | Fallback only: on-screen text hotbar. No UMG widget/icons yet. | | hk_asset_reader | Written (tar.exe + asset index). Unverified. |

Known gaps (need the real game to close)

• Textures: a material with a texture param Tex and vector param Tint must exist at /Game/Mods/Blockbreakers/BB_BlockMat. That needs the UE editor to cook; until then blocks show untextured.
• Audio: UE4SS Lua cannot decode OGG. Provide an optional native module bb_native with play_ogg(path, volume).
• Health/stun/absorption: Ready or Not's health property and suspect/stun functions are guessed or unmapped. Heal, pearl self-damage and arrow stun are no-ops until mapped; the log (melty.log) prints what it hit.
• Ender pearl and arrows are instant ray casts, not physical projectiles. Arrow pickup is a 2 s refund placeholder.
• Hotbar icons, listing, credits, license, remix choice and screenshot are not done.