mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-03-23 15:50:20 +00:00
116 lines
2.9 KiB
C++
116 lines
2.9 KiB
C++
#pragma once
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
#include <cstdint>
|
|
#include <memory>
|
|
#include <map>
|
|
#include <unordered_set>
|
|
#include <mutex>
|
|
|
|
// Forward declare StormLib handle
|
|
typedef void* HANDLE;
|
|
|
|
namespace wowee {
|
|
namespace pipeline {
|
|
|
|
/**
|
|
* MPQManager - Manages MPQ archive loading and file reading
|
|
*
|
|
* WoW 3.3.5a stores all game assets in MPQ archives.
|
|
* This manager loads multiple archives and provides unified file access.
|
|
*/
|
|
class MPQManager {
|
|
public:
|
|
MPQManager();
|
|
~MPQManager();
|
|
|
|
/**
|
|
* Initialize the MPQ system
|
|
* @param dataPath Path to WoW Data directory
|
|
* @return true if initialization succeeded
|
|
*/
|
|
bool initialize(const std::string& dataPath);
|
|
|
|
/**
|
|
* Shutdown and close all archives
|
|
*/
|
|
void shutdown();
|
|
|
|
/**
|
|
* Load a single MPQ archive
|
|
* @param path Full path to MPQ file
|
|
* @param priority Priority for file resolution (higher = checked first)
|
|
* @return true if archive loaded successfully
|
|
*/
|
|
bool loadArchive(const std::string& path, int priority = 0);
|
|
|
|
/**
|
|
* Check if a file exists in any loaded archive
|
|
* @param filename Virtual file path (e.g., "World\\Maps\\Azeroth\\Azeroth.wdt")
|
|
* @return true if file exists
|
|
*/
|
|
bool fileExists(const std::string& filename) const;
|
|
|
|
/**
|
|
* Read a file from MPQ archives
|
|
* @param filename Virtual file path
|
|
* @return File contents as byte vector (empty if not found)
|
|
*/
|
|
std::vector<uint8_t> readFile(const std::string& filename) const;
|
|
|
|
/**
|
|
* Get file size without reading it
|
|
* @param filename Virtual file path
|
|
* @return File size in bytes (0 if not found)
|
|
*/
|
|
uint32_t getFileSize(const std::string& filename) const;
|
|
|
|
/**
|
|
* Check if MPQ system is initialized
|
|
*/
|
|
bool isInitialized() const { return initialized; }
|
|
|
|
/**
|
|
* Get list of loaded archives
|
|
*/
|
|
const std::vector<std::string>& getLoadedArchives() const { return archiveNames; }
|
|
|
|
private:
|
|
struct ArchiveEntry {
|
|
HANDLE handle;
|
|
std::string path;
|
|
int priority;
|
|
};
|
|
|
|
bool initialized = false;
|
|
std::string dataPath;
|
|
std::vector<ArchiveEntry> archives;
|
|
std::vector<std::string> archiveNames;
|
|
|
|
/**
|
|
* Find archive containing a file
|
|
* @param filename File to search for
|
|
* @return Archive handle or nullptr if not found
|
|
*/
|
|
HANDLE findFileArchive(const std::string& filename) const;
|
|
|
|
/**
|
|
* Load patch archives (e.g., patch.MPQ, patch-2.MPQ, etc.)
|
|
*/
|
|
bool loadPatchArchives();
|
|
|
|
/**
|
|
* Load locale-specific archives
|
|
* @param locale Locale string (e.g., "enUS")
|
|
*/
|
|
bool loadLocaleArchives(const std::string& locale);
|
|
|
|
void logMissingFileOnce(const std::string& filename) const;
|
|
|
|
mutable std::mutex missingFileMutex_;
|
|
mutable std::unordered_set<std::string> missingFileWarnings_;
|
|
};
|
|
|
|
} // namespace pipeline
|
|
} // namespace wowee
|