Implement timed Invisible gadget and shared energy warnings

This commit is contained in:
UnixNight committed 2026-11-02 09:21:56 -05:00
1 parent 3527d33810
commit 1897dd2b90
44 files changed
+2466 -39

No files matched your search

+197
View File
@@ -0,0 +1,197 @@
#!/usr/bin/env python3
"""Read-only Invisible gadget source guards and bounded branch projections.
These projections are independently transcribed static contracts, not execution
of original code or a replacement for the port's runtime checks.
"""
from __future__ import annotations
import argparse
from dataclasses import dataclass, replace
import hashlib
import json
import math
from pathlib import Path
import struct
from checkpoint_script_state import EXE_SHA256, find_case, read_va
from pe_inspect import PE
BODIES = (
('invisible_tick', 0x424E80, 0x425114, 'b52f6f643c786206fa5a4089d58b311417439a203e0914a8a0243e319c52ebb3'),
('invisible_equip', 0x428E51, 0x428F61, '9abaa12fb4625248564818695c6a7e6d27fccf15216c670e5321a3742aa99bc2'),
('invisible_cleanup', 0x42810C, 0x4281B3, '92e9ffe9516cca33159b05d3509dc0e34d839e6c8d3deb7e1cd08adbfbfc2851'),
('material_alpha', 0x40E4A0, 0x40E5D9, '741d94d5cf14efd99e5380239d7a1b4be7e7fb5f478590604e8bd76b8e5d1ead'),
('indexed_blend', 0x40DD40, 0x40DD5D, 'b14a27765254aba1bb2e420019648ee0f05573567c1d1f79c6d8ab09cc59fdc5'),
('meter', 0x4036C0, 0x40385B, '46f35e6db8030b96cd6a0bddaf59cf37d36b41f6b568143856db2184b360ca8b'),
('enemy_target_flag', 0x409CC0, 0x409CF7, 'cf6e1c52f5801412ab7012465fd41d0278ddb9aef62002535c829f6e03af9252'),
)
SITES = (
('tick_after_movement', 0x424C31, 20),
('tick_control_pointer_not_identity', 0x424E80, 30),
('tick_mode_two', 0x424E9E, 12),
('tick_show_meter', 0x424EB4, 6),
('primary_then_not_jump', 0x424EBA, 26),
('primary_suppressor_returns', 0x424ED4, 13),
('activation_remaining_exact_zero', 0x424EE1, 19),
('activation_recharge_exact_seven_bits', 0x424EF4, 12),
('activation_energy_strict_two_or_override', 0x424F00, 33),
('activation_fixed_cost_minus_two', 0x424F21, 10),
('activation_duration_seven', 0x424F32, 10),
('activation_blend_source6_dest1', 0x424F3C, 12),
('activation_material_alpha_point7', 0x424F48, 15),
('activation_target_flag_false', 0x424F57, 7),
('activation_recharge_zero', 0x424F5E, 10),
('recharge_only_remaining_zero', 0x424F68, 23),
('recharge_energy_positive_or_override', 0x424F7F, 29),
('recharge_store_before_meter', 0x424F9C, 54),
('recharge_seven_clamp_white', 0x424FD2, 47),
('active_strict_positive_before_decrement', 0x425001, 23),
('active_decrement_before_meter', 0x425018, 28),
('active_expiry_less_or_equal_zero', 0x425064, 19),
('expiry_material_reset', 0x425077, 38),
('expiry_target_true_red_meter', 0x42509D, 25),
('flash_last_three', 0x4250BA, 19),
('flash_trunc_remaining_times_five', 0x4250CD, 19),
('flash_odd_dest7_even_dest1', 0x4250EA, 38),
('equip_energy_positive_or_override', 0x428E51, 40),
('equip_mode_two_timers_target_flag', 0x428EB4, 36),
('equip_display_before_branch', 0x428D95, 9),
('cleanup_target_flag_true_recharge_zero', 0x428125, 21),
('cleanup_companion_skip_flag', 0x428144, 20),
('cleanup_material_opaque_mode_minus_one', 0x428194, 31),
('constructor_timer_zero', 0x4227BE, 15),
('constructor_override_false', 0x437650, 6),
('postload_override_false', 0x4236C0, 7),
('postload_vr_range_override_true', 0x423E44, 45),
('enemy_chase_target_flag', 0x40847C, 34),
('enemy_acquire_target_flag', 0x40877A, 28),
('enemy_lost_target_flag', 0x4087F6, 51),
('cam_optional_cleanup_flag', 0x4165B7, 43),
('mca_optional_cleanup_flag', 0x43129A, 56),
('jimmy438_cleanup', 0x42AE08, 18),
('cam_interface_complete_plus_c8', 0x415A60, 6),
('cam_property_default_one_register', 0x415C09, 5),
('cam_property_default_one_store', 0x415CD5, 6),
('cam_deactivateinv_property', 0x415F70, 26),
('mca_interface_complete_plus_c8', 0x430930, 6),
('mca_property_default_one', 0x430AA0, 10),
('mca_deactivateinv_property', 0x430D7E, 26),
)
VTABLES = (
(0x4A3BDC, 0x1C8, 0x424E80), (0x4A3BDC, 0x178, 0x427FF0),
(0x4A3BDC, 0xFC, 0x40DD40), (0x4A3BDC, 0x114, 0x40E4A0),
(0x48D414, 0x484, 0x4036C0), (0x48D414, 0x488, 0x403700),
(0x48D414, 0x48C, 0x403730), (0x48D414, 0x490, 0x4037A0),
)
CONSTANTS = ((0x48D914, 0.0), (0x48D954, 2.0), (0x48D950, 5.0),
(0x48E5A0, 3.0), (0x48E5B8, 7.0), (0x4A3E30, 1/7))
def collect(original: Path | str):
pe = PE(find_case(Path(original), 'Neutron.exe'))
digest = hashlib.sha256(pe.data).hexdigest()
if digest != EXE_SHA256:
raise ValueError('Unexpected original EXE identity')
bodies = []
for name, start, end, expected in BODIES:
actual = hashlib.sha256(read_va(pe, start, end-start)).hexdigest()
if actual != expected:
raise ValueError(f'Changed original span {name}')
bodies.append(dict(name=name, va=hex(start), file_offset=hex(pe.offset(start-pe.base)),
length=end-start, sha256=actual))
sites = [dict(name=name, va=hex(va), file_offset=hex(pe.offset(va-pe.base)),
bytes=read_va(pe, va, length).hex()) for name, va, length in SITES]
tables = []
for base, slot, expected in VTABLES:
actual = struct.unpack('<I', read_va(pe, base+slot, 4))[0]
if actual != expected:
raise ValueError('Changed original virtual binding')
tables.append(dict(table=hex(base), slot=hex(slot), target=hex(actual)))
constants = []
for va, expected in CONSTANTS:
actual = struct.unpack('<f', read_va(pe, va, 4))[0]
if abs(actual-expected) > 1e-7:
raise ValueError('Changed original float constant')
constants.append(dict(va=hex(va), file_offset=hex(pe.offset(va-pe.base)), value=actual))
if read_va(pe, 0x4EDF10, 14) != b'DeactivateInv\0':
raise ValueError('Changed cleanup property identity')
return dict(sha256=digest, bodies=bodies, sites=sites, vtables=tables, constants=constants)
def f32(value):
return struct.unpack('<f', struct.pack('<f', value))[0]
@dataclass(frozen=True)
class State:
mode: int = 2
remaining: float = 0
recharge: float = 0
alpha: float = 1
blend: str = 'opaque'
targetable: bool = True
meter_visible: bool = True
meter_red: bool = True
def equip(state: State, energy: float, override: bool = False):
"""After caller cleanup/UI display2; failed branch changes only raw mode."""
if energy <= 0 and not override:
return replace(state, mode=-1)
return replace(state, mode=2, remaining=0, recharge=0, targetable=True,
meter_visible=True, meter_red=True)
def cleanup(state: State):
"""Only Jimmy-owned scalar/material/meter leaves; companion cleanup separate."""
return replace(state, mode=-1, remaining=7, recharge=0, alpha=1,
blend='opaque', targetable=True, meter_visible=False)
def step(state: State, seconds: float, energy: float, *, primary=False,
jump=False, suppressed=False, control_present=True, override=False,
graphics_alpha=False):
"""Source424E80 partial-order projection; return (state, fixed energy delta).
Uses float stores but does not claim x87 extended-precision equivalence for
every bin boundary or reproduce the UI's transient pre-clamp meter sample.
"""
if not math.isfinite(seconds) or not 0 <= seconds < 1:
raise ValueError('seconds must be finite and bounded')
if not control_present:
return replace(state, meter_visible=False), 0
if state.mode != 2:
return state, 0
state = replace(state, meter_visible=True)
delta = 0
if primary and not jump:
if suppressed:
return state, delta
if state.remaining == 0 and struct.pack('<f', state.recharge) == b'\0\0\xe0@':
if energy <= 2 and not override:
return state, delta
delta = -2
energy = max(0, min(100, f32(energy-2)))
state = replace(state, remaining=7, recharge=0, alpha=f32(.7),
blend='alpha' if graphics_alpha else 'additive', targetable=False)
if state.remaining == 0 and (energy > 0 or override):
recharge = f32(state.recharge+seconds)
state = replace(state, recharge=min(recharge, 7),
meter_red=False if recharge >= 7 else state.meter_red)
if state.remaining > 0:
remaining = f32(state.remaining-seconds)
if remaining <= 0:
return replace(state, remaining=0, alpha=1, blend='opaque',
targetable=True, meter_red=True), delta
blend = state.blend
if remaining <= 3:
blend = 'alpha' if int(remaining*5) % 2 else 'additive'
state = replace(state, remaining=remaining, blend=blend)
return state, delta
if __name__ == '__main__':
cli = argparse.ArgumentParser(description=__doc__)
cli.add_argument('original', type=Path)
print(json.dumps(collect(cli.parse_args().original), indent=2))