arcattackandClaude Fable 5
2edde29671
Replace the RivetGun-modeled ProjectileWeaponSimulation body with the fully recovered binary machine (capstone disasm, every branch address-cited): - gate 1 @4bbd36: simulationState@0x40==1 (destroyed) || heatAlarm==FailureHeat || owner disabled -> recoil=rechargeRate + alarm 7 (was: simulationFlags==1) - gate 2 @4bbd71: bin alarm 2/3 or bin destroyed -> alarm 7 re-pinned per frame - Loaded @4bbec2: DENIED shots (viewFireEnable off / no owner target) blip SetLevel(4);SetLevel(2) and STAY LOADED, no ammo pull (the old FireWeapon early-returns under an unconditionally-cycling caller faked a full firing pip cycle -- the "missiles cycle but never launch" incident mechanic); the ammo pull is bin->FeedAmmo @4bbee6 in the CALLER; both updateModel|=1 marks (@4bbf05/@4bbf4c = ForceUpdate) bracket FireWeapon; recoil set @4bbf51 - Loading @4bbdd2: recoil bleeds ONLY here at electrical Ready and CLAMPS at 0 (it ran to -114 before); bin Loaded -> weapon Loaded - 7 @4bbe4d: binary-faithful roach motel (re-asserted unconditionally; recovery = ResetToInitialState only) - slot 17 @004b9c9c reconstructed as MechWeapon::ComputeOutputVoltage (rechargeLevel=(rechargeRate-recoil)/rechargeRate, Emitter overrides with @4ba738) and called from Loading/7 -- the launcher recharge dial ANIMATES (the old "authentically static" claim was wrong) FireWeapon bodies stripped to heat+spawn only per @004bcc60 (no view gate, no ConsumeRound, no recoil); ConsumeRound retired (not a binary method). Gotcha #20 sweep (all sites disasm-verified): simulationFlags|=0x1 == engine DelayWatchersFlag (audio watchers muted forever) removed everywhere -- projweap/mislanch fire marks, ProjectileWeapon::ResetToInitialState (@4bbb47 = updateModel|=1); Emitter::SetDirty retired and split per binary site into ForceUpdate() (@4bafaa/@4ba55d) vs ExecuteOnUpdate() (@4ba99a/@4ba943); Emitter fault gate GetFlags()==1 -> simulationState==1 (@4baab9). AmmoBin::GetAmmoState() accessor added (named-member read of ammoAlarm@0x1A8). BT_LOOK_TEST=<frame> scripted verify added (mech4.cpp): holds the rear-view button 300f on/300f off to drive viewFireEnable headlessly. Verified solo ARENA1 (bhk1, autofire): 54-60 [projectile] PUSH + impact smoke; look-back denial window = trigger pulses, state stays 2, zero launches, resumes on release; enemy (disabled) mech launchers pinned 7 + full recoil; STREAK-6 recharge dial sweeps across BT_SHOT frames; lasers fire throughout; zero gauge faults. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
252 lines
11 KiB
C++
252 lines
11 KiB
C++
//============================================================================//
|
|
// File: ammobin.hpp //
|
|
// Project: BattleTech //
|
|
// Contents: Ammunition bin -- holds rounds, feeds a ProjectileWeapon, and //
|
|
// cooks off when overheated. //
|
|
//----------------------------------------------------------------------------//
|
|
// Date Who Modification //
|
|
// -------- --- ------------------------------------------------------------//
|
|
// 04/13/95 JM Initial coding. //
|
|
//----------------------------------------------------------------------------//
|
|
// Copyright (C) 1995, Virtual World Entertainment, Inc. All Rights reserved //
|
|
// PROPRIETARY AND CONFIDENTIAL //
|
|
//============================================================================//
|
|
//
|
|
// RECONSTRUCTED from the shipped binary (Ghidra pseudo-C, module cluster
|
|
// @004bd2c0-@004bdb94 + CSS @004bd6f0 in part_013.c). Only the test fragment
|
|
// AMMOBIN.TCP survives (AmmoBin::TestClass -> True; AmmoBin::ResetToInitialState
|
|
// -> empty). Member/method names are inferred from the streamed resource keys
|
|
// ("AmmoCount"/"FeedRate"/"AmmoClassID"/"ProjectileClassID"/"MissileClassID"/
|
|
// "AmmoModelFile"/"ExplosionModelFile") and from usage; see ammobin.cpp for the
|
|
// per-method @ADDR evidence. Names past the HeatWatcher base are best-effort.
|
|
//
|
|
// Inheritance chain established from the decomp:
|
|
// Subsystem -> HeatableSubsystem -> HeatWatcher (ctor @4aeb40, vtable
|
|
// @0050ed10) -> AmmoBin (ctor @4bd5c4, vtable @0051286c, classID 0x0BCB).
|
|
// AmmoBin IS a HeatWatcher: it watches a temperature against the resource's
|
|
// degradation/failure thresholds, and when the watch alarm (this+0x140) reaches
|
|
// FAILURE it arms a randomised cook-off timer that dumps all stored rounds'
|
|
// heat into the mech and empties the bin. A ProjectileWeapon links to it as a
|
|
// SharedData connection (launcher this[0x10F]@0x43C, connection ctor @4bcbb0,
|
|
// vtable @00512424) and pulls a round via FeedAmmo() each time it fires.
|
|
//
|
|
// Object byte offsets (this is an int* in the decomp, word index in parens).
|
|
// Everything below +0x180 is the HeatWatcher / HeatableSubsystem / Subsystem
|
|
// base (watch heatAlarm level @0x140 = word 0x50; base status alarm @0x2C).
|
|
//
|
|
|
|
#if !defined (AMMOBIN_HPP)
|
|
# define AMMOBIN_HPP
|
|
|
|
# if !defined(HEATFAMILY_RESLICE_HPP)
|
|
# include <heatfamily_reslice.hpp> // HeatWatcher base (heat family)
|
|
# endif
|
|
|
|
//######################### Forward Class Declarations ########################
|
|
class Mech;
|
|
|
|
//###########################################################################
|
|
//################# AmmoBin Model Resource ##############################
|
|
//###########################################################################
|
|
//
|
|
// Streamed by AmmoBin::CreateStreamedSubsystem @004bd6f0 (record size 0x104,
|
|
// classID 0x0BCB). The ammo-specific block sits at +0xF0 past the heat-watcher
|
|
// resource header. "AmmoClassID" accepts the symbolic forms "ProjectileClassID"
|
|
// (stamps 0x0BD1) and "MissileClassID" (stamps 0x0BBA), naming the entity class
|
|
// the bin spawns when a round is fired.
|
|
//
|
|
struct AmmoBin__SubsystemResource:
|
|
public HeatWatcher::SubsystemResource
|
|
{
|
|
int ammoClassID; // +0xF0 "AmmoClassID"/"ProjectileClassID"/"MissileClassID"
|
|
int ammoModelFile; // +0xF4 "AmmoModelFile" (resolved model index)
|
|
int explosionModelFile; // +0xF8 "ExplosionModelFile" (resolved model index)
|
|
int ammoCount; // +0xFC "AmmoCount"
|
|
Scalar feedRate; // +0x100 "FeedRate" (seconds per round feed)
|
|
}; // ends 0x104
|
|
static_assert(offsetof(AmmoBin__SubsystemResource, ammoClassID) == 0xF0, "AmmoBin ammoClassID must be at 0xF0");
|
|
static_assert(offsetof(AmmoBin__SubsystemResource, feedRate) == 0x100, "AmmoBin feedRate must be at 0x100");
|
|
static_assert(sizeof(AmmoBin__SubsystemResource) == 0x104, "AmmoBin record must be 0x104");
|
|
|
|
//###########################################################################
|
|
//######################### CLASS -- AmmoBin #########################
|
|
//###########################################################################
|
|
//
|
|
// (vtable @0051286c, ctor @004bd5c4, dtor @004bd6b0, CSS @004bd6f0.)
|
|
//
|
|
class AmmoBin:
|
|
public HeatWatcher
|
|
{
|
|
friend struct AmmoBinLayoutCheck; // compile-time offset locks (ammobin.cpp)
|
|
friend int *BTAmmoBinCountPtr(void *bin); // panel ammo counter bridge (Streak fix)
|
|
friend int BTAmmoBinFeeding(void *bin); // panel reload-state bridge
|
|
friend int BTAmmoRoundModelResource(void *bin); // splash-radius resolve (round GameModel +0x50)
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// Shared Data Support
|
|
//
|
|
public:
|
|
static Derivation ClassDerivations; // IsDerivedFrom tag 0x512488
|
|
static Receiver::MessageHandlerSet MessageHandlers;
|
|
static AttributeIndexSet AttributeIndex;
|
|
static SharedData DefaultData; // resolved as &DAT_005125bc
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// Ammo feed state machine (this->ammoAlarm @0x194, level @0x1A8 = word 0x6A)
|
|
//
|
|
// The 6-level AlarmIndicator carries the feed cycle. Levels confirmed from
|
|
// usage; 3 and 4 are unobserved.
|
|
//
|
|
public:
|
|
enum AmmoState {
|
|
Feeding = 0, // a round is in transit (feedTimer counting down)
|
|
Loaded = 1, // a round is chambered and ready to fire
|
|
Empty = 2, // no rounds remain
|
|
Dumped = 5 // transient pulse raised by DumpAmmo() before Empty
|
|
};
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// Model Support
|
|
//
|
|
public:
|
|
enum {
|
|
CookingOff = HeatWatcher::StateCount,
|
|
StateCount
|
|
};
|
|
|
|
// Attribute Support -- audio binds an AudioStateWatcher to AmmoState; it
|
|
// resolves to ammoAlarm (@0x194, a 0x54 StateIndicator-compatible alarm) so
|
|
// the feed/reload/empty audio fires on the AmmoState transition. The static
|
|
// AttributeIndex (ammobin.cpp) is now chained to HeatWatcher -- previously it
|
|
// was a bare, unchained index, so even SimulationState resolved to NULL.
|
|
enum {
|
|
AmmoStateAttributeID = HeatWatcher::NextAttributeID,
|
|
FireCountdownStartedAttributeID, // F18: the ammo COOK-OFF warning (binary
|
|
// AmmoBin table @0x512600 -> +0x18C); the 4
|
|
// authored start/stop match watchers gate the
|
|
// cook-off countdown klaxon on it
|
|
NextAttributeID
|
|
};
|
|
static const IndexEntry AttributePointers[];
|
|
|
|
typedef void
|
|
(AmmoBin::*Performance)(Scalar time_slice);
|
|
|
|
// @004bd394 -- the registered Performance. Drives the watch alarm, ticks
|
|
// the feed timer (Feeding -> Loaded), arms/fires the cook-off, and trips
|
|
// the Empty alarm when exhausted.
|
|
void
|
|
AmmoBinSimulation(Scalar time_slice);
|
|
|
|
void
|
|
SetPerformance(Performance performance)
|
|
{
|
|
Check(this);
|
|
activePerformance = (Simulation::Performance)performance;
|
|
}
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// Ammo feed interface (called by the linked ProjectileWeapon)
|
|
//
|
|
public:
|
|
// @004bd4f4 -- request one round. When Loaded: chamber the next round,
|
|
// reset the feed timer to feedRate, decrement ammoCount, and return the
|
|
// remaining count (Empty alarm raised at 0). Returns 0 if not ready /
|
|
// already feeding / empty / destroyed.
|
|
int
|
|
FeedAmmo();
|
|
|
|
// @004bd588 -- forcibly empty the bin (eject / strip): zero ammoCount and
|
|
// pulse the alarm Dumped(5) -> Empty(2).
|
|
void
|
|
DumpAmmo();
|
|
|
|
// The feed alarm's current level (this+0x1A8) -- the linked weapon's
|
|
// ProjectileWeaponSimulation @004bbd04 reads it raw off the resolved bin:
|
|
// gate 2 @4bbd80 (level 2/3 or bin destroyed -> weapon alarm 7), the
|
|
// Loading recoil-clamp Loaded test @4bbe25 (level 1 -> weapon Loaded), and
|
|
// the post-fire Empty test @4bbf11 (level 2 -> weapon alarm 7). Named
|
|
// accessor per the databinding rule (never a raw offset on our layout).
|
|
int
|
|
GetAmmoState() const { return ammoAlarm.GetLevel(); }
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// Subsystem virtual overrides (vtable @0051286c)
|
|
//
|
|
public:
|
|
Logical
|
|
HandleMessage(int message); // slot 8, @004bdb94
|
|
void
|
|
ReadUpdateRecord(UpdateRecord *update); // slot 9, @004bd2c0
|
|
void
|
|
ResetToInitialState(); // slot 10 (AMMOBIN.TCP: empty)
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// Local helpers
|
|
//
|
|
protected:
|
|
// @004bd300 -- cook-off: inject (ammoCount * heatPerRound) heat into the
|
|
// mech, then zero ammoCount and raise the Empty alarm.
|
|
void
|
|
CookOff();
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// TestClass Support (AMMOBIN.TCP)
|
|
//
|
|
public:
|
|
static Logical
|
|
TestClass(Mech &); // AMMOBIN.TCP: returns True
|
|
Logical
|
|
TestInstance() const; // @004bd1e0
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// Construction and Destruction
|
|
//
|
|
public:
|
|
typedef AmmoBin__SubsystemResource SubsystemResource;
|
|
|
|
AmmoBin( // @004bd5c4
|
|
Mech *owner,
|
|
int subsystem_ID,
|
|
SubsystemResource *subsystem_resource
|
|
);
|
|
~AmmoBin(); // @004bd6b0
|
|
|
|
static int
|
|
CreateStreamedSubsystem( // @004bd6f0 (record size 0x104)
|
|
NotationFile *model_file,
|
|
const char *model_name,
|
|
const char *subsystem_name,
|
|
SubsystemResource *subsystem_resource,
|
|
NotationFile *subsystem_file,
|
|
const ResourceDirectories *directories,
|
|
int passes = 1
|
|
);
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// Local data appended past the HeatWatcher base (offsets best-effort).
|
|
//
|
|
protected:
|
|
int ammoCount; // @0x180 (word 0x60) rounds remaining
|
|
Scalar feedTimer; // @0x184 (word 0x61) seconds left in current feed
|
|
int ammoClassID; // @0x188 (word 0x62) entity class spawned per round
|
|
int cookOffArmed; // @0x18C (word 0x63) cook-off timer running
|
|
int cookOffTime; // @0x190 (word 0x64) game clock at which it detonates
|
|
WatcherGaugeAlarm ammoAlarm; // @0x194 (0x54) 6-level feed alarm (level @0x1A8)
|
|
// (WAVE 4) `int statusState` DELETED -- it was a this+0x40 SHADOW of the
|
|
// inherited MechSubsystem::simulationState; the reads now use that base
|
|
// member. The 0x54 ammoAlarm (was an 8-byte HeatAlarm) lands ammoModelFile
|
|
// at 0x1E8 -- exact binary layout, locked by AmmoBinLayoutCheck.
|
|
int ammoModelFile; // @0x1E8 (word 0x7A) round model index
|
|
int explosionModelFile; // @0x1EC (word 0x7B) cook-off explosion model index
|
|
// @0x1F0 (word 0x7C) cook-off heat-injection descriptor, inited by
|
|
// FUN_0041db7c; CookOff() fills word 0x7D (@0x1F4) below with the total
|
|
// heat (ammoCount * heatPerRound) before injecting via HeatableSubsystem.
|
|
int cookOffHeatSource[1]; // @0x1F0 (word 0x7C)
|
|
Scalar heatPerRound; // @0x1F4 (word 0x7D)
|
|
int cookOffHeatRest[10]; // @0x1F8..0x21C (words 0x7E..0x87)
|
|
int initialAmmoCount; // @0x220 (word 0x88) ammoCount captured at ctor
|
|
Scalar feedRate; // @0x224 (word 0x89) resource FeedRate
|
|
int reserved; // @0x228 (word 0x8A) init 0 (unused)
|
|
};
|
|
#endif
|