mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 08:00:42 +00:00
The repo was internally inconsistent: the LICENSE file is GPL v3 but every src/ header carried the LGPL v3 notice and the README said "LGPL v3 or later". LGPL was also the wrong fit — this is an injected mod plus a bundled addon, not a library other code links against, so LGPL's linking exception buys nothing. It's also required: src/voicechat/Tts.cpp is ported from awesome_wotlk's VoiceChat.cpp, which is GPL v3, and a derivative of GPL code cannot be relicensed under more permissive terms. Dependencies stay compatible — MinHook (BSD-2) and the nampower-mirrored packet shapes (BSD) are GPL-compatible, and SAPI is covered by the system-library exception. Swept "GNU Lesser General Public License" -> "GNU General Public License" across all 257 src/ headers and changed the README license line to match the GPL v3 LICENSE file. Comment-only; no build impact.
45 lines
1.8 KiB
C++
45 lines
1.8 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/>.
|
|
|
|
#pragma once
|
|
|
|
#include <cstdint>
|
|
|
|
namespace Item::Charges {
|
|
|
|
// Pushes the total uses available in this single slot — the
|
|
// per-slot equivalent of `GetItemCount(_, _, includeCharges=true)`.
|
|
// Returns `1` (pushed one value) on success, `0` (pushes nothing,
|
|
// caller surfaces as `nil`) when the item is missing or the
|
|
// descriptor is null.
|
|
//
|
|
// Math is `stack * usesPerItem` where `usesPerItem` follows
|
|
// `Item::Count::GetUsesPerItem`:
|
|
// - `SPELL_CHARGES[0] >= 0` → `1` (no destroy-on-zero behavior;
|
|
// stack count alone reflects "how many uses").
|
|
// - `SPELL_CHARGES[0] < 0` → `abs(value)` (consume-on-use items;
|
|
// wand at 50 has `-50` so each item contributes 50).
|
|
//
|
|
// Worked examples:
|
|
// - Wand at 50 charges (stack=1, raw=-50): `1 * 50 = 50`
|
|
// - Hearthstone (stack=1, raw=0): `1 * 1 = 1` (cooldown-
|
|
// only, no charges concept; we still surface "1 use").
|
|
// - Water stack of 20 (stack=20, raw=-1): `20 * 1 = 20`
|
|
// - Equipped sword (stack=1, raw=0): `1 * 1 = 1`
|
|
//
|
|
// Caller can `return PushChargesForItem(L, item);` to forward the
|
|
// count directly.
|
|
int PushChargesForItem(void *L, const uint8_t *item);
|
|
|
|
} // namespace Item::Charges
|