// 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 . // Embedded addons. When the user doesn't have an addon installed on disk, // this module makes the engine think they do — without writing anything // to the filesystem. The addons are `Manifest::kAddons` (the `ADDONS` // list in CMakeLists.txt): `!!!ClassicAPI`, which loads at login, and // `ClassicAPI_DebugTools` and `ClassicAPI_EventTrace`, which are // `## LoadOnDemand` behind the `/dump` / `/fstack` / `/etrace` stubs in // `!!!ClassicAPI` — retail's chat-frame + Blizzard_DebugTools / // Blizzard_EventTrace split. (The `Blizzard_` name is not // available to us: the engine moves loose `Interface\AddOns\Blizzard*` // folders aside at startup, `MoveAsideLooseInterface`, and refuses a // `Blizzard_*` TOC without a signature.) // // How: // // 1. The CMake build embeds each listed addon as one RCDATA resource, // a gzipped pack of its files, plus a generated // `{path, resourceId, index}` manifest (`embedded_resources.h`). // // 2. We hook the engine's file-read function at `FUN_FILE_READ`. // When the engine asks for a path under // `Interface\AddOns\\`, we allocate a Storm buffer // via the same allocator the engine itself uses, copy the // embedded content in, and hand it back. The caller's normal // `SMemFree` reclaims it on completion — no special lifetime. // A TOC then goes through `AddOns::TocRewrite`, as an installed // addon's does, so its file lines can carry `[AllowLoadGameType ...]` // / `[ExcludeLoadGameType ...]` conditions. // // 3. We hook the exists-check `FUN_FILE_EXISTS` so it answers the same // way for the same paths. Without it every embedded file reads fine // but reports as missing — the per-addon loader would skip an // embedded `Bindings.xml`, and `Xml::ScriptPath` would never find an // embedded `