mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 08:00:42 +00:00
Returns the health deficit -- the equivalent of UnitHealthMax(unit) - UnitHealth(unit) -- in one native call, so healing addons don't call both engine getters and subtract in Lua every frame. One token resolve + two descriptor field reads (HEALTH +0x40, MAXHEALTH +0x58); no display divisor (health is stored at face value), clamped at 0. Tracks the engine's own UnitHealth/UnitHealthMax exactly in both forms: real values (player 3600-1 = 3599) and vanilla's percentage form for non-grouped units (target 100-85 = 15). Returns 0 for a valid-but-absent unit, matching UnitHealth's convention.
80 lines
3.0 KiB
C++
80 lines
3.0 KiB
C++
// This file is part of ClassicAPI.
|
|
//
|
|
// ClassicAPI is free software: you can redistribute it and/or modify it under the terms
|
|
// of the GNU General Public License as published by the Free Software Foundation, either
|
|
// version 3 of the License, or (at your option) any later version.
|
|
//
|
|
// ClassicAPI is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
// WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
// PURPOSE. See the GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License along with
|
|
// ClassicAPI. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
// `UnitHealthMissing(unit)` — the health deficit, i.e. the equivalent of
|
|
// `UnitHealthMax(unit) - UnitHealth(unit)`. A convenience for healing addons
|
|
// (overheal checks, "missing health" bars) that otherwise call both engine
|
|
// functions and subtract in Lua every frame. Reads the two health fields off
|
|
// the unit's descriptor directly (same path `Unit::Power` uses for POWER),
|
|
// so it's a single resolve + two field reads.
|
|
//
|
|
// Health carries no display divisor — unlike rage/happiness, HEALTH and
|
|
// MAXHEALTH are stored at face value — so the deficit is a plain subtraction,
|
|
// clamped at 0 (a transient current > max should never surface as negative).
|
|
|
|
#include "Game.h"
|
|
#include "Offsets.h"
|
|
|
|
#include <cstdint>
|
|
|
|
namespace Unit::Health {
|
|
|
|
namespace {
|
|
|
|
using ResolveUnitToken_t = void *(__fastcall *)(const char *token);
|
|
|
|
const uint8_t *Descriptor(const uint8_t *unit) {
|
|
if (unit == nullptr)
|
|
return nullptr;
|
|
return *reinterpret_cast<const uint8_t *const *>(
|
|
unit + Offsets::OFF_CGUNIT_OBJECT_FIELDS);
|
|
}
|
|
|
|
const uint8_t *ResolveUnit(const char *token) {
|
|
if (token == nullptr)
|
|
return nullptr;
|
|
auto fn = reinterpret_cast<ResolveUnitToken_t>(Offsets::FUN_RESOLVE_UNIT_TOKEN);
|
|
return static_cast<const uint8_t *>(fn(token));
|
|
}
|
|
|
|
// `UnitHealthMissing("unit")` — returns `max - current` health (never
|
|
// negative). Returns 0 for a valid-but-absent unit (e.g. `"target"` with no
|
|
// target), matching `UnitHealth`'s 0-for-missing convention.
|
|
static int __fastcall Script_UnitHealthMissing(void *L) {
|
|
if (!Game::Lua::IsString(L, 1)) {
|
|
Game::Lua::Error(L, "Usage: UnitHealthMissing(\"unit\")");
|
|
return 0;
|
|
}
|
|
const uint8_t *desc = Descriptor(ResolveUnit(Game::Lua::ToString(L, 1)));
|
|
if (desc == nullptr) {
|
|
Game::Lua::PushNumber(L, 0.0);
|
|
return 1;
|
|
}
|
|
const uint32_t cur = *reinterpret_cast<const uint32_t *>(
|
|
desc + Offsets::OFF_UNIT_FIELD_HEALTH);
|
|
const uint32_t max = *reinterpret_cast<const uint32_t *>(
|
|
desc + Offsets::OFF_UNIT_FIELD_MAXHEALTH);
|
|
Game::Lua::PushNumber(L, static_cast<double>(max > cur ? max - cur : 0u));
|
|
return 1;
|
|
}
|
|
|
|
static void RegisterLuaFunctions() {
|
|
Game::Lua::RegisterGlobalFunction("UnitHealthMissing", &Script_UnitHealthMissing);
|
|
}
|
|
|
|
static const Game::ModuleAutoRegister _autoreg{&RegisterLuaFunctions};
|
|
|
|
} // namespace
|
|
|
|
} // namespace Unit::Health
|