mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 08:00:42 +00:00
`C_Spell.CastAtUnit(spellID, unit)` and `C_Item.UseAtUnit(itemInfo,
unit)` are the unit-position analogs of the existing `…AtCursor` pair:
they commit the engine's in-flight ground-target placement at the
resolved unit's world position instead of the cursor raycast.
ClassicAPI's `/cast [@unit]` / `[@unit]` for AoE reticle spells and
on-use items. Verified in-game against "player", "target", and
"nameplate1".
Implementation reuses the cursor path's placement primitives:
- Extracted `Spell::AtCursor::DispatchSpellCast` + `CommitAtCoords`
(explicit-coords commit, sharing the same placement-ready gate as
the cursor `Resolve`).
- New header-only `Unit::Position` (vtable slot-5 `GetPosition` read);
migrated `UnitInRange` onto it to drop the duplicate copy.
The unit is resolved before the cast/use is dispatched, so an absent
unit fails cleanly without arming placement mode or consuming the
item. Unknown token strings raise the engine's standard "Unknown unit"
error, matching `UnitHealth("garbage")`.
91 lines
3.1 KiB
C++
91 lines
3.1 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 Lesser 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 Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public License along with
|
|
// ClassicAPI. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
// `C_Item.UseAtUnit(itemInfo, unit)` — use the named item at the given
|
|
// unit's feet. For items whose on-use spell is ground-target (Iron
|
|
// Grenade, demolition charges, etc.), bypasses the manual click on the
|
|
// AoE reticle. `UseAtUnit(itemInfo, "target")` drops the reticle at
|
|
// the target's position.
|
|
//
|
|
// Unit-position analog of `C_Item.UseAtCursor` — same bag-walk +
|
|
// `FUN_ITEM_USE` dispatch, but the placement is committed at the
|
|
// unit's world position (via `Spell::AtCursor::CommitAtCoords`)
|
|
// instead of the cursor raycast.
|
|
//
|
|
// Returns `true` when the placement landed at the unit; `false` for
|
|
// non-ground-target items (the item still fires, no implicit target),
|
|
// unparseable input, item-not-in-bags, or an unresolvable unit.
|
|
|
|
#include "Game.h"
|
|
#include "Offsets.h"
|
|
#include "item/Arg.h"
|
|
#include "item/Location.h"
|
|
#include "spell/AtCursor.h"
|
|
#include "unit/Position.h"
|
|
|
|
#include <cstdint>
|
|
|
|
namespace Item::UseAtUnit {
|
|
|
|
namespace {
|
|
|
|
using UseItem_t = unsigned(__thiscall *)(const void *item, const uint64_t *targetGuid,
|
|
int flag);
|
|
|
|
int __fastcall Script_C_Item_UseAtUnit(void *L) {
|
|
const auto arg = Item::Arg::Resolve(L, 1);
|
|
if (arg.itemID <= 0 && arg.name == nullptr) {
|
|
Game::Lua::PushBool(L, false);
|
|
return 1;
|
|
}
|
|
if (!Game::Lua::IsString(L, 2)) {
|
|
Game::Lua::PushBool(L, false);
|
|
return 1;
|
|
}
|
|
const char *token = Game::Lua::ToString(L, 2);
|
|
|
|
// Resolve the unit position first — fail fast before firing the
|
|
// item if the unit is absent. (FindByArgInBags below stomps the
|
|
// Lua stack, so read the token argument before that runs.)
|
|
float pos[3];
|
|
if (!Unit::Position::ReadToken(token, pos)) {
|
|
Game::Lua::PushBool(L, false);
|
|
return 1;
|
|
}
|
|
|
|
Item::Location::ByGUIDResult found;
|
|
if (!Item::Location::FindByArgInBags(L, arg, &found)) {
|
|
Game::Lua::PushBool(L, false);
|
|
return 1;
|
|
}
|
|
|
|
const uint64_t zeroTarget = 0;
|
|
auto useItem = reinterpret_cast<UseItem_t>(Offsets::FUN_ITEM_USE);
|
|
useItem(found.item, &zeroTarget, 0);
|
|
|
|
const bool placed = Spell::AtCursor::CommitAtCoords(pos);
|
|
Game::Lua::PushBool(L, placed);
|
|
return 1;
|
|
}
|
|
|
|
void RegisterLuaFunctions() {
|
|
Game::Lua::RegisterTableFunction("C_Item", "UseAtUnit",
|
|
&Script_C_Item_UseAtUnit);
|
|
}
|
|
|
|
const Game::ModuleAutoRegister _autoreg{&RegisterLuaFunctions};
|
|
|
|
} // namespace
|
|
|
|
} // namespace Item::UseAtUnit
|