Ready or Not: Lockdown Waves — v0.1 source prototype

Status: source prototype; not gameplay-tested; not publish-ready.

This project implements the agreed first-pass structure for a solo Ready or Not mission variant:

1. The mission begins normally.
2. Crossing a configured building-entry trigger activates lockdown mode.
3. Configured exits lock.
4. Enemy waves begin and escalate by sheet-defined rules.
5. The run fails if the local player is no longer active.

The project intentionally leaves Ready or Not's existing loadout/inventory systems untouched.

Why this is not a playable release yet

The current workspace cannot access the user's Windows Ready or Not installation or run the game. The exact reflected Ready or Not class/function names needed for the trigger, doors, local player and wave enemy actor are therefore unverified. The preflight tool refuses a release build until every required binding is verified.

The wave rules are testable without the game using the headless simulator.

Layout

• sheets/ — source of truth for systems, waves, hooks and bindings.
• tools/preflight.py — verifies every required sheet cell and cross-reference.
• tools/generate.py — generates Lua configuration from verified sheets.
• tools/simulate.py — headless wave-state simulation.
• src/ReadyOrNotZombies/Scripts/ — UE4SS Lua source scaffold.
• MODLOG.md — decisions, evidence, unresolved bindings, test results.

Local checks

python tools/preflight.py
python tools/simulate.py --waves 5

preflight.py is expected to fail until the game-specific binding sheet has been filled from a real Ready or Not run.

Loader route

The intended host route is a UE4SS Lua mod under Ready or Not's Win64 mod directory. Melty's supplied project brief says Ready or Not is the host and that Melty can install UE4SS for it. The current public Ready or Not mod ecosystem also has current 2026 UE4SS Lua mods.

No Ready or Not or Black Ops III game files are included in this project.