arcattackandClaude Opus 4.8
7b7d465e5e
Clean, self-contained extraction of the BattleTech-specific work from the
reverse-engineering workspace -- engine + game + content + build, with nothing
from Red Planet or the raw archive dumps. Builds green (Win32) and runs the
single-player drive->animate->target->fire->damage->destroy loop out of the box.
Layout:
engine/ MUNGA + MUNGA_L4 shared 2007 engine, carrying our BT render/loader
work (bgfload/L4D3D/L4VIDEO: BSL bit-slice decode, LOD/ground/shadow
models) + image codec; the minimal rp/ headers the audio HAL needs
game/ reconstructed BT logic + surviving-original BT source + fwd shims
+ WinMain launcher
content/ full runtime tree (BTL4.RES, VIDEO/, GAUGE/, AUDIO/, eggs, BTDPL.INI)
docs/ format specs + reconstruction ledgers
reference/ raw Ghidra pseudocode (recon source-of-truth) + decomp exporter
tools/ MP console emulator + map/resource scanners
One top-level CMake builds munga_engine lib + bt410_l4 game lib + btl4.exe.
All paths relativized (186 fwd shims + ~437 CMake abs paths -> repo-relative);
DXSDK is the one external, overridable via -DDXSDK. Verified: builds to a
byte-identical 2.27MB exe and runs combat (TARGET DESTROYED, 0 crashes) against
the bundled content.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
221 lines
9.3 KiB
C++
221 lines
9.3 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
|
|
{
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// 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
|
|
};
|
|
|
|
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();
|
|
|
|
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
// 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
|
|
HeatAlarm ammoAlarm; // @0x194 (word 0x65) 6-level feed alarm (level @0x1A8)
|
|
int statusState; // base subsystem damage-state mirror (this+0x40)
|
|
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
|