2026-03-20 11:12:07 -07:00
|
|
|
#include "addons/lua_engine.hpp"
|
|
|
|
|
#include "game/game_handler.hpp"
|
feat: add core WoW Lua API functions for addon development
Add 13 WoW-compatible Lua API functions that addons can call:
Unit API: UnitName, UnitHealth, UnitHealthMax, UnitPower, UnitPowerMax,
UnitLevel, UnitExists, UnitIsDead, UnitClass (supports "player",
"target", "focus", "pet" unit IDs)
Game API: GetMoney, IsInGroup, IsInRaid, GetPlayerMapPosition
Updated HelloWorld addon to demonstrate querying player state.
2026-03-20 11:17:15 -07:00
|
|
|
#include "game/entity.hpp"
|
2026-03-20 11:12:07 -07:00
|
|
|
#include "core/logger.hpp"
|
|
|
|
|
|
|
|
|
|
extern "C" {
|
|
|
|
|
#include <lua.h>
|
|
|
|
|
#include <lauxlib.h>
|
|
|
|
|
#include <lualib.h>
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
namespace wowee::addons {
|
|
|
|
|
|
|
|
|
|
// Retrieve GameHandler pointer stored in Lua registry
|
|
|
|
|
static game::GameHandler* getGameHandler(lua_State* L) {
|
|
|
|
|
lua_getfield(L, LUA_REGISTRYINDEX, "wowee_game_handler");
|
|
|
|
|
auto* gh = static_cast<game::GameHandler*>(lua_touserdata(L, -1));
|
|
|
|
|
lua_pop(L, 1);
|
|
|
|
|
return gh;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// WoW-compatible print() — outputs to chat window instead of stdout
|
|
|
|
|
static int lua_wow_print(lua_State* L) {
|
|
|
|
|
int nargs = lua_gettop(L);
|
|
|
|
|
std::string result;
|
|
|
|
|
for (int i = 1; i <= nargs; i++) {
|
|
|
|
|
if (i > 1) result += '\t';
|
|
|
|
|
// Lua 5.1: use lua_tostring (luaL_tolstring is 5.3+)
|
|
|
|
|
if (lua_isstring(L, i) || lua_isnumber(L, i)) {
|
|
|
|
|
const char* s = lua_tostring(L, i);
|
|
|
|
|
if (s) result += s;
|
|
|
|
|
} else if (lua_isboolean(L, i)) {
|
|
|
|
|
result += lua_toboolean(L, i) ? "true" : "false";
|
|
|
|
|
} else if (lua_isnil(L, i)) {
|
|
|
|
|
result += "nil";
|
|
|
|
|
} else {
|
|
|
|
|
result += lua_typename(L, lua_type(L, i));
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
auto* gh = getGameHandler(L);
|
|
|
|
|
if (gh) {
|
|
|
|
|
game::MessageChatData msg;
|
|
|
|
|
msg.type = game::ChatType::SYSTEM;
|
|
|
|
|
msg.language = game::ChatLanguage::UNIVERSAL;
|
|
|
|
|
msg.message = result;
|
|
|
|
|
gh->addLocalChatMessage(msg);
|
|
|
|
|
}
|
|
|
|
|
LOG_INFO("[Lua] ", result);
|
|
|
|
|
return 0;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// WoW-compatible message() — same as print for now
|
|
|
|
|
static int lua_wow_message(lua_State* L) {
|
|
|
|
|
return lua_wow_print(L);
|
|
|
|
|
}
|
|
|
|
|
|
feat: add core WoW Lua API functions for addon development
Add 13 WoW-compatible Lua API functions that addons can call:
Unit API: UnitName, UnitHealth, UnitHealthMax, UnitPower, UnitPowerMax,
UnitLevel, UnitExists, UnitIsDead, UnitClass (supports "player",
"target", "focus", "pet" unit IDs)
Game API: GetMoney, IsInGroup, IsInRaid, GetPlayerMapPosition
Updated HelloWorld addon to demonstrate querying player state.
2026-03-20 11:17:15 -07:00
|
|
|
// Helper: get player Unit from game handler
|
|
|
|
|
static game::Unit* getPlayerUnit(lua_State* L) {
|
|
|
|
|
auto* gh = getGameHandler(L);
|
|
|
|
|
if (!gh) return nullptr;
|
|
|
|
|
auto entity = gh->getEntityManager().getEntity(gh->getPlayerGuid());
|
|
|
|
|
if (!entity) return nullptr;
|
|
|
|
|
return dynamic_cast<game::Unit*>(entity.get());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// Helper: resolve "player", "target", "focus", "pet" unit IDs to entity
|
|
|
|
|
static game::Unit* resolveUnit(lua_State* L, const char* unitId) {
|
|
|
|
|
auto* gh = getGameHandler(L);
|
|
|
|
|
if (!gh || !unitId) return nullptr;
|
|
|
|
|
std::string uid(unitId);
|
|
|
|
|
for (char& c : uid) c = static_cast<char>(std::tolower(static_cast<unsigned char>(c)));
|
|
|
|
|
|
|
|
|
|
uint64_t guid = 0;
|
|
|
|
|
if (uid == "player") guid = gh->getPlayerGuid();
|
|
|
|
|
else if (uid == "target") guid = gh->getTargetGuid();
|
|
|
|
|
else if (uid == "focus") guid = gh->getFocusGuid();
|
|
|
|
|
else if (uid == "pet") guid = gh->getPetGuid();
|
|
|
|
|
else return nullptr;
|
|
|
|
|
|
|
|
|
|
if (guid == 0) return nullptr;
|
|
|
|
|
auto entity = gh->getEntityManager().getEntity(guid);
|
|
|
|
|
if (!entity) return nullptr;
|
|
|
|
|
return dynamic_cast<game::Unit*>(entity.get());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// --- WoW Unit API ---
|
|
|
|
|
|
|
|
|
|
static int lua_UnitName(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
if (unit && !unit->getName().empty()) {
|
|
|
|
|
lua_pushstring(L, unit->getName().c_str());
|
|
|
|
|
} else {
|
|
|
|
|
lua_pushstring(L, "Unknown");
|
|
|
|
|
}
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_UnitHealth(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
lua_pushnumber(L, unit ? unit->getHealth() : 0);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_UnitHealthMax(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
lua_pushnumber(L, unit ? unit->getMaxHealth() : 0);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_UnitPower(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
lua_pushnumber(L, unit ? unit->getPower() : 0);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_UnitPowerMax(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
lua_pushnumber(L, unit ? unit->getMaxPower() : 0);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_UnitLevel(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
lua_pushnumber(L, unit ? unit->getLevel() : 0);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_UnitExists(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
lua_pushboolean(L, unit != nullptr);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_UnitIsDead(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
lua_pushboolean(L, unit && unit->getHealth() == 0);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_UnitClass(lua_State* L) {
|
|
|
|
|
const char* uid = luaL_optstring(L, 1, "player");
|
|
|
|
|
auto* gh = getGameHandler(L);
|
|
|
|
|
auto* unit = resolveUnit(L, uid);
|
|
|
|
|
if (unit && gh) {
|
|
|
|
|
static const char* kClasses[] = {"", "Warrior","Paladin","Hunter","Rogue","Priest",
|
|
|
|
|
"Death Knight","Shaman","Mage","Warlock","","Druid"};
|
|
|
|
|
uint8_t classId = 0;
|
|
|
|
|
// For player, use character data; for others, use UNIT_FIELD_BYTES_0
|
|
|
|
|
std::string uidStr(uid);
|
|
|
|
|
for (char& c : uidStr) c = static_cast<char>(std::tolower(static_cast<unsigned char>(c)));
|
|
|
|
|
if (uidStr == "player") classId = gh->getPlayerClass();
|
|
|
|
|
const char* name = (classId < 12) ? kClasses[classId] : "Unknown";
|
|
|
|
|
lua_pushstring(L, name);
|
|
|
|
|
lua_pushstring(L, name); // WoW returns localized + English
|
|
|
|
|
lua_pushnumber(L, classId);
|
|
|
|
|
return 3;
|
|
|
|
|
}
|
|
|
|
|
lua_pushstring(L, "Unknown");
|
|
|
|
|
lua_pushstring(L, "Unknown");
|
|
|
|
|
lua_pushnumber(L, 0);
|
|
|
|
|
return 3;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// --- Player/Game API ---
|
|
|
|
|
|
|
|
|
|
static int lua_GetMoney(lua_State* L) {
|
|
|
|
|
auto* gh = getGameHandler(L);
|
|
|
|
|
lua_pushnumber(L, gh ? static_cast<double>(gh->getMoneyCopper()) : 0.0);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_IsInGroup(lua_State* L) {
|
|
|
|
|
auto* gh = getGameHandler(L);
|
|
|
|
|
lua_pushboolean(L, gh && gh->isInGroup());
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_IsInRaid(lua_State* L) {
|
|
|
|
|
auto* gh = getGameHandler(L);
|
|
|
|
|
lua_pushboolean(L, gh && gh->isInGroup() && gh->getPartyData().groupType == 1);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
static int lua_GetPlayerMapPosition(lua_State* L) {
|
|
|
|
|
auto* gh = getGameHandler(L);
|
|
|
|
|
if (gh) {
|
|
|
|
|
const auto& mi = gh->getMovementInfo();
|
|
|
|
|
lua_pushnumber(L, mi.x);
|
|
|
|
|
lua_pushnumber(L, mi.y);
|
|
|
|
|
return 2;
|
|
|
|
|
}
|
|
|
|
|
lua_pushnumber(L, 0);
|
|
|
|
|
lua_pushnumber(L, 0);
|
|
|
|
|
return 2;
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-20 11:12:07 -07:00
|
|
|
// Stub for GetTime() — returns elapsed seconds
|
|
|
|
|
static int lua_wow_gettime(lua_State* L) {
|
|
|
|
|
static auto start = std::chrono::steady_clock::now();
|
|
|
|
|
auto now = std::chrono::steady_clock::now();
|
|
|
|
|
double elapsed = std::chrono::duration<double>(now - start).count();
|
|
|
|
|
lua_pushnumber(L, elapsed);
|
|
|
|
|
return 1;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
LuaEngine::LuaEngine() = default;
|
|
|
|
|
|
|
|
|
|
LuaEngine::~LuaEngine() {
|
|
|
|
|
shutdown();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
bool LuaEngine::initialize() {
|
|
|
|
|
if (L_) return true;
|
|
|
|
|
|
|
|
|
|
L_ = luaL_newstate();
|
|
|
|
|
if (!L_) {
|
|
|
|
|
LOG_ERROR("LuaEngine: failed to create Lua state");
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// Open safe standard libraries (no io, os, debug, package)
|
|
|
|
|
luaopen_base(L_);
|
|
|
|
|
luaopen_table(L_);
|
|
|
|
|
luaopen_string(L_);
|
|
|
|
|
luaopen_math(L_);
|
|
|
|
|
|
|
|
|
|
// Remove unsafe globals from base library
|
|
|
|
|
const char* unsafeGlobals[] = {
|
|
|
|
|
"dofile", "loadfile", "load", "collectgarbage", "newproxy", nullptr
|
|
|
|
|
};
|
|
|
|
|
for (const char** g = unsafeGlobals; *g; ++g) {
|
|
|
|
|
lua_pushnil(L_);
|
|
|
|
|
lua_setglobal(L_, *g);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
registerCoreAPI();
|
|
|
|
|
|
|
|
|
|
LOG_INFO("LuaEngine: initialized (Lua 5.1)");
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
void LuaEngine::shutdown() {
|
|
|
|
|
if (L_) {
|
|
|
|
|
lua_close(L_);
|
|
|
|
|
L_ = nullptr;
|
|
|
|
|
LOG_INFO("LuaEngine: shut down");
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
void LuaEngine::setGameHandler(game::GameHandler* handler) {
|
|
|
|
|
gameHandler_ = handler;
|
|
|
|
|
if (L_) {
|
|
|
|
|
lua_pushlightuserdata(L_, handler);
|
|
|
|
|
lua_setfield(L_, LUA_REGISTRYINDEX, "wowee_game_handler");
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
void LuaEngine::registerCoreAPI() {
|
|
|
|
|
// Override print() to go to chat
|
|
|
|
|
lua_pushcfunction(L_, lua_wow_print);
|
|
|
|
|
lua_setglobal(L_, "print");
|
|
|
|
|
|
|
|
|
|
// WoW API stubs
|
|
|
|
|
lua_pushcfunction(L_, lua_wow_message);
|
|
|
|
|
lua_setglobal(L_, "message");
|
|
|
|
|
|
|
|
|
|
lua_pushcfunction(L_, lua_wow_gettime);
|
|
|
|
|
lua_setglobal(L_, "GetTime");
|
feat: add core WoW Lua API functions for addon development
Add 13 WoW-compatible Lua API functions that addons can call:
Unit API: UnitName, UnitHealth, UnitHealthMax, UnitPower, UnitPowerMax,
UnitLevel, UnitExists, UnitIsDead, UnitClass (supports "player",
"target", "focus", "pet" unit IDs)
Game API: GetMoney, IsInGroup, IsInRaid, GetPlayerMapPosition
Updated HelloWorld addon to demonstrate querying player state.
2026-03-20 11:17:15 -07:00
|
|
|
|
|
|
|
|
// Unit API
|
|
|
|
|
static const struct { const char* name; lua_CFunction func; } unitAPI[] = {
|
|
|
|
|
{"UnitName", lua_UnitName},
|
|
|
|
|
{"UnitHealth", lua_UnitHealth},
|
|
|
|
|
{"UnitHealthMax", lua_UnitHealthMax},
|
|
|
|
|
{"UnitPower", lua_UnitPower},
|
|
|
|
|
{"UnitPowerMax", lua_UnitPowerMax},
|
|
|
|
|
{"UnitLevel", lua_UnitLevel},
|
|
|
|
|
{"UnitExists", lua_UnitExists},
|
|
|
|
|
{"UnitIsDead", lua_UnitIsDead},
|
|
|
|
|
{"UnitClass", lua_UnitClass},
|
|
|
|
|
{"GetMoney", lua_GetMoney},
|
|
|
|
|
{"IsInGroup", lua_IsInGroup},
|
|
|
|
|
{"IsInRaid", lua_IsInRaid},
|
|
|
|
|
{"GetPlayerMapPosition", lua_GetPlayerMapPosition},
|
|
|
|
|
};
|
|
|
|
|
for (const auto& [name, func] : unitAPI) {
|
|
|
|
|
lua_pushcfunction(L_, func);
|
|
|
|
|
lua_setglobal(L_, name);
|
|
|
|
|
}
|
2026-03-20 11:12:07 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
bool LuaEngine::executeFile(const std::string& path) {
|
|
|
|
|
if (!L_) return false;
|
|
|
|
|
|
|
|
|
|
int err = luaL_dofile(L_, path.c_str());
|
|
|
|
|
if (err != 0) {
|
|
|
|
|
const char* errMsg = lua_tostring(L_, -1);
|
|
|
|
|
std::string msg = errMsg ? errMsg : "(unknown error)";
|
|
|
|
|
LOG_ERROR("LuaEngine: error loading '", path, "': ", msg);
|
|
|
|
|
if (gameHandler_) {
|
|
|
|
|
game::MessageChatData errChat;
|
|
|
|
|
errChat.type = game::ChatType::SYSTEM;
|
|
|
|
|
errChat.language = game::ChatLanguage::UNIVERSAL;
|
|
|
|
|
errChat.message = "|cffff4040[Lua Error] " + msg + "|r";
|
|
|
|
|
gameHandler_->addLocalChatMessage(errChat);
|
|
|
|
|
}
|
|
|
|
|
lua_pop(L_, 1);
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
bool LuaEngine::executeString(const std::string& code) {
|
|
|
|
|
if (!L_) return false;
|
|
|
|
|
|
|
|
|
|
int err = luaL_dostring(L_, code.c_str());
|
|
|
|
|
if (err != 0) {
|
|
|
|
|
const char* errMsg = lua_tostring(L_, -1);
|
|
|
|
|
std::string msg = errMsg ? errMsg : "(unknown error)";
|
|
|
|
|
LOG_ERROR("LuaEngine: script error: ", msg);
|
|
|
|
|
if (gameHandler_) {
|
|
|
|
|
game::MessageChatData errChat;
|
|
|
|
|
errChat.type = game::ChatType::SYSTEM;
|
|
|
|
|
errChat.language = game::ChatLanguage::UNIVERSAL;
|
|
|
|
|
errChat.message = "|cffff4040[Lua Error] " + msg + "|r";
|
|
|
|
|
gameHandler_->addLocalChatMessage(errChat);
|
|
|
|
|
}
|
|
|
|
|
lua_pop(L_, 1);
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
} // namespace wowee::addons
|