Files
Dreierpack-Manager/src/game/bank_robbery.hpp
T
ClaudeandClaude Sonnet 5.5 287b5a9251 Add header comments to the source files
Every source file in ui, app, game, formats, cli, audio and launch that had none
now starts with a short English comment: what it implements, what state it owns
and how it relates to its neighbours (request/acknowledge flow, pairs of files,
random generator use). Comment lines only; the full build and the runnable
tests are unchanged.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-06 09:15:23 +01:00

40 lines
2.2 KiB
C++

// SPDX-License-Identifier: GPL-3.0-only
// Per-manager guard against repeated bank robbery events: one blocked month key per manager,
// stored in an OpenBMH-owned extension block of the static memory in GameState (not in the
// original save fields). The month key function is implemented in week.cpp.
// Header-only accessors; no random numbers are drawn.
#pragma once
#include "game/state.hpp"
#include <limits>
#include <optional>
namespace bmh {
// OpenBMH-owned OBMHEXT1 section BRM1: four little-endian blocked month-start keys.
// Unknown histories use UINT32_MAX; original save fields are not repurposed.
inline constexpr uint32_t kBankRobberyMonthExtension = 0x314d5242;
inline constexpr uint32_t kUnknownBankRobberyMonth = std::numeric_limits<uint32_t>::max();
inline constexpr uint32_t kBankRobberyMonthBytes = 16;
inline std::optional<uint32_t> bank_robbery_guard_month(const GameState& state, int manager) {
if (manager < 0 || manager > 3) throw FormatError("bank robbery: invalid manager");
if (!state.memory.has(kBankRobberyMonthExtension)) return {};
if (!state.memory.has(kBankRobberyMonthExtension + kBankRobberyMonthBytes - 1))
throw FormatError("bank robbery: truncated monthly guard");
const auto key = state.memory.u32(kBankRobberyMonthExtension + uint32_t(manager) * 4);
return key == kUnknownBankRobberyMonth ? std::nullopt : std::optional<uint32_t>{key};
}
inline void set_bank_robbery_guard_month(GameState& state, int manager, std::optional<uint32_t> key) {
if (manager < 0 || manager > 3) throw FormatError("bank robbery: invalid manager");
if (!state.memory.has(kBankRobberyMonthExtension)) {
state.memory.add_block(kBankRobberyMonthExtension, kBankRobberyMonthBytes);
for (uint32_t slot = 0; slot < 4; ++slot)
state.memory.set32(kBankRobberyMonthExtension + slot * 4, kUnknownBankRobberyMonth);
}
if (!state.memory.has(kBankRobberyMonthExtension + kBankRobberyMonthBytes - 1))
throw FormatError("bank robbery: truncated monthly guard");
state.memory.set32(kBankRobberyMonthExtension + uint32_t(manager) * 4, key.value_or(kUnknownBankRobberyMonth));
}
// The first absolute day of the source calendar month, distinct across years.
uint32_t bank_robbery_month_key(uint32_t date);
}