\n"); return 1; } if (std::strcmp(argv[i], "--add-quest-objective") == 0 && i + 4 >= argc) { std::fprintf(stderr, "--add-quest-objective requires <zoneDir> <questIdx> <type> <targetName>\n"); return 1; } if (std::strcmp(argv[i], "--remove-quest-objective") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--remove-quest-objective requires <zoneDir> <questIdx> <objIdx>\n"); return 1; } if (std::strcmp(argv[i], "--clone-quest") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--clone-quest requires <zoneDir> <questIdx>\n"); return 1; } if (std::strcmp(argv[i], "--clone-creature") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--clone-creature requires <zoneDir> <idx>\n"); return 1; } if (std::strcmp(argv[i], "--clone-object") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--clone-object requires <zoneDir> <idx>\n"); return 1; } if (std::strcmp(argv[i], "--add-quest-reward-item") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--add-quest-reward-item requires <zoneDir> <questIdx> <itemPath>\n"); return 1; } if (std::strcmp(argv[i], "--set-quest-reward") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--set-quest-reward requires <zoneDir> <questIdx> [--xp N] [--gold N] [--silver N] [--copper N]\n"); return 1; } if (std::strcmp(argv[i], "--add-tile") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--add-tile requires <zoneDir> <tx> <ty>\n"); return 1; } if (std::strcmp(argv[i], "--remove-tile") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--remove-tile requires <zoneDir> <tx> <ty>\n"); return 1; } if (std::strcmp(argv[i], "--copy-zone") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--copy-zone requires <srcDir> <newName>\n"); return 1; } if (std::strcmp(argv[i], "--rename-zone") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--rename-zone requires <srcDir> <newName>\n"); return 1; } for (const char* opt : {"--remove-creature", "--remove-object", "--remove-quest"}) { if (std::strcmp(argv[i], opt) == 0 && i + 2 >= argc) { std::fprintf(stderr, "%s requires <zoneDir> <index>\n", opt); return 1; } } } for (int i = 1; i < argc; i++) { // Modular handler families: extracted from the in-line if/else // chain below to keep main.cpp from sprawling further. Each // family lives in its own .cpp; if it matches argv[i] it // sets outRc and we exit. Otherwise fall through to the // legacy in-line dispatch. { int outRc = 0; if (wowee::editor::cli::handleGenAudio(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleZonePacks(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleAudits(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleReadmes(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleZoneInventory(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleProjectInventory(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleGenTexture(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleGenMesh(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleMeshIO(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleMeshEdit(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleWomInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleFormatValidate(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleConvert(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleFormatInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handlePack(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleContentInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleZoneInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleDataTree(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleDiff(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleSpawnAudit(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleItems(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleExtractInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleExport(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleBake(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleMigrate(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleConvertSingle(i, argc, argv, dataPath, outRc)) { return outRc; } if (wowee::editor::cli::handleValidateInterop(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleGlbInspect(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleWomIo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleWorldIo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoTree(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoBytes(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoExtents(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoWater(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoDensity(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoAudio(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleWorldInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleQuestObjective(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleQuestReward(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleClone(i, argc, argv, outRc)) { return outRc; } } if (std::strcmp(argv[i], "--data") == 0 && i + 1 < argc) { dataPath = argv[++i]; } else if (std::strcmp(argv[i], "--adt") == 0 && i + 3 < argc) { adtMap = argv[++i]; adtX = std::atoi(argv[++i]); adtY = std::atoi(argv[++i]); } else if (std::strcmp(argv[i], "--info-zone-models-total") == 0 && i + 1 < argc) { // Aggregate WOM/WOB stats across every model in a zone. // Useful for capacity planning ('how many bones across all // my creatures?') and perf budgeting ('total triangles // per frame if all loaded?'). std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "info-zone-models-total: %s does not exist\n", zoneDir.c_str()); return 1; } int womCount = 0, wobCount = 0; uint64_t womVerts = 0, womIndices = 0; uint64_t womBones = 0, womAnims = 0, womBatches = 0; uint64_t wobGroups = 0, wobVerts = 0, wobIndices = 0; uint64_t wobDoodads = 0, wobPortals = 0; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); std::string base = e.path().string(); if (base.size() > ext.size()) base = base.substr(0, base.size() - ext.size()); if (ext == ".wom") { womCount++; auto wom = wowee::pipeline::WoweeModelLoader::load(base); womVerts += wom.vertices.size(); womIndices += wom.indices.size(); womBones += wom.bones.size(); womAnims += wom.animations.size(); womBatches += wom.batches.size(); } else if (ext == ".wob") { wobCount++; auto wob = wowee::pipeline::WoweeBuildingLoader::load(base); wobGroups += wob.groups.size(); for (const auto& g : wob.groups) { wobVerts += g.vertices.size(); wobIndices += g.indices.size(); } wobDoodads += wob.doodads.size(); wobPortals += wob.portals.size(); } } if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["wom"] = {{"count", womCount}, {"vertices", womVerts}, {"indices", womIndices}, {"triangles", womIndices / 3}, {"bones", womBones}, {"animations", womAnims}, {"batches", womBatches}}; j["wob"] = {{"count", wobCount}, {"groups", wobGroups}, {"vertices", wobVerts}, {"indices", wobIndices}, {"triangles", wobIndices / 3}, {"doodads", wobDoodads}, {"portals", wobPortals}}; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone models total: %s\n", zoneDir.c_str()); std::printf("\n WOM (open M2):\n"); std::printf(" files : %d\n", womCount); std::printf(" vertices : %llu\n", static_cast<unsigned long long>(womVerts)); std::printf(" triangles : %llu\n", static_cast<unsigned long long>(womIndices / 3)); std::printf(" bones : %llu\n", static_cast<unsigned long long>(womBones)); std::printf(" anims : %llu\n", static_cast<unsigned long long>(womAnims)); std::printf(" batches : %llu\n", static_cast<unsigned long long>(womBatches)); std::printf("\n WOB (open WMO):\n"); std::printf(" files : %d\n", wobCount); std::printf(" groups : %llu\n", static_cast<unsigned long long>(wobGroups)); std::printf(" vertices : %llu\n", static_cast<unsigned long long>(wobVerts)); std::printf(" triangles : %llu\n", static_cast<unsigned long long>(wobIndices / 3)); std::printf(" doodads : %llu\n", static_cast<unsigned long long>(wobDoodads)); std::printf(" portals : %llu\n", static_cast<unsigned long long>(wobPortals)); std::printf("\n Combined :\n"); std::printf(" vertices : %llu\n", static_cast<unsigned long long>(womVerts + wobVerts)); std::printf(" triangles : %llu\n", static_cast<unsigned long long>((womIndices + wobIndices) / 3)); return 0; } else if (std::strcmp(argv[i], "--list-zone-meshes-detail") == 0 && i + 1 < argc) { // Per-mesh breakdown of every .wom file in <zoneDir>, // sorted by triangle count descending so the heaviest // meshes float to the top. Complements // --list-zone-meshes (per-zone summary) by surfacing // individual mesh metrics — useful for spotting // outliers ("which mesh is using 80% of my triangle // budget?") and for content audits. std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "list-zone-meshes-detail: %s does not exist\n", zoneDir.c_str()); return 1; } struct Row { std::string path; size_t verts; size_t tris; size_t bones; size_t batches; size_t textures; uint64_t bytes; uint32_t version; }; std::vector<Row> rows; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; if (e.path().extension() != ".wom") continue; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto wom = wowee::pipeline::WoweeModelLoader::load(base); Row r; r.path = fs::relative(e.path(), zoneDir, ec).string(); if (ec) r.path = e.path().filename().string(); r.verts = wom.vertices.size(); r.tris = wom.indices.size() / 3; r.bones = wom.bones.size(); r.batches = wom.batches.size(); r.textures = wom.texturePaths.size(); r.bytes = e.file_size(ec); if (ec) r.bytes = 0; r.version = wom.version; rows.push_back(r); } std::sort(rows.begin(), rows.end(), [](const Row& a, const Row& b) { return a.tris > b.tris; }); uint64_t totVerts = 0, totTris = 0, totBones = 0, totBytes = 0; for (const auto& r : rows) { totVerts += r.verts; totTris += r.tris; totBones += r.bones; totBytes += r.bytes; } if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["meshCount"] = rows.size(); j["totals"] = {{"vertices", totVerts}, {"triangles", totTris}, {"bones", totBones}, {"bytes", totBytes}}; nlohmann::json arr = nlohmann::json::array(); for (const auto& r : rows) { arr.push_back({{"path", r.path}, {"version", r.version}, {"vertices", r.verts}, {"triangles", r.tris}, {"bones", r.bones}, {"batches", r.batches}, {"textures", r.textures}, {"bytes", r.bytes}}); } j["meshes"] = arr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone meshes: %s\n", zoneDir.c_str()); std::printf(" meshes : %zu\n", rows.size()); std::printf(" totals : %llu verts, %llu tris, %llu bones, %.1f KB\n", static_cast<unsigned long long>(totVerts), static_cast<unsigned long long>(totTris), static_cast<unsigned long long>(totBones), totBytes / 1024.0); if (rows.empty()) { std::printf("\n *no .wom files in this zone*\n"); return 0; } std::printf("\n v verts tris bones batch tex bytes path\n"); for (const auto& r : rows) { std::printf(" v%u %6zu %6zu %5zu %5zu %3zu %7llu %s\n", r.version, r.verts, r.tris, r.bones, r.batches, r.textures, static_cast<unsigned long long>(r.bytes), r.path.c_str()); } return 0; } else if (std::strcmp(argv[i], "--info-mesh") == 0 && i + 1 < argc) { // Single-mesh detail view aggregating bounds, version, // batches, bones, animations, and texture slots into one // report. Composite of what --info-batches / --info-bones // / --info-batches show separately. Useful authoring // command: pass a WOM and see everything about it without // running three sub-commands. std::string base = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; if (base.size() >= 4 && base.substr(base.size() - 4) == ".wom") { base = base.substr(0, base.size() - 4); } if (!wowee::pipeline::WoweeModelLoader::exists(base)) { std::fprintf(stderr, "info-mesh: %s.wom does not exist\n", base.c_str()); return 1; } auto wom = wowee::pipeline::WoweeModelLoader::load(base); if (!wom.isValid()) { std::fprintf(stderr, "info-mesh: failed to load %s.wom\n", base.c_str()); return 1; } // Per-batch material summary. static const char* blendNames[] = { "opaque", "alpha-test", "alpha", "additive", "?", "?", "?", "?" }; if (jsonOut) { nlohmann::json j; j["base"] = base; j["name"] = wom.name; j["version"] = wom.version; j["bounds"] = {{"min", {wom.boundMin.x, wom.boundMin.y, wom.boundMin.z}}, {"max", {wom.boundMax.x, wom.boundMax.y, wom.boundMax.z}}, {"radius", wom.boundRadius}}; j["counts"] = {{"vertices", wom.vertices.size()}, {"indices", wom.indices.size()}, {"triangles", wom.indices.size() / 3}, {"bones", wom.bones.size()}, {"animations", wom.animations.size()}, {"batches", wom.batches.size()}, {"textures", wom.texturePaths.size()}}; nlohmann::json bs = nlohmann::json::array(); for (const auto& b : wom.batches) { std::string tex; if (b.textureIndex < wom.texturePaths.size()) tex = wom.texturePaths[b.textureIndex]; bs.push_back({{"indexStart", b.indexStart}, {"indexCount", b.indexCount}, {"triangles", b.indexCount / 3}, {"textureIndex", b.textureIndex}, {"texture", tex}, {"blendMode", b.blendMode}, {"flags", b.flags}}); } j["batchDetail"] = bs; j["texturePaths"] = wom.texturePaths; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Mesh: %s.wom\n", base.c_str()); std::printf(" name : %s\n", wom.name.c_str()); std::printf(" version : v%u\n", wom.version); std::printf("\n Counts:\n"); std::printf(" vertices : %zu\n", wom.vertices.size()); std::printf(" triangles : %zu\n", wom.indices.size() / 3); std::printf(" bones : %zu\n", wom.bones.size()); std::printf(" anims : %zu\n", wom.animations.size()); std::printf(" batches : %zu\n", wom.batches.size()); std::printf(" textures : %zu\n", wom.texturePaths.size()); std::printf("\n Bounds:\n"); std::printf(" min : (%.3f, %.3f, %.3f)\n", wom.boundMin.x, wom.boundMin.y, wom.boundMin.z); std::printf(" max : (%.3f, %.3f, %.3f)\n", wom.boundMax.x, wom.boundMax.y, wom.boundMax.z); std::printf(" radius : %.3f\n", wom.boundRadius); if (!wom.batches.empty()) { std::printf("\n Batches:\n"); std::printf(" idx iStart iCount tris blend texture\n"); for (size_t k = 0; k < wom.batches.size(); ++k) { const auto& b = wom.batches[k]; std::string tex = "<oob>"; if (b.textureIndex < wom.texturePaths.size()) tex = wom.texturePaths[b.textureIndex]; if (tex.empty()) tex = "(empty)"; int blend = b.blendMode < 8 ? b.blendMode : 0; std::printf(" %3zu %6u %6u %4u %-10s %s\n", k, b.indexStart, b.indexCount, b.indexCount / 3, blendNames[blend], tex.c_str()); } } if (!wom.texturePaths.empty()) { std::printf("\n Texture slots:\n"); for (size_t k = 0; k < wom.texturePaths.size(); ++k) { std::printf(" [%zu] %s\n", k, wom.texturePaths[k].empty() ? "(empty placeholder)" : wom.texturePaths[k].c_str()); } } return 0; } else if (std::strcmp(argv[i], "--info-mesh-storage-budget") == 0 && i + 1 < argc) { // Estimated bytes-per-category breakdown for a WOM. // Numbers are based on the in-memory struct sizes, not // the actual on-disk encoding (which has framing // overhead) — but the relative shares are accurate and // help users decide where shrinking efforts pay off. // // For example: a heightmap mesh's bytes are dominated by // vertices, so reducing vertex count is the lever to // pull. A skeletal mesh's animation keyframes can dwarf // the geometry itself — surfacing that lets the user // know to consider --strip-mesh --anims. std::string base = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; if (base.size() >= 4 && base.substr(base.size() - 4) == ".wom") { base = base.substr(0, base.size() - 4); } if (!wowee::pipeline::WoweeModelLoader::exists(base)) { std::fprintf(stderr, "info-mesh-storage-budget: %s.wom does not exist\n", base.c_str()); return 1; } auto wom = wowee::pipeline::WoweeModelLoader::load(base); if (!wom.isValid()) { std::fprintf(stderr, "info-mesh-storage-budget: failed to load %s.wom\n", base.c_str()); return 1; } // Per-category byte estimates. Vertex is 12+12+8+4+4=40 // bytes (pos/normal/uv/4 weights/4 indices). Index is // 4 bytes. Bone is 4+2+12+4=22 bytes. Batch is 4+4+4+2+ // 2=16. Animation keyframe is 4+12+16+12=44 bytes. // Texture path is summed length plus a small per-string // overhead. uint64_t vertBytes = wom.vertices.size() * 40; uint64_t idxBytes = wom.indices.size() * 4; uint64_t boneBytes = wom.bones.size() * 22; uint64_t batchBytes = wom.batches.size() * 16; uint64_t animBytes = 0; size_t totalKeyframes = 0; for (const auto& a : wom.animations) { animBytes += 12; // id + duration + movingSpeed for (const auto& bone : a.boneKeyframes) { animBytes += bone.size() * 44; totalKeyframes += bone.size(); } } uint64_t texBytes = 0; for (const auto& t : wom.texturePaths) texBytes += t.size() + 8; namespace fs = std::filesystem; uint64_t actualBytes = fs::file_size(base + ".wom"); uint64_t estBytes = vertBytes + idxBytes + boneBytes + batchBytes + animBytes + texBytes; struct Row { const char* name; uint64_t bytes; }; std::vector<Row> rows = { {"vertices ", vertBytes}, {"indices ", idxBytes}, {"bones ", boneBytes}, {"animations", animBytes}, {"batches ", batchBytes}, {"textures ", texBytes}, }; if (jsonOut) { nlohmann::json j; j["base"] = base; j["fileBytes"] = actualBytes; j["estimatedBytes"] = estBytes; j["categories"] = nlohmann::json::object(); for (const auto& r : rows) { double share = estBytes > 0 ? 100.0 * r.bytes / estBytes : 0.0; j["categories"][r.name] = {{"bytes", r.bytes}, {"share", share}}; } j["counts"] = {{"vertices", wom.vertices.size()}, {"indices", wom.indices.size()}, {"bones", wom.bones.size()}, {"animations", wom.animations.size()}, {"keyframes", totalKeyframes}, {"batches", wom.batches.size()}, {"textures", wom.texturePaths.size()}}; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Mesh storage budget: %s.wom\n", base.c_str()); std::printf(" on-disk : %llu bytes (%.1f KB)\n", static_cast<unsigned long long>(actualBytes), actualBytes / 1024.0); std::printf(" estimated : %llu bytes (sum of in-memory parts)\n", static_cast<unsigned long long>(estBytes)); std::printf("\n Per-category (estimated):\n"); for (const auto& r : rows) { if (r.bytes == 0) continue; double share = estBytes > 0 ? 100.0 * r.bytes / estBytes : 0.0; std::printf(" %s : %10llu bytes (%5.1f%%)\n", r.name, static_cast<unsigned long long>(r.bytes), share); } std::printf("\n Tips:\n"); if (animBytes > vertBytes && wom.animations.size() > 0) { std::printf(" - animations dominate; --strip-mesh " "--anims would save %.1f KB\n", animBytes / 1024.0); } if (boneBytes > vertBytes / 2 && wom.bones.size() > 0) { std::printf(" - bones non-trivial; consider " "--strip-mesh --bones for static placement\n"); } if (vertBytes > estBytes / 2) { std::printf(" - vertices dominate; check if a " "lower-poly variant works for placement\n"); } return 0; } else if (std::strcmp(argv[i], "--info-project-models-total") == 0 && i + 1 < argc) { // Multi-zone aggregate. Walks every zone in <projectDir>, // sums the same WOM/WOB metrics --info-zone-models-total // emits, and prints a per-zone breakdown table followed // by project-wide totals. Useful for capacity planning // across an entire content project. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "info-project-models-total: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); struct ZRow { std::string name; int womCount = 0, wobCount = 0; uint64_t womVerts = 0, womIndices = 0, womBones = 0; uint64_t womAnims = 0, womBatches = 0; uint64_t wobGroups = 0, wobVerts = 0, wobIndices = 0; uint64_t wobDoodads = 0, wobPortals = 0; }; std::vector<ZRow> rows; ZRow tot; tot.name = "TOTAL"; for (const auto& zoneDir : zones) { ZRow r; r.name = fs::path(zoneDir).filename().string(); std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); std::string base = e.path().string(); if (base.size() > ext.size()) base = base.substr(0, base.size() - ext.size()); if (ext == ".wom") { r.womCount++; auto wom = wowee::pipeline::WoweeModelLoader::load(base); r.womVerts += wom.vertices.size(); r.womIndices += wom.indices.size(); r.womBones += wom.bones.size(); r.womAnims += wom.animations.size(); r.womBatches += wom.batches.size(); } else if (ext == ".wob") { r.wobCount++; auto wob = wowee::pipeline::WoweeBuildingLoader::load(base); r.wobGroups += wob.groups.size(); for (const auto& g : wob.groups) { r.wobVerts += g.vertices.size(); r.wobIndices += g.indices.size(); } r.wobDoodads += wob.doodads.size(); r.wobPortals += wob.portals.size(); } } tot.womCount += r.womCount; tot.wobCount += r.wobCount; tot.womVerts += r.womVerts; tot.womIndices += r.womIndices; tot.womBones += r.womBones; tot.womAnims += r.womAnims; tot.womBatches += r.womBatches; tot.wobGroups += r.wobGroups; tot.wobVerts += r.wobVerts; tot.wobIndices += r.wobIndices; tot.wobDoodads += r.wobDoodads; tot.wobPortals += r.wobPortals; rows.push_back(r); } if (jsonOut) { nlohmann::json j; j["project"] = projectDir; j["zones"] = nlohmann::json::array(); auto rowJson = [](const ZRow& r) { nlohmann::json z; z["name"] = r.name; z["wom"] = {{"count", r.womCount}, {"vertices", r.womVerts}, {"indices", r.womIndices}, {"triangles", r.womIndices / 3}, {"bones", r.womBones}, {"animations", r.womAnims}, {"batches", r.womBatches}}; z["wob"] = {{"count", r.wobCount}, {"groups", r.wobGroups}, {"vertices", r.wobVerts}, {"indices", r.wobIndices}, {"triangles", r.wobIndices / 3}, {"doodads", r.wobDoodads}, {"portals", r.wobPortals}}; return z; }; for (const auto& r : rows) j["zones"].push_back(rowJson(r)); j["total"] = rowJson(tot); std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Project models total: %s\n", projectDir.c_str()); std::printf(" zones : %zu\n\n", zones.size()); std::printf(" zone WOMs WOMtri bones WOBs WOBtri doodads\n"); for (const auto& r : rows) { std::printf(" %-20s %5d %7llu %6llu %5d %7llu %8llu\n", r.name.substr(0, 20).c_str(), r.womCount, static_cast<unsigned long long>(r.womIndices / 3), static_cast<unsigned long long>(r.womBones), r.wobCount, static_cast<unsigned long long>(r.wobIndices / 3), static_cast<unsigned long long>(r.wobDoodads)); } std::printf(" %-20s %5d %7llu %6llu %5d %7llu %8llu\n", tot.name.c_str(), tot.womCount, static_cast<unsigned long long>(tot.womIndices / 3), static_cast<unsigned long long>(tot.womBones), tot.wobCount, static_cast<unsigned long long>(tot.wobIndices / 3), static_cast<unsigned long long>(tot.wobDoodads)); std::printf("\n Combined verts/tris (WOM+WOB): %llu / %llu\n", static_cast<unsigned long long>(tot.womVerts + tot.wobVerts), static_cast<unsigned long long>((tot.womIndices + tot.wobIndices) / 3)); return 0; } else if (std::strcmp(argv[i], "--copy-project") == 0 && i + 2 < argc) { // Recursively copy an entire project tree. Refuses to // overwrite an existing destination so a typo doesn't // silently merge into the wrong project. std::string fromDir = argv[++i]; std::string toDir = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(fromDir) || !fs::is_directory(fromDir)) { std::fprintf(stderr, "copy-project: %s is not a directory\n", fromDir.c_str()); return 1; } if (fs::exists(toDir)) { std::fprintf(stderr, "copy-project: destination %s already exists " "(delete it first if intentional)\n", toDir.c_str()); return 1; } std::error_code ec; fs::copy(fromDir, toDir, fs::copy_options::recursive | fs::copy_options::copy_symlinks, ec); if (ec) { std::fprintf(stderr, "copy-project: copy failed (%s)\n", ec.message().c_str()); return 1; } // Count what was copied for the report. int zoneCount = 0, fileCount = 0; uint64_t totalBytes = 0; for (const auto& entry : fs::directory_iterator(toDir, ec)) { if (entry.is_directory() && fs::exists(entry.path() / "zone.json")) zoneCount++; } for (const auto& e : fs::recursive_directory_iterator(toDir, ec)) { if (e.is_regular_file()) { fileCount++; totalBytes += e.file_size(ec); } } std::printf("Copied %s -> %s\n", fromDir.c_str(), toDir.c_str()); std::printf(" zones : %d\n", zoneCount); std::printf(" files : %d\n", fileCount); std::printf(" total bytes : %llu (%.1f MB)\n", static_cast<unsigned long long>(totalBytes), totalBytes / (1024.0 * 1024.0)); return 0; } else if (std::strcmp(argv[i], "--zone-summary") == 0 && i + 1 < argc) { // One-shot zone overview: validate + creature/object/quest counts. // Collapses the most common multi-step inspection into a single // command; useful for CI reports and quick sanity checks. std::string zoneDir = argv[++i]; // Optional --json after the dir for machine-readable output. bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "zone-summary: %s does not exist\n", zoneDir.c_str()); return 1; } auto v = wowee::editor::ContentPacker::validateZone(zoneDir); // Read creature/object/quest data once so both human and JSON // outputs share the same numbers. int creatureTotal = 0, hostile = 0, qg = 0, vendor = 0; int objectTotal = 0, m2Count = 0, wmoCount = 0; int questTotal = 0, chainWarnings = 0; std::string creaturesPath = zoneDir + "/creatures.json"; if (fs::exists(creaturesPath)) { wowee::editor::NpcSpawner sp; if (sp.loadFromFile(creaturesPath)) { creatureTotal = static_cast<int>(sp.getSpawns().size()); for (const auto& s : sp.getSpawns()) { if (s.hostile) hostile++; if (s.questgiver) qg++; if (s.vendor) vendor++; } } } std::string objectsPath = zoneDir + "/objects.json"; if (fs::exists(objectsPath)) { wowee::editor::ObjectPlacer op; if (op.loadFromFile(objectsPath)) { objectTotal = static_cast<int>(op.getObjects().size()); for (const auto& o : op.getObjects()) { if (o.type == wowee::editor::PlaceableType::M2) m2Count++; else wmoCount++; } } } std::string questsPath = zoneDir + "/quests.json"; if (fs::exists(questsPath)) { wowee::editor::QuestEditor qe; if (qe.loadFromFile(questsPath)) { questTotal = static_cast<int>(qe.getQuests().size()); std::vector<std::string> errors; qe.validateChains(errors); chainWarnings = static_cast<int>(errors.size()); } } if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["score"] = v.openFormatScore(); j["maxScore"] = 7; j["formats"] = v.summary(); j["counts"] = { {"wot", v.wotCount}, {"whm", v.whmCount}, {"wom", v.womCount}, {"wob", v.wobCount}, {"woc", v.wocCount}, {"png", v.pngCount}, }; j["creatures"] = { {"total", creatureTotal}, {"hostile", hostile}, {"questgiver", qg}, {"vendor", vendor}, }; j["objects"] = { {"total", objectTotal}, {"m2", m2Count}, {"wmo", wmoCount}, }; j["quests"] = { {"total", questTotal}, {"chainWarnings", chainWarnings}, }; std::printf("%s\n", j.dump(2).c_str()); return v.openFormatScore() == 7 ? 0 : 1; } std::printf("Zone: %s\n", zoneDir.c_str()); std::printf(" open formats : %d/7 (%s)\n", v.openFormatScore(), v.summary().c_str()); std::printf(" WOT/WHM : %d/%d WOM: %d WOB: %d WOC: %d PNG: %d\n", v.wotCount, v.whmCount, v.womCount, v.wobCount, v.wocCount, v.pngCount); if (creatureTotal > 0) { std::printf(" creatures : %d (%d hostile, %d quest, %d vendor)\n", creatureTotal, hostile, qg, vendor); } if (objectTotal > 0) { std::printf(" objects : %d (%d M2, %d WMO)\n", objectTotal, m2Count, wmoCount); } if (questTotal > 0) { std::printf(" quests : %d (%d chain warnings)\n", questTotal, chainWarnings); } return v.openFormatScore() == 7 ? 0 : 1; } else if (std::strcmp(argv[i], "--bench-bake-project") == 0 && i + 1 < argc) { // Time WHM/WOT load (the dominant cost in --bake-zone-glb/obj/ // stl) per zone. The actual write side adds ~constant cost // proportional to vertex count, so load time is a strong // proxy. Useful for tracking 'has my latest geometry change // made baking 3× slower?' across releases. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "bench-bake-project: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); struct Timing { std::string name; int tiles; double loadMs; int chunks; }; std::vector<Timing> timings; double totalMs = 0; for (const auto& zoneDir : zones) { wowee::editor::ZoneManifest zm; if (!zm.load(zoneDir + "/zone.json")) continue; Timing t{fs::path(zoneDir).filename().string(), 0, 0.0, 0}; auto t0 = std::chrono::steady_clock::now(); for (const auto& [tx, ty] : zm.tiles) { std::string base = zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); if (!wowee::pipeline::WoweeTerrainLoader::exists(base)) continue; wowee::pipeline::ADTTerrain terrain; wowee::pipeline::WoweeTerrainLoader::load(base, terrain); t.tiles++; for (const auto& chunk : terrain.chunks) { if (chunk.heightMap.isLoaded()) t.chunks++; } } auto t1 = std::chrono::steady_clock::now(); t.loadMs = std::chrono::duration<double, std::milli>(t1 - t0).count(); totalMs += t.loadMs; timings.push_back(t); } double avgMs = !timings.empty() ? totalMs / timings.size() : 0.0; double minMs = 1e30, maxMs = 0; std::string slowest; for (const auto& t : timings) { if (t.loadMs < minMs) minMs = t.loadMs; if (t.loadMs > maxMs) { maxMs = t.loadMs; slowest = t.name; } } if (timings.empty()) { minMs = 0; maxMs = 0; } if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["totalMs"] = totalMs; j["zoneCount"] = timings.size(); j["avgMs"] = avgMs; j["minMs"] = minMs; j["maxMs"] = maxMs; j["slowestZone"] = slowest; nlohmann::json arr = nlohmann::json::array(); for (const auto& t : timings) { arr.push_back({{"zone", t.name}, {"loadMs", t.loadMs}, {"tiles", t.tiles}, {"chunks", t.chunks}}); } j["perZone"] = arr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Bench bake (load-only): %s\n", projectDir.c_str()); std::printf(" zones : %zu\n", timings.size()); std::printf(" total : %.2f ms (terrain load)\n", totalMs); std::printf(" per zone : avg=%.2f min=%.2f max=%.2f ms\n", avgMs, minMs, maxMs); if (!slowest.empty()) { std::printf(" slowest : %s (%.2f ms)\n", slowest.c_str(), maxMs); } std::printf("\n Per-zone:\n"); std::printf(" zone ms tiles chunks ms/tile\n"); for (const auto& t : timings) { double mspt = t.tiles > 0 ? t.loadMs / t.tiles : 0.0; std::printf(" %-26s %7.2f %5d %5d %6.2f\n", t.name.substr(0, 26).c_str(), t.loadMs, t.tiles, t.chunks, mspt); } return 0; } else if (std::strcmp(argv[i], "--export-png") == 0 && i + 1 < argc) { // Render heightmap, normal-map, and zone-map PNG previews for a // terrain. Useful for portfolio screenshots, ground-truth map // comparison, and quick visual validation without launching GUI. std::string base = argv[++i]; for (const char* ext : {".wot", ".whm"}) { if (base.size() >= 4 && base.substr(base.size() - 4) == ext) { base = base.substr(0, base.size() - 4); break; } } if (!wowee::pipeline::WoweeTerrainLoader::exists(base)) { std::fprintf(stderr, "WOT/WHM not found at base: %s\n", base.c_str()); return 1; } wowee::pipeline::ADTTerrain terrain; if (!wowee::pipeline::WoweeTerrainLoader::load(base, terrain)) { std::fprintf(stderr, "Failed to load terrain: %s\n", base.c_str()); return 1; } wowee::editor::WoweeTerrain::exportHeightmapPreview(terrain, base + "_heightmap.png"); wowee::editor::WoweeTerrain::exportNormalMap(terrain, base + "_normals.png"); wowee::editor::WoweeTerrain::exportZoneMap(terrain, base + "_zone.png", 512); std::printf("Exported PNGs: %s_{heightmap,normals,zone}.png\n", base.c_str()); return 0; } else if (std::strcmp(argv[i], "--fix-zone") == 0 && i + 1 < argc) { // Re-parse + re-save every JSON/binary file in a zone to apply // the editor's load-time scrubs and save-time caps. Useful when // an old zone was created before recent hardening — running // this once cleans up NaN/oversize fields without touching // the editor GUI. std::string zoneDir = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "fix-zone: %s does not exist\n", zoneDir.c_str()); return 1; } int touched = 0; // zone.json { wowee::editor::ZoneManifest m; std::string p = zoneDir + "/zone.json"; if (fs::exists(p) && m.load(p) && m.save(p)) touched++; } // creatures.json { wowee::editor::NpcSpawner sp; std::string p = zoneDir + "/creatures.json"; if (fs::exists(p) && sp.loadFromFile(p) && sp.saveToFile(p)) touched++; } // objects.json { wowee::editor::ObjectPlacer op; std::string p = zoneDir + "/objects.json"; if (fs::exists(p) && op.loadFromFile(p) && op.saveToFile(p)) touched++; } // quests.json { wowee::editor::QuestEditor qe; std::string p = zoneDir + "/quests.json"; if (fs::exists(p) && qe.loadFromFile(p) && qe.saveToFile(p)) touched++; } // WHM/WOT pairs and WoB files would need full pipeline access; // skip them — the editor opens them on next zone load anyway, // and the load-time scrubs run then. std::printf("fix-zone: cleaned %d files in %s\n", touched, zoneDir.c_str()); return 0; } else if (std::strcmp(argv[i], "--regen-collision") == 0 && i + 1 < argc) { // Find all WHM/WOT pairs under a zone dir and rebuild WOC for each. // Useful after sculpting changes when you want to re-derive // collision in batch instead of one tile at a time. std::string zoneDir = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "regen-collision: %s does not exist\n", zoneDir.c_str()); return 1; } int rebuilt = 0, failed = 0; for (auto& entry : fs::recursive_directory_iterator(zoneDir)) { if (!entry.is_regular_file()) continue; if (entry.path().extension() != ".whm") continue; std::string base = entry.path().string(); base = base.substr(0, base.size() - 4); // strip .whm wowee::pipeline::ADTTerrain terrain; if (!wowee::pipeline::WoweeTerrainLoader::load(base, terrain)) { std::fprintf(stderr, " FAILED to load: %s\n", base.c_str()); failed++; continue; } auto col = wowee::pipeline::WoweeCollisionBuilder::fromTerrain(terrain); std::string outPath = base + ".woc"; if (wowee::pipeline::WoweeCollisionBuilder::save(col, outPath)) { std::printf(" WOC rebuilt: %s (%zu triangles)\n", outPath.c_str(), col.triangles.size()); rebuilt++; } else { std::fprintf(stderr, " FAILED to save: %s\n", outPath.c_str()); failed++; } } std::printf("regen-collision: %d rebuilt, %d failed\n", rebuilt, failed); return failed > 0 ? 1 : 0; } else if (std::strcmp(argv[i], "--build-woc") == 0 && i + 1 < argc) { // Generate a WOC collision mesh from a WHM/WOT terrain pair. // Uses terrain triangles only (no WMO overlays); useful as a // first-pass collision build before the editor adds buildings. std::string base = argv[++i]; for (const char* ext : {".wot", ".whm", ".woc"}) { if (base.size() >= 4 && base.substr(base.size() - 4) == ext) { base = base.substr(0, base.size() - 4); break; } } if (!wowee::pipeline::WoweeTerrainLoader::exists(base)) { std::fprintf(stderr, "WOT/WHM not found at base: %s\n", base.c_str()); return 1; } wowee::pipeline::ADTTerrain terrain; if (!wowee::pipeline::WoweeTerrainLoader::load(base, terrain)) { std::fprintf(stderr, "Failed to load terrain: %s\n", base.c_str()); return 1; } auto col = wowee::pipeline::WoweeCollisionBuilder::fromTerrain(terrain); std::string outPath = base + ".woc"; if (!wowee::pipeline::WoweeCollisionBuilder::save(col, outPath)) { std::fprintf(stderr, "WOC save failed: %s\n", outPath.c_str()); return 1; } std::printf("WOC built: %s (%zu triangles, %zu walkable, %zu steep)\n", outPath.c_str(), col.triangles.size(), col.walkableCount(), col.steepCount()); return 0; } else if (std::strcmp(argv[i], "--remove-creature") == 0 && i + 2 < argc) { // Remove a creature spawn by 0-based index. Pair with // --info-creatures (or your editor) to find the right index // first; nothing identifies entries reliably across reloads. std::string zoneDir = argv[++i]; std::string idxStr = argv[++i]; std::string path = zoneDir + "/creatures.json"; if (!std::filesystem::exists(path)) { std::fprintf(stderr, "remove-creature: %s not found\n", path.c_str()); return 1; } int idx; try { idx = std::stoi(idxStr); } catch (...) { std::fprintf(stderr, "remove-creature: bad index '%s'\n", idxStr.c_str()); return 1; } wowee::editor::NpcSpawner sp; sp.loadFromFile(path); if (idx < 0 || idx >= static_cast<int>(sp.spawnCount())) { std::fprintf(stderr, "remove-creature: index %d out of range [0, %zu)\n", idx, sp.spawnCount()); return 1; } std::string removedName = sp.getSpawns()[idx].name; sp.removeCreature(idx); if (!sp.saveToFile(path)) { std::fprintf(stderr, "remove-creature: failed to write %s\n", path.c_str()); return 1; } std::printf("Removed creature '%s' (was index %d) from %s (now %zu total)\n", removedName.c_str(), idx, path.c_str(), sp.spawnCount()); return 0; } else if (std::strcmp(argv[i], "--remove-object") == 0 && i + 2 < argc) { std::string zoneDir = argv[++i]; std::string idxStr = argv[++i]; std::string path = zoneDir + "/objects.json"; if (!std::filesystem::exists(path)) { std::fprintf(stderr, "remove-object: %s not found\n", path.c_str()); return 1; } int idx; try { idx = std::stoi(idxStr); } catch (...) { std::fprintf(stderr, "remove-object: bad index '%s'\n", idxStr.c_str()); return 1; } wowee::editor::ObjectPlacer placer; placer.loadFromFile(path); auto& objs = placer.getObjects(); if (idx < 0 || idx >= static_cast<int>(objs.size())) { std::fprintf(stderr, "remove-object: index %d out of range [0, %zu)\n", idx, objs.size()); return 1; } std::string removedPath = objs[idx].path; objs.erase(objs.begin() + idx); if (!placer.saveToFile(path)) { std::fprintf(stderr, "remove-object: failed to write %s\n", path.c_str()); return 1; } std::printf("Removed object '%s' (was index %d) from %s (now %zu total)\n", removedPath.c_str(), idx, path.c_str(), objs.size()); return 0; } else if (std::strcmp(argv[i], "--remove-quest") == 0 && i + 2 < argc) { std::string zoneDir = argv[++i]; std::string idxStr = argv[++i]; std::string path = zoneDir + "/quests.json"; if (!std::filesystem::exists(path)) { std::fprintf(stderr, "remove-quest: %s not found\n", path.c_str()); return 1; } int idx; try { idx = std::stoi(idxStr); } catch (...) { std::fprintf(stderr, "remove-quest: bad index '%s'\n", idxStr.c_str()); return 1; } wowee::editor::QuestEditor qe; qe.loadFromFile(path); if (idx < 0 || idx >= static_cast<int>(qe.questCount())) { std::fprintf(stderr, "remove-quest: index %d out of range [0, %zu)\n", idx, qe.questCount()); return 1; } std::string removedTitle = qe.getQuests()[idx].title; qe.removeQuest(idx); if (!qe.saveToFile(path)) { std::fprintf(stderr, "remove-quest: failed to write %s\n", path.c_str()); return 1; } std::printf("Removed quest '%s' (was index %d) from %s (now %zu total)\n", removedTitle.c_str(), idx, path.c_str(), qe.questCount()); return 0; } else if (std::strcmp(argv[i], "--add-object") == 0 && i + 5 < argc) { // Append a single object placement to a zone's objects.json. // Args: <zoneDir> <m2|wmo> <gamePath> <x> <y> <z> [scale] std::string zoneDir = argv[++i]; std::string typeStr = argv[++i]; std::string gamePath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "add-object: zone '%s' does not exist\n", zoneDir.c_str()); return 1; } wowee::editor::PlaceableType ptype; if (typeStr == "m2") ptype = wowee::editor::PlaceableType::M2; else if (typeStr == "wmo") ptype = wowee::editor::PlaceableType::WMO; else { std::fprintf(stderr, "add-object: type must be 'm2' or 'wmo'\n"); return 1; } glm::vec3 pos; try { pos.x = std::stof(argv[++i]); pos.y = std::stof(argv[++i]); pos.z = std::stof(argv[++i]); } catch (const std::exception& e) { std::fprintf(stderr, "add-object: bad coordinate (%s)\n", e.what()); return 1; } wowee::editor::ObjectPlacer placer; std::string path = zoneDir + "/objects.json"; if (fs::exists(path)) placer.loadFromFile(path); placer.setActivePath(gamePath, ptype); placer.placeObject(pos); // Optional scale after coordinates. if (i + 1 < argc && argv[i + 1][0] != '-') { try { float scale = std::stof(argv[++i]); if (std::isfinite(scale) && scale > 0.0f) { // Set scale on the just-placed object (last in list). placer.getObjects().back().scale = scale; } } catch (...) {} } if (!placer.saveToFile(path)) { std::fprintf(stderr, "add-object: failed to write %s\n", path.c_str()); return 1; } std::printf("Added %s '%s' to %s (now %zu total)\n", typeStr.c_str(), gamePath.c_str(), path.c_str(), placer.getObjects().size()); return 0; } else if (std::strcmp(argv[i], "--add-creature") == 0 && i + 4 < argc) { // Append a single creature spawn to a zone's creatures.json. // Args: <zoneDir> <name> <x> <y> <z> [displayId] [level] // Useful for batch-populating zones via shell script without // launching the GUI placement tool. std::string zoneDir = argv[++i]; std::string name = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "add-creature: zone '%s' does not exist\n", zoneDir.c_str()); return 1; } wowee::editor::CreatureSpawn s; s.name = name; try { s.position.x = std::stof(argv[++i]); s.position.y = std::stof(argv[++i]); s.position.z = std::stof(argv[++i]); } catch (const std::exception& e) { std::fprintf(stderr, "add-creature: bad coordinate (%s)\n", e.what()); return 1; } // Optional displayId (positional, after coordinates). if (i + 1 < argc && argv[i + 1][0] != '-') { try { s.displayId = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) { /* leave 0 → SQL exporter substitutes 11707 */ } } if (i + 1 < argc && argv[i + 1][0] != '-') { try { s.level = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) { /* leave default 1 */ } } // Load existing spawns (if any), append, save. wowee::editor::NpcSpawner spawner; std::string path = zoneDir + "/creatures.json"; if (fs::exists(path)) spawner.loadFromFile(path); spawner.placeCreature(s); if (!spawner.saveToFile(path)) { std::fprintf(stderr, "add-creature: failed to write %s\n", path.c_str()); return 1; } std::printf("Added creature '%s' to %s (now %zu total)\n", name.c_str(), path.c_str(), spawner.spawnCount()); return 0; } else if (std::strcmp(argv[i], "--add-item") == 0 && i + 2 < argc) { // Append one item entry to <zoneDir>/items.json. Inline // JSON without a dedicated editor class — items.json is // a simple {"items": [...]} array of records, and the // schema is small enough that we don't need NpcSpawner- // style infrastructure yet. // // Schema per item: // id (uint32) — Item.dbc primary key (auto-increments // from 1 if omitted) // name (string) // quality (uint8) — 0..6 (poor..artifact, default 1) // displayId (uint32) — ItemDisplayInfo index (default 0) // itemLevel (uint32) — default 1 // stackable (uint32) — max stack size (default 1) std::string zoneDir = argv[++i]; std::string name = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "add-item: zone '%s' does not exist\n", zoneDir.c_str()); return 1; } uint32_t id = 0, displayId = 0, itemLevel = 1; uint32_t quality = 1; if (i + 1 < argc && argv[i + 1][0] != '-') { try { id = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } if (i + 1 < argc && argv[i + 1][0] != '-') { try { quality = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} if (quality > 6) quality = 1; } if (i + 1 < argc && argv[i + 1][0] != '-') { try { displayId = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } if (i + 1 < argc && argv[i + 1][0] != '-') { try { itemLevel = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } std::string path = zoneDir + "/items.json"; nlohmann::json doc = nlohmann::json::object({{"items", nlohmann::json::array()}}); if (fs::exists(path)) { std::ifstream in(path); try { in >> doc; } catch (...) { std::fprintf(stderr, "add-item: %s exists but is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { doc["items"] = nlohmann::json::array(); } } // Auto-assign id if user passed 0 / nothing — pick the // smallest unused positive integer so the items.json // numbering stays contiguous. if (id == 0) { std::set<uint32_t> used; for (const auto& it : doc["items"]) { if (it.contains("id") && it["id"].is_number_unsigned()) { used.insert(it["id"].get<uint32_t>()); } } id = 1; while (used.count(id)) ++id; } // Reject duplicate id so the user notices a collision. for (const auto& it : doc["items"]) { if (it.contains("id") && it["id"].is_number_unsigned() && it["id"].get<uint32_t>() == id) { std::fprintf(stderr, "add-item: id %u already in use in %s\n", id, path.c_str()); return 1; } } nlohmann::json item = { {"id", id}, {"name", name}, {"quality", quality}, {"displayId", displayId}, {"itemLevel", itemLevel}, {"stackable", 1}, }; doc["items"].push_back(item); std::ofstream out(path); if (!out) { std::fprintf(stderr, "add-item: failed to write %s\n", path.c_str()); return 1; } out << doc.dump(2); out.close(); static const char* qualityNames[] = { "poor", "common", "uncommon", "rare", "epic", "legendary", "artifact" }; std::printf("Added item '%s' (id=%u, quality=%s, ilvl=%u) to %s (now %zu total)\n", name.c_str(), id, qualityNames[quality], itemLevel, path.c_str(), doc["items"].size()); return 0; } else if (std::strcmp(argv[i], "--random-populate-zone") == 0 && i + 1 < argc) { // Randomly add creatures and/or objects to a zone for // playtest scenarios. Reads the zone manifest's tile // bounds so spawn positions stay inside the actual // playable area. Seeded LCG for reproducibility — same // seed always produces the same population. // // Flags: // --seed N (default 42) // --creatures N (default 20) // --objects N (default 10) std::string zoneDir = argv[++i]; uint32_t seed = 42; int creatureCount = 20; int objectCount = 10; while (i + 2 < argc && argv[i + 1][0] == '-') { std::string flag = argv[++i]; if (flag == "--seed") { try { seed = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } else if (flag == "--creatures") { try { creatureCount = std::stoi(argv[++i]); } catch (...) {} } else if (flag == "--objects") { try { objectCount = std::stoi(argv[++i]); } catch (...) {} } else { std::fprintf(stderr, "random-populate-zone: unknown flag '%s'\n", flag.c_str()); return 1; } } namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "random-populate-zone: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "random-populate-zone: failed to parse %s\n", manifestPath.c_str()); return 1; } if (zm.tiles.empty()) { std::fprintf(stderr, "random-populate-zone: zone has no tiles to populate\n"); return 1; } // Compute the world AABB the zone occupies so spawns land // inside it. Each tile is 533.33y; WoW grid centers tile // (32, 32) at world origin. constexpr float kTileSize = 533.33333f; int tMinX = 64, tMaxX = -1, tMinY = 64, tMaxY = -1; for (const auto& [tx, ty] : zm.tiles) { tMinX = std::min(tMinX, tx); tMaxX = std::max(tMaxX, tx); tMinY = std::min(tMinY, ty); tMaxY = std::max(tMaxY, ty); } float wMinX = (32.0f - tMaxY - 1) * kTileSize; float wMaxX = (32.0f - tMinY) * kTileSize; float wMinY = (32.0f - tMaxX - 1) * kTileSize; float wMaxY = (32.0f - tMinX) * kTileSize; float baseZ = zm.baseHeight; uint32_t rng = seed ? seed : 1u; auto next01 = [&]() { rng = rng * 1664525u + 1013904223u; return (rng >> 8) / float(1 << 24); }; auto rangeF = [&](float a, float b) { return a + next01() * (b - a); }; auto rangeI = [&](int a, int b) { return a + static_cast<int>(next01() * (b - a + 1)); }; // Tiny bestiary so the random output reads as plausible // rather than "Creature1 / Creature2". static const std::vector<std::pair<const char*, uint32_t>> kRandomCreatures = { {"Wolf", 5}, {"Boar", 4}, {"Bear", 7}, {"Spider", 3}, {"Bandit", 6}, {"Kobold", 4}, {"Murloc", 5}, {"Skeleton", 5}, {"Wisp", 3}, {"Goblin", 5}, {"Stag", 4}, {"Crab", 3}, }; static const std::vector<const char*> kRandomObjects = { "World/Generic/Tree01.wmo", "World/Generic/Boulder.wmo", "World/Generic/Bush.wmo", "World/Generic/Stump.wmo", "World/Generic/Mushroom.wmo", }; // Creatures. wowee::editor::NpcSpawner spawner; std::string cpath = zoneDir + "/creatures.json"; if (fs::exists(cpath)) spawner.loadFromFile(cpath); int placedCreatures = 0; for (int n = 0; n < creatureCount; ++n) { const auto& [name, baseLvl] = kRandomCreatures[ rangeI(0, static_cast<int>(kRandomCreatures.size()) - 1)]; wowee::editor::CreatureSpawn s; s.name = name; s.position.x = rangeF(wMinX, wMaxX); s.position.y = rangeF(wMinY, wMaxY); s.position.z = baseZ; int lvl = std::max(1, static_cast<int>(baseLvl) + rangeI(-1, 2)); s.level = static_cast<uint32_t>(lvl); s.health = 50 + s.level * 10; s.orientation = rangeF(0.0f, 360.0f); spawner.placeCreature(s); placedCreatures++; } if (placedCreatures > 0) spawner.saveToFile(cpath); // Objects. wowee::editor::ObjectPlacer placer; std::string opath = zoneDir + "/objects.json"; if (fs::exists(opath)) placer.loadFromFile(opath); int placedObjects = 0; // Push PlacedObject directly into the placer's vector so // we don't fight placeObject()'s early-return on empty // activePath_. uniqueId starts after any existing objects // to keep IDs collision-free. auto& objs = placer.getObjects(); uint32_t maxUid = 0; for (const auto& o : objs) maxUid = std::max(maxUid, o.uniqueId); for (int n = 0; n < objectCount; ++n) { wowee::editor::PlacedObject o; o.path = kRandomObjects[ rangeI(0, static_cast<int>(kRandomObjects.size()) - 1)]; o.type = wowee::editor::PlaceableType::WMO; o.position.x = rangeF(wMinX, wMaxX); o.position.y = rangeF(wMinY, wMaxY); o.position.z = baseZ; o.rotation = glm::vec3(0.0f, rangeF(0.0f, 6.28f), 0.0f); o.scale = rangeF(0.8f, 1.4f); o.uniqueId = ++maxUid; o.nameId = 0; o.selected = false; objs.push_back(o); placedObjects++; } if (placedObjects > 0) placer.saveToFile(opath); std::printf("random-populate-zone: %s\n", zoneDir.c_str()); std::printf(" seed : %u\n", seed); std::printf(" zone bbox : (%.0f, %.0f) - (%.0f, %.0f)\n", wMinX, wMinY, wMaxX, wMaxY); std::printf(" creatures : %d added (%zu total)\n", placedCreatures, spawner.spawnCount()); std::printf(" objects : %d added (%zu total)\n", placedObjects, placer.getObjects().size()); return 0; } else if (std::strcmp(argv[i], "--random-populate-items") == 0 && i + 1 < argc) { // Seeded random items.json populator. Pulls a base name // and a noun from inline word lists, picks a quality up // to maxQuality, randomizes itemLevel and stack size // around plausible defaults. Useful for playtest loot // tables that need bulk content without hand-typing each // entry. // // Flags: --seed N (default 7), --count N (default 30), // --max-quality Q (default 4 = epic; 0..6 valid). std::string zoneDir = argv[++i]; uint32_t seed = 7; int count = 30; int maxQuality = 4; while (i + 2 < argc && argv[i + 1][0] == '-') { std::string flag = argv[++i]; if (flag == "--seed") { try { seed = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } else if (flag == "--count") { try { count = std::stoi(argv[++i]); } catch (...) {} } else if (flag == "--max-quality") { try { maxQuality = std::stoi(argv[++i]); } catch (...) {} } else { std::fprintf(stderr, "random-populate-items: unknown flag '%s'\n", flag.c_str()); return 1; } } if (maxQuality < 0 || maxQuality > 6) maxQuality = 4; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "random-populate-items: %s has no zone.json\n", zoneDir.c_str()); return 1; } uint32_t rng = seed ? seed : 1u; auto next01 = [&]() { rng = rng * 1664525u + 1013904223u; return (rng >> 8) / float(1 << 24); }; auto rangeI = [&](int a, int b) { return a + static_cast<int>(next01() * (b - a + 1)); }; // Inline name lexicon. {prefix, noun} → "Glowing Sword". // Quality ramps prefix selection; rare+ items get fancier // adjectives. static const std::vector<const char*> kPrefixes[5] = { {"Worn", "Tattered", "Cracked", "Dented", "Faded"}, // poor {"Common", "Plain", "Basic", "Simple", "Standard"}, // common {"Sharp", "Sturdy", "Polished", "Reinforced", "Fine"}, // uncommon {"Glowing", "Runed", "Enchanted", "Storm", "Mystic"}, // rare {"Ancient", "Eternal", "Heroic", "Vengeful", "Soul"}, // epic }; static const std::vector<const char*> kNouns = { "Sword", "Mace", "Axe", "Dagger", "Staff", "Bow", "Helm", "Cuirass", "Greaves", "Gauntlets", "Ring", "Amulet", "Cloak", "Belt", "Boots", "Potion", "Scroll", "Tome", "Wand", "Shield", }; // Open the items doc. std::string ipath = zoneDir + "/items.json"; nlohmann::json doc = nlohmann::json::object({{"items", nlohmann::json::array()}}); if (fs::exists(ipath)) { std::ifstream in(ipath); try { in >> doc; } catch (...) {} if (!doc.contains("items") || !doc["items"].is_array()) { doc["items"] = nlohmann::json::array(); } } std::set<uint32_t> used; for (const auto& it : doc["items"]) { if (it.contains("id") && it["id"].is_number_unsigned()) used.insert(it["id"].get<uint32_t>()); } int added = 0; for (int n = 0; n < count; ++n) { int q = std::min(maxQuality, rangeI(0, maxQuality)); int qBucket = std::min(q, 4); const auto& prefixes = kPrefixes[qBucket]; std::string name = prefixes[rangeI(0, static_cast<int>(prefixes.size()) - 1)]; name += " "; name += kNouns[rangeI(0, static_cast<int>(kNouns.size()) - 1)]; uint32_t id = 1; while (used.count(id)) ++id; used.insert(id); int ilvl = std::max(1, rangeI(1, 5) + q * 12 + rangeI(-3, 3)); doc["items"].push_back({ {"id", id}, {"name", name}, {"quality", q}, {"displayId", rangeI(1000, 9999)}, {"itemLevel", ilvl}, {"stackable", q == 0 || q == 1 ? rangeI(1, 20) : 1}, }); added++; } std::ofstream out(ipath); if (!out) { std::fprintf(stderr, "random-populate-items: failed to write %s\n", ipath.c_str()); return 1; } out << doc.dump(2); out.close(); std::printf("random-populate-items: %s\n", ipath.c_str()); std::printf(" seed : %u\n", seed); std::printf(" added : %d\n", added); std::printf(" total items : %zu\n", doc["items"].size()); std::printf(" max quality : %d\n", maxQuality); return 0; } else if (std::strcmp(argv[i], "--gen-random-zone") == 0 && i + 1 < argc) { // End-to-end random zone generator. Composes scaffold-zone // + random-populate-zone + random-populate-items in one // invocation. Useful for "I just want a complete test // zone, don't make me chain three commands." // // Args: // <name> required (becomes the slug) // [tx ty] optional (default 32 32) // --seed N default 42 // --creatures N default 20 // --objects N default 10 // --items N default 25 // // Honors --random-populate-zone's hard caps + the existing // scaffold-zone validation. Sub-commands' output streams // through. std::string name = argv[++i]; int tx = 32, ty = 32; uint32_t seed = 42; int creatures = 20, objects = 10, items = 25; // Optional positional tx/ty (must be before any --flags). if (i + 2 < argc && argv[i + 1][0] != '-' && argv[i + 2][0] != '-') { try { tx = std::stoi(argv[++i]); ty = std::stoi(argv[++i]); } catch (...) {} } while (i + 2 < argc && argv[i + 1][0] == '-') { std::string flag = argv[++i]; if (flag == "--seed") try { seed = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} else if (flag == "--creatures") try { creatures = std::stoi(argv[++i]); } catch (...) {} else if (flag == "--objects") try { objects = std::stoi(argv[++i]); } catch (...) {} else if (flag == "--items") try { items = std::stoi(argv[++i]); } catch (...) {} else { std::fprintf(stderr, "gen-random-zone: unknown flag '%s'\n", flag.c_str()); return 1; } } // Slug-clean the name to match scaffold-zone's expectations. std::string slug; for (char c : name) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') { slug += c; } else if (c == ' ') { slug += '_'; } } if (slug.empty()) { std::fprintf(stderr, "gen-random-zone: name '%s' has no valid characters\n", name.c_str()); return 1; } std::string self = argv[0]; namespace fs = std::filesystem; std::string zoneDir = "custom_zones/" + slug; std::printf("gen-random-zone: %s (tile %d, %d)\n", slug.c_str(), tx, ty); std::fflush(stdout); // 1. Scaffold. std::string scaffoldCmd = "\"" + self + "\" --scaffold-zone \"" + slug + "\" " + std::to_string(tx) + " " + std::to_string(ty); int rc = std::system(scaffoldCmd.c_str()); if (rc != 0) { std::fprintf(stderr, "gen-random-zone: scaffold step failed (rc=%d)\n", rc); return 1; } // 2. Random populate. std::fflush(stdout); std::string popCmd = "\"" + self + "\" --random-populate-zone \"" + zoneDir + "\" --seed " + std::to_string(seed) + " --creatures " + std::to_string(creatures) + " --objects " + std::to_string(objects); rc = std::system(popCmd.c_str()); if (rc != 0) { std::fprintf(stderr, "gen-random-zone: populate step failed (rc=%d)\n", rc); return 1; } // 3. Random items. std::fflush(stdout); std::string itemsCmd = "\"" + self + "\" --random-populate-items \"" + zoneDir + "\" --seed " + std::to_string(seed + 1) + " --count " + std::to_string(items); rc = std::system(itemsCmd.c_str()); if (rc != 0) { std::fprintf(stderr, "gen-random-zone: items step failed (rc=%d)\n", rc); return 1; } std::printf("\ngen-random-zone: complete\n"); std::printf(" zone dir : %s\n", zoneDir.c_str()); std::printf(" creatures : %d\n", creatures); std::printf(" objects : %d\n", objects); std::printf(" items : %d\n", items); return 0; } else if (std::strcmp(argv[i], "--gen-random-project") == 0 && i + 1 < argc) { // Project-wide companion: spawn N random zones in one // pass. Names default to "Zone1, Zone2..."; tile // coordinates step from (32, 32) outward in a simple // raster so they don't overlap. Each zone gets a unique // sub-seed so its random content differs. int count = 0; try { count = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "gen-random-project: <count> must be an integer\n"); return 1; } if (count < 1 || count > 100) { std::fprintf(stderr, "gen-random-project: count %d out of range (1..100)\n", count); return 1; } std::string prefix = "Zone"; uint32_t seed = 100; int creatures = 20, objects = 10, items = 25; while (i + 2 < argc && argv[i + 1][0] == '-') { std::string flag = argv[++i]; if (flag == "--prefix") prefix = argv[++i]; else if (flag == "--seed") try { seed = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} else if (flag == "--creatures") try { creatures = std::stoi(argv[++i]); } catch (...) {} else if (flag == "--objects") try { objects = std::stoi(argv[++i]); } catch (...) {} else if (flag == "--items") try { items = std::stoi(argv[++i]); } catch (...) {} else { std::fprintf(stderr, "gen-random-project: unknown flag '%s'\n", flag.c_str()); return 1; } } std::string self = argv[0]; int produced = 0, failed = 0; std::printf("gen-random-project: %d zone(s) with prefix '%s'\n", count, prefix.c_str()); for (int n = 0; n < count; ++n) { // Step outward from (32, 32) in a small raster so the // tiles don't coincide. (-1,0,1,...) X (-1,0,1,...). int side = 1; while ((2 * side + 1) * (2 * side + 1) <= n) side++; int idx = n; int dx = idx % (2 * side + 1) - side; int dy = (idx / (2 * side + 1)) - side; int tx = std::max(0, std::min(63, 32 + dx)); int ty = std::max(0, std::min(63, 32 + dy)); std::string zoneName = prefix + std::to_string(n + 1); std::printf("\n=== %s (tile %d, %d) ===\n", zoneName.c_str(), tx, ty); std::fflush(stdout); std::string cmd = "\"" + self + "\" --gen-random-zone \"" + zoneName + "\" " + std::to_string(tx) + " " + std::to_string(ty) + " --seed " + std::to_string(seed + n) + " --creatures " + std::to_string(creatures) + " --objects " + std::to_string(objects) + " --items " + std::to_string(items); int rc = std::system(cmd.c_str()); if (rc == 0) produced++; else failed++; } std::printf("\n--- summary ---\n"); std::printf(" produced : %d\n", produced); std::printf(" failed : %d\n", failed); return failed == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--set-item") == 0 && i + 2 < argc) { // Edit fields on an existing item in place. Lookup is by // id by default; '#N' for index lookup. Only specified // flags are changed; everything else is preserved // verbatim — including any extra fields added by hand. // // Supported flags: --name, --quality, --displayId, // --itemLevel, --stackable. Each takes one positional // argument that follows the flag. std::string zoneDir = argv[++i]; std::string lookup = argv[++i]; namespace fs = std::filesystem; std::string path = zoneDir + "/items.json"; if (!fs::exists(path)) { std::fprintf(stderr, "set-item: %s has no items.json\n", zoneDir.c_str()); return 1; } nlohmann::json doc; try { std::ifstream in(path); in >> doc; } catch (...) { std::fprintf(stderr, "set-item: %s is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { std::fprintf(stderr, "set-item: %s has no 'items' array\n", path.c_str()); return 1; } auto& items = doc["items"]; int foundIdx = -1; if (!lookup.empty() && lookup[0] == '#') { try { int idx = std::stoi(lookup.substr(1)); if (idx >= 0 && static_cast<size_t>(idx) < items.size()) foundIdx = idx; } catch (...) {} } else { uint32_t targetId = 0; try { targetId = static_cast<uint32_t>(std::stoul(lookup)); } catch (...) { std::fprintf(stderr, "set-item: lookup '%s' is not a number\n", lookup.c_str()); return 1; } for (size_t k = 0; k < items.size(); ++k) { if (items[k].contains("id") && items[k]["id"].is_number_unsigned() && items[k]["id"].get<uint32_t>() == targetId) { foundIdx = static_cast<int>(k); break; } } } if (foundIdx < 0) { std::fprintf(stderr, "set-item: no match for '%s' in %s\n", lookup.c_str(), path.c_str()); return 1; } auto& it = items[foundIdx]; std::vector<std::string> changes; // Walk the remaining args looking for known --field value // pairs. Anything unrecognized is reported and aborts so // typos don't silently no-op. while (i + 2 < argc) { std::string flag = argv[i + 1]; std::string val = argv[i + 2]; if (flag.size() < 2 || flag[0] != '-' || flag[1] != '-') break; if (flag == "--name") { it["name"] = val; changes.push_back("name=" + val); } else if (flag == "--quality") { try { uint32_t q = static_cast<uint32_t>(std::stoul(val)); if (q > 6) { std::fprintf(stderr, "set-item: quality %u out of range (0..6)\n", q); return 1; } it["quality"] = q; changes.push_back("quality=" + val); } catch (...) { std::fprintf(stderr, "set-item: --quality needs a number\n"); return 1; } } else if (flag == "--displayId") { try { it["displayId"] = static_cast<uint32_t>(std::stoul(val)); changes.push_back("displayId=" + val); } catch (...) { std::fprintf(stderr, "set-item: --displayId needs a number\n"); return 1; } } else if (flag == "--itemLevel") { try { it["itemLevel"] = static_cast<uint32_t>(std::stoul(val)); changes.push_back("itemLevel=" + val); } catch (...) { std::fprintf(stderr, "set-item: --itemLevel needs a number\n"); return 1; } } else if (flag == "--stackable") { try { uint32_t s = static_cast<uint32_t>(std::stoul(val)); if (s == 0 || s > 1000) { std::fprintf(stderr, "set-item: stackable %u out of range (1..1000)\n", s); return 1; } it["stackable"] = s; changes.push_back("stackable=" + val); } catch (...) { std::fprintf(stderr, "set-item: --stackable needs a number\n"); return 1; } } else { std::fprintf(stderr, "set-item: unknown flag '%s' (typo?)\n", flag.c_str()); return 1; } i += 2; } if (changes.empty()) { std::fprintf(stderr, "set-item: no field flags supplied — nothing to change\n"); return 1; } std::ofstream out(path); if (!out) { std::fprintf(stderr, "set-item: failed to write %s\n", path.c_str()); return 1; } out << doc.dump(2); out.close(); std::printf("Updated item %d in %s:\n", foundIdx, path.c_str()); for (const auto& c : changes) { std::printf(" %s\n", c.c_str()); } return 0; } else if (std::strcmp(argv[i], "--export-zone-items-md") == 0 && i + 1 < argc) { // Render items.json as a Markdown table grouped by // quality. Useful for design docs, PR descriptions, and // GitHub Pages — one rendered page communicates the loot // landscape better than scrolling through JSON. std::string zoneDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; std::string path = zoneDir + "/items.json"; if (!fs::exists(path)) { std::fprintf(stderr, "export-zone-items-md: %s has no items.json\n", zoneDir.c_str()); return 1; } nlohmann::json doc; try { std::ifstream in(path); in >> doc; } catch (...) { std::fprintf(stderr, "export-zone-items-md: %s is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { std::fprintf(stderr, "export-zone-items-md: %s has no 'items' array\n", path.c_str()); return 1; } if (outPath.empty()) outPath = zoneDir + "/ITEMS.md"; const auto& items = doc["items"]; static const char* qualityNames[] = { "Poor", "Common", "Uncommon", "Rare", "Epic", "Legendary", "Artifact" }; // Bucket by quality so the report reads top-down from // best loot to filler. Reverse iteration over the buckets. std::map<int, std::vector<size_t>> byQuality; for (size_t k = 0; k < items.size(); ++k) { uint32_t q = items[k].value("quality", 1u); if (q > 6) q = 0; byQuality[q].push_back(k); } std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "export-zone-items-md: cannot write %s\n", outPath.c_str()); return 1; } std::string zoneName = fs::path(zoneDir).filename().string(); out << "# Items: " << zoneName << "\n\n"; out << "Source: `" << path << "` \n"; out << "Total items: **" << items.size() << "**\n\n"; // Quality histogram up top. out << "## Quality breakdown\n\n"; out << "| Quality | Count |\n|---|---:|\n"; for (int q = 6; q >= 0; --q) { auto it = byQuality.find(q); if (it == byQuality.end()) continue; out << "| " << qualityNames[q] << " | " << it->second.size() << " |\n"; } out << "\n"; // Per-quality sections, best first. for (int q = 6; q >= 0; --q) { auto qit = byQuality.find(q); if (qit == byQuality.end()) continue; out << "## " << qualityNames[q] << "\n\n"; out << "| ID | Name | iLvl | Display | Stack |\n"; out << "|---:|---|---:|---:|---:|\n"; for (size_t k : qit->second) { const auto& it = items[k]; std::string name = it.value("name", std::string("(unnamed)")); out << "| " << it.value("id", 0u) << " | " << name << " | " << it.value("itemLevel", 1u) << " | " << it.value("displayId", 0u) << " | " << it.value("stackable", 1u) << " |\n"; } out << "\n"; } out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" total items : %zu\n", items.size()); std::printf(" qualities : %zu (used)\n", byQuality.size()); return 0; } else if (std::strcmp(argv[i], "--export-project-items-md") == 0 && i + 1 < argc) { // Project-wide items markdown. Walks every zone in // <projectDir> and emits one document with: project-wide // header + total + quality histogram, then per-zone // sections each containing a table (ID/name/quality/ // ilvl/displayId/stack). Easier to scan than running // --export-zone-items-md N times. std::string projectDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "export-project-items-md: %s is not a directory\n", projectDir.c_str()); return 1; } if (outPath.empty()) outPath = projectDir + "/ITEMS.md"; std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; if (!fs::exists(entry.path() / "items.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); static const char* qualityNames[] = { "Poor", "Common", "Uncommon", "Rare", "Epic", "Legendary", "Artifact" }; int totalItems = 0; std::map<int, int> globalQ; // Per-zone collected items so we don't have to re-read // each items.json twice. struct ZItems { std::string name; nlohmann::json items; }; std::vector<ZItems> zoneItems; for (const auto& zoneDir : zones) { std::string ipath = zoneDir + "/items.json"; nlohmann::json doc; try { std::ifstream in(ipath); in >> doc; } catch (...) { continue; } if (!doc.contains("items") || !doc["items"].is_array()) continue; ZItems z; z.name = fs::path(zoneDir).filename().string(); z.items = doc["items"]; for (const auto& it : z.items) { int q = static_cast<int>(it.value("quality", 1u)); if (q < 0 || q > 6) q = 0; globalQ[q]++; totalItems++; } zoneItems.push_back(std::move(z)); } std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "export-project-items-md: cannot write %s\n", outPath.c_str()); return 1; } out << "# Project Items: " << fs::path(projectDir).filename().string() << "\n\n"; out << "Source: `" << projectDir << "` \n"; out << "Zones with items: **" << zoneItems.size() << "** \n"; out << "Total items: **" << totalItems << "**\n\n"; out << "## Project quality breakdown\n\n"; out << "| Quality | Count |\n|---|---:|\n"; for (int q = 6; q >= 0; --q) { auto it = globalQ.find(q); if (it == globalQ.end()) continue; out << "| " << qualityNames[q] << " | " << it->second << " |\n"; } out << "\n"; for (const auto& z : zoneItems) { out << "## Zone: " << z.name << "\n\n"; out << "Items: **" << z.items.size() << "**\n\n"; out << "| ID | Name | Quality | iLvl | Display | Stack |\n"; out << "|---:|---|---|---:|---:|---:|\n"; for (const auto& it : z.items) { int q = static_cast<int>(it.value("quality", 1u)); if (q < 0 || q > 6) q = 0; std::string name = it.value("name", std::string("(unnamed)")); out << "| " << it.value("id", 0u) << " | " << name << " | " << qualityNames[q] << " | " << it.value("itemLevel", 1u) << " | " << it.value("displayId", 0u) << " | " << it.value("stackable", 1u) << " |\n"; } out << "\n"; } out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" zones with items : %zu\n", zoneItems.size()); std::printf(" total items : %d\n", totalItems); return 0; } else if (std::strcmp(argv[i], "--export-project-items-csv") == 0 && i + 1 < argc) { // Single CSV with every item across every zone. The // zone name is the first column so a pivot table can // group by it; everything else mirrors --export-zone-csv // items columns. Saves running the per-zone CSV exporter // N times and concatenating manually. std::string projectDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "export-project-items-csv: %s is not a directory\n", projectDir.c_str()); return 1; } if (outPath.empty()) outPath = projectDir + "/items.csv"; std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; if (!fs::exists(entry.path() / "items.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // CSV-escape the same way --export-zone-csv does. auto csvEsc = [](const std::string& s) { bool needs = s.find(',') != std::string::npos || s.find('"') != std::string::npos || s.find('\n') != std::string::npos; if (!needs) return s; std::string out = "\""; for (char c : s) { if (c == '"') out += "\"\""; else out += c; } out += "\""; return out; }; std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "export-project-items-csv: cannot write %s\n", outPath.c_str()); return 1; } out << "zone,index,id,name,quality,itemLevel,displayId,stackable\n"; int totalRows = 0; for (const auto& zoneDir : zones) { std::string zoneName = fs::path(zoneDir).filename().string(); std::string ipath = zoneDir + "/items.json"; nlohmann::json doc; try { std::ifstream in(ipath); in >> doc; } catch (...) { continue; } if (!doc.contains("items") || !doc["items"].is_array()) continue; const auto& items = doc["items"]; for (size_t k = 0; k < items.size(); ++k) { const auto& it = items[k]; out << csvEsc(zoneName) << "," << k << "," << it.value("id", 0u) << "," << csvEsc(it.value("name", std::string())) << "," << it.value("quality", 1u) << "," << it.value("itemLevel", 1u) << "," << it.value("displayId", 0u) << "," << it.value("stackable", 1u) << "\n"; totalRows++; } } out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" zones with items : %zu\n", zones.size()); std::printf(" rows : %d\n", totalRows); return 0; } else if (std::strcmp(argv[i], "--remove-item") == 0 && i + 2 < argc) { // Remove the item at given 0-based index from <zoneDir>/ // items.json. Mirrors --remove-creature/--remove-object/ // --remove-quest semantics — bounds-checked, file rewrites // on success, exit 1 on out-of-range. std::string zoneDir = argv[++i]; int idx = -1; try { idx = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "remove-item: index must be an integer\n"); return 1; } namespace fs = std::filesystem; std::string path = zoneDir + "/items.json"; if (!fs::exists(path)) { std::fprintf(stderr, "remove-item: %s has no items.json\n", zoneDir.c_str()); return 1; } nlohmann::json doc; try { std::ifstream in(path); in >> doc; } catch (...) { std::fprintf(stderr, "remove-item: %s is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { std::fprintf(stderr, "remove-item: %s has no 'items' array\n", path.c_str()); return 1; } auto& items = doc["items"]; if (idx < 0 || static_cast<size_t>(idx) >= items.size()) { std::fprintf(stderr, "remove-item: index %d out of range (have %zu)\n", idx, items.size()); return 1; } std::string removedName = items[idx].value("name", std::string("(unnamed)")); uint32_t removedId = items[idx].value("id", 0u); items.erase(items.begin() + idx); std::ofstream out(path); if (!out) { std::fprintf(stderr, "remove-item: failed to write %s\n", path.c_str()); return 1; } out << doc.dump(2); out.close(); std::printf("Removed item '%s' (id=%u) from %s (now %zu total)\n", removedName.c_str(), removedId, path.c_str(), items.size()); return 0; } else if (std::strcmp(argv[i], "--copy-zone-items") == 0 && i + 2 < argc) { // Copy items from one zone to another. Default mode // replaces the destination items.json wholesale; --merge // appends each source item to the existing destination // list, re-id'ing on collision so the destination's // existing IDs are preserved and the source's new // entries get fresh ones. std::string fromZone = argv[++i]; std::string toZone = argv[++i]; bool mergeMode = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--merge") == 0) { mergeMode = true; i++; } namespace fs = std::filesystem; std::string srcPath = fromZone + "/items.json"; if (!fs::exists(srcPath)) { std::fprintf(stderr, "copy-zone-items: %s has no items.json\n", fromZone.c_str()); return 1; } if (!fs::exists(toZone) || !fs::is_directory(toZone)) { std::fprintf(stderr, "copy-zone-items: dest %s is not a directory\n", toZone.c_str()); return 1; } nlohmann::json src; try { std::ifstream in(srcPath); in >> src; } catch (...) { std::fprintf(stderr, "copy-zone-items: %s is not valid JSON\n", srcPath.c_str()); return 1; } if (!src.contains("items") || !src["items"].is_array()) { std::fprintf(stderr, "copy-zone-items: %s has no 'items' array\n", srcPath.c_str()); return 1; } std::string dstPath = toZone + "/items.json"; nlohmann::json dst = nlohmann::json::object({{"items", nlohmann::json::array()}}); int copied = 0, reIded = 0; if (mergeMode && fs::exists(dstPath)) { try { std::ifstream in(dstPath); in >> dst; } catch (...) {} if (!dst.contains("items") || !dst["items"].is_array()) { dst["items"] = nlohmann::json::array(); } std::set<uint32_t> usedIds; for (const auto& it : dst["items"]) { if (it.contains("id") && it["id"].is_number_unsigned()) { usedIds.insert(it["id"].get<uint32_t>()); } } for (const auto& it : src["items"]) { nlohmann::json newItem = it; uint32_t srcId = it.value("id", 0u); if (srcId == 0 || usedIds.count(srcId)) { // Pick the next free id. uint32_t fresh = 1; while (usedIds.count(fresh)) ++fresh; newItem["id"] = fresh; usedIds.insert(fresh); if (srcId != 0) reIded++; } else { usedIds.insert(srcId); } dst["items"].push_back(newItem); copied++; } } else { // Replace mode: destination becomes a verbatim copy of // the source items array. dst["items"] = src["items"]; copied = static_cast<int>(src["items"].size()); } std::ofstream out(dstPath); if (!out) { std::fprintf(stderr, "copy-zone-items: failed to write %s\n", dstPath.c_str()); return 1; } out << dst.dump(2); out.close(); std::printf("Copied %d item(s) from %s to %s\n", copied, fromZone.c_str(), toZone.c_str()); std::printf(" mode : %s\n", mergeMode ? "merge (append + re-id)" : "replace"); std::printf(" dst total : %zu\n", dst["items"].size()); if (reIded > 0) { std::printf(" re-ided : %d (id collisions)\n", reIded); } return 0; } else if (std::strcmp(argv[i], "--clone-item") == 0 && i + 2 < argc) { // Duplicate the item at given 0-based index. Auto-assigns // the smallest unused positive id; optional <newName> // overrides the cloned name (without it the new entry // gets " (copy)" appended). std::string zoneDir = argv[++i]; int idx = -1; try { idx = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "clone-item: index must be an integer\n"); return 1; } std::string newName; if (i + 1 < argc && argv[i + 1][0] != '-') newName = argv[++i]; namespace fs = std::filesystem; std::string path = zoneDir + "/items.json"; if (!fs::exists(path)) { std::fprintf(stderr, "clone-item: %s has no items.json\n", zoneDir.c_str()); return 1; } nlohmann::json doc; try { std::ifstream in(path); in >> doc; } catch (...) { std::fprintf(stderr, "clone-item: %s is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { std::fprintf(stderr, "clone-item: %s has no 'items' array\n", path.c_str()); return 1; } auto& items = doc["items"]; if (idx < 0 || static_cast<size_t>(idx) >= items.size()) { std::fprintf(stderr, "clone-item: index %d out of range (have %zu)\n", idx, items.size()); return 1; } // Pick the next free id. std::set<uint32_t> used; for (const auto& it : items) { if (it.contains("id") && it["id"].is_number_unsigned()) { used.insert(it["id"].get<uint32_t>()); } } uint32_t newId = 1; while (used.count(newId)) ++newId; nlohmann::json clone = items[idx]; clone["id"] = newId; if (!newName.empty()) { clone["name"] = newName; } else { std::string oldName = clone.value("name", std::string("(unnamed)")); clone["name"] = oldName + " (copy)"; } items.push_back(clone); std::ofstream out(path); if (!out) { std::fprintf(stderr, "clone-item: failed to write %s\n", path.c_str()); return 1; } out << doc.dump(2); out.close(); std::printf("Cloned item idx %d to '%s' (id=%u) in %s (now %zu total)\n", idx, clone["name"].get<std::string>().c_str(), newId, path.c_str(), items.size()); return 0; } else if (std::strcmp(argv[i], "--scaffold-zone") == 0 && i + 1 < argc) { // Generate a minimal valid empty zone — useful for kickstarting // a new authoring session without needing to launch the GUI. std::string rawName = argv[++i]; int sx = 32, sy = 32; if (i + 2 < argc) { int parsedX = std::atoi(argv[i + 1]); int parsedY = std::atoi(argv[i + 2]); if (parsedX >= 0 && parsedX <= 63 && parsedY >= 0 && parsedY <= 63) { sx = parsedX; sy = parsedY; i += 2; } } // Slugify name to match unpackZone / server module rules. std::string slug; for (char c : rawName) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') { slug += c; } else if (c == ' ') { slug += '_'; } } if (slug.empty()) { std::fprintf(stderr, "--scaffold-zone: name '%s' has no valid characters\n", rawName.c_str()); return 1; } namespace fs = std::filesystem; std::string dir = "custom_zones/" + slug; if (fs::exists(dir)) { std::fprintf(stderr, "--scaffold-zone: directory already exists: %s\n", dir.c_str()); return 1; } fs::create_directories(dir); // Blank flat terrain at the requested tile. auto terrain = wowee::editor::TerrainEditor::createBlankTerrain( sx, sy, 100.0f, wowee::editor::Biome::Grassland); std::string base = dir + "/" + slug + "_" + std::to_string(sx) + "_" + std::to_string(sy); wowee::editor::WoweeTerrain::exportOpen(terrain, base, sx, sy); // Minimal zone.json wowee::editor::ZoneManifest manifest; manifest.mapName = slug; manifest.displayName = rawName; manifest.mapId = 9000; manifest.baseHeight = 100.0f; manifest.tiles.push_back({sx, sy}); manifest.save(dir + "/zone.json"); std::printf("Scaffolded zone: %s\n", dir.c_str()); std::printf(" tile : (%d, %d)\n", sx, sy); std::printf(" files : %s.wot, %s.whm, zone.json\n", slug.c_str(), slug.c_str()); std::printf(" next step: run editor without args, then File → Open Zone\n"); return 0; } else if (std::strcmp(argv[i], "--mvp-zone") == 0 && i + 1 < argc) { // Quick-start: scaffold + populate one of each content type // (1 creature, 1 object, 1 quest with objective + reward). // Useful for demos, screenshot bait, smoke tests of the // bake/validate pipeline. The zone goes from empty to // 'something to look at' in one command. std::string rawName = argv[++i]; int sx = 32, sy = 32; if (i + 2 < argc) { int parsedX = std::atoi(argv[i + 1]); int parsedY = std::atoi(argv[i + 2]); if (parsedX >= 0 && parsedX <= 63 && parsedY >= 0 && parsedY <= 63) { sx = parsedX; sy = parsedY; i += 2; } } // Reuse scaffold-zone's slug logic. std::string slug; for (char c : rawName) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') slug += c; else if (c == ' ') slug += '_'; } if (slug.empty()) { std::fprintf(stderr, "mvp-zone: name '%s' has no valid characters\n", rawName.c_str()); return 1; } namespace fs = std::filesystem; std::string dir = "custom_zones/" + slug; if (fs::exists(dir)) { std::fprintf(stderr, "mvp-zone: directory already exists: %s\n", dir.c_str()); return 1; } fs::create_directories(dir); // Scaffold terrain. auto terrain = wowee::editor::TerrainEditor::createBlankTerrain( sx, sy, 100.0f, wowee::editor::Biome::Grassland); std::string base = dir + "/" + slug + "_" + std::to_string(sx) + "_" + std::to_string(sy); wowee::editor::WoweeTerrain::exportOpen(terrain, base, sx, sy); // Manifest. wowee::editor::ZoneManifest zm; zm.mapName = slug; zm.displayName = rawName; zm.mapId = 9000; zm.baseHeight = 100.0f; zm.tiles.push_back({sx, sy}); zm.hasCreatures = true; zm.save(dir + "/zone.json"); // Position the demo content roughly centered in the tile. // Tile (32, 32) is the WoW map origin; tile centers are at // 533.33-yard intervals from there. float centerX = (32.0f - sy) * 533.33333f - 266.667f; float centerY = (32.0f - sx) * 533.33333f - 266.667f; float centerZ = 100.0f; // Demo creature. wowee::editor::NpcSpawner sp; wowee::editor::CreatureSpawn c; c.name = "Demo Wolf"; c.position = {centerX, centerY, centerZ}; c.level = 5; c.health = 100; c.minDamage = 5; c.maxDamage = 10; c.displayId = 11430; // any valid id; renderer falls back if absent sp.getSpawns().push_back(c); sp.saveToFile(dir + "/creatures.json"); // Demo object — a tree placement near the creature. wowee::editor::ObjectPlacer op; wowee::editor::PlacedObject po; po.type = wowee::editor::PlaceableType::M2; po.path = "World/Generic/Tree.m2"; po.position = {centerX + 5.0f, centerY, centerZ}; po.scale = 1.0f; op.getObjects().push_back(po); op.saveToFile(dir + "/objects.json"); // Demo quest with objective + XP reward. wowee::editor::QuestEditor qe; wowee::editor::Quest q; q.title = "Welcome to " + rawName; q.requiredLevel = 1; q.questGiverNpcId = c.id; // self-referential so refs check passes q.turnInNpcId = c.id; q.reward.xp = 100; wowee::editor::QuestObjective obj; obj.type = wowee::editor::QuestObjectiveType::KillCreature; obj.targetName = "Demo Wolf"; obj.targetCount = 1; obj.description = "Slay the Demo Wolf"; q.objectives.push_back(obj); qe.addQuest(q); qe.saveToFile(dir + "/quests.json"); std::printf("Created demo zone: %s\n", dir.c_str()); std::printf(" tile : (%d, %d)\n", sx, sy); std::printf(" contents : 1 creature, 1 object, 1 quest (with objective + reward)\n"); std::printf(" next : wowee_editor --info-zone-tree %s\n", dir.c_str()); return 0; } else if (std::strcmp(argv[i], "--add-tile") == 0 && i + 3 < argc) { // Extend an existing zone with another ADT tile. Zones can // span multiple tiles (e.g. a continent fragment), but // --scaffold-zone only creates one. This adds another: // wowee_editor --add-tile custom_zones/MyZone 29 30 // Generates a fresh blank-flat WHM/WOT pair at the new tile // and appends to the zone manifest's tiles list. std::string zoneDir = argv[++i]; int tx, ty; try { tx = std::stoi(argv[++i]); ty = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "add-tile: bad coordinates\n"); return 1; } float baseHeight = 100.0f; if (i + 1 < argc && argv[i + 1][0] != '-') { try { baseHeight = std::stof(argv[++i]); } catch (...) {} } if (tx < 0 || tx >= 64 || ty < 0 || ty >= 64) { std::fprintf(stderr, "add-tile: tile coord (%d, %d) out of WoW grid [0, 64)\n", tx, ty); return 1; } namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "add-tile: %s has no zone.json — not a zone dir\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "add-tile: failed to parse %s\n", manifestPath.c_str()); return 1; } // Reject duplicates so we don't silently overwrite an existing // tile's heightmap when the user makes a typo. for (const auto& [ex, ey] : zm.tiles) { if (ex == tx && ey == ty) { std::fprintf(stderr, "add-tile: tile (%d, %d) already in manifest\n", tx, ty); return 1; } } // Also bail if the file would clobber an existing one outside // the manifest (e.g. user hand-created tiles without updating // zone.json). Catches drift between disk and manifest. std::string base = zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); if (fs::exists(base + ".whm") || fs::exists(base + ".wot")) { std::fprintf(stderr, "add-tile: %s.{whm,wot} already exists on disk (manifest out of sync?)\n", base.c_str()); return 1; } // Generate the new heightmap. Reuses the same factory that // --scaffold-zone uses, so the output is consistent. auto terrain = wowee::editor::TerrainEditor::createBlankTerrain( tx, ty, baseHeight, wowee::editor::Biome::Grassland); wowee::editor::WoweeTerrain::exportOpen(terrain, base, tx, ty); // Append + save manifest. ZoneManifest::save rebuilds the // files block from the tiles list, so the new adt_tx_ty entry // appears automatically in zone.json. zm.tiles.push_back({tx, ty}); if (!zm.save(manifestPath)) { std::fprintf(stderr, "add-tile: failed to save %s\n", manifestPath.c_str()); return 1; } std::printf("Added tile (%d, %d) to %s\n", tx, ty, zoneDir.c_str()); std::printf(" files : %s.whm, %s.wot\n", (zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty)).c_str(), (zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty)).c_str()); std::printf(" tiles now : %zu total\n", zm.tiles.size()); return 0; } else if (std::strcmp(argv[i], "--remove-tile") == 0 && i + 3 < argc) { // Symmetric counterpart to --add-tile. Drops the entry from // ZoneManifest::tiles AND deletes the WHM/WOT/WOC files on // disk so the zone is left consistent (no orphan sidecars). std::string zoneDir = argv[++i]; int tx, ty; try { tx = std::stoi(argv[++i]); ty = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "remove-tile: bad coordinates\n"); return 1; } namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "remove-tile: %s has no zone.json — not a zone dir\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "remove-tile: failed to parse %s\n", manifestPath.c_str()); return 1; } auto it = std::find_if(zm.tiles.begin(), zm.tiles.end(), [&](const std::pair<int,int>& p) { return p.first == tx && p.second == ty; }); if (it == zm.tiles.end()) { std::fprintf(stderr, "remove-tile: tile (%d, %d) not in manifest\n", tx, ty); return 1; } // Don't strand a zone with zero tiles — server module gen and // pack-wcp both expect at least one. The user can --rename-zone // or rm -rf if they want the zone gone entirely. if (zm.tiles.size() == 1) { std::fprintf(stderr, "remove-tile: refusing to remove last tile (zone would be empty)\n"); return 1; } zm.tiles.erase(it); // Delete the slug-prefixed files for this tile. Use error_code // so we don't throw on missing files — partial removal from // earlier failures shouldn't block cleanup of what's left. std::string base = zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); int deleted = 0; std::error_code ec; for (const char* ext : {".whm", ".wot", ".woc"}) { if (fs::remove(base + ext, ec)) deleted++; } if (!zm.save(manifestPath)) { std::fprintf(stderr, "remove-tile: failed to save %s\n", manifestPath.c_str()); return 1; } std::printf("Removed tile (%d, %d) from %s\n", tx, ty, zoneDir.c_str()); std::printf(" deleted : %d file(s) (.whm/.wot/.woc)\n", deleted); std::printf(" tiles now : %zu remaining\n", zm.tiles.size()); return 0; } else if (std::strcmp(argv[i], "--list-tiles") == 0 && i + 1 < argc) { // Enumerate every tile in the zone manifest with on-disk // file presence — useful for spotting missing/orphan files // before pack-wcp would fail. std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "list-tiles: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "list-tiles: failed to parse %s\n", manifestPath.c_str()); return 1; } auto baseFor = [&](int tx, int ty) { return zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); }; if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["mapName"] = zm.mapName; j["count"] = zm.tiles.size(); nlohmann::json arr = nlohmann::json::array(); for (const auto& [tx, ty] : zm.tiles) { std::string b = baseFor(tx, ty); arr.push_back({ {"x", tx}, {"y", ty}, {"whm", fs::exists(b + ".whm")}, {"wot", fs::exists(b + ".wot")}, {"woc", fs::exists(b + ".woc")}, }); } j["tiles"] = arr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone: %s (%s, %zu tile(s))\n", zoneDir.c_str(), zm.mapName.c_str(), zm.tiles.size()); std::printf(" tx ty whm wot woc\n"); for (const auto& [tx, ty] : zm.tiles) { std::string b = baseFor(tx, ty); std::printf(" %3d %3d %s %s %s\n", tx, ty, fs::exists(b + ".whm") ? "y" : "-", fs::exists(b + ".wot") ? "y" : "-", fs::exists(b + ".woc") ? "y" : "-"); } return 0; } else if (std::strcmp(argv[i], "--copy-zone") == 0 && i + 2 < argc) { // Duplicate a zone — copy every file then rename slug-prefixed // ones (heightmap/terrain/collision sidecars carry the slug in // their filenames, e.g. "Sample_28_30.whm") so the new zone is // self-consistent. Useful for templating: scaffold once, then // copy-zone N times to create variants. std::string srcDir = argv[++i]; std::string rawName = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(srcDir) || !fs::is_directory(srcDir)) { std::fprintf(stderr, "copy-zone: source dir not found: %s\n", srcDir.c_str()); return 1; } if (!fs::exists(srcDir + "/zone.json")) { std::fprintf(stderr, "copy-zone: %s has no zone.json — not a zone dir\n", srcDir.c_str()); return 1; } // Slugify new name (matches scaffold-zone rules so the result // round-trips through unpackZone / server module gen). std::string newSlug; for (char c : rawName) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') { newSlug += c; } else if (c == ' ') { newSlug += '_'; } } if (newSlug.empty()) { std::fprintf(stderr, "copy-zone: name '%s' has no valid characters\n", rawName.c_str()); return 1; } std::string dstDir = "custom_zones/" + newSlug; if (fs::exists(dstDir)) { std::fprintf(stderr, "copy-zone: destination already exists: %s\n", dstDir.c_str()); return 1; } // Read the source slug from its zone.json so we know what // prefix to rewrite. Don't trust the directory name — a user // could have renamed the dir without touching the manifest. wowee::editor::ZoneManifest src; if (!src.load(srcDir + "/zone.json")) { std::fprintf(stderr, "copy-zone: failed to parse %s/zone.json\n", srcDir.c_str()); return 1; } std::string oldSlug = src.mapName; if (oldSlug == newSlug) { std::fprintf(stderr, "copy-zone: new slug matches old (%s); nothing to do\n", oldSlug.c_str()); return 1; } // Recursive copy preserves any subdirs (e.g. data/ for DBC sidecars). std::error_code ec; fs::create_directories(dstDir); fs::copy(srcDir, dstDir, fs::copy_options::recursive | fs::copy_options::copy_symlinks, ec); if (ec) { std::fprintf(stderr, "copy-zone: copy failed: %s\n", ec.message().c_str()); return 1; } // Rename slug-prefixed files inside the destination. Match // "<oldSlug>_..." or "<oldSlug>." so we catch both // "Sample_28_30.whm" and a hypothetical "Sample.wdt". int renamed = 0; for (const auto& entry : fs::recursive_directory_iterator(dstDir)) { if (!entry.is_regular_file()) continue; std::string fname = entry.path().filename().string(); bool match = (fname.size() > oldSlug.size() + 1 && fname.compare(0, oldSlug.size(), oldSlug) == 0 && (fname[oldSlug.size()] == '_' || fname[oldSlug.size()] == '.')); if (!match) continue; std::string newName = newSlug + fname.substr(oldSlug.size()); fs::rename(entry.path(), entry.path().parent_path() / newName, ec); if (!ec) renamed++; } // Rewrite the destination's zone.json with the new slug so its // files-block (rebuilt from mapName by save()) matches the // renamed files on disk. wowee::editor::ZoneManifest dst = src; dst.mapName = newSlug; dst.displayName = rawName; if (!dst.save(dstDir + "/zone.json")) { std::fprintf(stderr, "copy-zone: failed to write %s/zone.json\n", dstDir.c_str()); return 1; } std::printf("Copied %s -> %s\n", srcDir.c_str(), dstDir.c_str()); std::printf(" mapName : %s -> %s\n", oldSlug.c_str(), newSlug.c_str()); std::printf(" renamed : %d slug-prefixed file(s)\n", renamed); return 0; } else if (std::strcmp(argv[i], "--rename-zone") == 0 && i + 2 < argc) { // In-place rename — like --copy-zone but no copy. Useful when // the user wants to fix a typo or change a name without // doubling disk usage. Renames the directory itself too // (Old/ -> New/ under the same parent), so paths shift. std::string srcDir = argv[++i]; std::string rawName = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(srcDir) || !fs::is_directory(srcDir)) { std::fprintf(stderr, "rename-zone: source dir not found: %s\n", srcDir.c_str()); return 1; } if (!fs::exists(srcDir + "/zone.json")) { std::fprintf(stderr, "rename-zone: %s has no zone.json — not a zone dir\n", srcDir.c_str()); return 1; } std::string newSlug; for (char c : rawName) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') { newSlug += c; } else if (c == ' ') { newSlug += '_'; } } if (newSlug.empty()) { std::fprintf(stderr, "rename-zone: name '%s' has no valid characters\n", rawName.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(srcDir + "/zone.json")) { std::fprintf(stderr, "rename-zone: failed to parse %s/zone.json\n", srcDir.c_str()); return 1; } std::string oldSlug = zm.mapName; if (oldSlug == newSlug && rawName == zm.displayName) { std::fprintf(stderr, "rename-zone: nothing to do (slug=%s, displayName=%s already match)\n", oldSlug.c_str(), rawName.c_str()); return 1; } // Compute target directory: same parent, new slug name. If the // current directory name already matches the new slug, skip // the dir rename (only manifest + slug-prefixed files change). fs::path srcPath = fs::absolute(srcDir); fs::path parent = srcPath.parent_path(); fs::path dstPath = parent / newSlug; bool needDirRename = (srcPath.filename() != newSlug); if (needDirRename && fs::exists(dstPath)) { std::fprintf(stderr, "rename-zone: target dir already exists: %s\n", dstPath.string().c_str()); return 1; } // Rename slug-prefixed files inside the source dir BEFORE // moving the directory — fewer paths to fix up if anything // fails midway. fs::rename is atomic per-call. std::error_code ec; int renamed = 0; for (const auto& entry : fs::recursive_directory_iterator(srcDir)) { if (!entry.is_regular_file()) continue; std::string fname = entry.path().filename().string(); bool match = (oldSlug != newSlug && fname.size() > oldSlug.size() + 1 && fname.compare(0, oldSlug.size(), oldSlug) == 0 && (fname[oldSlug.size()] == '_' || fname[oldSlug.size()] == '.')); if (!match) continue; std::string newName = newSlug + fname.substr(oldSlug.size()); fs::rename(entry.path(), entry.path().parent_path() / newName, ec); if (!ec) renamed++; } // Update manifest and save BEFORE the dir rename so the file // exists at the path we're saving to. zm.mapName = newSlug; zm.displayName = rawName; if (!zm.save(srcDir + "/zone.json")) { std::fprintf(stderr, "rename-zone: failed to write zone.json\n"); return 1; } // Now move the directory itself. std::string finalDir = srcDir; if (needDirRename) { fs::rename(srcPath, dstPath, ec); if (ec) { std::fprintf(stderr, "rename-zone: dir rename failed (%s); manifest already updated\n", ec.message().c_str()); return 1; } finalDir = dstPath.string(); } std::printf("Renamed %s -> %s\n", srcDir.c_str(), finalDir.c_str()); std::printf(" mapName : %s -> %s\n", oldSlug.c_str(), newSlug.c_str()); std::printf(" renamed : %d slug-prefixed file(s)\n", renamed); return 0; } else if (std::strcmp(argv[i], "--remove-zone") == 0 && i + 1 < argc) { // Delete a zone directory entirely. Requires --confirm to // actually delete (defense against accidental destruction // and against shell glob mishaps). Without --confirm, // just lists what would be deleted. std::string zoneDir = argv[++i]; bool confirm = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--confirm") == 0) { confirm = true; i++; } namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "remove-zone: %s does not exist\n", zoneDir.c_str()); return 1; } if (!fs::exists(zoneDir + "/zone.json")) { // Belt-and-suspenders: refuse to wipe anything that doesn't // look like a zone dir, even with --confirm. Catches typos // like '--remove-zone .' that would nuke the whole project. std::fprintf(stderr, "remove-zone: %s has no zone.json — refusing to delete (not a zone dir)\n", zoneDir.c_str()); return 1; } // Read manifest for the user-facing name. wowee::editor::ZoneManifest zm; std::string zoneName = zoneDir; if (zm.load(zoneDir + "/zone.json")) { zoneName = zm.displayName.empty() ? zm.mapName : zm.displayName; } // Walk for what would be removed (counts + total bytes). int fileCount = 0; uint64_t totalBytes = 0; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; fileCount++; totalBytes += e.file_size(ec); } if (!confirm) { std::printf("remove-zone: %s ('%s')\n", zoneDir.c_str(), zoneName.c_str()); std::printf(" would delete: %d file(s), %.1f KB\n", fileCount, totalBytes / 1024.0); std::printf(" re-run with --confirm to actually delete\n"); return 0; } // Confirmed — wipe it. uintmax_t removed = fs::remove_all(zoneDir, ec); if (ec) { std::fprintf(stderr, "remove-zone: failed to remove %s (%s)\n", zoneDir.c_str(), ec.message().c_str()); return 1; } std::printf("Removed %s ('%s')\n", zoneDir.c_str(), zoneName.c_str()); std::printf(" deleted: %ju filesystem entries, %.1f KB freed\n", static_cast<uintmax_t>(removed), totalBytes / 1024.0); return 0; } else if (std::strcmp(argv[i], "--clear-zone-content") == 0 && i + 1 < argc) { // Wipe content files (creatures.json / objects.json / // quests.json) from a zone while keeping terrain + manifest // intact. Useful for templating: --copy-zone gives you a // duplicate; --clear-zone-content turns it into an empty // shell ready for fresh population. // // Pass --creatures / --objects / --quests to wipe individually, // or --all to wipe everything. At least one selector is required. std::string zoneDir = argv[++i]; bool wipeCreatures = false, wipeObjects = false, wipeQuests = false; while (i + 1 < argc && argv[i + 1][0] == '-') { std::string opt = argv[i + 1]; if (opt == "--creatures") { wipeCreatures = true; ++i; } else if (opt == "--objects") { wipeObjects = true; ++i; } else if (opt == "--quests") { wipeQuests = true; ++i; } else if (opt == "--all") { wipeCreatures = wipeObjects = wipeQuests = true; ++i; } else break; // unknown flag — stop consuming, surface the error } if (!wipeCreatures && !wipeObjects && !wipeQuests) { std::fprintf(stderr, "clear-zone-content: pass --creatures / --objects / --quests / --all\n"); return 1; } namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "clear-zone-content: %s has no zone.json — not a zone dir\n", zoneDir.c_str()); return 1; } // Delete (not blank-write) so the next --info-* doesn't see // an empty file and report 'total: 0' as if data existed. // Missing files are the canonical 'no content' state. int deleted = 0; std::error_code ec; auto wipe = [&](const std::string& fname) { std::string p = zoneDir + "/" + fname; if (fs::exists(p) && fs::remove(p, ec)) { ++deleted; std::printf(" removed : %s\n", fname.c_str()); } else if (fs::exists(p)) { std::fprintf(stderr, " WARN: failed to remove %s (%s)\n", p.c_str(), ec.message().c_str()); } else { std::printf(" skipped : %s (already absent)\n", fname.c_str()); } }; std::printf("Cleared content from %s\n", zoneDir.c_str()); if (wipeCreatures) wipe("creatures.json"); if (wipeObjects) wipe("objects.json"); if (wipeQuests) wipe("quests.json"); // Also reset manifest.hasCreatures so server module gen // doesn't expect an NPC table that's no longer there. if (wipeCreatures) { wowee::editor::ZoneManifest zm; if (zm.load(zoneDir + "/zone.json")) { if (zm.hasCreatures) { zm.hasCreatures = false; zm.save(zoneDir + "/zone.json"); std::printf(" updated : zone.json hasCreatures = false\n"); } } } std::printf(" removed : %d file(s) total\n", deleted); return 0; } else if (std::strcmp(argv[i], "--strip-zone") == 0 && i + 1 < argc) { // Cleanup pass: remove the derived outputs (.glb/.obj/.stl/ // .html/.dot/.csv/ZONE.md/DEPS.md) leaving only source files // (zone.json + content JSONs + open binary formats). Useful // before --pack-wcp so the archive doesn't carry redundant // exports, or before committing to git so derived blobs // don't bloat history. // // Optional --dry-run flag previews what would be removed // without actually deleting anything. std::string zoneDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "strip-zone: %s has no zone.json\n", zoneDir.c_str()); return 1; } // Whitelist of derived extensions. PNG is special-cased: it // can be either a derived export (heightmap preview at zone // root) or a source sidecar (BLP→PNG inside data/). Only // strip PNGs at the top-level zone dir. auto isDerivedExt = [](const std::string& ext) { return ext == ".glb" || ext == ".obj" || ext == ".stl" || ext == ".html" || ext == ".dot" || ext == ".csv"; }; auto isDerivedFilename = [](const std::string& name) { return name == "ZONE.md" || name == "DEPS.md" || name == "quests.dot"; }; int removed = 0; uint64_t bytesFreed = 0; std::error_code ec; // Top-level only — do NOT recurse into data/ (those are // source sidecars). for (const auto& e : fs::directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); std::string name = e.path().filename().string(); bool kill = false; if (isDerivedExt(ext)) kill = true; if (isDerivedFilename(name)) kill = true; // PNG at zone root is derived (--export-png); PNGs inside // data/ are source. Top-level loop only sees the root // dir, so .png here is always derived. if (ext == ".png") kill = true; if (!kill) continue; uint64_t sz = e.file_size(ec); if (dryRun) { std::printf(" would remove: %s (%llu bytes)\n", name.c_str(), static_cast<unsigned long long>(sz)); } else { if (fs::remove(e.path(), ec)) { std::printf(" removed: %s (%llu bytes)\n", name.c_str(), static_cast<unsigned long long>(sz)); removed++; bytesFreed += sz; } else { std::fprintf(stderr, " WARN: failed to remove %s (%s)\n", name.c_str(), ec.message().c_str()); } } } std::printf("\nstrip-zone: %s%s\n", zoneDir.c_str(), dryRun ? " (dry-run)" : ""); if (dryRun) { std::printf(" pass --dry-run off to actually delete\n"); } else { std::printf(" removed : %d file(s)\n", removed); std::printf(" freed : %.1f KB\n", bytesFreed / 1024.0); } return 0; } else if (std::strcmp(argv[i], "--strip-project") == 0 && i + 1 < argc) { // Project-wide wrapper around --strip-zone. Walks every zone // in <projectDir>, removes derived outputs at each zone's // top level, and reports per-zone removed/freed counts plus // an aggregate. Honors --dry-run for safe previews. std::string projectDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "strip-project: %s is not a directory\n", projectDir.c_str()); return 1; } // Same derived-classifier as --strip-zone — keep in sync. auto isDerivedExt = [](const std::string& ext) { return ext == ".glb" || ext == ".obj" || ext == ".stl" || ext == ".html" || ext == ".dot" || ext == ".csv"; }; auto isDerivedFilename = [](const std::string& name) { return name == "ZONE.md" || name == "DEPS.md" || name == "quests.dot"; }; std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); struct ZRow { std::string name; int removed = 0; uint64_t freed = 0; }; std::vector<ZRow> rows; int totalRemoved = 0; uint64_t totalFreed = 0; int totalFailed = 0; for (const auto& zoneDir : zones) { ZRow r; r.name = fs::path(zoneDir).filename().string(); std::error_code ec; for (const auto& e : fs::directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); std::string name = e.path().filename().string(); bool kill = false; if (isDerivedExt(ext)) kill = true; if (isDerivedFilename(name)) kill = true; if (ext == ".png") kill = true; if (!kill) continue; uint64_t sz = e.file_size(ec); if (dryRun) { r.removed++; r.freed += sz; } else { if (fs::remove(e.path(), ec)) { r.removed++; r.freed += sz; } else { std::fprintf(stderr, " WARN: failed to remove %s/%s (%s)\n", r.name.c_str(), name.c_str(), ec.message().c_str()); totalFailed++; } } } totalRemoved += r.removed; totalFreed += r.freed; rows.push_back(r); } std::printf("strip-project: %s%s\n", projectDir.c_str(), dryRun ? " (dry-run)" : ""); std::printf(" zones : %zu\n", zones.size()); std::printf("\n zone removed freed\n"); for (const auto& r : rows) { std::printf(" %-26s %5d %9.1f KB\n", r.name.substr(0, 26).c_str(), r.removed, r.freed / 1024.0); } std::printf("\n totals%s : %d file(s), %.1f KB\n", dryRun ? " (would-remove)" : " ", totalRemoved, totalFreed / 1024.0); if (dryRun) { std::printf(" pass --dry-run off to actually delete\n"); } return totalFailed == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--gen-texture") == 0 && i + 2 < argc) { // Synthesize a placeholder PNG texture. Lets users add a // working texture to their project without an external // image editor — useful for prototyping new meshes, // filling out a zone before art is final, or generating // test fixtures. // // <colorHex|pattern>: // "RRGGBB" or "RGB" hex (case-insensitive) → solid color // "checker" → 32x32 black/white checkerboard // "grid" → black background with white 1-px grid every 16 std::string outPath = argv[++i]; std::string spec = argv[++i]; int W = 256, H = 256; if (i + 1 < argc && argv[i + 1][0] != '-') { try { W = std::stoi(argv[++i]); } catch (...) {} } if (i + 1 < argc && argv[i + 1][0] != '-') { try { H = std::stoi(argv[++i]); } catch (...) {} } if (W < 1 || H < 1 || W > 8192 || H > 8192) { std::fprintf(stderr, "gen-texture: invalid size %dx%d (must be 1..8192)\n", W, H); return 1; } std::vector<uint8_t> pixels(static_cast<size_t>(W) * H * 3, 0); std::string lower = spec; std::transform(lower.begin(), lower.end(), lower.begin(), [](unsigned char c) { return std::tolower(c); }); if (lower == "checker") { for (int y = 0; y < H; ++y) { for (int x = 0; x < W; ++x) { bool dark = ((x / 32) + (y / 32)) & 1; uint8_t v = dark ? 16 : 240; size_t i2 = (static_cast<size_t>(y) * W + x) * 3; pixels[i2 + 0] = v; pixels[i2 + 1] = v; pixels[i2 + 2] = v; } } } else if (lower == "grid") { for (int y = 0; y < H; ++y) { for (int x = 0; x < W; ++x) { bool line = (x % 16 == 0) || (y % 16 == 0); uint8_t v = line ? 240 : 32; size_t i2 = (static_cast<size_t>(y) * W + x) * 3; pixels[i2 + 0] = v; pixels[i2 + 1] = v; pixels[i2 + 2] = v; } } } else { // Hex color. Accept "RGB" (3 chars) or "RRGGBB" (6 chars), // optional leading '#'. std::string hex = lower; if (!hex.empty() && hex[0] == '#') hex.erase(0, 1); auto fromHex = [](char c) -> int { if (c >= '0' && c <= '9') return c - '0'; if (c >= 'a' && c <= 'f') return 10 + c - 'a'; return -1; }; uint8_t r = 0, g = 0, b = 0; if (hex.size() == 6) { int hi, lo; if ((hi = fromHex(hex[0])) < 0) goto bad_color; if ((lo = fromHex(hex[1])) < 0) goto bad_color; r = static_cast<uint8_t>((hi << 4) | lo); if ((hi = fromHex(hex[2])) < 0) goto bad_color; if ((lo = fromHex(hex[3])) < 0) goto bad_color; g = static_cast<uint8_t>((hi << 4) | lo); if ((hi = fromHex(hex[4])) < 0) goto bad_color; if ((lo = fromHex(hex[5])) < 0) goto bad_color; b = static_cast<uint8_t>((hi << 4) | lo); } else if (hex.size() == 3) { int v0, v1, v2; if ((v0 = fromHex(hex[0])) < 0) goto bad_color; if ((v1 = fromHex(hex[1])) < 0) goto bad_color; if ((v2 = fromHex(hex[2])) < 0) goto bad_color; r = static_cast<uint8_t>((v0 << 4) | v0); g = static_cast<uint8_t>((v1 << 4) | v1); b = static_cast<uint8_t>((v2 << 4) | v2); } else { goto bad_color; } for (int y = 0; y < H; ++y) { for (int x = 0; x < W; ++x) { size_t i2 = (static_cast<size_t>(y) * W + x) * 3; pixels[i2 + 0] = r; pixels[i2 + 1] = g; pixels[i2 + 2] = b; } } goto color_ok; bad_color: std::fprintf(stderr, "gen-texture: '%s' is not a valid hex color or 'checker'/'grid'\n", spec.c_str()); return 1; color_ok: ; } if (!stbi_write_png(outPath.c_str(), W, H, 3, pixels.data(), W * 3)) { std::fprintf(stderr, "gen-texture: stbi_write_png failed for %s\n", outPath.c_str()); return 1; } std::printf("Wrote %s\n", outPath.c_str()); std::printf(" size : %dx%d\n", W, H); std::printf(" spec : %s\n", spec.c_str()); return 0; } else if (std::strcmp(argv[i], "--add-texture-to-zone") == 0 && i + 2 < argc) { // Import an existing PNG into a zone directory. Useful // for the "I have an artist-painted texture, get it into // my project" workflow — complements --gen-texture // (procedural placeholder) and --convert-blp-png (legacy // BLP migration). // // Optional <renameTo> argument lets the user store the // PNG under a project-specific name (e.g., a generic // "stone.png" downloaded from a tileset becomes // "courtyard_floor.png" in the zone). // // Refuses to overwrite an existing destination unless the // source and destination are byte-identical (idempotent // re-runs are safe). std::string zoneDir = argv[++i]; std::string srcPng = argv[++i]; std::string renameTo; if (i + 1 < argc && argv[i + 1][0] != '-') renameTo = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir) || !fs::is_directory(zoneDir)) { std::fprintf(stderr, "add-texture-to-zone: %s is not a directory\n", zoneDir.c_str()); return 1; } if (!fs::exists(srcPng) || !fs::is_regular_file(srcPng)) { std::fprintf(stderr, "add-texture-to-zone: %s is not a file\n", srcPng.c_str()); return 1; } // Sanity-check: must end in .png (any case) so users // don't accidentally drop a .blp/.tga and get surprised // when nothing renders. std::string srcExt = fs::path(srcPng).extension().string(); std::transform(srcExt.begin(), srcExt.end(), srcExt.begin(), [](unsigned char c) { return std::tolower(c); }); if (srcExt != ".png") { std::fprintf(stderr, "add-texture-to-zone: %s is not a .png " "(use --convert-blp-png for .blp first)\n", srcPng.c_str()); return 1; } std::string destLeaf = renameTo.empty() ? fs::path(srcPng).filename().string() : renameTo; // If the rename arg lacks an extension, append .png so // common typos ("stone" -> "stone.png") just work. if (fs::path(destLeaf).extension().string().empty()) { destLeaf += ".png"; } std::string destPath = zoneDir + "/" + destLeaf; std::error_code ec; if (fs::exists(destPath)) { // Allow re-running if the bytes already match — makes // makefile-driven workflows idempotent. if (fs::file_size(srcPng, ec) == fs::file_size(destPath, ec)) { std::ifstream a(srcPng, std::ios::binary); std::ifstream b(destPath, std::ios::binary); std::stringstream sa, sb; sa << a.rdbuf(); sb << b.rdbuf(); if (sa.str() == sb.str()) { std::printf("Already present: %s (no-op)\n", destPath.c_str()); return 0; } } std::fprintf(stderr, "add-texture-to-zone: %s already exists with different " "content (delete it first if intentional)\n", destPath.c_str()); return 1; } fs::copy_file(srcPng, destPath, ec); if (ec) { std::fprintf(stderr, "add-texture-to-zone: copy failed (%s)\n", ec.message().c_str()); return 1; } uint64_t bytes = fs::file_size(destPath, ec); std::printf("Imported %s -> %s\n", srcPng.c_str(), destPath.c_str()); std::printf(" bytes : %llu\n", static_cast<unsigned long long>(bytes)); std::printf(" next : --add-texture-to-mesh <wom-base> %s\n", destPath.c_str()); return 0; } else if (std::strcmp(argv[i], "--repair-zone") == 0 && i + 1 < argc) { // Auto-fix the common manifest-vs-disk drift issues that // accumulate when a zone is hand-edited or partially copied: // - WHM/WOT files exist on disk but tile not in manifest // -> add to tiles // - manifest hasCreatures=false but creatures.json exists // and is non-empty -> set true // - manifest hasCreatures=true but no creatures.json or // empty -> clear false // // Tiles in manifest with NO disk files are NOT auto-removed // (they may indicate work-in-progress); they're warned about // so the user can decide. // // --dry-run flag previews changes without writing. std::string zoneDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "repair-zone: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "repair-zone: parse failed\n"); return 1; } int fixes = 0, warnings = 0; // Pass 1: scan disk for WHM files matching mapName_X_Y.whm // pattern. Match against manifest tiles. Anything on disk // but missing from manifest gets queued for addition. std::set<std::pair<int,int>> manifestTiles( zm.tiles.begin(), zm.tiles.end()); std::set<std::pair<int,int>> diskTiles; std::error_code ec; for (const auto& e : fs::directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string name = e.path().filename().string(); if (e.path().extension() != ".whm") continue; // Expect "<mapName>_TX_TY.whm". Parse out the two // integers between the last two underscores. std::string stem = name.substr(0, name.size() - 4); std::string prefix = zm.mapName + "_"; if (stem.size() <= prefix.size() || stem.substr(0, prefix.size()) != prefix) { continue; // doesn't match map slug } std::string coords = stem.substr(prefix.size()); auto under = coords.find('_'); if (under == std::string::npos) continue; try { int tx = std::stoi(coords.substr(0, under)); int ty = std::stoi(coords.substr(under + 1)); diskTiles.insert({tx, ty}); } catch (...) {} } // Tiles on disk but not in manifest -> add. std::vector<std::pair<int,int>> toAdd; for (const auto& d : diskTiles) { if (manifestTiles.count(d) == 0) toAdd.push_back(d); } for (const auto& [tx, ty] : toAdd) { std::printf(" %s tile (%d, %d) to manifest\n", dryRun ? "would add" : "added", tx, ty); if (!dryRun) zm.tiles.push_back({tx, ty}); fixes++; } // Tiles in manifest but no .whm on disk -> warn (not auto-removed). for (const auto& m : manifestTiles) { if (diskTiles.count(m) == 0) { std::printf(" WARN: tile (%d, %d) in manifest but no %s_%d_%d.whm on disk\n", m.first, m.second, zm.mapName.c_str(), m.first, m.second); warnings++; } } // hasCreatures flag sync. bool creaturesPresent = false; wowee::editor::NpcSpawner sp; if (sp.loadFromFile(zoneDir + "/creatures.json") && sp.spawnCount() > 0) { creaturesPresent = true; } if (zm.hasCreatures != creaturesPresent) { std::printf(" %s hasCreatures: %s -> %s\n", dryRun ? "would set" : "set", zm.hasCreatures ? "true" : "false", creaturesPresent ? "true" : "false"); if (!dryRun) zm.hasCreatures = creaturesPresent; fixes++; } if (!dryRun && fixes > 0) { if (!zm.save(manifestPath)) { std::fprintf(stderr, "repair-zone: failed to write %s\n", manifestPath.c_str()); return 1; } } std::printf("\nrepair-zone: %s%s\n", zoneDir.c_str(), dryRun ? " (dry-run)" : ""); std::printf(" fixes : %d\n", fixes); std::printf(" warnings : %d (manual decision needed)\n", warnings); if (dryRun && fixes > 0) { std::printf(" re-run without --dry-run to apply\n"); } return 0; } else if (std::strcmp(argv[i], "--repair-project") == 0 && i + 1 < argc) { // Project-wide wrapper around --repair-zone. Spawns the // binary per-zone so each zone's full repair report // streams through, then aggregates a final tally. Honors // --dry-run for safe previews. std::string projectDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "repair-project: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); std::string self = argv[0]; int totalFailed = 0; std::printf("repair-project: %s%s\n", projectDir.c_str(), dryRun ? " (dry-run)" : ""); std::printf(" zones : %zu\n", zones.size()); for (const auto& zoneDir : zones) { std::printf("\n--- %s ---\n", fs::path(zoneDir).filename().string().c_str()); // Flush so the section marker lands before the spawned // child's stdout — std::system inherits FDs but each // process has its own buffer. std::fflush(stdout); std::string cmd = "\"" + self + "\" --repair-zone \"" + zoneDir + "\"" + (dryRun ? " --dry-run" : ""); int rc = std::system(cmd.c_str()); if (rc != 0) totalFailed++; } std::printf("\n--- summary ---\n"); std::printf(" zones processed : %zu\n", zones.size()); std::printf(" failures : %d\n", totalFailed); if (dryRun) { std::printf(" re-run without --dry-run to apply changes\n"); } return totalFailed == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--gen-makefile") == 0 && i + 1 < argc) { // Generate a Makefile that rebuilds every derived output for // a zone. With this in place, designers can `make` to refresh // glb/obj/stl/html/csv/md from sources after editing // creatures.json or terrain — without remembering which // wowee_editor flag does what. The Makefile uses dependency // tracking so only stale outputs get rebuilt. std::string zoneDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "gen-makefile: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "gen-makefile: parse failed\n"); return 1; } if (outPath.empty()) outPath = zoneDir + "/Makefile"; std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "gen-makefile: cannot write %s\n", outPath.c_str()); return 1; } // Use a single absolute editor path so the Makefile works // from any cwd (running `make -C custom_zones/MyZone` etc.). std::error_code ec; std::string editorBin = fs::canonical("/proc/self/exe", ec).string(); if (ec || editorBin.empty()) editorBin = "wowee_editor"; // Per-tile WHM/WOT inputs feed the bake targets. Compose the // list once so all targets share the same dep set. std::string tileWhmDeps; for (const auto& [tx, ty] : zm.tiles) { tileWhmDeps += " " + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty) + ".whm"; } std::string slug = zm.mapName; out << "# Generated by wowee_editor --gen-makefile\n" "# Zone: " << slug << "\n" "# Run from this directory: `make` to rebuild all\n" "# derived outputs from sources, `make clean` to wipe.\n\n"; out << "EDITOR := " << editorBin << "\n"; out << "ZONE := .\n\n"; // Source dep aggregations for content-derived outputs. out << "CONTENT_SRCS := zone.json $(wildcard creatures.json) " "$(wildcard objects.json) $(wildcard quests.json)\n"; out << "TERRAIN_SRCS := zone.json" << tileWhmDeps << "\n\n"; out << ".PHONY: all clean glb obj stl html docs csv graph\n\n"; out << "all: glb obj stl html docs csv graph\n\n"; // Each target lists its dependencies so make can skip already- // up-to-date outputs. out << "glb: " << slug << ".glb\n" << slug << ".glb: $(TERRAIN_SRCS)\n" << "\t$(EDITOR) --bake-zone-glb $(ZONE)\n\n"; out << "obj: " << slug << ".obj\n" << slug << ".obj: $(TERRAIN_SRCS)\n" << "\t$(EDITOR) --bake-zone-obj $(ZONE)\n\n"; out << "stl: " << slug << ".stl\n" << slug << ".stl: $(TERRAIN_SRCS)\n" << "\t$(EDITOR) --bake-zone-stl $(ZONE)\n\n"; out << "html: " << slug << ".html\n" << slug << ".html: " << slug << ".glb\n" << "\t$(EDITOR) --export-zone-html $(ZONE)\n\n"; out << "docs: ZONE.md DEPS.md\n"; out << "ZONE.md: $(CONTENT_SRCS)\n" << "\t$(EDITOR) --export-zone-summary-md $(ZONE)\n"; out << "DEPS.md: zone.json $(wildcard objects.json) $(wildcard *.wob)\n" << "\t$(EDITOR) --export-zone-deps-md $(ZONE)\n\n"; // CSV + graph targets use '-' prefix so missing-content // (zone without creatures/quests) doesn't fail the whole // 'make all'. The editor prints the error to stderr; make // continues with the next target. out << "csv:\n" << "\t-$(EDITOR) --export-zone-csv $(ZONE)\n\n"; out << "graph:\n" << "\t-$(EDITOR) --export-quest-graph $(ZONE)\n\n"; out << "clean:\n" << "\t$(EDITOR) --strip-zone $(ZONE)\n\n"; out << "validate:\n" << "\t$(EDITOR) --validate-all $(ZONE)\n"; out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" zone : %s\n", slug.c_str()); std::printf(" tiles : %zu (terrain dep)\n", zm.tiles.size()); std::printf(" next : cd %s && make\n", zoneDir.c_str()); return 0; } else if (std::strcmp(argv[i], "--gen-project-makefile") == 0 && i + 1 < argc) { // Top-level Makefile that delegates to per-zone Makefiles. // Pairs with --gen-makefile (per-zone): one project-level // command rebuilds every zone's derived outputs in parallel. // // wowee_editor --gen-project-makefile custom_zones // make -C custom_zones -j$(nproc) # all zones in parallel std::string projectDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "gen-project-makefile: %s is not a directory\n", projectDir.c_str()); return 1; } if (outPath.empty()) outPath = projectDir + "/Makefile"; // Find zones (dirs with zone.json). std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().filename().string()); } std::sort(zones.begin(), zones.end()); if (zones.empty()) { std::fprintf(stderr, "gen-project-makefile: no zones found in %s\n", projectDir.c_str()); return 1; } std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "gen-project-makefile: cannot write %s\n", outPath.c_str()); return 1; } std::error_code ec; std::string editorBin = fs::canonical("/proc/self/exe", ec).string(); if (ec || editorBin.empty()) editorBin = "wowee_editor"; out << "# Generated by wowee_editor --gen-project-makefile\n" "# Project: " << projectDir << " (" << zones.size() << " zones)\n" "# Run from this dir: `make` to rebuild all zone outputs.\n" "# Pass -j to make for parallel zone builds across cores.\n\n"; out << "EDITOR := " << editorBin << "\n\n"; out << "ZONES := "; for (const auto& z : zones) out << z << " "; out << "\n\n"; out << ".PHONY: all clean validate index html stats $(addsuffix -bake,$(ZONES)) " "$(addsuffix -clean,$(ZONES)) $(addsuffix -validate,$(ZONES))\n\n"; // Aggregate phony targets: 'make' rebuilds all zones; 'make // ZONE-bake' targets just one. The per-zone Makefile must // exist (regenerate via --gen-makefile if not). out << "all: $(addsuffix -bake,$(ZONES)) index\n\n"; for (const auto& z : zones) { out << z << "-bake:\n"; out << "\t@if [ ! -f " << z << "/Makefile ]; then \\\n" << "\t $(EDITOR) --gen-makefile " << z << " >/dev/null; fi\n"; out << "\t$(MAKE) -C " << z << " all\n\n"; out << z << "-clean:\n"; out << "\t-$(EDITOR) --strip-zone " << z << "\n\n"; out << z << "-validate:\n"; out << "\t$(EDITOR) --validate-all " << z << "\n\n"; } // Top-level utility targets. out << "clean: $(addsuffix -clean,$(ZONES))\n\n"; out << "validate: $(addsuffix -validate,$(ZONES))\n\n"; out << "index:\n" << "\t$(EDITOR) --export-project-html .\n\n"; out << "stats:\n" << "\t$(EDITOR) --zone-stats .\n\n"; out << "tilemap:\n" << "\t$(EDITOR) --info-tilemap .\n"; out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" %zu zone(s) wired up\n", zones.size()); std::printf(" next: make -C %s -j$(nproc)\n", projectDir.c_str()); return 0; } else if (std::strcmp(argv[i], "--list-zones") == 0) { // Optional --json after the flag for machine-readable output. bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; auto zones = wowee::pipeline::CustomZoneDiscovery::scan({"custom_zones", "output"}); if (jsonOut) { nlohmann::json j = nlohmann::json::array(); for (const auto& z : zones) { nlohmann::json zoneObj; zoneObj["name"] = z.name; zoneObj["directory"] = z.directory; zoneObj["mapId"] = z.mapId; zoneObj["author"] = z.author; zoneObj["description"] = z.description; zoneObj["hasCreatures"] = z.hasCreatures; zoneObj["hasQuests"] = z.hasQuests; nlohmann::json tiles = nlohmann::json::array(); for (const auto& t : z.tiles) tiles.push_back({t.first, t.second}); zoneObj["tiles"] = tiles; j.push_back(std::move(zoneObj)); } std::printf("%s\n", j.dump(2).c_str()); return 0; } if (zones.empty()) { std::printf("No custom zones found in custom_zones/ or output/\n"); } else { std::printf("Custom zones found:\n"); for (const auto& z : zones) { std::printf(" %s — %s%s%s\n", z.name.c_str(), z.directory.c_str(), z.hasCreatures ? " [NPCs]" : "", z.hasQuests ? " [Quests]" : ""); } } return 0; } else if (std::strcmp(argv[i], "--zone-stats") == 0 && i + 1 < argc) { // Multi-zone aggregator. Walks <projectDir> for every dir // with a zone.json and emits totals across the project: // tile counts, creature/object/quest counts, on-disk byte // sizes per format. Useful for content-pack release notes // and capacity planning. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "zone-stats: %s is not a directory\n", projectDir.c_str()); return 1; } // Collect zone dirs. std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (fs::exists(entry.path() / "zone.json")) { zones.push_back(entry.path().string()); } } std::sort(zones.begin(), zones.end()); // Aggregate. struct Totals { int zoneCount = 0; int tileCount = 0; int creatures = 0, objects = 0, quests = 0; int hostileCreatures = 0; int chainedQuests = 0; uint64_t totalXp = 0; uint64_t whmBytes = 0, wotBytes = 0, wocBytes = 0; uint64_t womBytes = 0, wobBytes = 0; uint64_t pngBytes = 0, jsonBytes = 0; uint64_t otherBytes = 0; } T; T.zoneCount = static_cast<int>(zones.size()); // Per-zone breakdown for the table view (kept short — not // every field, just the high-signal ones). struct ZoneRow { std::string name; int tiles = 0, creatures = 0, objects = 0, quests = 0; uint64_t bytes = 0; }; std::vector<ZoneRow> rows; for (const auto& zoneDir : zones) { wowee::editor::ZoneManifest zm; if (!zm.load(zoneDir + "/zone.json")) continue; wowee::editor::NpcSpawner sp; sp.loadFromFile(zoneDir + "/creatures.json"); wowee::editor::ObjectPlacer op; op.loadFromFile(zoneDir + "/objects.json"); wowee::editor::QuestEditor qe; qe.loadFromFile(zoneDir + "/quests.json"); ZoneRow row; row.name = zm.mapName.empty() ? fs::path(zoneDir).filename().string() : zm.mapName; row.tiles = static_cast<int>(zm.tiles.size()); row.creatures = static_cast<int>(sp.spawnCount()); row.objects = static_cast<int>(op.getObjects().size()); row.quests = static_cast<int>(qe.questCount()); T.tileCount += row.tiles; T.creatures += row.creatures; T.objects += row.objects; T.quests += row.quests; for (const auto& s : sp.getSpawns()) { if (s.hostile) T.hostileCreatures++; } for (const auto& q : qe.getQuests()) { if (q.nextQuestId != 0) T.chainedQuests++; T.totalXp += q.reward.xp; } // Walk on-disk files in the zone (recursive — sub-dirs // like data/ may hold sidecars). Bucket by extension. std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; uint64_t sz = e.file_size(ec); if (ec) continue; row.bytes += sz; std::string ext = e.path().extension().string(); std::transform(ext.begin(), ext.end(), ext.begin(), [](unsigned char c) { return std::tolower(c); }); if (ext == ".whm") T.whmBytes += sz; else if (ext == ".wot") T.wotBytes += sz; else if (ext == ".woc") T.wocBytes += sz; else if (ext == ".wom") T.womBytes += sz; else if (ext == ".wob") T.wobBytes += sz; else if (ext == ".png") T.pngBytes += sz; else if (ext == ".json") T.jsonBytes += sz; else T.otherBytes += sz; } rows.push_back(row); } uint64_t totalBytes = T.whmBytes + T.wotBytes + T.wocBytes + T.womBytes + T.wobBytes + T.pngBytes + T.jsonBytes + T.otherBytes; if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["zoneCount"] = T.zoneCount; j["tileCount"] = T.tileCount; j["creatures"] = T.creatures; j["hostileCreatures"] = T.hostileCreatures; j["objects"] = T.objects; j["quests"] = T.quests; j["chainedQuests"] = T.chainedQuests; j["totalXp"] = T.totalXp; j["bytes"] = { {"whm", T.whmBytes}, {"wot", T.wotBytes}, {"woc", T.wocBytes}, {"wom", T.womBytes}, {"wob", T.wobBytes}, {"png", T.pngBytes}, {"json", T.jsonBytes}, {"other", T.otherBytes}, {"total", totalBytes} }; nlohmann::json zarr = nlohmann::json::array(); for (const auto& r : rows) { zarr.push_back({ {"name", r.name}, {"tiles", r.tiles}, {"creatures", r.creatures}, {"objects", r.objects}, {"quests", r.quests}, {"bytes", r.bytes} }); } j["zones"] = zarr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone stats: %s\n", projectDir.c_str()); std::printf(" zones : %d\n", T.zoneCount); std::printf(" tiles : %d total\n", T.tileCount); std::printf(" creatures : %d (%d hostile)\n", T.creatures, T.hostileCreatures); std::printf(" objects : %d\n", T.objects); std::printf(" quests : %d (%d chained, %llu total XP)\n", T.quests, T.chainedQuests, static_cast<unsigned long long>(T.totalXp)); constexpr double kKB = 1024.0; std::printf(" bytes : %.1f KB total\n", totalBytes / kKB); std::printf(" whm/wot : %.1f KB / %.1f KB\n", T.whmBytes / kKB, T.wotBytes / kKB); std::printf(" woc : %.1f KB\n", T.wocBytes / kKB); std::printf(" wom/wob : %.1f KB / %.1f KB\n", T.womBytes / kKB, T.wobBytes / kKB); std::printf(" png/json : %.1f KB / %.1f KB\n", T.pngBytes / kKB, T.jsonBytes / kKB); if (T.otherBytes > 0) { std::printf(" other : %.1f KB\n", T.otherBytes / kKB); } std::printf("\n per-zone breakdown:\n"); std::printf(" name tiles creat obj quest bytes\n"); for (const auto& r : rows) { std::printf(" %-18s %5d %5d %3d %5d %7.1f KB\n", r.name.substr(0, 18).c_str(), r.tiles, r.creatures, r.objects, r.quests, r.bytes / kKB); } return 0; } else if (std::strcmp(argv[i], "--info-tilemap") == 0 && i + 1 < argc) { // Visualize the WoW 64x64 ADT grid showing which tiles are // claimed by which zones across a project. Useful for // spotting tile-coord collisions before two zones try to // ship overlapping content, and for getting a 'where am I // working?' overview of a multi-zone project. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "info-tilemap: %s is not a directory\n", projectDir.c_str()); return 1; } // Map (tx, ty) -> vector<zone names> so collision overlaps // are visible. Walk every zone in the project. std::map<std::pair<int,int>, std::vector<std::string>> claims; std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; wowee::editor::ZoneManifest zm; if (!zm.load((entry.path() / "zone.json").string())) continue; std::string zname = zm.mapName.empty() ? entry.path().filename().string() : zm.mapName; zones.push_back(zname); for (const auto& [tx, ty] : zm.tiles) { if (tx >= 0 && tx < 64 && ty >= 0 && ty < 64) { claims[{tx, ty}].push_back(zname); } } } // Per-zone label glyph: first letter of the zone name, // uppercased so different zones get distinct chars in the // grid. Multi-letter overlap collapses to '*'. std::map<std::string, char> zoneGlyph; char nextGlyph = 'A'; for (const auto& z : zones) { if (zoneGlyph.count(z)) continue; if (!z.empty() && std::isalpha(static_cast<unsigned char>(z[0]))) { zoneGlyph[z] = static_cast<char>(std::toupper(static_cast<unsigned char>(z[0]))); } else { zoneGlyph[z] = nextGlyph++; if (nextGlyph > 'Z') nextGlyph = 'a'; } } int collisions = 0; for (const auto& [coord, owners] : claims) { if (owners.size() > 1) collisions++; } if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["zoneCount"] = zones.size(); j["claimedTiles"] = claims.size(); j["collisions"] = collisions; nlohmann::json claimsJson = nlohmann::json::array(); for (const auto& [coord, owners] : claims) { claimsJson.push_back({{"x", coord.first}, {"y", coord.second}, {"zones", owners}}); } j["claims"] = claimsJson; std::printf("%s\n", j.dump(2).c_str()); return collisions == 0 ? 0 : 1; } std::printf("Tilemap: %s\n", projectDir.c_str()); std::printf(" zones : %zu\n", zones.size()); std::printf(" tiles used : %zu\n", claims.size()); std::printf(" collisions : %d (multiple zones claiming same tile)\n", collisions); std::printf(" legend :"); for (const auto& [name, glyph] : zoneGlyph) { std::printf(" %c=%s", glyph, name.c_str()); } std::printf("\n\n"); // Render 64x64 grid. Print column header in groups of 10 // for readability. std::printf(" "); for (int x = 0; x < 64; ++x) { std::printf("%c", (x % 10 == 0) ? '0' + (x / 10) : ' '); } std::printf("\n"); std::printf(" "); for (int x = 0; x < 64; ++x) std::printf("%d", x % 10); std::printf("\n"); for (int y = 0; y < 64; ++y) { // Skip rows that have no tiles claimed — keeps the // output bounded for projects in one corner of the map. bool rowHasContent = false; for (int x = 0; x < 64 && !rowHasContent; ++x) { if (claims.count({x, y})) rowHasContent = true; } if (!rowHasContent) continue; std::printf(" y=%2d ", y); for (int x = 0; x < 64; ++x) { auto it = claims.find({x, y}); if (it == claims.end()) { std::printf("."); } else if (it->second.size() > 1) { std::printf("*"); // collision } else { std::printf("%c", zoneGlyph[it->second[0]]); } } std::printf("\n"); } if (collisions > 0) { std::printf("\n COLLISIONS:\n"); for (const auto& [coord, owners] : claims) { if (owners.size() < 2) continue; std::printf(" (%d, %d) claimed by:", coord.first, coord.second); for (const auto& o : owners) std::printf(" %s", o.c_str()); std::printf("\n"); } } return collisions == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--list-zone-deps") == 0 && i + 1 < argc) { // Enumerate every external model path a zone references — // both directly placed (objects.json) and indirectly via // doodad placements inside any WOB sitting next to the // zone manifest. Useful when packaging a content pack to // confirm every needed asset will ship. std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "list-zone-deps: %s has no zone.json\n", zoneDir.c_str()); return 1; } // Collect with usage counts so duplicates report '×N' instead // of cluttering the table. std::map<std::string, int> directM2; // m2 placements std::map<std::string, int> directWMO; // wmo placements std::map<std::string, int> doodadM2; // m2s referenced inside WOBs wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.type == wowee::editor::PlaceableType::M2) directM2[o.path]++; else if (o.type == wowee::editor::PlaceableType::WMO) directWMO[o.path]++; } } // Walk WOBs in the zone directory recursively and pull in // their doodad model paths. Sub-dirs caught too in case the // user organizes buildings under a buildings/ subfolder. int wobCount = 0; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); if (ext != ".wob") continue; wobCount++; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto bld = wowee::pipeline::WoweeBuildingLoader::load(base); for (const auto& d : bld.doodads) { if (d.modelPath.empty()) continue; doodadM2[d.modelPath]++; } } // For each direct WMO placement, also recurse into the WOB // sitting at that path (relative to the zone) so transitive // doodad deps surface — this matches the runtime's actual // load chain. for (const auto& [path, count] : directWMO) { // Strip extension since loader takes a base path. std::string base = path; if (base.size() >= 4 && base.substr(base.size() - 4) == ".wmo") base = base.substr(0, base.size() - 4); // Try relative-to-zone first, then absolute. std::string trial = zoneDir + "/" + base; if (!wowee::pipeline::WoweeBuildingLoader::exists(trial)) trial = base; if (!wowee::pipeline::WoweeBuildingLoader::exists(trial)) continue; auto bld = wowee::pipeline::WoweeBuildingLoader::load(trial); for (const auto& d : bld.doodads) { if (d.modelPath.empty()) continue; doodadM2[d.modelPath]++; } } size_t totalUnique = directM2.size() + directWMO.size() + doodadM2.size(); if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["wobCount"] = wobCount; j["totalUnique"] = totalUnique; auto toArr = [](const std::map<std::string, int>& m) { nlohmann::json a = nlohmann::json::array(); for (const auto& [path, count] : m) { a.push_back({{"path", path}, {"count", count}}); } return a; }; j["directM2"] = toArr(directM2); j["directWMO"] = toArr(directWMO); j["doodadM2"] = toArr(doodadM2); std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone deps: %s\n", zoneDir.c_str()); std::printf(" WOBs scanned : %d\n", wobCount); std::printf(" unique paths total : %zu\n", totalUnique); auto emit = [](const char* tag, const std::map<std::string, int>& m) { std::printf("\n %s (%zu unique):\n", tag, m.size()); if (m.empty()) { std::printf(" *none*\n"); return; } for (const auto& [path, count] : m) { if (count > 1) std::printf(" %s ×%d\n", path.c_str(), count); else std::printf(" %s\n", path.c_str()); } }; emit("Direct M2 placements", directM2); emit("Direct WMO placements", directWMO); emit("WOB doodad M2 refs", doodadM2); return 0; } else if (std::strcmp(argv[i], "--list-project-orphans") == 0 && i + 1 < argc) { // Inverse of --list-zone-deps. Walks every zone in // <projectDir>, collects the set of .wom/.wob files // sitting on disk and the set of paths actually // referenced by objects.json placements + WOB doodad // lists. Files in the first set but not the second are // orphans — candidates for removal before --pack-wcp so // the archive doesn't carry dead weight. // // Comparison is by basename (extension stripped) since // the reference paths sometimes include the extension and // sometimes don't. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "list-project-orphans: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // Project-wide reference set. Normalize by stripping // extension and any leading "./". auto normalize = [](std::string p) { while (p.size() >= 2 && p[0] == '.' && p[1] == '/') p.erase(0, 2); std::string ext = fs::path(p).extension().string(); if (ext == ".wom" || ext == ".wob" || ext == ".m2" || ext == ".wmo") { p = p.substr(0, p.size() - ext.size()); } return p; }; std::set<std::string> referencedBases; // normalized basenames for (const auto& zoneDir : zones) { wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.path.empty()) continue; // Reference can be relative to zone or just a // bare model name; record both forms for the // membership test. std::string norm = normalize(o.path); referencedBases.insert(norm); // Also try the leaf basename so unqualified // refs match. referencedBases.insert(fs::path(norm).filename().string()); } } std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; if (e.path().extension() != ".wob") continue; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto bld = wowee::pipeline::WoweeBuildingLoader::load(base); for (const auto& d : bld.doodads) { if (d.modelPath.empty()) continue; std::string norm = normalize(d.modelPath); referencedBases.insert(norm); referencedBases.insert(fs::path(norm).filename().string()); } } } // Now walk every zone again and flag orphan .wom/.wob files. struct Orphan { std::string zone, path; uint64_t bytes; }; std::vector<Orphan> orphans; uint64_t totalOrphanBytes = 0; for (const auto& zoneDir : zones) { std::string zoneName = fs::path(zoneDir).filename().string(); std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); if (ext != ".wom" && ext != ".wob") continue; std::string rel = fs::relative(e.path(), zoneDir, ec).string(); if (ec) rel = e.path().filename().string(); std::string normRel = rel.substr(0, rel.size() - ext.size()); std::string leaf = e.path().stem().string(); if (referencedBases.count(normRel) || referencedBases.count(leaf)) { continue; // referenced, not orphan } uint64_t sz = e.file_size(ec); if (ec) sz = 0; orphans.push_back({zoneName, rel, sz}); totalOrphanBytes += sz; } } std::sort(orphans.begin(), orphans.end(), [](const Orphan& a, const Orphan& b) { if (a.zone != b.zone) return a.zone < b.zone; return a.path < b.path; }); if (jsonOut) { nlohmann::json j; j["project"] = projectDir; j["referencedCount"] = referencedBases.size(); j["orphanCount"] = orphans.size(); j["orphanBytes"] = totalOrphanBytes; nlohmann::json arr = nlohmann::json::array(); for (const auto& o : orphans) { arr.push_back({{"zone", o.zone}, {"path", o.path}, {"bytes", o.bytes}}); } j["orphans"] = arr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Project orphans: %s\n", projectDir.c_str()); std::printf(" zones scanned : %zu\n", zones.size()); std::printf(" refs collected : %zu (normalized basenames)\n", referencedBases.size()); std::printf(" orphan .wom/.wob : %zu file(s), %.1f KB\n", orphans.size(), totalOrphanBytes / 1024.0); if (orphans.empty()) { std::printf("\n (no orphans — every model file is referenced)\n"); return 0; } std::printf("\n zone bytes path\n"); for (const auto& o : orphans) { std::printf(" %-20s %8llu %s\n", o.zone.substr(0, 20).c_str(), static_cast<unsigned long long>(o.bytes), o.path.c_str()); } return 0; } else if (std::strcmp(argv[i], "--remove-project-orphans") == 0 && i + 1 < argc) { // Destructive companion to --list-project-orphans. Reuses // the same reference-collection + orphan-detection logic // and then deletes the resulting files. --dry-run shows // what would be removed without touching anything. std::string projectDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "remove-project-orphans: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // Same normalize + reference collection as --list-project-orphans. // Keep both functions in sync if the matching rules evolve. auto normalize = [](std::string p) { while (p.size() >= 2 && p[0] == '.' && p[1] == '/') p.erase(0, 2); std::string ext = fs::path(p).extension().string(); if (ext == ".wom" || ext == ".wob" || ext == ".m2" || ext == ".wmo") { p = p.substr(0, p.size() - ext.size()); } return p; }; std::set<std::string> referencedBases; for (const auto& zoneDir : zones) { wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.path.empty()) continue; std::string norm = normalize(o.path); referencedBases.insert(norm); referencedBases.insert(fs::path(norm).filename().string()); } } std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; if (e.path().extension() != ".wob") continue; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto bld = wowee::pipeline::WoweeBuildingLoader::load(base); for (const auto& d : bld.doodads) { if (d.modelPath.empty()) continue; std::string norm = normalize(d.modelPath); referencedBases.insert(norm); referencedBases.insert(fs::path(norm).filename().string()); } } } int removed = 0, failed = 0; uint64_t freedBytes = 0; for (const auto& zoneDir : zones) { std::string zoneName = fs::path(zoneDir).filename().string(); std::error_code ec; std::vector<fs::path> toRemove; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); if (ext != ".wom" && ext != ".wob") continue; std::string rel = fs::relative(e.path(), zoneDir, ec).string(); if (ec) rel = e.path().filename().string(); std::string normRel = rel.substr(0, rel.size() - ext.size()); std::string leaf = e.path().stem().string(); if (referencedBases.count(normRel) || referencedBases.count(leaf)) continue; toRemove.push_back(e.path()); } // Materialize the deletion list before removing so we // don't mutate the directory while iterating. for (const auto& p : toRemove) { uint64_t sz = fs::file_size(p, ec); if (ec) sz = 0; std::string rel = fs::relative(p, zoneDir, ec).string(); if (ec) rel = p.filename().string(); if (dryRun) { std::printf(" would remove: %s/%s (%llu bytes)\n", zoneName.c_str(), rel.c_str(), static_cast<unsigned long long>(sz)); removed++; freedBytes += sz; } else { if (fs::remove(p, ec)) { std::printf(" removed: %s/%s (%llu bytes)\n", zoneName.c_str(), rel.c_str(), static_cast<unsigned long long>(sz)); removed++; freedBytes += sz; } else { std::fprintf(stderr, " WARN: failed to remove %s (%s)\n", p.c_str(), ec.message().c_str()); failed++; } } } } std::printf("\nremove-project-orphans: %s%s\n", projectDir.c_str(), dryRun ? " (dry-run)" : ""); std::printf(" zones : %zu\n", zones.size()); std::printf(" refs : %zu (normalized basenames)\n", referencedBases.size()); std::printf(" %s : %d file(s)\n", dryRun ? "would remove" : "removed ", removed); std::printf(" freed : %.1f KB\n", freedBytes / 1024.0); if (failed > 0) { std::printf(" FAILED : %d (see stderr)\n", failed); } if (dryRun && removed > 0) { std::printf(" re-run without --dry-run to apply\n"); } return failed == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--export-zone-deps-md") == 0 && i + 1 < argc) { // Markdown counterpart to --list-zone-deps. Writes a sortable // GitHub-rendered table of every external model the zone // references plus on-disk presence (so PR reviewers see at a // glance whether dependencies are accounted for in the // accompanying asset bundle). std::string zoneDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "export-zone-deps-md: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; zm.load(zoneDir + "/zone.json"); if (outPath.empty()) outPath = zoneDir + "/DEPS.md"; // Same dep-collection pass as --list-zone-deps. std::map<std::string, int> directM2; std::map<std::string, int> directWMO; std::map<std::string, int> doodadM2; wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.type == wowee::editor::PlaceableType::M2) directM2[o.path]++; else if (o.type == wowee::editor::PlaceableType::WMO) directWMO[o.path]++; } } int wobCount = 0; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file() || e.path().extension() != ".wob") continue; wobCount++; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto bld = wowee::pipeline::WoweeBuildingLoader::load(base); for (const auto& d : bld.doodads) { if (!d.modelPath.empty()) doodadM2[d.modelPath]++; } } // Resolve dep on disk. Same heuristic as --check-zone-refs: // try both open + proprietary in conventional roots. auto stripExt = [](const std::string& p, const char* ext) { size_t n = std::strlen(ext); if (p.size() >= n) { std::string tail = p.substr(p.size() - n); std::string lower = tail; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (lower == ext) return p.substr(0, p.size() - n); } return p; }; auto resolveStatus = [&](const std::string& path, bool isWMO) { std::string base, openExt, propExt; if (isWMO) { base = stripExt(path, ".wmo"); openExt = ".wob"; propExt = ".wmo"; } else { base = stripExt(path, ".m2"); openExt = ".wom"; propExt = ".m2"; } std::vector<std::string> roots = { "", zoneDir + "/", "output/", "custom_zones/", "Data/" }; bool hasOpen = false, hasProp = false; for (const auto& root : roots) { if (fs::exists(root + base + openExt)) hasOpen = true; if (fs::exists(root + base + propExt)) hasProp = true; } if (hasOpen && hasProp) return "open + proprietary"; if (hasOpen) return "open only"; if (hasProp) return "proprietary only"; return "MISSING"; }; std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "export-zone-deps-md: cannot write %s\n", outPath.c_str()); return 1; } out << "# Dependencies — " << (zm.displayName.empty() ? zm.mapName : zm.displayName) << "\n\n"; out << "*Auto-generated by `wowee_editor --export-zone-deps-md`. " "Status is best-effort — checks zone-local, output/, " "custom_zones/, Data/ roots in that order.*\n\n"; auto emitTable = [&](const char* heading, const std::map<std::string,int>& m, bool isWMO) { out << "## " << heading << " (" << m.size() << ")\n\n"; if (m.empty()) { out << "*None.*\n\n"; return; } out << "| Refs | Path | Status |\n"; out << "|---:|---|---|\n"; for (const auto& [path, count] : m) { out << "| " << count << " | `" << path << "` | " << resolveStatus(path, isWMO) << " |\n"; } out << "\n"; }; emitTable("Direct M2 placements", directM2, false); emitTable("Direct WMO placements", directWMO, true); emitTable("WOB doodad M2 refs", doodadM2, false); out << "## Summary\n\n"; out << "- Zone: `" << zm.mapName << "`\n"; out << "- WOBs scanned: " << wobCount << "\n"; out << "- Unique dependencies: " << directM2.size() + directWMO.size() + doodadM2.size() << "\n"; out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" %zu M2 placements, %zu WMO placements, %zu WOB doodad refs\n", directM2.size(), directWMO.size(), doodadM2.size()); return 0; } else if (std::strcmp(argv[i], "--export-zone-spawn-png") == 0 && i + 1 < argc) { // Top-down PNG of spawn positions colored by type. Bound by // the zone's tile range so the image is properly framed. // Useful for design review (does the spawn distribution // match the intended encounter design?) and for showing // collaborators 'where are the mobs'. std::string zoneDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "export-zone-spawn-png: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "export-zone-spawn-png: parse failed\n"); return 1; } if (zm.tiles.empty()) { std::fprintf(stderr, "export-zone-spawn-png: zone has no tiles\n"); return 1; } if (outPath.empty()) outPath = zoneDir + "/" + zm.mapName + "_spawns.png"; // Compute world-space bounds from manifest tiles. Same math // as --info-zone-extents. constexpr float kTileSize = 533.33333f; int tileMinX = 64, tileMaxX = -1; int tileMinY = 64, tileMaxY = -1; for (const auto& [tx, ty] : zm.tiles) { tileMinX = std::min(tileMinX, tx); tileMaxX = std::max(tileMaxX, tx); tileMinY = std::min(tileMinY, ty); tileMaxY = std::max(tileMaxY, ty); } float worldMinX = (32.0f - tileMaxY - 1) * kTileSize; float worldMaxX = (32.0f - tileMinY) * kTileSize; float worldMinY = (32.0f - tileMaxX - 1) * kTileSize; float worldMaxY = (32.0f - tileMinX) * kTileSize; // Image dimensions: 256px per tile so detail is visible // without inflating per-pixel cost. int tilesX = tileMaxY - tileMinY + 1; // tile.y maps to world.x int tilesY = tileMaxX - tileMinX + 1; const int kPxPerTile = 256; int imgW = tilesX * kPxPerTile; int imgH = tilesY * kPxPerTile; // Cap output size — 16-tile-wide projects shouldn't exceed // 4096 wide. Scale down if needed. int maxDim = std::max(imgW, imgH); if (maxDim > 4096) { int divisor = (maxDim + 4095) / 4096; imgW = std::max(64, imgW / divisor); imgH = std::max(64, imgH / divisor); } std::vector<uint8_t> img(imgW * imgH * 3, 32); // dark grey background // Tile-grid lines so the boundary is visible. for (int t = 1; t < tilesX; ++t) { int x = (t * imgW) / tilesX; if (x >= 0 && x < imgW) { for (int y = 0; y < imgH; ++y) { size_t off = (y * imgW + x) * 3; img[off] = img[off+1] = img[off+2] = 64; } } } for (int t = 1; t < tilesY; ++t) { int y = (t * imgH) / tilesY; if (y >= 0 && y < imgH) { for (int x = 0; x < imgW; ++x) { size_t off = (y * imgW + x) * 3; img[off] = img[off+1] = img[off+2] = 64; } } } // Plot spawn points. Map world (X, Y) to image (px, py): // px = (worldMaxX - X) / (worldMaxX - worldMinX) * imgW // py = (worldMaxY - Y) / (worldMaxY - worldMinY) * imgH // since +X world is north (up) and +Y world is west (left) // in WoW coords. float wRangeX = worldMaxX - worldMinX; float wRangeY = worldMaxY - worldMinY; auto plotPoint = [&](float wx, float wy, uint8_t r, uint8_t g, uint8_t b) { if (wRangeX <= 0 || wRangeY <= 0) return; int px = static_cast<int>((worldMaxX - wx) / wRangeX * imgW); int py = static_cast<int>((worldMaxY - wy) / wRangeY * imgH); // 3×3 dot. for (int dy = -1; dy <= 1; ++dy) { for (int dx = -1; dx <= 1; ++dx) { int x = px + dx, y = py + dy; if (x < 0 || x >= imgW || y < 0 || y >= imgH) continue; size_t off = (y * imgW + x) * 3; img[off] = r; img[off+1] = g; img[off+2] = b; } } }; // Creatures = red. wowee::editor::NpcSpawner sp; int creaturesPlotted = 0; if (sp.loadFromFile(zoneDir + "/creatures.json")) { for (const auto& s : sp.getSpawns()) { plotPoint(s.position.x, s.position.y, 220, 60, 60); creaturesPlotted++; } } // Objects = green (M2) / blue (WMO). wowee::editor::ObjectPlacer op; int objectsPlotted = 0; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.type == wowee::editor::PlaceableType::M2) { plotPoint(o.position.x, o.position.y, 60, 200, 60); } else { plotPoint(o.position.x, o.position.y, 60, 120, 220); } objectsPlotted++; } } if (!stbi_write_png(outPath.c_str(), imgW, imgH, 3, img.data(), imgW * 3)) { std::fprintf(stderr, "export-zone-spawn-png: stbi_write_png failed\n"); return 1; } std::printf("Wrote %s\n", outPath.c_str()); std::printf(" %dx%d px, tile grid %dx%d, %d creatures (red), %d objects (green/blue)\n", imgW, imgH, tilesX, tilesY, creaturesPlotted, objectsPlotted); return 0; } else if (std::strcmp(argv[i], "--check-zone-refs") == 0 && i + 1 < argc) { // Cross-reference checker: every model path in objects.json // must resolve as either an open WOM/WOB sidecar or a // proprietary M2/WMO; every quest's giver/turnIn NPC ID must // appear in creatures.json (when the zone has creatures). // Catches dangling references that --validate doesn't, since // --validate only checks open-format file presence. std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "check-zone-refs: %s has no zone.json\n", zoneDir.c_str()); return 1; } // Try to find a model on disk in any of the conventional // locations (zone-local, output/, custom_zones/, Data/). // Strips extension and tries each open + proprietary variant. auto stripExt = [](const std::string& p, const char* ext) { size_t n = std::strlen(ext); if (p.size() >= n) { std::string tail = p.substr(p.size() - n); std::string lower = tail; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (lower == ext) return p.substr(0, p.size() - n); } return p; }; auto modelExists = [&](const std::string& path, bool isWMO) { std::string base; std::vector<std::string> exts; if (isWMO) { base = stripExt(path, ".wmo"); exts = {".wob", ".wmo"}; } else { base = stripExt(path, ".m2"); exts = {".wom", ".m2"}; } std::vector<std::string> roots = { "", zoneDir + "/", "output/", "custom_zones/", "Data/" }; for (const auto& root : roots) { for (const auto& ext : exts) { if (fs::exists(root + base + ext)) return true; // Case-fold fallback for case-sensitive filesystems // (designers usually type Mixed Case but Linux // stores asset paths lowercase after extraction). std::string lower = base + ext; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (fs::exists(root + lower)) return true; } } return false; }; std::vector<std::string> errors; // Object placements -> models on disk wowee::editor::ObjectPlacer op; int objectsChecked = 0, objectsMissing = 0; if (op.loadFromFile(zoneDir + "/objects.json")) { for (size_t k = 0; k < op.getObjects().size(); ++k) { const auto& o = op.getObjects()[k]; objectsChecked++; bool isWMO = (o.type == wowee::editor::PlaceableType::WMO); if (!modelExists(o.path, isWMO)) { objectsMissing++; if (errors.size() < 30) { errors.push_back("object[" + std::to_string(k) + "] missing: " + o.path); } } } } // Quest NPCs -> creatures.json IDs (only when creatures exist; // otherwise NPC IDs may legitimately reference upstream content // outside the zone). wowee::editor::NpcSpawner sp; wowee::editor::QuestEditor qe; int questsChecked = 0, questsMissing = 0; bool hasCreatures = sp.loadFromFile(zoneDir + "/creatures.json"); std::unordered_set<uint32_t> creatureIds; if (hasCreatures) { for (const auto& s : sp.getSpawns()) creatureIds.insert(s.id); } if (qe.loadFromFile(zoneDir + "/quests.json") && hasCreatures) { for (size_t k = 0; k < qe.getQuests().size(); ++k) { const auto& q = qe.getQuests()[k]; questsChecked++; bool localGiver = (q.questGiverNpcId != 0 && creatureIds.count(q.questGiverNpcId) == 0); bool localTurn = (q.turnInNpcId != 0 && q.turnInNpcId != q.questGiverNpcId && creatureIds.count(q.turnInNpcId) == 0); // Only flag IDs that look 'small' (likely zone-local). // Production uses 6-digit IDs that reference upstream // content; designers wire those in deliberately. if (localGiver && q.questGiverNpcId < 100000) { questsMissing++; if (errors.size() < 30) { errors.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' giver " + std::to_string(q.questGiverNpcId) + " not in creatures.json"); } } if (localTurn && q.turnInNpcId < 100000) { questsMissing++; if (errors.size() < 30) { errors.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' turn-in " + std::to_string(q.turnInNpcId) + " not in creatures.json"); } } } } int totalErrors = objectsMissing + questsMissing; if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["objectsChecked"] = objectsChecked; j["objectsMissing"] = objectsMissing; j["questsChecked"] = questsChecked; j["questsMissing"] = questsMissing; j["errors"] = errors; j["passed"] = (totalErrors == 0); std::printf("%s\n", j.dump(2).c_str()); return totalErrors == 0 ? 0 : 1; } std::printf("Zone refs: %s\n", zoneDir.c_str()); std::printf(" objects checked : %d (%d missing)\n", objectsChecked, objectsMissing); std::printf(" quests checked : %d (%d bad NPC refs)\n", questsChecked, questsMissing); if (totalErrors == 0) { std::printf(" PASSED\n"); return 0; } std::printf(" FAILED — %d issue(s):\n", totalErrors); for (const auto& e : errors) std::printf(" - %s\n", e.c_str()); return 1; } else if (std::strcmp(argv[i], "--check-zone-content") == 0 && i + 1 < argc) { // Sanity-check creature/object/quest fields for plausible // values. --check-zone-refs catches dangling references; // this catches data-quality issues like creatures with 0 HP, // objects with negative scale, quests with no objectives. // Both are needed — a quest can have valid NPC IDs (refs OK) // AND no objectives (content broken). std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "check-zone-content: %s has no zone.json\n", zoneDir.c_str()); return 1; } std::vector<std::string> warnings; int creatureWarn = 0, objectWarn = 0, questWarn = 0; // Creatures wowee::editor::NpcSpawner sp; if (sp.loadFromFile(zoneDir + "/creatures.json")) { for (size_t k = 0; k < sp.spawnCount(); ++k) { const auto& s = sp.getSpawns()[k]; if (s.name.empty()) { warnings.push_back("creature[" + std::to_string(k) + "] has empty name"); creatureWarn++; } if (s.health == 0) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has 0 health"); creatureWarn++; } if (s.level == 0) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has level 0"); creatureWarn++; } if (s.minDamage > s.maxDamage) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has minDamage > maxDamage"); creatureWarn++; } if (s.scale <= 0.0f || !std::isfinite(s.scale)) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has non-positive or non-finite scale"); creatureWarn++; } if (s.displayId == 0) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has displayId=0 (will render invisibly)"); creatureWarn++; } } } // Objects wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (size_t k = 0; k < op.getObjects().size(); ++k) { const auto& o = op.getObjects()[k]; if (o.path.empty()) { warnings.push_back("object[" + std::to_string(k) + "] has empty path"); objectWarn++; } if (o.scale <= 0.0f || !std::isfinite(o.scale)) { warnings.push_back("object[" + std::to_string(k) + "] has non-positive or non-finite scale"); objectWarn++; } if (!std::isfinite(o.position.x) || !std::isfinite(o.position.y) || !std::isfinite(o.position.z)) { warnings.push_back("object[" + std::to_string(k) + "] has non-finite position"); objectWarn++; } } } // Quests wowee::editor::QuestEditor qe; if (qe.loadFromFile(zoneDir + "/quests.json")) { for (size_t k = 0; k < qe.questCount(); ++k) { const auto& q = qe.getQuests()[k]; if (q.title.empty()) { warnings.push_back("quest[" + std::to_string(k) + "] has empty title"); questWarn++; } if (q.objectives.empty()) { warnings.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' has no objectives (uncompletable)"); questWarn++; } if (q.reward.xp == 0 && q.reward.itemRewards.empty() && q.reward.gold == 0 && q.reward.silver == 0 && q.reward.copper == 0) { warnings.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' has no reward at all"); questWarn++; } if (q.requiredLevel == 0) { warnings.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' has requiredLevel=0"); questWarn++; } } } int total = creatureWarn + objectWarn + questWarn; if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["creatureWarnings"] = creatureWarn; j["objectWarnings"] = objectWarn; j["questWarnings"] = questWarn; j["totalWarnings"] = total; j["warnings"] = warnings; j["passed"] = (total == 0); std::printf("%s\n", j.dump(2).c_str()); return total == 0 ? 0 : 1; } std::printf("Zone content: %s\n", zoneDir.c_str()); std::printf(" creature warnings: %d\n", creatureWarn); std::printf(" object warnings : %d\n", objectWarn); std::printf(" quest warnings : %d\n", questWarn); if (total == 0) { std::printf(" PASSED\n"); return 0; } std::printf(" FAILED — %d total warning(s):\n", total); for (const auto& w : warnings) std::printf(" - %s\n", w.c_str()); return 1; } else if (std::strcmp(argv[i], "--check-project-content") == 0 && i + 1 < argc) { // Project-level content sanity check. Walks every zone and // runs the same per-zone checks that --check-zone-content // does, aggregating warnings per zone. Exit 1 if any zone // has any warning. Designed for CI gates before --pack-wcp. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "check-project-content: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // Same per-zone walks as --check-zone-content. Reuse the // logic by counting issues directly here (cheaper than // shelling out to a sub-invocation per zone). struct ZoneRow { std::string name; int creatureWarn, objectWarn, questWarn; }; std::vector<ZoneRow> rows; int projectFailedZones = 0; for (const auto& zoneDir : zones) { ZoneRow row{fs::path(zoneDir).filename().string(), 0, 0, 0}; wowee::editor::NpcSpawner sp; if (sp.loadFromFile(zoneDir + "/creatures.json")) { for (const auto& s : sp.getSpawns()) { if (s.name.empty()) row.creatureWarn++; if (s.health == 0) row.creatureWarn++; if (s.level == 0) row.creatureWarn++; if (s.minDamage > s.maxDamage) row.creatureWarn++; if (s.scale <= 0.0f || !std::isfinite(s.scale)) row.creatureWarn++; if (s.displayId == 0) row.creatureWarn++; } } wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.path.empty()) row.objectWarn++; if (o.scale <= 0.0f || !std::isfinite(o.scale)) row.objectWarn++; if (!std::isfinite(o.position.x) || !std::isfinite(o.position.y) || !std::isfinite(o.position.z)) row.objectWarn++; } } wowee::editor::QuestEditor qe; if (qe.loadFromFile(zoneDir + "/quests.json")) { for (const auto& q : qe.getQuests()) { if (q.title.empty()) row.questWarn++; if (q.objectives.empty()) row.questWarn++; if (q.reward.xp == 0 && q.reward.itemRewards.empty() && q.reward.gold == 0 && q.reward.silver == 0 && q.reward.copper == 0) row.questWarn++; if (q.requiredLevel == 0) row.questWarn++; } } int rowTotal = row.creatureWarn + row.objectWarn + row.questWarn; if (rowTotal > 0) projectFailedZones++; rows.push_back(row); } int allPassed = (projectFailedZones == 0); int totalWarn = 0; for (const auto& r : rows) totalWarn += r.creatureWarn + r.objectWarn + r.questWarn; if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["totalZones"] = zones.size(); j["failedZones"] = projectFailedZones; j["totalWarnings"] = totalWarn; j["passed"] = bool(allPassed); nlohmann::json arr = nlohmann::json::array(); for (const auto& r : rows) { arr.push_back({{"zone", r.name}, {"creatureWarn", r.creatureWarn}, {"objectWarn", r.objectWarn}, {"questWarn", r.questWarn}}); } j["zones"] = arr; std::printf("%s\n", j.dump(2).c_str()); return allPassed ? 0 : 1; } std::printf("check-project-content: %s\n", projectDir.c_str()); std::printf(" zones : %zu (%d failed)\n", zones.size(), projectFailedZones); std::printf(" total warns : %d\n", totalWarn); std::printf("\n zone creat object quest status\n"); for (const auto& r : rows) { int rowTotal = r.creatureWarn + r.objectWarn + r.questWarn; std::printf(" %-26s %5d %5d %5d %s\n", r.name.substr(0, 26).c_str(), r.creatureWarn, r.objectWarn, r.questWarn, rowTotal == 0 ? "PASS" : "FAIL"); } if (allPassed) { std::printf("\n ALL ZONES PASSED\n"); return 0; } std::printf("\n %d zone(s) have content warnings\n", projectFailedZones); return 1; } else if (std::strcmp(argv[i], "--check-project-refs") == 0 && i + 1 < argc) { // Project-level cross-reference checker. Walks every zone // and runs the same model-path / NPC-id checks as // --check-zone-refs. Aggregates per zone with file-level // breakdown. Exit 1 if any zone has dangling refs. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "check-project-refs: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // Same model-resolve logic as --check-zone-refs, applied // per zone with the appropriate root list. auto stripExt = [](const std::string& p, const char* ext) { size_t n = std::strlen(ext); if (p.size() >= n) { std::string tail = p.substr(p.size() - n); std::string lower = tail; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (lower == ext) return p.substr(0, p.size() - n); } return p; }; struct ZoneRow { std::string name; int objCheck, objMiss, qCheck, qMiss; }; std::vector<ZoneRow> rows; int projectFailedZones = 0; for (const auto& zoneDir : zones) { ZoneRow row{fs::path(zoneDir).filename().string(), 0, 0, 0, 0}; auto modelExists = [&](const std::string& path, bool isWMO) { std::string base; std::vector<std::string> exts; if (isWMO) { base = stripExt(path, ".wmo"); exts = {".wob", ".wmo"}; } else { base = stripExt(path, ".m2"); exts = {".wom", ".m2"}; } std::vector<std::string> roots = { "", zoneDir + "/", "output/", "custom_zones/", "Data/" }; for (const auto& root : roots) { for (const auto& ext : exts) { if (fs::exists(root + base + ext)) return true; std::string lower = base + ext; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (fs::exists(root + lower)) return true; } } return false; }; wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { row.objCheck++; bool isWMO = (o.type == wowee::editor::PlaceableType::WMO); if (!modelExists(o.path, isWMO)) row.objMiss++; } } wowee::editor::NpcSpawner sp; wowee::editor::QuestEditor qe; bool hasCreatures = sp.loadFromFile(zoneDir + "/creatures.json"); std::unordered_set<uint32_t> creatureIds; if (hasCreatures) { for (const auto& s : sp.getSpawns()) creatureIds.insert(s.id); } if (qe.loadFromFile(zoneDir + "/quests.json") && hasCreatures) { for (const auto& q : qe.getQuests()) { row.qCheck++; bool localGiver = (q.questGiverNpcId != 0 && q.questGiverNpcId < 100000 && creatureIds.count(q.questGiverNpcId) == 0); bool localTurn = (q.turnInNpcId != 0 && q.turnInNpcId < 100000 && q.turnInNpcId != q.questGiverNpcId && creatureIds.count(q.turnInNpcId) == 0); if (localGiver) row.qMiss++; if (localTurn) row.qMiss++; } } if (row.objMiss + row.qMiss > 0) projectFailedZones++; rows.push_back(row); } int allPassed = (projectFailedZones == 0); int totalMiss = 0; for (const auto& r : rows) totalMiss += r.objMiss + r.qMiss; if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["totalZones"] = zones.size(); j["failedZones"] = projectFailedZones; j["totalMissing"] = totalMiss; j["passed"] = bool(allPassed); nlohmann::json arr = nlohmann::json::array(); for (const auto& r : rows) { arr.push_back({{"zone", r.name}, {"objectsChecked", r.objCheck}, {"objectsMissing", r.objMiss}, {"questsChecked", r.qCheck}, {"questsMissing", r.qMiss}}); } j["zones"] = arr; std::printf("%s\n", j.dump(2).c_str()); return allPassed ? 0 : 1; } std::printf("check-project-refs: %s\n", projectDir.c_str()); std::printf(" zones : %zu (%d failed)\n", zones.size(), projectFailedZones); std::printf(" total missing: %d\n", totalMiss); std::printf("\n zone obj_chk obj_miss q_chk q_miss status\n"); for (const auto& r : rows) { int rowMiss = r.objMiss + r.qMiss; std::printf(" %-26s %5d %5d %5d %5d %s\n", r.name.substr(0, 26).c_str(), r.objCheck, r.objMiss, r.qCheck, r.qMiss, rowMiss == 0 ? "PASS" : "FAIL"); } if (allPassed) { std::printf("\n ALL ZONES PASSED\n"); return 0; } std::printf("\n %d zone(s) have dangling refs\n", projectFailedZones); return 1; } else if (std::strcmp(argv[i], "--for-each-zone") == 0 && i + 1 < argc) { // Batch runner: enumerates zones in <projectDir> and runs the // command after '--' for each one. '{}' in the command is // substituted with the zone path (find -exec convention). // // wowee_editor --for-each-zone custom_zones -- \\ // wowee_editor --validate-all {} // // Returns the count of failed runs as the exit code (capped // at 255 so the shell can still see it). std::string projectDir = argv[++i]; // The literal '--' separates the projectDir from the command. // Skip it; everything after is the command template. if (i + 1 < argc && std::strcmp(argv[i + 1], "--") == 0) ++i; if (i + 1 >= argc) { std::fprintf(stderr, "for-each-zone: need command after '--'\n"); return 1; } // Collect command tokens until end of argv. Don't try to be // clever about quoting — just escape each token for shell // safety using single quotes (' inside is escaped as '\\''). std::vector<std::string> cmdTokens; for (int k = i + 1; k < argc; ++k) cmdTokens.push_back(argv[k]); i = argc - 1; // consume rest of argv namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "for-each-zone: %s is not a directory\n", projectDir.c_str()); return 1; } // Find every child dir that contains a zone.json — that's the // canonical 'is this a zone?' test the rest of the editor uses. std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (fs::exists(entry.path() / "zone.json")) { zones.push_back(entry.path().string()); } } std::sort(zones.begin(), zones.end()); if (zones.empty()) { std::fprintf(stderr, "for-each-zone: no zones found in %s\n", projectDir.c_str()); return 1; } auto shellEscape = [](const std::string& s) { std::string out = "'"; for (char c : s) { if (c == '\'') out += "'\\''"; else out += c; } out += "'"; return out; }; int failed = 0; for (const auto& zone : zones) { std::string cmd; for (size_t k = 0; k < cmdTokens.size(); ++k) { if (k > 0) cmd += " "; std::string token = cmdTokens[k]; // Replace {} with zone path (every occurrence). size_t pos; while ((pos = token.find("{}")) != std::string::npos) { token.replace(pos, 2, zone); } cmd += shellEscape(token); } std::printf("[%s]\n", zone.c_str()); // Flush before std::system so the header lands above the // child's output rather than after (parent stdout is line- // buffered, child writes go straight to the terminal). std::fflush(stdout); int rc = std::system(cmd.c_str()); if (rc != 0) { failed++; std::fprintf(stderr, "for-each-zone: command exited %d for %s\n", rc, zone.c_str()); } } std::printf("\nfor-each-zone: %zu zones, %d failed\n", zones.size(), failed); return failed > 255 ? 255 : failed; } else if (std::strcmp(argv[i], "--for-each-tile") == 0 && i + 1 < argc) { // Per-tile batch runner. --for-each-zone iterates zones in // a project; this iterates tiles within a zone. The '{}' in // the command template is replaced with the tile-base path // (zoneDir/mapName_TX_TY) — the form most tile-level // editor commands take. // // wowee_editor --for-each-tile MyZone -- \\ // wowee_editor --build-woc {} // wowee_editor --for-each-tile MyZone -- \\ // wowee_editor --validate-whm {} std::string zoneDir = argv[++i]; if (i + 1 < argc && std::strcmp(argv[i + 1], "--") == 0) ++i; if (i + 1 >= argc) { std::fprintf(stderr, "for-each-tile: need command after '--'\n"); return 1; } std::vector<std::string> cmdTokens; for (int k = i + 1; k < argc; ++k) cmdTokens.push_back(argv[k]); i = argc - 1; namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "for-each-tile: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "for-each-tile: parse failed\n"); return 1; } if (zm.tiles.empty()) { std::fprintf(stderr, "for-each-tile: zone has no tiles\n"); return 1; } // Same shell-escape + cmd-substitution as --for-each-zone. auto shellEscape = [](const std::string& s) { std::string out = "'"; for (char c : s) { if (c == '\'') out += "'\\''"; else out += c; } out += "'"; return out; }; int failed = 0; // Sort tiles so order is deterministic across runs. auto tiles = zm.tiles; std::sort(tiles.begin(), tiles.end()); for (const auto& [tx, ty] : tiles) { std::string tileBase = zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); std::string cmd; for (size_t k = 0; k < cmdTokens.size(); ++k) { if (k > 0) cmd += " "; std::string token = cmdTokens[k]; size_t pos; while ((pos = token.find("{}")) != std::string::npos) { token.replace(pos, 2, tileBase); } cmd += shellEscape(token); } std::printf("[%s (%d, %d)]\n", tileBase.c_str(), tx, ty); std::fflush(stdout); int rc = std::system(cmd.c_str()); if (rc != 0) { failed++; std::fprintf(stderr, "for-each-tile: command exited %d for (%d, %d)\n", rc, tx, ty); } } std::printf("\nfor-each-tile: %zu tiles, %d failed\n", tiles.size(), failed); return failed > 255 ? 255 : failed; } else if (std::strcmp(argv[i], "--version") == 0 || std::strcmp(argv[i], "-v") == 0) { std::printf("Wowee World Editor v1.0.0\n"); std::printf("Open formats: WOT/WHM/WOM/WOB/WOC/WCP + PNG/JSON (all novel)\n"); std::printf("By Kelsi Davis\n"); return 0; } else if (std::strcmp(argv[i], "--list-commands") == 0) { // Capture printUsage's stdout and grep for '--flag' tokens at // the start of each line. This auto-tracks the help text as // commands are added — no parallel list to maintain. Result // is a sorted, deduped, one-per-line list of recognized flags. FILE* old = stdout; // Temp file lets us read printUsage's output back. fmemopen // would be cleaner but isn't available on Windows; tmpfile is // portable. FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "list-commands: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::set<std::string> commands; char line[512]; while (std::fgets(line, sizeof(line), tmp)) { // Match leading whitespace then '--' then [a-z-]+ const char* p = line; while (*p == ' ' || *p == '\t') ++p; if (p[0] != '-' || p[1] != '-') continue; std::string flag; while (*p && (std::isalnum(static_cast<unsigned char>(*p)) || *p == '-' || *p == '_')) { flag += *p++; } if (flag.size() > 2) commands.insert(flag); } std::fclose(tmp); // Always include the meta-flags that printUsage describes // alongside others (-h/-v aliases) since the regex above only // captures double-dash forms. commands.insert("--help"); commands.insert("--version"); for (const auto& c : commands) std::printf("%s\n", c.c_str()); return 0; } else if (std::strcmp(argv[i], "--info-cli-stats") == 0) { // Meta-stats on the CLI surface: total command count + per- // category breakdown by prefix verb (--info-*, --validate-*, // --diff-*, etc.). Useful for tracking growth over time and // spotting category imbalances. bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; // Re-use --list-commands' parser. Capture printUsage stdout. FILE* old = stdout; FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "info-cli-stats: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::set<std::string> commands; char line[512]; while (std::fgets(line, sizeof(line), tmp)) { const char* p = line; while (*p == ' ' || *p == '\t') ++p; if (p[0] != '-' || p[1] != '-') continue; std::string flag; while (*p && (std::isalnum(static_cast<unsigned char>(*p)) || *p == '-' || *p == '_')) { flag += *p++; } if (flag.size() > 2) commands.insert(flag); } std::fclose(tmp); commands.insert("--help"); commands.insert("--version"); // Bucket by category — verb is the second token after '--', // up to the next dash. So '--info-zone-tree' -> 'info'. std::map<std::string, int> byCategory; int maxLen = 0; for (const auto& c : commands) { if (static_cast<int>(c.size()) > maxLen) maxLen = static_cast<int>(c.size()); size_t verbStart = 2; // skip '--' size_t verbEnd = c.find('-', verbStart); std::string verb = (verbEnd == std::string::npos) ? c.substr(verbStart) : c.substr(verbStart, verbEnd - verbStart); byCategory[verb]++; } if (jsonOut) { nlohmann::json j; j["totalCommands"] = commands.size(); j["maxFlagLength"] = maxLen; nlohmann::json cats = nlohmann::json::object(); for (const auto& [v, c] : byCategory) cats[v] = c; j["byCategory"] = cats; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("CLI surface stats\n"); std::printf(" total commands : %zu\n", commands.size()); std::printf(" longest flag : %d chars\n", maxLen); std::printf("\n Categories (by verb prefix, sorted by count):\n"); // Sort by count descending for the table. std::vector<std::pair<std::string, int>> sorted( byCategory.begin(), byCategory.end()); std::sort(sorted.begin(), sorted.end(), [](const auto& a, const auto& b) { return a.second > b.second; }); for (const auto& [verb, count] : sorted) { std::printf(" --%-12s %4d\n", verb.c_str(), count); } return 0; } else if (std::strcmp(argv[i], "--info-cli-categories") == 0) { // Discovery view of every CLI flag grouped by verb prefix. // Where --info-cli-stats just counts per category, this // lists every command in each category — handy for "I // know I want to gen something but what shapes/textures // are available?" FILE* old = stdout; FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "info-cli-categories: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::set<std::string> commands; char line[512]; while (std::fgets(line, sizeof(line), tmp)) { const char* p = line; while (*p == ' ' || *p == '\t') ++p; if (p[0] != '-' || p[1] != '-') continue; std::string flag; while (*p && (std::isalnum(static_cast<unsigned char>(*p)) || *p == '-' || *p == '_')) { flag += *p++; } if (flag.size() > 2) commands.insert(flag); } std::fclose(tmp); commands.insert("--help"); commands.insert("--version"); std::map<std::string, std::vector<std::string>> byCategory; for (const auto& c : commands) { size_t verbStart = 2; size_t verbEnd = c.find('-', verbStart); std::string verb = (verbEnd == std::string::npos) ? c.substr(verbStart) : c.substr(verbStart, verbEnd - verbStart); byCategory[verb].push_back(c); } std::printf("CLI commands by category (%zu total):\n\n", commands.size()); // Sort categories by count descending, commands within // each alphabetically. std::vector<std::pair<std::string, std::vector<std::string>>> sorted( byCategory.begin(), byCategory.end()); std::sort(sorted.begin(), sorted.end(), [](const auto& a, const auto& b) { if (a.second.size() != b.second.size()) return a.second.size() > b.second.size(); return a.first < b.first; }); for (const auto& [verb, cmds] : sorted) { std::printf("--%s (%zu):\n", verb.c_str(), cmds.size()); for (const auto& c : cmds) { std::printf(" %s\n", c.c_str()); } std::printf("\n"); } return 0; } else if (std::strcmp(argv[i], "--info-cli-help") == 0 && i + 1 < argc) { // Substring search through the help text. With 130+ commands, // 'is there a thing for X?' is a common ask — this answers it // without making the user scroll the full --help output: // // wowee_editor --info-cli-help quest // wowee_editor --info-cli-help validate // wowee_editor --info-cli-help glb std::string pattern = argv[++i]; // Lowercase the pattern for case-insensitive match. std::string patLower = pattern; for (auto& c : patLower) c = std::tolower(static_cast<unsigned char>(c)); // Capture printUsage stdout, walk line-by-line, print every // line containing the pattern (case-insensitive). Continuation // lines (the indented description on the line after a flag) // are emitted along with the flag line for context. FILE* old = stdout; FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "info-cli-help: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::vector<std::string> lines; char buf[1024]; while (std::fgets(buf, sizeof(buf), tmp)) { std::string s = buf; if (!s.empty() && s.back() == '\n') s.pop_back(); lines.push_back(std::move(s)); } std::fclose(tmp); int matches = 0; for (size_t k = 0; k < lines.size(); ++k) { std::string lower = lines[k]; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (lower.find(patLower) == std::string::npos) continue; std::printf("%s\n", lines[k].c_str()); // Look ahead for a continuation line (indented and not // starting with '--'). Print it for context. if (k + 1 < lines.size()) { const auto& next = lines[k + 1]; if (!next.empty() && next[0] == ' ' && next.find("--") == std::string::npos) { std::printf("%s\n", next.c_str()); } } matches++; } if (matches == 0) { std::fprintf(stderr, "info-cli-help: no matches for '%s'\n", pattern.c_str()); return 1; } std::fprintf(stderr, "\n%d line(s) matched '%s'\n", matches, pattern.c_str()); return 0; } else if (std::strcmp(argv[i], "--validate-cli-help") == 0) { // Self-check: every flag we declare in kArgRequired (the list // of commands needing positional args) must appear in the // help text printUsage emits. Catches drift where someone // adds a handler + argument check but forgets the help line. bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; // Capture printUsage's stdout. FILE* old = stdout; FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "validate-cli-help: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::string helpText; char chunk[1024]; while (std::fgets(chunk, sizeof(chunk), tmp)) helpText += chunk; std::fclose(tmp); // Walk kArgRequired and check each appears in the help. std::vector<std::string> missing; for (const char* opt : kArgRequired) { if (helpText.find(opt) == std::string::npos) { missing.push_back(opt); } } if (jsonOut) { nlohmann::json j; j["totalArgRequired"] = sizeof(kArgRequired) / sizeof(kArgRequired[0]); j["missing"] = missing; j["passed"] = missing.empty(); std::printf("%s\n", j.dump(2).c_str()); return missing.empty() ? 0 : 1; } std::printf("CLI help self-check\n"); std::printf(" kArgRequired entries : %zu\n", sizeof(kArgRequired) / sizeof(kArgRequired[0])); if (missing.empty()) { std::printf(" PASSED — every kArgRequired flag is documented\n"); return 0; } std::printf(" FAILED — %zu flag(s) missing from help text:\n", missing.size()); for (const auto& m : missing) std::printf(" - %s\n", m.c_str()); return 1; } else if (std::strcmp(argv[i], "--gen-completion") == 0 && i + 1 < argc) { // Emit a bash or zsh completion script. Re-execs the editor's // own --list-commands at completion time so newly-added flags // light up automatically without regenerating the script. std::string shell = argv[++i]; if (shell != "bash" && shell != "zsh") { std::fprintf(stderr, "gen-completion: shell must be 'bash' or 'zsh', got '%s'\n", shell.c_str()); return 1; } // Use argv[0] as the binary name in the completion so it // works whether the user installed it as 'wowee_editor' or // a custom alias. Strip directory components for the // completion-name registration (bash 'complete -F' expects // a basename). std::string self = argv[0]; auto slash = self.find_last_of('/'); std::string baseName = (slash != std::string::npos) ? self.substr(slash + 1) : self; if (shell == "bash") { std::printf( "# wowee_editor bash completion — source from ~/.bashrc:\n" "# source <(%s --gen-completion bash)\n" "_wowee_editor_complete() {\n" " local cur prev cmds\n" " COMPREPLY=()\n" " cur=\"${COMP_WORDS[COMP_CWORD]}\"\n" " prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\n" " # Cache the command list per shell session.\n" " if [[ -z \"$_WOWEE_EDITOR_CMDS\" ]]; then\n" " _WOWEE_EDITOR_CMDS=$(%s --list-commands 2>/dev/null)\n" " fi\n" " if [[ \"$cur\" == --* ]]; then\n" " COMPREPLY=( $(compgen -W \"$_WOWEE_EDITOR_CMDS\" -- \"$cur\") )\n" " return 0\n" " fi\n" " # Default: complete file paths for arg slots.\n" " COMPREPLY=( $(compgen -f -- \"$cur\") )\n" "}\n" "complete -F _wowee_editor_complete %s\n", self.c_str(), self.c_str(), baseName.c_str()); } else { // zsh — simpler descriptor-based completion. std::printf( "# wowee_editor zsh completion — source from ~/.zshrc:\n" "# source <(%s --gen-completion zsh)\n" "_wowee_editor_complete() {\n" " local -a cmds\n" " if [[ -z \"$_WOWEE_EDITOR_CMDS\" ]]; then\n" " export _WOWEE_EDITOR_CMDS=$(%s --list-commands 2>/dev/null)\n" " fi\n" " cmds=( ${(f)_WOWEE_EDITOR_CMDS} )\n" " _arguments \"*: :($cmds)\"\n" "}\n" "compdef _wowee_editor_complete %s\n", self.c_str(), self.c_str(), baseName.c_str()); } return 0; } else if (std::strcmp(argv[i], "--help") == 0 || std::strcmp(argv[i], "-h") == 0) { wowee::editor::cli::printUsage(argv[0]); return 0; } } if (dataPath.empty()) { dataPath = "Data"; LOG_INFO("No --data path specified, using default: ", dataPath); } wowee::editor::EditorApp app; if (!app.initialize(dataPath)) { LOG_ERROR("Failed to initialize editor"); return 1; } if (!adtMap.empty()) { app.loadADT(adtMap, adtX, adtY); } app.run(); app.shutdown(); return 0; }

#include "editor_app.hpp" #include "cli_gen_audio.hpp" #include "cli_zone_packs.hpp" #include "cli_audits.hpp" #include "cli_readmes.hpp" #include "cli_zone_inventory.hpp" #include "cli_project_inventory.hpp" #include "cli_help.hpp" #include "cli_gen_texture.hpp" #include "cli_gen_mesh.hpp" #include "cli_mesh_io.hpp" #include "cli_mesh_edit.hpp" #include "cli_wom_info.hpp" #include "cli_format_validate.hpp" #include "cli_convert.hpp" #include "cli_format_info.hpp" #include "cli_pack.hpp" #include "cli_content_info.hpp" #include "cli_zone_info.hpp" #include "cli_data_tree.hpp" #include "cli_diff.hpp" #include "cli_spawn_audit.hpp" #include "cli_items.hpp" #include "cli_extract_info.hpp" #include "cli_export.hpp" #include "cli_bake.hpp" #include "cli_migrate.hpp" #include "cli_convert_single.hpp" #include "cli_validate_interop.hpp" #include "cli_glb_inspect.hpp" #include "cli_wom_io.hpp" #include "cli_world_io.hpp" #include "cli_info_tree.hpp" #include "cli_info_bytes.hpp" #include "cli_info_extents.hpp" #include "cli_info_water.hpp" #include "cli_info_density.hpp" #include "cli_info_audio.hpp" #include "cli_world_info.hpp" #include "cli_quest_objective.hpp" #include "cli_quest_reward.hpp" #include "cli_clone.hpp" #include "content_pack.hpp" #include "npc_spawner.hpp" #include "object_placer.hpp" #include "quest_editor.hpp" #include "wowee_terrain.hpp" #include "zone_manifest.hpp" #include "terrain_editor.hpp" #include "terrain_biomes.hpp" #include #include #include #include #include "pipeline/wowee_model.hpp" #include "pipeline/wowee_building.hpp" #include "pipeline/wowee_collision.hpp" #include "pipeline/wowee_terrain_loader.hpp" #include "pipeline/wmo_loader.hpp" #include "pipeline/m2_loader.hpp" #include "pipeline/adt_loader.hpp" #include "pipeline/asset_manager.hpp" #include "pipeline/custom_zone_discovery.hpp" #include "core/logger.hpp" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "stb_image_write.h" #include "stb_image.h" // implementation in stb_image_impl.cpp // ─── Open-format consistency checks ───────────────────────────── // Both validators are called from the per-file CLI commands AND // from --validate-all which walks a zone dir. Returning a vector // of error strings (empty == passed) keeps callers simple. // Minimal SHA-256 implementation (FIPS 180-4) used by --export-zone-checksum // to produce hashes that interoperate with `sha256sum -c`. Not exposed beyond // this file — about 90 LoC, no external deps. See RFC 6234 for the algorithm. int main(int argc, char* argv[]) { std::string dataPath; std::string adtMap; int adtX = -1, adtY = -1; // Detect non-GUI options that are missing their argument and bail out // with a helpful message instead of silently dropping into the GUI. static const char* kArgRequired[] = { "--data", "--info", "--info-batches", "--info-textures", "--info-doodads", "--info-attachments", "--info-particles", "--info-sequences", "--info-bones", "--export-bones-dot", "--list-zone-meshes", "--list-zone-audio", "--list-zone-textures", "--list-project-meshes", "--list-project-audio", "--list-project-textures", "--info-zone-models-total", "--info-project-models-total", "--list-zone-meshes-detail", "--list-project-meshes-detail", "--info-mesh", "--info-mesh-storage-budget", "--info-wob", "--info-woc", "--info-wot", "--info-creatures", "--info-objects", "--info-quests", "--info-extract", "--info-extract-tree", "--info-extract-budget", "--list-missing-sidecars", "--info-png", "--info-jsondbc", "--info-blp", "--info-pack-budget", "--info-pack-tree", "--info-m2", "--info-wmo", "--info-adt", "--info-zone", "--info-zone-overview", "--info-project-overview", "--copy-project", "--info-wcp", "--list-wcp", "--list-creatures", "--list-objects", "--list-quests", "--list-quest-objectives", "--list-quest-rewards", "--info-creature", "--info-quest", "--info-object", "--info-quest-graph-stats", "--info-creatures-by-faction", "--info-creatures-by-level", "--info-objects-by-path", "--info-objects-by-type", "--info-quests-by-level", "--info-quests-by-xp", "--unpack-wcp", "--pack-wcp", "--validate", "--validate-wom", "--validate-wob", "--validate-woc", "--validate-whm", "--validate-all", "--validate-project", "--validate-project-open-only", "--audit-project", "--bench-audit-project", "--bench-validate-project", "--bench-bake-project", "--bench-migrate-data-tree", "--list-data-tree-largest", "--export-data-tree-md", "--gen-texture", "--gen-mesh", "--gen-mesh-textured", "--add-texture-to-mesh", "--add-texture-to-zone", "--gen-mesh-stairs", "--gen-mesh-grid", "--gen-mesh-disc", "--gen-mesh-tube", "--gen-mesh-capsule", "--gen-mesh-arch", "--gen-mesh-pyramid", "--gen-mesh-fence", "--gen-mesh-tree", "--gen-mesh-rock", "--gen-mesh-pillar", "--gen-mesh-bridge", "--gen-mesh-tower", "--gen-mesh-house", "--gen-mesh-fountain", "--gen-mesh-statue", "--gen-mesh-altar", "--gen-mesh-portal", "--gen-mesh-archway", "--gen-mesh-barrel", "--gen-mesh-chest", "--gen-mesh-anvil", "--gen-mesh-mushroom", "--gen-mesh-cart", "--gen-mesh-banner", "--gen-mesh-grave", "--gen-mesh-bench", "--gen-mesh-shrine", "--gen-mesh-totem", "--gen-mesh-cage", "--gen-mesh-throne", "--gen-mesh-coffin", "--gen-mesh-bookshelf", "--gen-mesh-table", "--gen-mesh-lamppost", "--gen-mesh-bed", "--gen-mesh-ladder", "--gen-mesh-well", "--gen-mesh-signpost", "--gen-mesh-mailbox", "--gen-texture-gradient", "--gen-mesh-from-heightmap", "--export-mesh-heightmap", "--displace-mesh", "--scale-mesh", "--translate-mesh", "--strip-mesh", "--gen-texture-noise", "--gen-texture-noise-color", "--rotate-mesh", "--center-mesh", "--flip-mesh-normals", "--mirror-mesh", "--smooth-mesh-normals", "--merge-meshes", "--gen-texture-radial", "--gen-texture-stripes", "--gen-texture-dots", "--gen-texture-rings", "--gen-texture-checker", "--gen-texture-brick", "--gen-texture-wood", "--gen-texture-grass", "--gen-texture-fabric", "--gen-texture-cobble", "--gen-texture-marble", "--gen-texture-metal", "--gen-texture-leather", "--gen-texture-sand", "--gen-texture-snow", "--gen-texture-lava", "--gen-texture-tile", "--gen-texture-bark", "--gen-texture-clouds", "--gen-texture-stars", "--gen-texture-vines", "--gen-texture-mosaic", "--gen-texture-rust", "--gen-texture-circuit", "--gen-texture-coral", "--gen-texture-flame", "--gen-texture-tartan", "--gen-texture-argyle", "--gen-texture-herringbone", "--gen-texture-scales", "--gen-texture-stained-glass", "--gen-texture-shingles", "--gen-texture-frost", "--gen-texture-parquet", "--gen-texture-bubbles", "--validate-glb", "--info-glb", "--info-glb-tree", "--info-glb-bytes", "--validate-jsondbc", "--check-glb-bounds", "--validate-stl", "--validate-png", "--validate-blp", "--zone-summary", "--info-zone-tree", "--info-project-tree", "--info-zone-bytes", "--info-project-bytes", "--info-zone-extents", "--info-project-extents", "--info-zone-water", "--info-project-water", "--info-zone-density", "--info-project-density", "--export-zone-summary-md", "--export-quest-graph", "--export-zone-csv", "--export-zone-html", "--export-project-html", "--export-project-md", "--export-zone-checksum", "--export-project-checksum", "--validate-project-checksum", "--scaffold-zone", "--mvp-zone", "--add-tile", "--remove-tile", "--list-tiles", "--for-each-zone", "--for-each-tile", "--zone-stats", "--info-tilemap", "--list-zone-deps", "--list-project-orphans", "--remove-project-orphans", "--check-zone-refs", "--check-zone-content", "--check-project-content", "--check-project-refs", "--export-zone-deps-md", "--export-zone-spawn-png", "--add-creature", "--add-object", "--add-quest", "--add-item", "--random-populate-zone", "--random-populate-items", "--info-zone-audio", "--snap-zone-to-ground", "--audit-zone-spawns", "--info-project-audio", "--snap-project-to-ground", "--audit-project-spawns", "--list-zone-spawns", "--list-project-spawns", "--gen-random-zone", "--gen-random-project", "--gen-zone-texture-pack", "--gen-zone-mesh-pack", "--gen-zone-starter-pack", "--gen-project-starter-pack", "--gen-audio-tone", "--gen-audio-noise", "--gen-audio-sweep", "--gen-zone-audio-pack", "--info-zone-summary", "--info-project-summary", "--info-zone-deps", "--info-project-deps", "--gen-zone-readme", "--gen-project-readme", "--validate-zone-pack", "--validate-project-packs", "--info-spawn", "--diff-zone-spawns", "--list-items", "--info-item", "--set-item", "--export-zone-items-md", "--export-project-items-md", "--export-project-items-csv", "--add-quest-objective", "--add-quest-reward-item", "--set-quest-reward", "--remove-quest-objective", "--clone-quest", "--clone-creature", "--clone-item", "--validate-items", "--validate-project-items", "--info-project-items", "--clone-object", "--remove-creature", "--remove-object", "--remove-quest", "--remove-item", "--copy-zone-items", "--copy-zone", "--rename-zone", "--remove-zone", "--clear-zone-content", "--strip-zone", "--strip-project", "--repair-zone", "--repair-project", "--gen-makefile", "--gen-project-makefile", "--build-woc", "--regen-collision", "--fix-zone", "--export-png", "--export-obj", "--import-obj", "--export-wob-obj", "--import-wob-obj", "--export-woc-obj", "--export-whm-obj", "--export-glb", "--export-wob-glb", "--export-whm-glb", "--export-stl", "--import-stl", "--bake-zone-glb", "--bake-zone-stl", "--bake-zone-obj", "--bake-project-obj", "--bake-project-stl", "--bake-project-glb", "--convert-m2", "--convert-m2-batch", "--convert-wmo", "--convert-wmo-batch", "--convert-dbc-json", "--convert-dbc-batch", "--convert-json-dbc", "--convert-blp-png", "--convert-blp-batch", "--migrate-wom", "--migrate-zone", "--migrate-project", "--migrate-data-tree", "--info-data-tree", "--strip-data-tree", "--audit-data-tree", "--migrate-jsondbc", }; for (int i = 1; i < argc; i++) { for (const char* opt : kArgRequired) { if (std::strcmp(argv[i], opt) == 0 && i + 1 >= argc) { std::fprintf(stderr, "%s requires an argument\n", opt); return 1; } } if (std::strcmp(argv[i], "--adt") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--adt requires \n"); return 1; } if (std::strcmp(argv[i], "--diff-zone") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-zone requires \n"); return 1; } if (std::strcmp(argv[i], "--diff-glb") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-glb requires \n"); return 1; } if (std::strcmp(argv[i], "--diff-wom") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-wom requires

\n"); return 1; } if (std::strcmp(argv[i], "--diff-wob") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-wob requires

\n"); return 1; } if (std::strcmp(argv[i], "--diff-whm") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-whm requires

\n"); return 1; } if (std::strcmp(argv[i], "--diff-woc") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-woc requires \n"); return 1; } if (std::strcmp(argv[i], "--diff-jsondbc") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-jsondbc requires \n"); return 1; } if (std::strcmp(argv[i], "--diff-extract") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-extract requires \n"); return 1; } if (std::strcmp(argv[i], "--diff-checksum") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-checksum requires \n"); return 1; } if (std::strcmp(argv[i], "--diff-wcp") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--diff-wcp requires two paths\n"); return 1; } if (std::strcmp(argv[i], "--add-creature") == 0 && i + 5 >= argc) { std::fprintf(stderr, "--add-creature requires \n"); return 1; } if (std::strcmp(argv[i], "--add-object") == 0 && i + 6 >= argc) { std::fprintf(stderr, "--add-object requires \n"); return 1; } if (std::strcmp(argv[i], "--add-quest") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--add-quest requires \n"); return 1; } if (std::strcmp(argv[i], "--add-quest-objective") == 0 && i + 4 >= argc) { std::fprintf(stderr, "--add-quest-objective requires <zoneDir> <questIdx> <type> <targetName>\n"); return 1; } if (std::strcmp(argv[i], "--remove-quest-objective") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--remove-quest-objective requires <zoneDir> <questIdx> <objIdx>\n"); return 1; } if (std::strcmp(argv[i], "--clone-quest") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--clone-quest requires <zoneDir> <questIdx>\n"); return 1; } if (std::strcmp(argv[i], "--clone-creature") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--clone-creature requires <zoneDir> <idx>\n"); return 1; } if (std::strcmp(argv[i], "--clone-object") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--clone-object requires <zoneDir> <idx>\n"); return 1; } if (std::strcmp(argv[i], "--add-quest-reward-item") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--add-quest-reward-item requires <zoneDir> <questIdx> <itemPath>\n"); return 1; } if (std::strcmp(argv[i], "--set-quest-reward") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--set-quest-reward requires <zoneDir> <questIdx> [--xp N] [--gold N] [--silver N] [--copper N]\n"); return 1; } if (std::strcmp(argv[i], "--add-tile") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--add-tile requires <zoneDir> <tx> <ty>\n"); return 1; } if (std::strcmp(argv[i], "--remove-tile") == 0 && i + 3 >= argc) { std::fprintf(stderr, "--remove-tile requires <zoneDir> <tx> <ty>\n"); return 1; } if (std::strcmp(argv[i], "--copy-zone") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--copy-zone requires <srcDir> <newName>\n"); return 1; } if (std::strcmp(argv[i], "--rename-zone") == 0 && i + 2 >= argc) { std::fprintf(stderr, "--rename-zone requires <srcDir> <newName>\n"); return 1; } for (const char* opt : {"--remove-creature", "--remove-object", "--remove-quest"}) { if (std::strcmp(argv[i], opt) == 0 && i + 2 >= argc) { std::fprintf(stderr, "%s requires <zoneDir> <index>\n", opt); return 1; } } } for (int i = 1; i < argc; i++) { // Modular handler families: extracted from the in-line if/else // chain below to keep main.cpp from sprawling further. Each // family lives in its own .cpp; if it matches argv[i] it // sets outRc and we exit. Otherwise fall through to the // legacy in-line dispatch. { int outRc = 0; if (wowee::editor::cli::handleGenAudio(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleZonePacks(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleAudits(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleReadmes(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleZoneInventory(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleProjectInventory(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleGenTexture(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleGenMesh(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleMeshIO(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleMeshEdit(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleWomInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleFormatValidate(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleConvert(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleFormatInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handlePack(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleContentInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleZoneInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleDataTree(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleDiff(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleSpawnAudit(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleItems(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleExtractInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleExport(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleBake(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleMigrate(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleConvertSingle(i, argc, argv, dataPath, outRc)) { return outRc; } if (wowee::editor::cli::handleValidateInterop(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleGlbInspect(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleWomIo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleWorldIo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoTree(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoBytes(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoExtents(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoWater(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoDensity(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleInfoAudio(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleWorldInfo(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleQuestObjective(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleQuestReward(i, argc, argv, outRc)) { return outRc; } if (wowee::editor::cli::handleClone(i, argc, argv, outRc)) { return outRc; } } if (std::strcmp(argv[i], "--data") == 0 && i + 1 < argc) { dataPath = argv[++i]; } else if (std::strcmp(argv[i], "--adt") == 0 && i + 3 < argc) { adtMap = argv[++i]; adtX = std::atoi(argv[++i]); adtY = std::atoi(argv[++i]); } else if (std::strcmp(argv[i], "--info-zone-models-total") == 0 && i + 1 < argc) { // Aggregate WOM/WOB stats across every model in a zone. // Useful for capacity planning ('how many bones across all // my creatures?') and perf budgeting ('total triangles // per frame if all loaded?'). std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "info-zone-models-total: %s does not exist\n", zoneDir.c_str()); return 1; } int womCount = 0, wobCount = 0; uint64_t womVerts = 0, womIndices = 0; uint64_t womBones = 0, womAnims = 0, womBatches = 0; uint64_t wobGroups = 0, wobVerts = 0, wobIndices = 0; uint64_t wobDoodads = 0, wobPortals = 0; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); std::string base = e.path().string(); if (base.size() > ext.size()) base = base.substr(0, base.size() - ext.size()); if (ext == ".wom") { womCount++; auto wom = wowee::pipeline::WoweeModelLoader::load(base); womVerts += wom.vertices.size(); womIndices += wom.indices.size(); womBones += wom.bones.size(); womAnims += wom.animations.size(); womBatches += wom.batches.size(); } else if (ext == ".wob") { wobCount++; auto wob = wowee::pipeline::WoweeBuildingLoader::load(base); wobGroups += wob.groups.size(); for (const auto& g : wob.groups) { wobVerts += g.vertices.size(); wobIndices += g.indices.size(); } wobDoodads += wob.doodads.size(); wobPortals += wob.portals.size(); } } if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["wom"] = {{"count", womCount}, {"vertices", womVerts}, {"indices", womIndices}, {"triangles", womIndices / 3}, {"bones", womBones}, {"animations", womAnims}, {"batches", womBatches}}; j["wob"] = {{"count", wobCount}, {"groups", wobGroups}, {"vertices", wobVerts}, {"indices", wobIndices}, {"triangles", wobIndices / 3}, {"doodads", wobDoodads}, {"portals", wobPortals}}; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone models total: %s\n", zoneDir.c_str()); std::printf("\n WOM (open M2):\n"); std::printf(" files : %d\n", womCount); std::printf(" vertices : %llu\n", static_cast<unsigned long long>(womVerts)); std::printf(" triangles : %llu\n", static_cast<unsigned long long>(womIndices / 3)); std::printf(" bones : %llu\n", static_cast<unsigned long long>(womBones)); std::printf(" anims : %llu\n", static_cast<unsigned long long>(womAnims)); std::printf(" batches : %llu\n", static_cast<unsigned long long>(womBatches)); std::printf("\n WOB (open WMO):\n"); std::printf(" files : %d\n", wobCount); std::printf(" groups : %llu\n", static_cast<unsigned long long>(wobGroups)); std::printf(" vertices : %llu\n", static_cast<unsigned long long>(wobVerts)); std::printf(" triangles : %llu\n", static_cast<unsigned long long>(wobIndices / 3)); std::printf(" doodads : %llu\n", static_cast<unsigned long long>(wobDoodads)); std::printf(" portals : %llu\n", static_cast<unsigned long long>(wobPortals)); std::printf("\n Combined :\n"); std::printf(" vertices : %llu\n", static_cast<unsigned long long>(womVerts + wobVerts)); std::printf(" triangles : %llu\n", static_cast<unsigned long long>((womIndices + wobIndices) / 3)); return 0; } else if (std::strcmp(argv[i], "--list-zone-meshes-detail") == 0 && i + 1 < argc) { // Per-mesh breakdown of every .wom file in <zoneDir>, // sorted by triangle count descending so the heaviest // meshes float to the top. Complements // --list-zone-meshes (per-zone summary) by surfacing // individual mesh metrics — useful for spotting // outliers ("which mesh is using 80% of my triangle // budget?") and for content audits. std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "list-zone-meshes-detail: %s does not exist\n", zoneDir.c_str()); return 1; } struct Row { std::string path; size_t verts; size_t tris; size_t bones; size_t batches; size_t textures; uint64_t bytes; uint32_t version; }; std::vector<Row> rows; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; if (e.path().extension() != ".wom") continue; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto wom = wowee::pipeline::WoweeModelLoader::load(base); Row r; r.path = fs::relative(e.path(), zoneDir, ec).string(); if (ec) r.path = e.path().filename().string(); r.verts = wom.vertices.size(); r.tris = wom.indices.size() / 3; r.bones = wom.bones.size(); r.batches = wom.batches.size(); r.textures = wom.texturePaths.size(); r.bytes = e.file_size(ec); if (ec) r.bytes = 0; r.version = wom.version; rows.push_back(r); } std::sort(rows.begin(), rows.end(), [](const Row& a, const Row& b) { return a.tris > b.tris; }); uint64_t totVerts = 0, totTris = 0, totBones = 0, totBytes = 0; for (const auto& r : rows) { totVerts += r.verts; totTris += r.tris; totBones += r.bones; totBytes += r.bytes; } if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["meshCount"] = rows.size(); j["totals"] = {{"vertices", totVerts}, {"triangles", totTris}, {"bones", totBones}, {"bytes", totBytes}}; nlohmann::json arr = nlohmann::json::array(); for (const auto& r : rows) { arr.push_back({{"path", r.path}, {"version", r.version}, {"vertices", r.verts}, {"triangles", r.tris}, {"bones", r.bones}, {"batches", r.batches}, {"textures", r.textures}, {"bytes", r.bytes}}); } j["meshes"] = arr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone meshes: %s\n", zoneDir.c_str()); std::printf(" meshes : %zu\n", rows.size()); std::printf(" totals : %llu verts, %llu tris, %llu bones, %.1f KB\n", static_cast<unsigned long long>(totVerts), static_cast<unsigned long long>(totTris), static_cast<unsigned long long>(totBones), totBytes / 1024.0); if (rows.empty()) { std::printf("\n *no .wom files in this zone*\n"); return 0; } std::printf("\n v verts tris bones batch tex bytes path\n"); for (const auto& r : rows) { std::printf(" v%u %6zu %6zu %5zu %5zu %3zu %7llu %s\n", r.version, r.verts, r.tris, r.bones, r.batches, r.textures, static_cast<unsigned long long>(r.bytes), r.path.c_str()); } return 0; } else if (std::strcmp(argv[i], "--info-mesh") == 0 && i + 1 < argc) { // Single-mesh detail view aggregating bounds, version, // batches, bones, animations, and texture slots into one // report. Composite of what --info-batches / --info-bones // / --info-batches show separately. Useful authoring // command: pass a WOM and see everything about it without // running three sub-commands. std::string base = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; if (base.size() >= 4 && base.substr(base.size() - 4) == ".wom") { base = base.substr(0, base.size() - 4); } if (!wowee::pipeline::WoweeModelLoader::exists(base)) { std::fprintf(stderr, "info-mesh: %s.wom does not exist\n", base.c_str()); return 1; } auto wom = wowee::pipeline::WoweeModelLoader::load(base); if (!wom.isValid()) { std::fprintf(stderr, "info-mesh: failed to load %s.wom\n", base.c_str()); return 1; } // Per-batch material summary. static const char* blendNames[] = { "opaque", "alpha-test", "alpha", "additive", "?", "?", "?", "?" }; if (jsonOut) { nlohmann::json j; j["base"] = base; j["name"] = wom.name; j["version"] = wom.version; j["bounds"] = {{"min", {wom.boundMin.x, wom.boundMin.y, wom.boundMin.z}}, {"max", {wom.boundMax.x, wom.boundMax.y, wom.boundMax.z}}, {"radius", wom.boundRadius}}; j["counts"] = {{"vertices", wom.vertices.size()}, {"indices", wom.indices.size()}, {"triangles", wom.indices.size() / 3}, {"bones", wom.bones.size()}, {"animations", wom.animations.size()}, {"batches", wom.batches.size()}, {"textures", wom.texturePaths.size()}}; nlohmann::json bs = nlohmann::json::array(); for (const auto& b : wom.batches) { std::string tex; if (b.textureIndex < wom.texturePaths.size()) tex = wom.texturePaths[b.textureIndex]; bs.push_back({{"indexStart", b.indexStart}, {"indexCount", b.indexCount}, {"triangles", b.indexCount / 3}, {"textureIndex", b.textureIndex}, {"texture", tex}, {"blendMode", b.blendMode}, {"flags", b.flags}}); } j["batchDetail"] = bs; j["texturePaths"] = wom.texturePaths; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Mesh: %s.wom\n", base.c_str()); std::printf(" name : %s\n", wom.name.c_str()); std::printf(" version : v%u\n", wom.version); std::printf("\n Counts:\n"); std::printf(" vertices : %zu\n", wom.vertices.size()); std::printf(" triangles : %zu\n", wom.indices.size() / 3); std::printf(" bones : %zu\n", wom.bones.size()); std::printf(" anims : %zu\n", wom.animations.size()); std::printf(" batches : %zu\n", wom.batches.size()); std::printf(" textures : %zu\n", wom.texturePaths.size()); std::printf("\n Bounds:\n"); std::printf(" min : (%.3f, %.3f, %.3f)\n", wom.boundMin.x, wom.boundMin.y, wom.boundMin.z); std::printf(" max : (%.3f, %.3f, %.3f)\n", wom.boundMax.x, wom.boundMax.y, wom.boundMax.z); std::printf(" radius : %.3f\n", wom.boundRadius); if (!wom.batches.empty()) { std::printf("\n Batches:\n"); std::printf(" idx iStart iCount tris blend texture\n"); for (size_t k = 0; k < wom.batches.size(); ++k) { const auto& b = wom.batches[k]; std::string tex = "<oob>"; if (b.textureIndex < wom.texturePaths.size()) tex = wom.texturePaths[b.textureIndex]; if (tex.empty()) tex = "(empty)"; int blend = b.blendMode < 8 ? b.blendMode : 0; std::printf(" %3zu %6u %6u %4u %-10s %s\n", k, b.indexStart, b.indexCount, b.indexCount / 3, blendNames[blend], tex.c_str()); } } if (!wom.texturePaths.empty()) { std::printf("\n Texture slots:\n"); for (size_t k = 0; k < wom.texturePaths.size(); ++k) { std::printf(" [%zu] %s\n", k, wom.texturePaths[k].empty() ? "(empty placeholder)" : wom.texturePaths[k].c_str()); } } return 0; } else if (std::strcmp(argv[i], "--info-mesh-storage-budget") == 0 && i + 1 < argc) { // Estimated bytes-per-category breakdown for a WOM. // Numbers are based on the in-memory struct sizes, not // the actual on-disk encoding (which has framing // overhead) — but the relative shares are accurate and // help users decide where shrinking efforts pay off. // // For example: a heightmap mesh's bytes are dominated by // vertices, so reducing vertex count is the lever to // pull. A skeletal mesh's animation keyframes can dwarf // the geometry itself — surfacing that lets the user // know to consider --strip-mesh --anims. std::string base = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; if (base.size() >= 4 && base.substr(base.size() - 4) == ".wom") { base = base.substr(0, base.size() - 4); } if (!wowee::pipeline::WoweeModelLoader::exists(base)) { std::fprintf(stderr, "info-mesh-storage-budget: %s.wom does not exist\n", base.c_str()); return 1; } auto wom = wowee::pipeline::WoweeModelLoader::load(base); if (!wom.isValid()) { std::fprintf(stderr, "info-mesh-storage-budget: failed to load %s.wom\n", base.c_str()); return 1; } // Per-category byte estimates. Vertex is 12+12+8+4+4=40 // bytes (pos/normal/uv/4 weights/4 indices). Index is // 4 bytes. Bone is 4+2+12+4=22 bytes. Batch is 4+4+4+2+ // 2=16. Animation keyframe is 4+12+16+12=44 bytes. // Texture path is summed length plus a small per-string // overhead. uint64_t vertBytes = wom.vertices.size() * 40; uint64_t idxBytes = wom.indices.size() * 4; uint64_t boneBytes = wom.bones.size() * 22; uint64_t batchBytes = wom.batches.size() * 16; uint64_t animBytes = 0; size_t totalKeyframes = 0; for (const auto& a : wom.animations) { animBytes += 12; // id + duration + movingSpeed for (const auto& bone : a.boneKeyframes) { animBytes += bone.size() * 44; totalKeyframes += bone.size(); } } uint64_t texBytes = 0; for (const auto& t : wom.texturePaths) texBytes += t.size() + 8; namespace fs = std::filesystem; uint64_t actualBytes = fs::file_size(base + ".wom"); uint64_t estBytes = vertBytes + idxBytes + boneBytes + batchBytes + animBytes + texBytes; struct Row { const char* name; uint64_t bytes; }; std::vector<Row> rows = { {"vertices ", vertBytes}, {"indices ", idxBytes}, {"bones ", boneBytes}, {"animations", animBytes}, {"batches ", batchBytes}, {"textures ", texBytes}, }; if (jsonOut) { nlohmann::json j; j["base"] = base; j["fileBytes"] = actualBytes; j["estimatedBytes"] = estBytes; j["categories"] = nlohmann::json::object(); for (const auto& r : rows) { double share = estBytes > 0 ? 100.0 * r.bytes / estBytes : 0.0; j["categories"][r.name] = {{"bytes", r.bytes}, {"share", share}}; } j["counts"] = {{"vertices", wom.vertices.size()}, {"indices", wom.indices.size()}, {"bones", wom.bones.size()}, {"animations", wom.animations.size()}, {"keyframes", totalKeyframes}, {"batches", wom.batches.size()}, {"textures", wom.texturePaths.size()}}; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Mesh storage budget: %s.wom\n", base.c_str()); std::printf(" on-disk : %llu bytes (%.1f KB)\n", static_cast<unsigned long long>(actualBytes), actualBytes / 1024.0); std::printf(" estimated : %llu bytes (sum of in-memory parts)\n", static_cast<unsigned long long>(estBytes)); std::printf("\n Per-category (estimated):\n"); for (const auto& r : rows) { if (r.bytes == 0) continue; double share = estBytes > 0 ? 100.0 * r.bytes / estBytes : 0.0; std::printf(" %s : %10llu bytes (%5.1f%%)\n", r.name, static_cast<unsigned long long>(r.bytes), share); } std::printf("\n Tips:\n"); if (animBytes > vertBytes && wom.animations.size() > 0) { std::printf(" - animations dominate; --strip-mesh " "--anims would save %.1f KB\n", animBytes / 1024.0); } if (boneBytes > vertBytes / 2 && wom.bones.size() > 0) { std::printf(" - bones non-trivial; consider " "--strip-mesh --bones for static placement\n"); } if (vertBytes > estBytes / 2) { std::printf(" - vertices dominate; check if a " "lower-poly variant works for placement\n"); } return 0; } else if (std::strcmp(argv[i], "--info-project-models-total") == 0 && i + 1 < argc) { // Multi-zone aggregate. Walks every zone in <projectDir>, // sums the same WOM/WOB metrics --info-zone-models-total // emits, and prints a per-zone breakdown table followed // by project-wide totals. Useful for capacity planning // across an entire content project. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "info-project-models-total: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); struct ZRow { std::string name; int womCount = 0, wobCount = 0; uint64_t womVerts = 0, womIndices = 0, womBones = 0; uint64_t womAnims = 0, womBatches = 0; uint64_t wobGroups = 0, wobVerts = 0, wobIndices = 0; uint64_t wobDoodads = 0, wobPortals = 0; }; std::vector<ZRow> rows; ZRow tot; tot.name = "TOTAL"; for (const auto& zoneDir : zones) { ZRow r; r.name = fs::path(zoneDir).filename().string(); std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); std::string base = e.path().string(); if (base.size() > ext.size()) base = base.substr(0, base.size() - ext.size()); if (ext == ".wom") { r.womCount++; auto wom = wowee::pipeline::WoweeModelLoader::load(base); r.womVerts += wom.vertices.size(); r.womIndices += wom.indices.size(); r.womBones += wom.bones.size(); r.womAnims += wom.animations.size(); r.womBatches += wom.batches.size(); } else if (ext == ".wob") { r.wobCount++; auto wob = wowee::pipeline::WoweeBuildingLoader::load(base); r.wobGroups += wob.groups.size(); for (const auto& g : wob.groups) { r.wobVerts += g.vertices.size(); r.wobIndices += g.indices.size(); } r.wobDoodads += wob.doodads.size(); r.wobPortals += wob.portals.size(); } } tot.womCount += r.womCount; tot.wobCount += r.wobCount; tot.womVerts += r.womVerts; tot.womIndices += r.womIndices; tot.womBones += r.womBones; tot.womAnims += r.womAnims; tot.womBatches += r.womBatches; tot.wobGroups += r.wobGroups; tot.wobVerts += r.wobVerts; tot.wobIndices += r.wobIndices; tot.wobDoodads += r.wobDoodads; tot.wobPortals += r.wobPortals; rows.push_back(r); } if (jsonOut) { nlohmann::json j; j["project"] = projectDir; j["zones"] = nlohmann::json::array(); auto rowJson = [](const ZRow& r) { nlohmann::json z; z["name"] = r.name; z["wom"] = {{"count", r.womCount}, {"vertices", r.womVerts}, {"indices", r.womIndices}, {"triangles", r.womIndices / 3}, {"bones", r.womBones}, {"animations", r.womAnims}, {"batches", r.womBatches}}; z["wob"] = {{"count", r.wobCount}, {"groups", r.wobGroups}, {"vertices", r.wobVerts}, {"indices", r.wobIndices}, {"triangles", r.wobIndices / 3}, {"doodads", r.wobDoodads}, {"portals", r.wobPortals}}; return z; }; for (const auto& r : rows) j["zones"].push_back(rowJson(r)); j["total"] = rowJson(tot); std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Project models total: %s\n", projectDir.c_str()); std::printf(" zones : %zu\n\n", zones.size()); std::printf(" zone WOMs WOMtri bones WOBs WOBtri doodads\n"); for (const auto& r : rows) { std::printf(" %-20s %5d %7llu %6llu %5d %7llu %8llu\n", r.name.substr(0, 20).c_str(), r.womCount, static_cast<unsigned long long>(r.womIndices / 3), static_cast<unsigned long long>(r.womBones), r.wobCount, static_cast<unsigned long long>(r.wobIndices / 3), static_cast<unsigned long long>(r.wobDoodads)); } std::printf(" %-20s %5d %7llu %6llu %5d %7llu %8llu\n", tot.name.c_str(), tot.womCount, static_cast<unsigned long long>(tot.womIndices / 3), static_cast<unsigned long long>(tot.womBones), tot.wobCount, static_cast<unsigned long long>(tot.wobIndices / 3), static_cast<unsigned long long>(tot.wobDoodads)); std::printf("\n Combined verts/tris (WOM+WOB): %llu / %llu\n", static_cast<unsigned long long>(tot.womVerts + tot.wobVerts), static_cast<unsigned long long>((tot.womIndices + tot.wobIndices) / 3)); return 0; } else if (std::strcmp(argv[i], "--copy-project") == 0 && i + 2 < argc) { // Recursively copy an entire project tree. Refuses to // overwrite an existing destination so a typo doesn't // silently merge into the wrong project. std::string fromDir = argv[++i]; std::string toDir = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(fromDir) || !fs::is_directory(fromDir)) { std::fprintf(stderr, "copy-project: %s is not a directory\n", fromDir.c_str()); return 1; } if (fs::exists(toDir)) { std::fprintf(stderr, "copy-project: destination %s already exists " "(delete it first if intentional)\n", toDir.c_str()); return 1; } std::error_code ec; fs::copy(fromDir, toDir, fs::copy_options::recursive | fs::copy_options::copy_symlinks, ec); if (ec) { std::fprintf(stderr, "copy-project: copy failed (%s)\n", ec.message().c_str()); return 1; } // Count what was copied for the report. int zoneCount = 0, fileCount = 0; uint64_t totalBytes = 0; for (const auto& entry : fs::directory_iterator(toDir, ec)) { if (entry.is_directory() && fs::exists(entry.path() / "zone.json")) zoneCount++; } for (const auto& e : fs::recursive_directory_iterator(toDir, ec)) { if (e.is_regular_file()) { fileCount++; totalBytes += e.file_size(ec); } } std::printf("Copied %s -> %s\n", fromDir.c_str(), toDir.c_str()); std::printf(" zones : %d\n", zoneCount); std::printf(" files : %d\n", fileCount); std::printf(" total bytes : %llu (%.1f MB)\n", static_cast<unsigned long long>(totalBytes), totalBytes / (1024.0 * 1024.0)); return 0; } else if (std::strcmp(argv[i], "--zone-summary") == 0 && i + 1 < argc) { // One-shot zone overview: validate + creature/object/quest counts. // Collapses the most common multi-step inspection into a single // command; useful for CI reports and quick sanity checks. std::string zoneDir = argv[++i]; // Optional --json after the dir for machine-readable output. bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "zone-summary: %s does not exist\n", zoneDir.c_str()); return 1; } auto v = wowee::editor::ContentPacker::validateZone(zoneDir); // Read creature/object/quest data once so both human and JSON // outputs share the same numbers. int creatureTotal = 0, hostile = 0, qg = 0, vendor = 0; int objectTotal = 0, m2Count = 0, wmoCount = 0; int questTotal = 0, chainWarnings = 0; std::string creaturesPath = zoneDir + "/creatures.json"; if (fs::exists(creaturesPath)) { wowee::editor::NpcSpawner sp; if (sp.loadFromFile(creaturesPath)) { creatureTotal = static_cast<int>(sp.getSpawns().size()); for (const auto& s : sp.getSpawns()) { if (s.hostile) hostile++; if (s.questgiver) qg++; if (s.vendor) vendor++; } } } std::string objectsPath = zoneDir + "/objects.json"; if (fs::exists(objectsPath)) { wowee::editor::ObjectPlacer op; if (op.loadFromFile(objectsPath)) { objectTotal = static_cast<int>(op.getObjects().size()); for (const auto& o : op.getObjects()) { if (o.type == wowee::editor::PlaceableType::M2) m2Count++; else wmoCount++; } } } std::string questsPath = zoneDir + "/quests.json"; if (fs::exists(questsPath)) { wowee::editor::QuestEditor qe; if (qe.loadFromFile(questsPath)) { questTotal = static_cast<int>(qe.getQuests().size()); std::vector<std::string> errors; qe.validateChains(errors); chainWarnings = static_cast<int>(errors.size()); } } if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["score"] = v.openFormatScore(); j["maxScore"] = 7; j["formats"] = v.summary(); j["counts"] = { {"wot", v.wotCount}, {"whm", v.whmCount}, {"wom", v.womCount}, {"wob", v.wobCount}, {"woc", v.wocCount}, {"png", v.pngCount}, }; j["creatures"] = { {"total", creatureTotal}, {"hostile", hostile}, {"questgiver", qg}, {"vendor", vendor}, }; j["objects"] = { {"total", objectTotal}, {"m2", m2Count}, {"wmo", wmoCount}, }; j["quests"] = { {"total", questTotal}, {"chainWarnings", chainWarnings}, }; std::printf("%s\n", j.dump(2).c_str()); return v.openFormatScore() == 7 ? 0 : 1; } std::printf("Zone: %s\n", zoneDir.c_str()); std::printf(" open formats : %d/7 (%s)\n", v.openFormatScore(), v.summary().c_str()); std::printf(" WOT/WHM : %d/%d WOM: %d WOB: %d WOC: %d PNG: %d\n", v.wotCount, v.whmCount, v.womCount, v.wobCount, v.wocCount, v.pngCount); if (creatureTotal > 0) { std::printf(" creatures : %d (%d hostile, %d quest, %d vendor)\n", creatureTotal, hostile, qg, vendor); } if (objectTotal > 0) { std::printf(" objects : %d (%d M2, %d WMO)\n", objectTotal, m2Count, wmoCount); } if (questTotal > 0) { std::printf(" quests : %d (%d chain warnings)\n", questTotal, chainWarnings); } return v.openFormatScore() == 7 ? 0 : 1; } else if (std::strcmp(argv[i], "--bench-bake-project") == 0 && i + 1 < argc) { // Time WHM/WOT load (the dominant cost in --bake-zone-glb/obj/ // stl) per zone. The actual write side adds ~constant cost // proportional to vertex count, so load time is a strong // proxy. Useful for tracking 'has my latest geometry change // made baking 3× slower?' across releases. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "bench-bake-project: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); struct Timing { std::string name; int tiles; double loadMs; int chunks; }; std::vector<Timing> timings; double totalMs = 0; for (const auto& zoneDir : zones) { wowee::editor::ZoneManifest zm; if (!zm.load(zoneDir + "/zone.json")) continue; Timing t{fs::path(zoneDir).filename().string(), 0, 0.0, 0}; auto t0 = std::chrono::steady_clock::now(); for (const auto& [tx, ty] : zm.tiles) { std::string base = zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); if (!wowee::pipeline::WoweeTerrainLoader::exists(base)) continue; wowee::pipeline::ADTTerrain terrain; wowee::pipeline::WoweeTerrainLoader::load(base, terrain); t.tiles++; for (const auto& chunk : terrain.chunks) { if (chunk.heightMap.isLoaded()) t.chunks++; } } auto t1 = std::chrono::steady_clock::now(); t.loadMs = std::chrono::duration<double, std::milli>(t1 - t0).count(); totalMs += t.loadMs; timings.push_back(t); } double avgMs = !timings.empty() ? totalMs / timings.size() : 0.0; double minMs = 1e30, maxMs = 0; std::string slowest; for (const auto& t : timings) { if (t.loadMs < minMs) minMs = t.loadMs; if (t.loadMs > maxMs) { maxMs = t.loadMs; slowest = t.name; } } if (timings.empty()) { minMs = 0; maxMs = 0; } if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["totalMs"] = totalMs; j["zoneCount"] = timings.size(); j["avgMs"] = avgMs; j["minMs"] = minMs; j["maxMs"] = maxMs; j["slowestZone"] = slowest; nlohmann::json arr = nlohmann::json::array(); for (const auto& t : timings) { arr.push_back({{"zone", t.name}, {"loadMs", t.loadMs}, {"tiles", t.tiles}, {"chunks", t.chunks}}); } j["perZone"] = arr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Bench bake (load-only): %s\n", projectDir.c_str()); std::printf(" zones : %zu\n", timings.size()); std::printf(" total : %.2f ms (terrain load)\n", totalMs); std::printf(" per zone : avg=%.2f min=%.2f max=%.2f ms\n", avgMs, minMs, maxMs); if (!slowest.empty()) { std::printf(" slowest : %s (%.2f ms)\n", slowest.c_str(), maxMs); } std::printf("\n Per-zone:\n"); std::printf(" zone ms tiles chunks ms/tile\n"); for (const auto& t : timings) { double mspt = t.tiles > 0 ? t.loadMs / t.tiles : 0.0; std::printf(" %-26s %7.2f %5d %5d %6.2f\n", t.name.substr(0, 26).c_str(), t.loadMs, t.tiles, t.chunks, mspt); } return 0; } else if (std::strcmp(argv[i], "--export-png") == 0 && i + 1 < argc) { // Render heightmap, normal-map, and zone-map PNG previews for a // terrain. Useful for portfolio screenshots, ground-truth map // comparison, and quick visual validation without launching GUI. std::string base = argv[++i]; for (const char* ext : {".wot", ".whm"}) { if (base.size() >= 4 && base.substr(base.size() - 4) == ext) { base = base.substr(0, base.size() - 4); break; } } if (!wowee::pipeline::WoweeTerrainLoader::exists(base)) { std::fprintf(stderr, "WOT/WHM not found at base: %s\n", base.c_str()); return 1; } wowee::pipeline::ADTTerrain terrain; if (!wowee::pipeline::WoweeTerrainLoader::load(base, terrain)) { std::fprintf(stderr, "Failed to load terrain: %s\n", base.c_str()); return 1; } wowee::editor::WoweeTerrain::exportHeightmapPreview(terrain, base + "_heightmap.png"); wowee::editor::WoweeTerrain::exportNormalMap(terrain, base + "_normals.png"); wowee::editor::WoweeTerrain::exportZoneMap(terrain, base + "_zone.png", 512); std::printf("Exported PNGs: %s_{heightmap,normals,zone}.png\n", base.c_str()); return 0; } else if (std::strcmp(argv[i], "--fix-zone") == 0 && i + 1 < argc) { // Re-parse + re-save every JSON/binary file in a zone to apply // the editor's load-time scrubs and save-time caps. Useful when // an old zone was created before recent hardening — running // this once cleans up NaN/oversize fields without touching // the editor GUI. std::string zoneDir = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "fix-zone: %s does not exist\n", zoneDir.c_str()); return 1; } int touched = 0; // zone.json { wowee::editor::ZoneManifest m; std::string p = zoneDir + "/zone.json"; if (fs::exists(p) && m.load(p) && m.save(p)) touched++; } // creatures.json { wowee::editor::NpcSpawner sp; std::string p = zoneDir + "/creatures.json"; if (fs::exists(p) && sp.loadFromFile(p) && sp.saveToFile(p)) touched++; } // objects.json { wowee::editor::ObjectPlacer op; std::string p = zoneDir + "/objects.json"; if (fs::exists(p) && op.loadFromFile(p) && op.saveToFile(p)) touched++; } // quests.json { wowee::editor::QuestEditor qe; std::string p = zoneDir + "/quests.json"; if (fs::exists(p) && qe.loadFromFile(p) && qe.saveToFile(p)) touched++; } // WHM/WOT pairs and WoB files would need full pipeline access; // skip them — the editor opens them on next zone load anyway, // and the load-time scrubs run then. std::printf("fix-zone: cleaned %d files in %s\n", touched, zoneDir.c_str()); return 0; } else if (std::strcmp(argv[i], "--regen-collision") == 0 && i + 1 < argc) { // Find all WHM/WOT pairs under a zone dir and rebuild WOC for each. // Useful after sculpting changes when you want to re-derive // collision in batch instead of one tile at a time. std::string zoneDir = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "regen-collision: %s does not exist\n", zoneDir.c_str()); return 1; } int rebuilt = 0, failed = 0; for (auto& entry : fs::recursive_directory_iterator(zoneDir)) { if (!entry.is_regular_file()) continue; if (entry.path().extension() != ".whm") continue; std::string base = entry.path().string(); base = base.substr(0, base.size() - 4); // strip .whm wowee::pipeline::ADTTerrain terrain; if (!wowee::pipeline::WoweeTerrainLoader::load(base, terrain)) { std::fprintf(stderr, " FAILED to load: %s\n", base.c_str()); failed++; continue; } auto col = wowee::pipeline::WoweeCollisionBuilder::fromTerrain(terrain); std::string outPath = base + ".woc"; if (wowee::pipeline::WoweeCollisionBuilder::save(col, outPath)) { std::printf(" WOC rebuilt: %s (%zu triangles)\n", outPath.c_str(), col.triangles.size()); rebuilt++; } else { std::fprintf(stderr, " FAILED to save: %s\n", outPath.c_str()); failed++; } } std::printf("regen-collision: %d rebuilt, %d failed\n", rebuilt, failed); return failed > 0 ? 1 : 0; } else if (std::strcmp(argv[i], "--build-woc") == 0 && i + 1 < argc) { // Generate a WOC collision mesh from a WHM/WOT terrain pair. // Uses terrain triangles only (no WMO overlays); useful as a // first-pass collision build before the editor adds buildings. std::string base = argv[++i]; for (const char* ext : {".wot", ".whm", ".woc"}) { if (base.size() >= 4 && base.substr(base.size() - 4) == ext) { base = base.substr(0, base.size() - 4); break; } } if (!wowee::pipeline::WoweeTerrainLoader::exists(base)) { std::fprintf(stderr, "WOT/WHM not found at base: %s\n", base.c_str()); return 1; } wowee::pipeline::ADTTerrain terrain; if (!wowee::pipeline::WoweeTerrainLoader::load(base, terrain)) { std::fprintf(stderr, "Failed to load terrain: %s\n", base.c_str()); return 1; } auto col = wowee::pipeline::WoweeCollisionBuilder::fromTerrain(terrain); std::string outPath = base + ".woc"; if (!wowee::pipeline::WoweeCollisionBuilder::save(col, outPath)) { std::fprintf(stderr, "WOC save failed: %s\n", outPath.c_str()); return 1; } std::printf("WOC built: %s (%zu triangles, %zu walkable, %zu steep)\n", outPath.c_str(), col.triangles.size(), col.walkableCount(), col.steepCount()); return 0; } else if (std::strcmp(argv[i], "--remove-creature") == 0 && i + 2 < argc) { // Remove a creature spawn by 0-based index. Pair with // --info-creatures (or your editor) to find the right index // first; nothing identifies entries reliably across reloads. std::string zoneDir = argv[++i]; std::string idxStr = argv[++i]; std::string path = zoneDir + "/creatures.json"; if (!std::filesystem::exists(path)) { std::fprintf(stderr, "remove-creature: %s not found\n", path.c_str()); return 1; } int idx; try { idx = std::stoi(idxStr); } catch (...) { std::fprintf(stderr, "remove-creature: bad index '%s'\n", idxStr.c_str()); return 1; } wowee::editor::NpcSpawner sp; sp.loadFromFile(path); if (idx < 0 || idx >= static_cast<int>(sp.spawnCount())) { std::fprintf(stderr, "remove-creature: index %d out of range [0, %zu)\n", idx, sp.spawnCount()); return 1; } std::string removedName = sp.getSpawns()[idx].name; sp.removeCreature(idx); if (!sp.saveToFile(path)) { std::fprintf(stderr, "remove-creature: failed to write %s\n", path.c_str()); return 1; } std::printf("Removed creature '%s' (was index %d) from %s (now %zu total)\n", removedName.c_str(), idx, path.c_str(), sp.spawnCount()); return 0; } else if (std::strcmp(argv[i], "--remove-object") == 0 && i + 2 < argc) { std::string zoneDir = argv[++i]; std::string idxStr = argv[++i]; std::string path = zoneDir + "/objects.json"; if (!std::filesystem::exists(path)) { std::fprintf(stderr, "remove-object: %s not found\n", path.c_str()); return 1; } int idx; try { idx = std::stoi(idxStr); } catch (...) { std::fprintf(stderr, "remove-object: bad index '%s'\n", idxStr.c_str()); return 1; } wowee::editor::ObjectPlacer placer; placer.loadFromFile(path); auto& objs = placer.getObjects(); if (idx < 0 || idx >= static_cast<int>(objs.size())) { std::fprintf(stderr, "remove-object: index %d out of range [0, %zu)\n", idx, objs.size()); return 1; } std::string removedPath = objs[idx].path; objs.erase(objs.begin() + idx); if (!placer.saveToFile(path)) { std::fprintf(stderr, "remove-object: failed to write %s\n", path.c_str()); return 1; } std::printf("Removed object '%s' (was index %d) from %s (now %zu total)\n", removedPath.c_str(), idx, path.c_str(), objs.size()); return 0; } else if (std::strcmp(argv[i], "--remove-quest") == 0 && i + 2 < argc) { std::string zoneDir = argv[++i]; std::string idxStr = argv[++i]; std::string path = zoneDir + "/quests.json"; if (!std::filesystem::exists(path)) { std::fprintf(stderr, "remove-quest: %s not found\n", path.c_str()); return 1; } int idx; try { idx = std::stoi(idxStr); } catch (...) { std::fprintf(stderr, "remove-quest: bad index '%s'\n", idxStr.c_str()); return 1; } wowee::editor::QuestEditor qe; qe.loadFromFile(path); if (idx < 0 || idx >= static_cast<int>(qe.questCount())) { std::fprintf(stderr, "remove-quest: index %d out of range [0, %zu)\n", idx, qe.questCount()); return 1; } std::string removedTitle = qe.getQuests()[idx].title; qe.removeQuest(idx); if (!qe.saveToFile(path)) { std::fprintf(stderr, "remove-quest: failed to write %s\n", path.c_str()); return 1; } std::printf("Removed quest '%s' (was index %d) from %s (now %zu total)\n", removedTitle.c_str(), idx, path.c_str(), qe.questCount()); return 0; } else if (std::strcmp(argv[i], "--add-object") == 0 && i + 5 < argc) { // Append a single object placement to a zone's objects.json. // Args: <zoneDir> <m2|wmo> <gamePath> <x> <y> <z> [scale] std::string zoneDir = argv[++i]; std::string typeStr = argv[++i]; std::string gamePath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "add-object: zone '%s' does not exist\n", zoneDir.c_str()); return 1; } wowee::editor::PlaceableType ptype; if (typeStr == "m2") ptype = wowee::editor::PlaceableType::M2; else if (typeStr == "wmo") ptype = wowee::editor::PlaceableType::WMO; else { std::fprintf(stderr, "add-object: type must be 'm2' or 'wmo'\n"); return 1; } glm::vec3 pos; try { pos.x = std::stof(argv[++i]); pos.y = std::stof(argv[++i]); pos.z = std::stof(argv[++i]); } catch (const std::exception& e) { std::fprintf(stderr, "add-object: bad coordinate (%s)\n", e.what()); return 1; } wowee::editor::ObjectPlacer placer; std::string path = zoneDir + "/objects.json"; if (fs::exists(path)) placer.loadFromFile(path); placer.setActivePath(gamePath, ptype); placer.placeObject(pos); // Optional scale after coordinates. if (i + 1 < argc && argv[i + 1][0] != '-') { try { float scale = std::stof(argv[++i]); if (std::isfinite(scale) && scale > 0.0f) { // Set scale on the just-placed object (last in list). placer.getObjects().back().scale = scale; } } catch (...) {} } if (!placer.saveToFile(path)) { std::fprintf(stderr, "add-object: failed to write %s\n", path.c_str()); return 1; } std::printf("Added %s '%s' to %s (now %zu total)\n", typeStr.c_str(), gamePath.c_str(), path.c_str(), placer.getObjects().size()); return 0; } else if (std::strcmp(argv[i], "--add-creature") == 0 && i + 4 < argc) { // Append a single creature spawn to a zone's creatures.json. // Args: <zoneDir> <name> <x> <y> <z> [displayId] [level] // Useful for batch-populating zones via shell script without // launching the GUI placement tool. std::string zoneDir = argv[++i]; std::string name = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "add-creature: zone '%s' does not exist\n", zoneDir.c_str()); return 1; } wowee::editor::CreatureSpawn s; s.name = name; try { s.position.x = std::stof(argv[++i]); s.position.y = std::stof(argv[++i]); s.position.z = std::stof(argv[++i]); } catch (const std::exception& e) { std::fprintf(stderr, "add-creature: bad coordinate (%s)\n", e.what()); return 1; } // Optional displayId (positional, after coordinates). if (i + 1 < argc && argv[i + 1][0] != '-') { try { s.displayId = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) { /* leave 0 → SQL exporter substitutes 11707 */ } } if (i + 1 < argc && argv[i + 1][0] != '-') { try { s.level = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) { /* leave default 1 */ } } // Load existing spawns (if any), append, save. wowee::editor::NpcSpawner spawner; std::string path = zoneDir + "/creatures.json"; if (fs::exists(path)) spawner.loadFromFile(path); spawner.placeCreature(s); if (!spawner.saveToFile(path)) { std::fprintf(stderr, "add-creature: failed to write %s\n", path.c_str()); return 1; } std::printf("Added creature '%s' to %s (now %zu total)\n", name.c_str(), path.c_str(), spawner.spawnCount()); return 0; } else if (std::strcmp(argv[i], "--add-item") == 0 && i + 2 < argc) { // Append one item entry to <zoneDir>/items.json. Inline // JSON without a dedicated editor class — items.json is // a simple {"items": [...]} array of records, and the // schema is small enough that we don't need NpcSpawner- // style infrastructure yet. // // Schema per item: // id (uint32) — Item.dbc primary key (auto-increments // from 1 if omitted) // name (string) // quality (uint8) — 0..6 (poor..artifact, default 1) // displayId (uint32) — ItemDisplayInfo index (default 0) // itemLevel (uint32) — default 1 // stackable (uint32) — max stack size (default 1) std::string zoneDir = argv[++i]; std::string name = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "add-item: zone '%s' does not exist\n", zoneDir.c_str()); return 1; } uint32_t id = 0, displayId = 0, itemLevel = 1; uint32_t quality = 1; if (i + 1 < argc && argv[i + 1][0] != '-') { try { id = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } if (i + 1 < argc && argv[i + 1][0] != '-') { try { quality = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} if (quality > 6) quality = 1; } if (i + 1 < argc && argv[i + 1][0] != '-') { try { displayId = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } if (i + 1 < argc && argv[i + 1][0] != '-') { try { itemLevel = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } std::string path = zoneDir + "/items.json"; nlohmann::json doc = nlohmann::json::object({{"items", nlohmann::json::array()}}); if (fs::exists(path)) { std::ifstream in(path); try { in >> doc; } catch (...) { std::fprintf(stderr, "add-item: %s exists but is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { doc["items"] = nlohmann::json::array(); } } // Auto-assign id if user passed 0 / nothing — pick the // smallest unused positive integer so the items.json // numbering stays contiguous. if (id == 0) { std::set<uint32_t> used; for (const auto& it : doc["items"]) { if (it.contains("id") && it["id"].is_number_unsigned()) { used.insert(it["id"].get<uint32_t>()); } } id = 1; while (used.count(id)) ++id; } // Reject duplicate id so the user notices a collision. for (const auto& it : doc["items"]) { if (it.contains("id") && it["id"].is_number_unsigned() && it["id"].get<uint32_t>() == id) { std::fprintf(stderr, "add-item: id %u already in use in %s\n", id, path.c_str()); return 1; } } nlohmann::json item = { {"id", id}, {"name", name}, {"quality", quality}, {"displayId", displayId}, {"itemLevel", itemLevel}, {"stackable", 1}, }; doc["items"].push_back(item); std::ofstream out(path); if (!out) { std::fprintf(stderr, "add-item: failed to write %s\n", path.c_str()); return 1; } out << doc.dump(2); out.close(); static const char* qualityNames[] = { "poor", "common", "uncommon", "rare", "epic", "legendary", "artifact" }; std::printf("Added item '%s' (id=%u, quality=%s, ilvl=%u) to %s (now %zu total)\n", name.c_str(), id, qualityNames[quality], itemLevel, path.c_str(), doc["items"].size()); return 0; } else if (std::strcmp(argv[i], "--random-populate-zone") == 0 && i + 1 < argc) { // Randomly add creatures and/or objects to a zone for // playtest scenarios. Reads the zone manifest's tile // bounds so spawn positions stay inside the actual // playable area. Seeded LCG for reproducibility — same // seed always produces the same population. // // Flags: // --seed N (default 42) // --creatures N (default 20) // --objects N (default 10) std::string zoneDir = argv[++i]; uint32_t seed = 42; int creatureCount = 20; int objectCount = 10; while (i + 2 < argc && argv[i + 1][0] == '-') { std::string flag = argv[++i]; if (flag == "--seed") { try { seed = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } else if (flag == "--creatures") { try { creatureCount = std::stoi(argv[++i]); } catch (...) {} } else if (flag == "--objects") { try { objectCount = std::stoi(argv[++i]); } catch (...) {} } else { std::fprintf(stderr, "random-populate-zone: unknown flag '%s'\n", flag.c_str()); return 1; } } namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "random-populate-zone: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "random-populate-zone: failed to parse %s\n", manifestPath.c_str()); return 1; } if (zm.tiles.empty()) { std::fprintf(stderr, "random-populate-zone: zone has no tiles to populate\n"); return 1; } // Compute the world AABB the zone occupies so spawns land // inside it. Each tile is 533.33y; WoW grid centers tile // (32, 32) at world origin. constexpr float kTileSize = 533.33333f; int tMinX = 64, tMaxX = -1, tMinY = 64, tMaxY = -1; for (const auto& [tx, ty] : zm.tiles) { tMinX = std::min(tMinX, tx); tMaxX = std::max(tMaxX, tx); tMinY = std::min(tMinY, ty); tMaxY = std::max(tMaxY, ty); } float wMinX = (32.0f - tMaxY - 1) * kTileSize; float wMaxX = (32.0f - tMinY) * kTileSize; float wMinY = (32.0f - tMaxX - 1) * kTileSize; float wMaxY = (32.0f - tMinX) * kTileSize; float baseZ = zm.baseHeight; uint32_t rng = seed ? seed : 1u; auto next01 = [&]() { rng = rng * 1664525u + 1013904223u; return (rng >> 8) / float(1 << 24); }; auto rangeF = [&](float a, float b) { return a + next01() * (b - a); }; auto rangeI = [&](int a, int b) { return a + static_cast<int>(next01() * (b - a + 1)); }; // Tiny bestiary so the random output reads as plausible // rather than "Creature1 / Creature2". static const std::vector<std::pair<const char*, uint32_t>> kRandomCreatures = { {"Wolf", 5}, {"Boar", 4}, {"Bear", 7}, {"Spider", 3}, {"Bandit", 6}, {"Kobold", 4}, {"Murloc", 5}, {"Skeleton", 5}, {"Wisp", 3}, {"Goblin", 5}, {"Stag", 4}, {"Crab", 3}, }; static const std::vector<const char*> kRandomObjects = { "World/Generic/Tree01.wmo", "World/Generic/Boulder.wmo", "World/Generic/Bush.wmo", "World/Generic/Stump.wmo", "World/Generic/Mushroom.wmo", }; // Creatures. wowee::editor::NpcSpawner spawner; std::string cpath = zoneDir + "/creatures.json"; if (fs::exists(cpath)) spawner.loadFromFile(cpath); int placedCreatures = 0; for (int n = 0; n < creatureCount; ++n) { const auto& [name, baseLvl] = kRandomCreatures[ rangeI(0, static_cast<int>(kRandomCreatures.size()) - 1)]; wowee::editor::CreatureSpawn s; s.name = name; s.position.x = rangeF(wMinX, wMaxX); s.position.y = rangeF(wMinY, wMaxY); s.position.z = baseZ; int lvl = std::max(1, static_cast<int>(baseLvl) + rangeI(-1, 2)); s.level = static_cast<uint32_t>(lvl); s.health = 50 + s.level * 10; s.orientation = rangeF(0.0f, 360.0f); spawner.placeCreature(s); placedCreatures++; } if (placedCreatures > 0) spawner.saveToFile(cpath); // Objects. wowee::editor::ObjectPlacer placer; std::string opath = zoneDir + "/objects.json"; if (fs::exists(opath)) placer.loadFromFile(opath); int placedObjects = 0; // Push PlacedObject directly into the placer's vector so // we don't fight placeObject()'s early-return on empty // activePath_. uniqueId starts after any existing objects // to keep IDs collision-free. auto& objs = placer.getObjects(); uint32_t maxUid = 0; for (const auto& o : objs) maxUid = std::max(maxUid, o.uniqueId); for (int n = 0; n < objectCount; ++n) { wowee::editor::PlacedObject o; o.path = kRandomObjects[ rangeI(0, static_cast<int>(kRandomObjects.size()) - 1)]; o.type = wowee::editor::PlaceableType::WMO; o.position.x = rangeF(wMinX, wMaxX); o.position.y = rangeF(wMinY, wMaxY); o.position.z = baseZ; o.rotation = glm::vec3(0.0f, rangeF(0.0f, 6.28f), 0.0f); o.scale = rangeF(0.8f, 1.4f); o.uniqueId = ++maxUid; o.nameId = 0; o.selected = false; objs.push_back(o); placedObjects++; } if (placedObjects > 0) placer.saveToFile(opath); std::printf("random-populate-zone: %s\n", zoneDir.c_str()); std::printf(" seed : %u\n", seed); std::printf(" zone bbox : (%.0f, %.0f) - (%.0f, %.0f)\n", wMinX, wMinY, wMaxX, wMaxY); std::printf(" creatures : %d added (%zu total)\n", placedCreatures, spawner.spawnCount()); std::printf(" objects : %d added (%zu total)\n", placedObjects, placer.getObjects().size()); return 0; } else if (std::strcmp(argv[i], "--random-populate-items") == 0 && i + 1 < argc) { // Seeded random items.json populator. Pulls a base name // and a noun from inline word lists, picks a quality up // to maxQuality, randomizes itemLevel and stack size // around plausible defaults. Useful for playtest loot // tables that need bulk content without hand-typing each // entry. // // Flags: --seed N (default 7), --count N (default 30), // --max-quality Q (default 4 = epic; 0..6 valid). std::string zoneDir = argv[++i]; uint32_t seed = 7; int count = 30; int maxQuality = 4; while (i + 2 < argc && argv[i + 1][0] == '-') { std::string flag = argv[++i]; if (flag == "--seed") { try { seed = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} } else if (flag == "--count") { try { count = std::stoi(argv[++i]); } catch (...) {} } else if (flag == "--max-quality") { try { maxQuality = std::stoi(argv[++i]); } catch (...) {} } else { std::fprintf(stderr, "random-populate-items: unknown flag '%s'\n", flag.c_str()); return 1; } } if (maxQuality < 0 || maxQuality > 6) maxQuality = 4; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "random-populate-items: %s has no zone.json\n", zoneDir.c_str()); return 1; } uint32_t rng = seed ? seed : 1u; auto next01 = [&]() { rng = rng * 1664525u + 1013904223u; return (rng >> 8) / float(1 << 24); }; auto rangeI = [&](int a, int b) { return a + static_cast<int>(next01() * (b - a + 1)); }; // Inline name lexicon. {prefix, noun} → "Glowing Sword". // Quality ramps prefix selection; rare+ items get fancier // adjectives. static const std::vector<const char*> kPrefixes[5] = { {"Worn", "Tattered", "Cracked", "Dented", "Faded"}, // poor {"Common", "Plain", "Basic", "Simple", "Standard"}, // common {"Sharp", "Sturdy", "Polished", "Reinforced", "Fine"}, // uncommon {"Glowing", "Runed", "Enchanted", "Storm", "Mystic"}, // rare {"Ancient", "Eternal", "Heroic", "Vengeful", "Soul"}, // epic }; static const std::vector<const char*> kNouns = { "Sword", "Mace", "Axe", "Dagger", "Staff", "Bow", "Helm", "Cuirass", "Greaves", "Gauntlets", "Ring", "Amulet", "Cloak", "Belt", "Boots", "Potion", "Scroll", "Tome", "Wand", "Shield", }; // Open the items doc. std::string ipath = zoneDir + "/items.json"; nlohmann::json doc = nlohmann::json::object({{"items", nlohmann::json::array()}}); if (fs::exists(ipath)) { std::ifstream in(ipath); try { in >> doc; } catch (...) {} if (!doc.contains("items") || !doc["items"].is_array()) { doc["items"] = nlohmann::json::array(); } } std::set<uint32_t> used; for (const auto& it : doc["items"]) { if (it.contains("id") && it["id"].is_number_unsigned()) used.insert(it["id"].get<uint32_t>()); } int added = 0; for (int n = 0; n < count; ++n) { int q = std::min(maxQuality, rangeI(0, maxQuality)); int qBucket = std::min(q, 4); const auto& prefixes = kPrefixes[qBucket]; std::string name = prefixes[rangeI(0, static_cast<int>(prefixes.size()) - 1)]; name += " "; name += kNouns[rangeI(0, static_cast<int>(kNouns.size()) - 1)]; uint32_t id = 1; while (used.count(id)) ++id; used.insert(id); int ilvl = std::max(1, rangeI(1, 5) + q * 12 + rangeI(-3, 3)); doc["items"].push_back({ {"id", id}, {"name", name}, {"quality", q}, {"displayId", rangeI(1000, 9999)}, {"itemLevel", ilvl}, {"stackable", q == 0 || q == 1 ? rangeI(1, 20) : 1}, }); added++; } std::ofstream out(ipath); if (!out) { std::fprintf(stderr, "random-populate-items: failed to write %s\n", ipath.c_str()); return 1; } out << doc.dump(2); out.close(); std::printf("random-populate-items: %s\n", ipath.c_str()); std::printf(" seed : %u\n", seed); std::printf(" added : %d\n", added); std::printf(" total items : %zu\n", doc["items"].size()); std::printf(" max quality : %d\n", maxQuality); return 0; } else if (std::strcmp(argv[i], "--gen-random-zone") == 0 && i + 1 < argc) { // End-to-end random zone generator. Composes scaffold-zone // + random-populate-zone + random-populate-items in one // invocation. Useful for "I just want a complete test // zone, don't make me chain three commands." // // Args: // <name> required (becomes the slug) // [tx ty] optional (default 32 32) // --seed N default 42 // --creatures N default 20 // --objects N default 10 // --items N default 25 // // Honors --random-populate-zone's hard caps + the existing // scaffold-zone validation. Sub-commands' output streams // through. std::string name = argv[++i]; int tx = 32, ty = 32; uint32_t seed = 42; int creatures = 20, objects = 10, items = 25; // Optional positional tx/ty (must be before any --flags). if (i + 2 < argc && argv[i + 1][0] != '-' && argv[i + 2][0] != '-') { try { tx = std::stoi(argv[++i]); ty = std::stoi(argv[++i]); } catch (...) {} } while (i + 2 < argc && argv[i + 1][0] == '-') { std::string flag = argv[++i]; if (flag == "--seed") try { seed = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} else if (flag == "--creatures") try { creatures = std::stoi(argv[++i]); } catch (...) {} else if (flag == "--objects") try { objects = std::stoi(argv[++i]); } catch (...) {} else if (flag == "--items") try { items = std::stoi(argv[++i]); } catch (...) {} else { std::fprintf(stderr, "gen-random-zone: unknown flag '%s'\n", flag.c_str()); return 1; } } // Slug-clean the name to match scaffold-zone's expectations. std::string slug; for (char c : name) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') { slug += c; } else if (c == ' ') { slug += '_'; } } if (slug.empty()) { std::fprintf(stderr, "gen-random-zone: name '%s' has no valid characters\n", name.c_str()); return 1; } std::string self = argv[0]; namespace fs = std::filesystem; std::string zoneDir = "custom_zones/" + slug; std::printf("gen-random-zone: %s (tile %d, %d)\n", slug.c_str(), tx, ty); std::fflush(stdout); // 1. Scaffold. std::string scaffoldCmd = "\"" + self + "\" --scaffold-zone \"" + slug + "\" " + std::to_string(tx) + " " + std::to_string(ty); int rc = std::system(scaffoldCmd.c_str()); if (rc != 0) { std::fprintf(stderr, "gen-random-zone: scaffold step failed (rc=%d)\n", rc); return 1; } // 2. Random populate. std::fflush(stdout); std::string popCmd = "\"" + self + "\" --random-populate-zone \"" + zoneDir + "\" --seed " + std::to_string(seed) + " --creatures " + std::to_string(creatures) + " --objects " + std::to_string(objects); rc = std::system(popCmd.c_str()); if (rc != 0) { std::fprintf(stderr, "gen-random-zone: populate step failed (rc=%d)\n", rc); return 1; } // 3. Random items. std::fflush(stdout); std::string itemsCmd = "\"" + self + "\" --random-populate-items \"" + zoneDir + "\" --seed " + std::to_string(seed + 1) + " --count " + std::to_string(items); rc = std::system(itemsCmd.c_str()); if (rc != 0) { std::fprintf(stderr, "gen-random-zone: items step failed (rc=%d)\n", rc); return 1; } std::printf("\ngen-random-zone: complete\n"); std::printf(" zone dir : %s\n", zoneDir.c_str()); std::printf(" creatures : %d\n", creatures); std::printf(" objects : %d\n", objects); std::printf(" items : %d\n", items); return 0; } else if (std::strcmp(argv[i], "--gen-random-project") == 0 && i + 1 < argc) { // Project-wide companion: spawn N random zones in one // pass. Names default to "Zone1, Zone2..."; tile // coordinates step from (32, 32) outward in a simple // raster so they don't overlap. Each zone gets a unique // sub-seed so its random content differs. int count = 0; try { count = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "gen-random-project: <count> must be an integer\n"); return 1; } if (count < 1 || count > 100) { std::fprintf(stderr, "gen-random-project: count %d out of range (1..100)\n", count); return 1; } std::string prefix = "Zone"; uint32_t seed = 100; int creatures = 20, objects = 10, items = 25; while (i + 2 < argc && argv[i + 1][0] == '-') { std::string flag = argv[++i]; if (flag == "--prefix") prefix = argv[++i]; else if (flag == "--seed") try { seed = static_cast<uint32_t>(std::stoul(argv[++i])); } catch (...) {} else if (flag == "--creatures") try { creatures = std::stoi(argv[++i]); } catch (...) {} else if (flag == "--objects") try { objects = std::stoi(argv[++i]); } catch (...) {} else if (flag == "--items") try { items = std::stoi(argv[++i]); } catch (...) {} else { std::fprintf(stderr, "gen-random-project: unknown flag '%s'\n", flag.c_str()); return 1; } } std::string self = argv[0]; int produced = 0, failed = 0; std::printf("gen-random-project: %d zone(s) with prefix '%s'\n", count, prefix.c_str()); for (int n = 0; n < count; ++n) { // Step outward from (32, 32) in a small raster so the // tiles don't coincide. (-1,0,1,...) X (-1,0,1,...). int side = 1; while ((2 * side + 1) * (2 * side + 1) <= n) side++; int idx = n; int dx = idx % (2 * side + 1) - side; int dy = (idx / (2 * side + 1)) - side; int tx = std::max(0, std::min(63, 32 + dx)); int ty = std::max(0, std::min(63, 32 + dy)); std::string zoneName = prefix + std::to_string(n + 1); std::printf("\n=== %s (tile %d, %d) ===\n", zoneName.c_str(), tx, ty); std::fflush(stdout); std::string cmd = "\"" + self + "\" --gen-random-zone \"" + zoneName + "\" " + std::to_string(tx) + " " + std::to_string(ty) + " --seed " + std::to_string(seed + n) + " --creatures " + std::to_string(creatures) + " --objects " + std::to_string(objects) + " --items " + std::to_string(items); int rc = std::system(cmd.c_str()); if (rc == 0) produced++; else failed++; } std::printf("\n--- summary ---\n"); std::printf(" produced : %d\n", produced); std::printf(" failed : %d\n", failed); return failed == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--set-item") == 0 && i + 2 < argc) { // Edit fields on an existing item in place. Lookup is by // id by default; '#N' for index lookup. Only specified // flags are changed; everything else is preserved // verbatim — including any extra fields added by hand. // // Supported flags: --name, --quality, --displayId, // --itemLevel, --stackable. Each takes one positional // argument that follows the flag. std::string zoneDir = argv[++i]; std::string lookup = argv[++i]; namespace fs = std::filesystem; std::string path = zoneDir + "/items.json"; if (!fs::exists(path)) { std::fprintf(stderr, "set-item: %s has no items.json\n", zoneDir.c_str()); return 1; } nlohmann::json doc; try { std::ifstream in(path); in >> doc; } catch (...) { std::fprintf(stderr, "set-item: %s is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { std::fprintf(stderr, "set-item: %s has no 'items' array\n", path.c_str()); return 1; } auto& items = doc["items"]; int foundIdx = -1; if (!lookup.empty() && lookup[0] == '#') { try { int idx = std::stoi(lookup.substr(1)); if (idx >= 0 && static_cast<size_t>(idx) < items.size()) foundIdx = idx; } catch (...) {} } else { uint32_t targetId = 0; try { targetId = static_cast<uint32_t>(std::stoul(lookup)); } catch (...) { std::fprintf(stderr, "set-item: lookup '%s' is not a number\n", lookup.c_str()); return 1; } for (size_t k = 0; k < items.size(); ++k) { if (items[k].contains("id") && items[k]["id"].is_number_unsigned() && items[k]["id"].get<uint32_t>() == targetId) { foundIdx = static_cast<int>(k); break; } } } if (foundIdx < 0) { std::fprintf(stderr, "set-item: no match for '%s' in %s\n", lookup.c_str(), path.c_str()); return 1; } auto& it = items[foundIdx]; std::vector<std::string> changes; // Walk the remaining args looking for known --field value // pairs. Anything unrecognized is reported and aborts so // typos don't silently no-op. while (i + 2 < argc) { std::string flag = argv[i + 1]; std::string val = argv[i + 2]; if (flag.size() < 2 || flag[0] != '-' || flag[1] != '-') break; if (flag == "--name") { it["name"] = val; changes.push_back("name=" + val); } else if (flag == "--quality") { try { uint32_t q = static_cast<uint32_t>(std::stoul(val)); if (q > 6) { std::fprintf(stderr, "set-item: quality %u out of range (0..6)\n", q); return 1; } it["quality"] = q; changes.push_back("quality=" + val); } catch (...) { std::fprintf(stderr, "set-item: --quality needs a number\n"); return 1; } } else if (flag == "--displayId") { try { it["displayId"] = static_cast<uint32_t>(std::stoul(val)); changes.push_back("displayId=" + val); } catch (...) { std::fprintf(stderr, "set-item: --displayId needs a number\n"); return 1; } } else if (flag == "--itemLevel") { try { it["itemLevel"] = static_cast<uint32_t>(std::stoul(val)); changes.push_back("itemLevel=" + val); } catch (...) { std::fprintf(stderr, "set-item: --itemLevel needs a number\n"); return 1; } } else if (flag == "--stackable") { try { uint32_t s = static_cast<uint32_t>(std::stoul(val)); if (s == 0 || s > 1000) { std::fprintf(stderr, "set-item: stackable %u out of range (1..1000)\n", s); return 1; } it["stackable"] = s; changes.push_back("stackable=" + val); } catch (...) { std::fprintf(stderr, "set-item: --stackable needs a number\n"); return 1; } } else { std::fprintf(stderr, "set-item: unknown flag '%s' (typo?)\n", flag.c_str()); return 1; } i += 2; } if (changes.empty()) { std::fprintf(stderr, "set-item: no field flags supplied — nothing to change\n"); return 1; } std::ofstream out(path); if (!out) { std::fprintf(stderr, "set-item: failed to write %s\n", path.c_str()); return 1; } out << doc.dump(2); out.close(); std::printf("Updated item %d in %s:\n", foundIdx, path.c_str()); for (const auto& c : changes) { std::printf(" %s\n", c.c_str()); } return 0; } else if (std::strcmp(argv[i], "--export-zone-items-md") == 0 && i + 1 < argc) { // Render items.json as a Markdown table grouped by // quality. Useful for design docs, PR descriptions, and // GitHub Pages — one rendered page communicates the loot // landscape better than scrolling through JSON. std::string zoneDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; std::string path = zoneDir + "/items.json"; if (!fs::exists(path)) { std::fprintf(stderr, "export-zone-items-md: %s has no items.json\n", zoneDir.c_str()); return 1; } nlohmann::json doc; try { std::ifstream in(path); in >> doc; } catch (...) { std::fprintf(stderr, "export-zone-items-md: %s is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { std::fprintf(stderr, "export-zone-items-md: %s has no 'items' array\n", path.c_str()); return 1; } if (outPath.empty()) outPath = zoneDir + "/ITEMS.md"; const auto& items = doc["items"]; static const char* qualityNames[] = { "Poor", "Common", "Uncommon", "Rare", "Epic", "Legendary", "Artifact" }; // Bucket by quality so the report reads top-down from // best loot to filler. Reverse iteration over the buckets. std::map<int, std::vector<size_t>> byQuality; for (size_t k = 0; k < items.size(); ++k) { uint32_t q = items[k].value("quality", 1u); if (q > 6) q = 0; byQuality[q].push_back(k); } std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "export-zone-items-md: cannot write %s\n", outPath.c_str()); return 1; } std::string zoneName = fs::path(zoneDir).filename().string(); out << "# Items: " << zoneName << "\n\n"; out << "Source: `" << path << "` \n"; out << "Total items: **" << items.size() << "**\n\n"; // Quality histogram up top. out << "## Quality breakdown\n\n"; out << "| Quality | Count |\n|---|---:|\n"; for (int q = 6; q >= 0; --q) { auto it = byQuality.find(q); if (it == byQuality.end()) continue; out << "| " << qualityNames[q] << " | " << it->second.size() << " |\n"; } out << "\n"; // Per-quality sections, best first. for (int q = 6; q >= 0; --q) { auto qit = byQuality.find(q); if (qit == byQuality.end()) continue; out << "## " << qualityNames[q] << "\n\n"; out << "| ID | Name | iLvl | Display | Stack |\n"; out << "|---:|---|---:|---:|---:|\n"; for (size_t k : qit->second) { const auto& it = items[k]; std::string name = it.value("name", std::string("(unnamed)")); out << "| " << it.value("id", 0u) << " | " << name << " | " << it.value("itemLevel", 1u) << " | " << it.value("displayId", 0u) << " | " << it.value("stackable", 1u) << " |\n"; } out << "\n"; } out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" total items : %zu\n", items.size()); std::printf(" qualities : %zu (used)\n", byQuality.size()); return 0; } else if (std::strcmp(argv[i], "--export-project-items-md") == 0 && i + 1 < argc) { // Project-wide items markdown. Walks every zone in // <projectDir> and emits one document with: project-wide // header + total + quality histogram, then per-zone // sections each containing a table (ID/name/quality/ // ilvl/displayId/stack). Easier to scan than running // --export-zone-items-md N times. std::string projectDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "export-project-items-md: %s is not a directory\n", projectDir.c_str()); return 1; } if (outPath.empty()) outPath = projectDir + "/ITEMS.md"; std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; if (!fs::exists(entry.path() / "items.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); static const char* qualityNames[] = { "Poor", "Common", "Uncommon", "Rare", "Epic", "Legendary", "Artifact" }; int totalItems = 0; std::map<int, int> globalQ; // Per-zone collected items so we don't have to re-read // each items.json twice. struct ZItems { std::string name; nlohmann::json items; }; std::vector<ZItems> zoneItems; for (const auto& zoneDir : zones) { std::string ipath = zoneDir + "/items.json"; nlohmann::json doc; try { std::ifstream in(ipath); in >> doc; } catch (...) { continue; } if (!doc.contains("items") || !doc["items"].is_array()) continue; ZItems z; z.name = fs::path(zoneDir).filename().string(); z.items = doc["items"]; for (const auto& it : z.items) { int q = static_cast<int>(it.value("quality", 1u)); if (q < 0 || q > 6) q = 0; globalQ[q]++; totalItems++; } zoneItems.push_back(std::move(z)); } std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "export-project-items-md: cannot write %s\n", outPath.c_str()); return 1; } out << "# Project Items: " << fs::path(projectDir).filename().string() << "\n\n"; out << "Source: `" << projectDir << "` \n"; out << "Zones with items: **" << zoneItems.size() << "** \n"; out << "Total items: **" << totalItems << "**\n\n"; out << "## Project quality breakdown\n\n"; out << "| Quality | Count |\n|---|---:|\n"; for (int q = 6; q >= 0; --q) { auto it = globalQ.find(q); if (it == globalQ.end()) continue; out << "| " << qualityNames[q] << " | " << it->second << " |\n"; } out << "\n"; for (const auto& z : zoneItems) { out << "## Zone: " << z.name << "\n\n"; out << "Items: **" << z.items.size() << "**\n\n"; out << "| ID | Name | Quality | iLvl | Display | Stack |\n"; out << "|---:|---|---|---:|---:|---:|\n"; for (const auto& it : z.items) { int q = static_cast<int>(it.value("quality", 1u)); if (q < 0 || q > 6) q = 0; std::string name = it.value("name", std::string("(unnamed)")); out << "| " << it.value("id", 0u) << " | " << name << " | " << qualityNames[q] << " | " << it.value("itemLevel", 1u) << " | " << it.value("displayId", 0u) << " | " << it.value("stackable", 1u) << " |\n"; } out << "\n"; } out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" zones with items : %zu\n", zoneItems.size()); std::printf(" total items : %d\n", totalItems); return 0; } else if (std::strcmp(argv[i], "--export-project-items-csv") == 0 && i + 1 < argc) { // Single CSV with every item across every zone. The // zone name is the first column so a pivot table can // group by it; everything else mirrors --export-zone-csv // items columns. Saves running the per-zone CSV exporter // N times and concatenating manually. std::string projectDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "export-project-items-csv: %s is not a directory\n", projectDir.c_str()); return 1; } if (outPath.empty()) outPath = projectDir + "/items.csv"; std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; if (!fs::exists(entry.path() / "items.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // CSV-escape the same way --export-zone-csv does. auto csvEsc = [](const std::string& s) { bool needs = s.find(',') != std::string::npos || s.find('"') != std::string::npos || s.find('\n') != std::string::npos; if (!needs) return s; std::string out = "\""; for (char c : s) { if (c == '"') out += "\"\""; else out += c; } out += "\""; return out; }; std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "export-project-items-csv: cannot write %s\n", outPath.c_str()); return 1; } out << "zone,index,id,name,quality,itemLevel,displayId,stackable\n"; int totalRows = 0; for (const auto& zoneDir : zones) { std::string zoneName = fs::path(zoneDir).filename().string(); std::string ipath = zoneDir + "/items.json"; nlohmann::json doc; try { std::ifstream in(ipath); in >> doc; } catch (...) { continue; } if (!doc.contains("items") || !doc["items"].is_array()) continue; const auto& items = doc["items"]; for (size_t k = 0; k < items.size(); ++k) { const auto& it = items[k]; out << csvEsc(zoneName) << "," << k << "," << it.value("id", 0u) << "," << csvEsc(it.value("name", std::string())) << "," << it.value("quality", 1u) << "," << it.value("itemLevel", 1u) << "," << it.value("displayId", 0u) << "," << it.value("stackable", 1u) << "\n"; totalRows++; } } out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" zones with items : %zu\n", zones.size()); std::printf(" rows : %d\n", totalRows); return 0; } else if (std::strcmp(argv[i], "--remove-item") == 0 && i + 2 < argc) { // Remove the item at given 0-based index from <zoneDir>/ // items.json. Mirrors --remove-creature/--remove-object/ // --remove-quest semantics — bounds-checked, file rewrites // on success, exit 1 on out-of-range. std::string zoneDir = argv[++i]; int idx = -1; try { idx = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "remove-item: index must be an integer\n"); return 1; } namespace fs = std::filesystem; std::string path = zoneDir + "/items.json"; if (!fs::exists(path)) { std::fprintf(stderr, "remove-item: %s has no items.json\n", zoneDir.c_str()); return 1; } nlohmann::json doc; try { std::ifstream in(path); in >> doc; } catch (...) { std::fprintf(stderr, "remove-item: %s is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { std::fprintf(stderr, "remove-item: %s has no 'items' array\n", path.c_str()); return 1; } auto& items = doc["items"]; if (idx < 0 || static_cast<size_t>(idx) >= items.size()) { std::fprintf(stderr, "remove-item: index %d out of range (have %zu)\n", idx, items.size()); return 1; } std::string removedName = items[idx].value("name", std::string("(unnamed)")); uint32_t removedId = items[idx].value("id", 0u); items.erase(items.begin() + idx); std::ofstream out(path); if (!out) { std::fprintf(stderr, "remove-item: failed to write %s\n", path.c_str()); return 1; } out << doc.dump(2); out.close(); std::printf("Removed item '%s' (id=%u) from %s (now %zu total)\n", removedName.c_str(), removedId, path.c_str(), items.size()); return 0; } else if (std::strcmp(argv[i], "--copy-zone-items") == 0 && i + 2 < argc) { // Copy items from one zone to another. Default mode // replaces the destination items.json wholesale; --merge // appends each source item to the existing destination // list, re-id'ing on collision so the destination's // existing IDs are preserved and the source's new // entries get fresh ones. std::string fromZone = argv[++i]; std::string toZone = argv[++i]; bool mergeMode = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--merge") == 0) { mergeMode = true; i++; } namespace fs = std::filesystem; std::string srcPath = fromZone + "/items.json"; if (!fs::exists(srcPath)) { std::fprintf(stderr, "copy-zone-items: %s has no items.json\n", fromZone.c_str()); return 1; } if (!fs::exists(toZone) || !fs::is_directory(toZone)) { std::fprintf(stderr, "copy-zone-items: dest %s is not a directory\n", toZone.c_str()); return 1; } nlohmann::json src; try { std::ifstream in(srcPath); in >> src; } catch (...) { std::fprintf(stderr, "copy-zone-items: %s is not valid JSON\n", srcPath.c_str()); return 1; } if (!src.contains("items") || !src["items"].is_array()) { std::fprintf(stderr, "copy-zone-items: %s has no 'items' array\n", srcPath.c_str()); return 1; } std::string dstPath = toZone + "/items.json"; nlohmann::json dst = nlohmann::json::object({{"items", nlohmann::json::array()}}); int copied = 0, reIded = 0; if (mergeMode && fs::exists(dstPath)) { try { std::ifstream in(dstPath); in >> dst; } catch (...) {} if (!dst.contains("items") || !dst["items"].is_array()) { dst["items"] = nlohmann::json::array(); } std::set<uint32_t> usedIds; for (const auto& it : dst["items"]) { if (it.contains("id") && it["id"].is_number_unsigned()) { usedIds.insert(it["id"].get<uint32_t>()); } } for (const auto& it : src["items"]) { nlohmann::json newItem = it; uint32_t srcId = it.value("id", 0u); if (srcId == 0 || usedIds.count(srcId)) { // Pick the next free id. uint32_t fresh = 1; while (usedIds.count(fresh)) ++fresh; newItem["id"] = fresh; usedIds.insert(fresh); if (srcId != 0) reIded++; } else { usedIds.insert(srcId); } dst["items"].push_back(newItem); copied++; } } else { // Replace mode: destination becomes a verbatim copy of // the source items array. dst["items"] = src["items"]; copied = static_cast<int>(src["items"].size()); } std::ofstream out(dstPath); if (!out) { std::fprintf(stderr, "copy-zone-items: failed to write %s\n", dstPath.c_str()); return 1; } out << dst.dump(2); out.close(); std::printf("Copied %d item(s) from %s to %s\n", copied, fromZone.c_str(), toZone.c_str()); std::printf(" mode : %s\n", mergeMode ? "merge (append + re-id)" : "replace"); std::printf(" dst total : %zu\n", dst["items"].size()); if (reIded > 0) { std::printf(" re-ided : %d (id collisions)\n", reIded); } return 0; } else if (std::strcmp(argv[i], "--clone-item") == 0 && i + 2 < argc) { // Duplicate the item at given 0-based index. Auto-assigns // the smallest unused positive id; optional <newName> // overrides the cloned name (without it the new entry // gets " (copy)" appended). std::string zoneDir = argv[++i]; int idx = -1; try { idx = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "clone-item: index must be an integer\n"); return 1; } std::string newName; if (i + 1 < argc && argv[i + 1][0] != '-') newName = argv[++i]; namespace fs = std::filesystem; std::string path = zoneDir + "/items.json"; if (!fs::exists(path)) { std::fprintf(stderr, "clone-item: %s has no items.json\n", zoneDir.c_str()); return 1; } nlohmann::json doc; try { std::ifstream in(path); in >> doc; } catch (...) { std::fprintf(stderr, "clone-item: %s is not valid JSON\n", path.c_str()); return 1; } if (!doc.contains("items") || !doc["items"].is_array()) { std::fprintf(stderr, "clone-item: %s has no 'items' array\n", path.c_str()); return 1; } auto& items = doc["items"]; if (idx < 0 || static_cast<size_t>(idx) >= items.size()) { std::fprintf(stderr, "clone-item: index %d out of range (have %zu)\n", idx, items.size()); return 1; } // Pick the next free id. std::set<uint32_t> used; for (const auto& it : items) { if (it.contains("id") && it["id"].is_number_unsigned()) { used.insert(it["id"].get<uint32_t>()); } } uint32_t newId = 1; while (used.count(newId)) ++newId; nlohmann::json clone = items[idx]; clone["id"] = newId; if (!newName.empty()) { clone["name"] = newName; } else { std::string oldName = clone.value("name", std::string("(unnamed)")); clone["name"] = oldName + " (copy)"; } items.push_back(clone); std::ofstream out(path); if (!out) { std::fprintf(stderr, "clone-item: failed to write %s\n", path.c_str()); return 1; } out << doc.dump(2); out.close(); std::printf("Cloned item idx %d to '%s' (id=%u) in %s (now %zu total)\n", idx, clone["name"].get<std::string>().c_str(), newId, path.c_str(), items.size()); return 0; } else if (std::strcmp(argv[i], "--scaffold-zone") == 0 && i + 1 < argc) { // Generate a minimal valid empty zone — useful for kickstarting // a new authoring session without needing to launch the GUI. std::string rawName = argv[++i]; int sx = 32, sy = 32; if (i + 2 < argc) { int parsedX = std::atoi(argv[i + 1]); int parsedY = std::atoi(argv[i + 2]); if (parsedX >= 0 && parsedX <= 63 && parsedY >= 0 && parsedY <= 63) { sx = parsedX; sy = parsedY; i += 2; } } // Slugify name to match unpackZone / server module rules. std::string slug; for (char c : rawName) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') { slug += c; } else if (c == ' ') { slug += '_'; } } if (slug.empty()) { std::fprintf(stderr, "--scaffold-zone: name '%s' has no valid characters\n", rawName.c_str()); return 1; } namespace fs = std::filesystem; std::string dir = "custom_zones/" + slug; if (fs::exists(dir)) { std::fprintf(stderr, "--scaffold-zone: directory already exists: %s\n", dir.c_str()); return 1; } fs::create_directories(dir); // Blank flat terrain at the requested tile. auto terrain = wowee::editor::TerrainEditor::createBlankTerrain( sx, sy, 100.0f, wowee::editor::Biome::Grassland); std::string base = dir + "/" + slug + "_" + std::to_string(sx) + "_" + std::to_string(sy); wowee::editor::WoweeTerrain::exportOpen(terrain, base, sx, sy); // Minimal zone.json wowee::editor::ZoneManifest manifest; manifest.mapName = slug; manifest.displayName = rawName; manifest.mapId = 9000; manifest.baseHeight = 100.0f; manifest.tiles.push_back({sx, sy}); manifest.save(dir + "/zone.json"); std::printf("Scaffolded zone: %s\n", dir.c_str()); std::printf(" tile : (%d, %d)\n", sx, sy); std::printf(" files : %s.wot, %s.whm, zone.json\n", slug.c_str(), slug.c_str()); std::printf(" next step: run editor without args, then File → Open Zone\n"); return 0; } else if (std::strcmp(argv[i], "--mvp-zone") == 0 && i + 1 < argc) { // Quick-start: scaffold + populate one of each content type // (1 creature, 1 object, 1 quest with objective + reward). // Useful for demos, screenshot bait, smoke tests of the // bake/validate pipeline. The zone goes from empty to // 'something to look at' in one command. std::string rawName = argv[++i]; int sx = 32, sy = 32; if (i + 2 < argc) { int parsedX = std::atoi(argv[i + 1]); int parsedY = std::atoi(argv[i + 2]); if (parsedX >= 0 && parsedX <= 63 && parsedY >= 0 && parsedY <= 63) { sx = parsedX; sy = parsedY; i += 2; } } // Reuse scaffold-zone's slug logic. std::string slug; for (char c : rawName) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') slug += c; else if (c == ' ') slug += '_'; } if (slug.empty()) { std::fprintf(stderr, "mvp-zone: name '%s' has no valid characters\n", rawName.c_str()); return 1; } namespace fs = std::filesystem; std::string dir = "custom_zones/" + slug; if (fs::exists(dir)) { std::fprintf(stderr, "mvp-zone: directory already exists: %s\n", dir.c_str()); return 1; } fs::create_directories(dir); // Scaffold terrain. auto terrain = wowee::editor::TerrainEditor::createBlankTerrain( sx, sy, 100.0f, wowee::editor::Biome::Grassland); std::string base = dir + "/" + slug + "_" + std::to_string(sx) + "_" + std::to_string(sy); wowee::editor::WoweeTerrain::exportOpen(terrain, base, sx, sy); // Manifest. wowee::editor::ZoneManifest zm; zm.mapName = slug; zm.displayName = rawName; zm.mapId = 9000; zm.baseHeight = 100.0f; zm.tiles.push_back({sx, sy}); zm.hasCreatures = true; zm.save(dir + "/zone.json"); // Position the demo content roughly centered in the tile. // Tile (32, 32) is the WoW map origin; tile centers are at // 533.33-yard intervals from there. float centerX = (32.0f - sy) * 533.33333f - 266.667f; float centerY = (32.0f - sx) * 533.33333f - 266.667f; float centerZ = 100.0f; // Demo creature. wowee::editor::NpcSpawner sp; wowee::editor::CreatureSpawn c; c.name = "Demo Wolf"; c.position = {centerX, centerY, centerZ}; c.level = 5; c.health = 100; c.minDamage = 5; c.maxDamage = 10; c.displayId = 11430; // any valid id; renderer falls back if absent sp.getSpawns().push_back(c); sp.saveToFile(dir + "/creatures.json"); // Demo object — a tree placement near the creature. wowee::editor::ObjectPlacer op; wowee::editor::PlacedObject po; po.type = wowee::editor::PlaceableType::M2; po.path = "World/Generic/Tree.m2"; po.position = {centerX + 5.0f, centerY, centerZ}; po.scale = 1.0f; op.getObjects().push_back(po); op.saveToFile(dir + "/objects.json"); // Demo quest with objective + XP reward. wowee::editor::QuestEditor qe; wowee::editor::Quest q; q.title = "Welcome to " + rawName; q.requiredLevel = 1; q.questGiverNpcId = c.id; // self-referential so refs check passes q.turnInNpcId = c.id; q.reward.xp = 100; wowee::editor::QuestObjective obj; obj.type = wowee::editor::QuestObjectiveType::KillCreature; obj.targetName = "Demo Wolf"; obj.targetCount = 1; obj.description = "Slay the Demo Wolf"; q.objectives.push_back(obj); qe.addQuest(q); qe.saveToFile(dir + "/quests.json"); std::printf("Created demo zone: %s\n", dir.c_str()); std::printf(" tile : (%d, %d)\n", sx, sy); std::printf(" contents : 1 creature, 1 object, 1 quest (with objective + reward)\n"); std::printf(" next : wowee_editor --info-zone-tree %s\n", dir.c_str()); return 0; } else if (std::strcmp(argv[i], "--add-tile") == 0 && i + 3 < argc) { // Extend an existing zone with another ADT tile. Zones can // span multiple tiles (e.g. a continent fragment), but // --scaffold-zone only creates one. This adds another: // wowee_editor --add-tile custom_zones/MyZone 29 30 // Generates a fresh blank-flat WHM/WOT pair at the new tile // and appends to the zone manifest's tiles list. std::string zoneDir = argv[++i]; int tx, ty; try { tx = std::stoi(argv[++i]); ty = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "add-tile: bad coordinates\n"); return 1; } float baseHeight = 100.0f; if (i + 1 < argc && argv[i + 1][0] != '-') { try { baseHeight = std::stof(argv[++i]); } catch (...) {} } if (tx < 0 || tx >= 64 || ty < 0 || ty >= 64) { std::fprintf(stderr, "add-tile: tile coord (%d, %d) out of WoW grid [0, 64)\n", tx, ty); return 1; } namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "add-tile: %s has no zone.json — not a zone dir\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "add-tile: failed to parse %s\n", manifestPath.c_str()); return 1; } // Reject duplicates so we don't silently overwrite an existing // tile's heightmap when the user makes a typo. for (const auto& [ex, ey] : zm.tiles) { if (ex == tx && ey == ty) { std::fprintf(stderr, "add-tile: tile (%d, %d) already in manifest\n", tx, ty); return 1; } } // Also bail if the file would clobber an existing one outside // the manifest (e.g. user hand-created tiles without updating // zone.json). Catches drift between disk and manifest. std::string base = zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); if (fs::exists(base + ".whm") || fs::exists(base + ".wot")) { std::fprintf(stderr, "add-tile: %s.{whm,wot} already exists on disk (manifest out of sync?)\n", base.c_str()); return 1; } // Generate the new heightmap. Reuses the same factory that // --scaffold-zone uses, so the output is consistent. auto terrain = wowee::editor::TerrainEditor::createBlankTerrain( tx, ty, baseHeight, wowee::editor::Biome::Grassland); wowee::editor::WoweeTerrain::exportOpen(terrain, base, tx, ty); // Append + save manifest. ZoneManifest::save rebuilds the // files block from the tiles list, so the new adt_tx_ty entry // appears automatically in zone.json. zm.tiles.push_back({tx, ty}); if (!zm.save(manifestPath)) { std::fprintf(stderr, "add-tile: failed to save %s\n", manifestPath.c_str()); return 1; } std::printf("Added tile (%d, %d) to %s\n", tx, ty, zoneDir.c_str()); std::printf(" files : %s.whm, %s.wot\n", (zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty)).c_str(), (zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty)).c_str()); std::printf(" tiles now : %zu total\n", zm.tiles.size()); return 0; } else if (std::strcmp(argv[i], "--remove-tile") == 0 && i + 3 < argc) { // Symmetric counterpart to --add-tile. Drops the entry from // ZoneManifest::tiles AND deletes the WHM/WOT/WOC files on // disk so the zone is left consistent (no orphan sidecars). std::string zoneDir = argv[++i]; int tx, ty; try { tx = std::stoi(argv[++i]); ty = std::stoi(argv[++i]); } catch (...) { std::fprintf(stderr, "remove-tile: bad coordinates\n"); return 1; } namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "remove-tile: %s has no zone.json — not a zone dir\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "remove-tile: failed to parse %s\n", manifestPath.c_str()); return 1; } auto it = std::find_if(zm.tiles.begin(), zm.tiles.end(), [&](const std::pair<int,int>& p) { return p.first == tx && p.second == ty; }); if (it == zm.tiles.end()) { std::fprintf(stderr, "remove-tile: tile (%d, %d) not in manifest\n", tx, ty); return 1; } // Don't strand a zone with zero tiles — server module gen and // pack-wcp both expect at least one. The user can --rename-zone // or rm -rf if they want the zone gone entirely. if (zm.tiles.size() == 1) { std::fprintf(stderr, "remove-tile: refusing to remove last tile (zone would be empty)\n"); return 1; } zm.tiles.erase(it); // Delete the slug-prefixed files for this tile. Use error_code // so we don't throw on missing files — partial removal from // earlier failures shouldn't block cleanup of what's left. std::string base = zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); int deleted = 0; std::error_code ec; for (const char* ext : {".whm", ".wot", ".woc"}) { if (fs::remove(base + ext, ec)) deleted++; } if (!zm.save(manifestPath)) { std::fprintf(stderr, "remove-tile: failed to save %s\n", manifestPath.c_str()); return 1; } std::printf("Removed tile (%d, %d) from %s\n", tx, ty, zoneDir.c_str()); std::printf(" deleted : %d file(s) (.whm/.wot/.woc)\n", deleted); std::printf(" tiles now : %zu remaining\n", zm.tiles.size()); return 0; } else if (std::strcmp(argv[i], "--list-tiles") == 0 && i + 1 < argc) { // Enumerate every tile in the zone manifest with on-disk // file presence — useful for spotting missing/orphan files // before pack-wcp would fail. std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "list-tiles: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "list-tiles: failed to parse %s\n", manifestPath.c_str()); return 1; } auto baseFor = [&](int tx, int ty) { return zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); }; if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["mapName"] = zm.mapName; j["count"] = zm.tiles.size(); nlohmann::json arr = nlohmann::json::array(); for (const auto& [tx, ty] : zm.tiles) { std::string b = baseFor(tx, ty); arr.push_back({ {"x", tx}, {"y", ty}, {"whm", fs::exists(b + ".whm")}, {"wot", fs::exists(b + ".wot")}, {"woc", fs::exists(b + ".woc")}, }); } j["tiles"] = arr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone: %s (%s, %zu tile(s))\n", zoneDir.c_str(), zm.mapName.c_str(), zm.tiles.size()); std::printf(" tx ty whm wot woc\n"); for (const auto& [tx, ty] : zm.tiles) { std::string b = baseFor(tx, ty); std::printf(" %3d %3d %s %s %s\n", tx, ty, fs::exists(b + ".whm") ? "y" : "-", fs::exists(b + ".wot") ? "y" : "-", fs::exists(b + ".woc") ? "y" : "-"); } return 0; } else if (std::strcmp(argv[i], "--copy-zone") == 0 && i + 2 < argc) { // Duplicate a zone — copy every file then rename slug-prefixed // ones (heightmap/terrain/collision sidecars carry the slug in // their filenames, e.g. "Sample_28_30.whm") so the new zone is // self-consistent. Useful for templating: scaffold once, then // copy-zone N times to create variants. std::string srcDir = argv[++i]; std::string rawName = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(srcDir) || !fs::is_directory(srcDir)) { std::fprintf(stderr, "copy-zone: source dir not found: %s\n", srcDir.c_str()); return 1; } if (!fs::exists(srcDir + "/zone.json")) { std::fprintf(stderr, "copy-zone: %s has no zone.json — not a zone dir\n", srcDir.c_str()); return 1; } // Slugify new name (matches scaffold-zone rules so the result // round-trips through unpackZone / server module gen). std::string newSlug; for (char c : rawName) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') { newSlug += c; } else if (c == ' ') { newSlug += '_'; } } if (newSlug.empty()) { std::fprintf(stderr, "copy-zone: name '%s' has no valid characters\n", rawName.c_str()); return 1; } std::string dstDir = "custom_zones/" + newSlug; if (fs::exists(dstDir)) { std::fprintf(stderr, "copy-zone: destination already exists: %s\n", dstDir.c_str()); return 1; } // Read the source slug from its zone.json so we know what // prefix to rewrite. Don't trust the directory name — a user // could have renamed the dir without touching the manifest. wowee::editor::ZoneManifest src; if (!src.load(srcDir + "/zone.json")) { std::fprintf(stderr, "copy-zone: failed to parse %s/zone.json\n", srcDir.c_str()); return 1; } std::string oldSlug = src.mapName; if (oldSlug == newSlug) { std::fprintf(stderr, "copy-zone: new slug matches old (%s); nothing to do\n", oldSlug.c_str()); return 1; } // Recursive copy preserves any subdirs (e.g. data/ for DBC sidecars). std::error_code ec; fs::create_directories(dstDir); fs::copy(srcDir, dstDir, fs::copy_options::recursive | fs::copy_options::copy_symlinks, ec); if (ec) { std::fprintf(stderr, "copy-zone: copy failed: %s\n", ec.message().c_str()); return 1; } // Rename slug-prefixed files inside the destination. Match // "<oldSlug>_..." or "<oldSlug>." so we catch both // "Sample_28_30.whm" and a hypothetical "Sample.wdt". int renamed = 0; for (const auto& entry : fs::recursive_directory_iterator(dstDir)) { if (!entry.is_regular_file()) continue; std::string fname = entry.path().filename().string(); bool match = (fname.size() > oldSlug.size() + 1 && fname.compare(0, oldSlug.size(), oldSlug) == 0 && (fname[oldSlug.size()] == '_' || fname[oldSlug.size()] == '.')); if (!match) continue; std::string newName = newSlug + fname.substr(oldSlug.size()); fs::rename(entry.path(), entry.path().parent_path() / newName, ec); if (!ec) renamed++; } // Rewrite the destination's zone.json with the new slug so its // files-block (rebuilt from mapName by save()) matches the // renamed files on disk. wowee::editor::ZoneManifest dst = src; dst.mapName = newSlug; dst.displayName = rawName; if (!dst.save(dstDir + "/zone.json")) { std::fprintf(stderr, "copy-zone: failed to write %s/zone.json\n", dstDir.c_str()); return 1; } std::printf("Copied %s -> %s\n", srcDir.c_str(), dstDir.c_str()); std::printf(" mapName : %s -> %s\n", oldSlug.c_str(), newSlug.c_str()); std::printf(" renamed : %d slug-prefixed file(s)\n", renamed); return 0; } else if (std::strcmp(argv[i], "--rename-zone") == 0 && i + 2 < argc) { // In-place rename — like --copy-zone but no copy. Useful when // the user wants to fix a typo or change a name without // doubling disk usage. Renames the directory itself too // (Old/ -> New/ under the same parent), so paths shift. std::string srcDir = argv[++i]; std::string rawName = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(srcDir) || !fs::is_directory(srcDir)) { std::fprintf(stderr, "rename-zone: source dir not found: %s\n", srcDir.c_str()); return 1; } if (!fs::exists(srcDir + "/zone.json")) { std::fprintf(stderr, "rename-zone: %s has no zone.json — not a zone dir\n", srcDir.c_str()); return 1; } std::string newSlug; for (char c : rawName) { if ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-') { newSlug += c; } else if (c == ' ') { newSlug += '_'; } } if (newSlug.empty()) { std::fprintf(stderr, "rename-zone: name '%s' has no valid characters\n", rawName.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(srcDir + "/zone.json")) { std::fprintf(stderr, "rename-zone: failed to parse %s/zone.json\n", srcDir.c_str()); return 1; } std::string oldSlug = zm.mapName; if (oldSlug == newSlug && rawName == zm.displayName) { std::fprintf(stderr, "rename-zone: nothing to do (slug=%s, displayName=%s already match)\n", oldSlug.c_str(), rawName.c_str()); return 1; } // Compute target directory: same parent, new slug name. If the // current directory name already matches the new slug, skip // the dir rename (only manifest + slug-prefixed files change). fs::path srcPath = fs::absolute(srcDir); fs::path parent = srcPath.parent_path(); fs::path dstPath = parent / newSlug; bool needDirRename = (srcPath.filename() != newSlug); if (needDirRename && fs::exists(dstPath)) { std::fprintf(stderr, "rename-zone: target dir already exists: %s\n", dstPath.string().c_str()); return 1; } // Rename slug-prefixed files inside the source dir BEFORE // moving the directory — fewer paths to fix up if anything // fails midway. fs::rename is atomic per-call. std::error_code ec; int renamed = 0; for (const auto& entry : fs::recursive_directory_iterator(srcDir)) { if (!entry.is_regular_file()) continue; std::string fname = entry.path().filename().string(); bool match = (oldSlug != newSlug && fname.size() > oldSlug.size() + 1 && fname.compare(0, oldSlug.size(), oldSlug) == 0 && (fname[oldSlug.size()] == '_' || fname[oldSlug.size()] == '.')); if (!match) continue; std::string newName = newSlug + fname.substr(oldSlug.size()); fs::rename(entry.path(), entry.path().parent_path() / newName, ec); if (!ec) renamed++; } // Update manifest and save BEFORE the dir rename so the file // exists at the path we're saving to. zm.mapName = newSlug; zm.displayName = rawName; if (!zm.save(srcDir + "/zone.json")) { std::fprintf(stderr, "rename-zone: failed to write zone.json\n"); return 1; } // Now move the directory itself. std::string finalDir = srcDir; if (needDirRename) { fs::rename(srcPath, dstPath, ec); if (ec) { std::fprintf(stderr, "rename-zone: dir rename failed (%s); manifest already updated\n", ec.message().c_str()); return 1; } finalDir = dstPath.string(); } std::printf("Renamed %s -> %s\n", srcDir.c_str(), finalDir.c_str()); std::printf(" mapName : %s -> %s\n", oldSlug.c_str(), newSlug.c_str()); std::printf(" renamed : %d slug-prefixed file(s)\n", renamed); return 0; } else if (std::strcmp(argv[i], "--remove-zone") == 0 && i + 1 < argc) { // Delete a zone directory entirely. Requires --confirm to // actually delete (defense against accidental destruction // and against shell glob mishaps). Without --confirm, // just lists what would be deleted. std::string zoneDir = argv[++i]; bool confirm = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--confirm") == 0) { confirm = true; i++; } namespace fs = std::filesystem; if (!fs::exists(zoneDir)) { std::fprintf(stderr, "remove-zone: %s does not exist\n", zoneDir.c_str()); return 1; } if (!fs::exists(zoneDir + "/zone.json")) { // Belt-and-suspenders: refuse to wipe anything that doesn't // look like a zone dir, even with --confirm. Catches typos // like '--remove-zone .' that would nuke the whole project. std::fprintf(stderr, "remove-zone: %s has no zone.json — refusing to delete (not a zone dir)\n", zoneDir.c_str()); return 1; } // Read manifest for the user-facing name. wowee::editor::ZoneManifest zm; std::string zoneName = zoneDir; if (zm.load(zoneDir + "/zone.json")) { zoneName = zm.displayName.empty() ? zm.mapName : zm.displayName; } // Walk for what would be removed (counts + total bytes). int fileCount = 0; uint64_t totalBytes = 0; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; fileCount++; totalBytes += e.file_size(ec); } if (!confirm) { std::printf("remove-zone: %s ('%s')\n", zoneDir.c_str(), zoneName.c_str()); std::printf(" would delete: %d file(s), %.1f KB\n", fileCount, totalBytes / 1024.0); std::printf(" re-run with --confirm to actually delete\n"); return 0; } // Confirmed — wipe it. uintmax_t removed = fs::remove_all(zoneDir, ec); if (ec) { std::fprintf(stderr, "remove-zone: failed to remove %s (%s)\n", zoneDir.c_str(), ec.message().c_str()); return 1; } std::printf("Removed %s ('%s')\n", zoneDir.c_str(), zoneName.c_str()); std::printf(" deleted: %ju filesystem entries, %.1f KB freed\n", static_cast<uintmax_t>(removed), totalBytes / 1024.0); return 0; } else if (std::strcmp(argv[i], "--clear-zone-content") == 0 && i + 1 < argc) { // Wipe content files (creatures.json / objects.json / // quests.json) from a zone while keeping terrain + manifest // intact. Useful for templating: --copy-zone gives you a // duplicate; --clear-zone-content turns it into an empty // shell ready for fresh population. // // Pass --creatures / --objects / --quests to wipe individually, // or --all to wipe everything. At least one selector is required. std::string zoneDir = argv[++i]; bool wipeCreatures = false, wipeObjects = false, wipeQuests = false; while (i + 1 < argc && argv[i + 1][0] == '-') { std::string opt = argv[i + 1]; if (opt == "--creatures") { wipeCreatures = true; ++i; } else if (opt == "--objects") { wipeObjects = true; ++i; } else if (opt == "--quests") { wipeQuests = true; ++i; } else if (opt == "--all") { wipeCreatures = wipeObjects = wipeQuests = true; ++i; } else break; // unknown flag — stop consuming, surface the error } if (!wipeCreatures && !wipeObjects && !wipeQuests) { std::fprintf(stderr, "clear-zone-content: pass --creatures / --objects / --quests / --all\n"); return 1; } namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "clear-zone-content: %s has no zone.json — not a zone dir\n", zoneDir.c_str()); return 1; } // Delete (not blank-write) so the next --info-* doesn't see // an empty file and report 'total: 0' as if data existed. // Missing files are the canonical 'no content' state. int deleted = 0; std::error_code ec; auto wipe = [&](const std::string& fname) { std::string p = zoneDir + "/" + fname; if (fs::exists(p) && fs::remove(p, ec)) { ++deleted; std::printf(" removed : %s\n", fname.c_str()); } else if (fs::exists(p)) { std::fprintf(stderr, " WARN: failed to remove %s (%s)\n", p.c_str(), ec.message().c_str()); } else { std::printf(" skipped : %s (already absent)\n", fname.c_str()); } }; std::printf("Cleared content from %s\n", zoneDir.c_str()); if (wipeCreatures) wipe("creatures.json"); if (wipeObjects) wipe("objects.json"); if (wipeQuests) wipe("quests.json"); // Also reset manifest.hasCreatures so server module gen // doesn't expect an NPC table that's no longer there. if (wipeCreatures) { wowee::editor::ZoneManifest zm; if (zm.load(zoneDir + "/zone.json")) { if (zm.hasCreatures) { zm.hasCreatures = false; zm.save(zoneDir + "/zone.json"); std::printf(" updated : zone.json hasCreatures = false\n"); } } } std::printf(" removed : %d file(s) total\n", deleted); return 0; } else if (std::strcmp(argv[i], "--strip-zone") == 0 && i + 1 < argc) { // Cleanup pass: remove the derived outputs (.glb/.obj/.stl/ // .html/.dot/.csv/ZONE.md/DEPS.md) leaving only source files // (zone.json + content JSONs + open binary formats). Useful // before --pack-wcp so the archive doesn't carry redundant // exports, or before committing to git so derived blobs // don't bloat history. // // Optional --dry-run flag previews what would be removed // without actually deleting anything. std::string zoneDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "strip-zone: %s has no zone.json\n", zoneDir.c_str()); return 1; } // Whitelist of derived extensions. PNG is special-cased: it // can be either a derived export (heightmap preview at zone // root) or a source sidecar (BLP→PNG inside data/). Only // strip PNGs at the top-level zone dir. auto isDerivedExt = [](const std::string& ext) { return ext == ".glb" || ext == ".obj" || ext == ".stl" || ext == ".html" || ext == ".dot" || ext == ".csv"; }; auto isDerivedFilename = [](const std::string& name) { return name == "ZONE.md" || name == "DEPS.md" || name == "quests.dot"; }; int removed = 0; uint64_t bytesFreed = 0; std::error_code ec; // Top-level only — do NOT recurse into data/ (those are // source sidecars). for (const auto& e : fs::directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); std::string name = e.path().filename().string(); bool kill = false; if (isDerivedExt(ext)) kill = true; if (isDerivedFilename(name)) kill = true; // PNG at zone root is derived (--export-png); PNGs inside // data/ are source. Top-level loop only sees the root // dir, so .png here is always derived. if (ext == ".png") kill = true; if (!kill) continue; uint64_t sz = e.file_size(ec); if (dryRun) { std::printf(" would remove: %s (%llu bytes)\n", name.c_str(), static_cast<unsigned long long>(sz)); } else { if (fs::remove(e.path(), ec)) { std::printf(" removed: %s (%llu bytes)\n", name.c_str(), static_cast<unsigned long long>(sz)); removed++; bytesFreed += sz; } else { std::fprintf(stderr, " WARN: failed to remove %s (%s)\n", name.c_str(), ec.message().c_str()); } } } std::printf("\nstrip-zone: %s%s\n", zoneDir.c_str(), dryRun ? " (dry-run)" : ""); if (dryRun) { std::printf(" pass --dry-run off to actually delete\n"); } else { std::printf(" removed : %d file(s)\n", removed); std::printf(" freed : %.1f KB\n", bytesFreed / 1024.0); } return 0; } else if (std::strcmp(argv[i], "--strip-project") == 0 && i + 1 < argc) { // Project-wide wrapper around --strip-zone. Walks every zone // in <projectDir>, removes derived outputs at each zone's // top level, and reports per-zone removed/freed counts plus // an aggregate. Honors --dry-run for safe previews. std::string projectDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "strip-project: %s is not a directory\n", projectDir.c_str()); return 1; } // Same derived-classifier as --strip-zone — keep in sync. auto isDerivedExt = [](const std::string& ext) { return ext == ".glb" || ext == ".obj" || ext == ".stl" || ext == ".html" || ext == ".dot" || ext == ".csv"; }; auto isDerivedFilename = [](const std::string& name) { return name == "ZONE.md" || name == "DEPS.md" || name == "quests.dot"; }; std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); struct ZRow { std::string name; int removed = 0; uint64_t freed = 0; }; std::vector<ZRow> rows; int totalRemoved = 0; uint64_t totalFreed = 0; int totalFailed = 0; for (const auto& zoneDir : zones) { ZRow r; r.name = fs::path(zoneDir).filename().string(); std::error_code ec; for (const auto& e : fs::directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); std::string name = e.path().filename().string(); bool kill = false; if (isDerivedExt(ext)) kill = true; if (isDerivedFilename(name)) kill = true; if (ext == ".png") kill = true; if (!kill) continue; uint64_t sz = e.file_size(ec); if (dryRun) { r.removed++; r.freed += sz; } else { if (fs::remove(e.path(), ec)) { r.removed++; r.freed += sz; } else { std::fprintf(stderr, " WARN: failed to remove %s/%s (%s)\n", r.name.c_str(), name.c_str(), ec.message().c_str()); totalFailed++; } } } totalRemoved += r.removed; totalFreed += r.freed; rows.push_back(r); } std::printf("strip-project: %s%s\n", projectDir.c_str(), dryRun ? " (dry-run)" : ""); std::printf(" zones : %zu\n", zones.size()); std::printf("\n zone removed freed\n"); for (const auto& r : rows) { std::printf(" %-26s %5d %9.1f KB\n", r.name.substr(0, 26).c_str(), r.removed, r.freed / 1024.0); } std::printf("\n totals%s : %d file(s), %.1f KB\n", dryRun ? " (would-remove)" : " ", totalRemoved, totalFreed / 1024.0); if (dryRun) { std::printf(" pass --dry-run off to actually delete\n"); } return totalFailed == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--gen-texture") == 0 && i + 2 < argc) { // Synthesize a placeholder PNG texture. Lets users add a // working texture to their project without an external // image editor — useful for prototyping new meshes, // filling out a zone before art is final, or generating // test fixtures. // // <colorHex|pattern>: // "RRGGBB" or "RGB" hex (case-insensitive) → solid color // "checker" → 32x32 black/white checkerboard // "grid" → black background with white 1-px grid every 16 std::string outPath = argv[++i]; std::string spec = argv[++i]; int W = 256, H = 256; if (i + 1 < argc && argv[i + 1][0] != '-') { try { W = std::stoi(argv[++i]); } catch (...) {} } if (i + 1 < argc && argv[i + 1][0] != '-') { try { H = std::stoi(argv[++i]); } catch (...) {} } if (W < 1 || H < 1 || W > 8192 || H > 8192) { std::fprintf(stderr, "gen-texture: invalid size %dx%d (must be 1..8192)\n", W, H); return 1; } std::vector<uint8_t> pixels(static_cast<size_t>(W) * H * 3, 0); std::string lower = spec; std::transform(lower.begin(), lower.end(), lower.begin(), [](unsigned char c) { return std::tolower(c); }); if (lower == "checker") { for (int y = 0; y < H; ++y) { for (int x = 0; x < W; ++x) { bool dark = ((x / 32) + (y / 32)) & 1; uint8_t v = dark ? 16 : 240; size_t i2 = (static_cast<size_t>(y) * W + x) * 3; pixels[i2 + 0] = v; pixels[i2 + 1] = v; pixels[i2 + 2] = v; } } } else if (lower == "grid") { for (int y = 0; y < H; ++y) { for (int x = 0; x < W; ++x) { bool line = (x % 16 == 0) || (y % 16 == 0); uint8_t v = line ? 240 : 32; size_t i2 = (static_cast<size_t>(y) * W + x) * 3; pixels[i2 + 0] = v; pixels[i2 + 1] = v; pixels[i2 + 2] = v; } } } else { // Hex color. Accept "RGB" (3 chars) or "RRGGBB" (6 chars), // optional leading '#'. std::string hex = lower; if (!hex.empty() && hex[0] == '#') hex.erase(0, 1); auto fromHex = [](char c) -> int { if (c >= '0' && c <= '9') return c - '0'; if (c >= 'a' && c <= 'f') return 10 + c - 'a'; return -1; }; uint8_t r = 0, g = 0, b = 0; if (hex.size() == 6) { int hi, lo; if ((hi = fromHex(hex[0])) < 0) goto bad_color; if ((lo = fromHex(hex[1])) < 0) goto bad_color; r = static_cast<uint8_t>((hi << 4) | lo); if ((hi = fromHex(hex[2])) < 0) goto bad_color; if ((lo = fromHex(hex[3])) < 0) goto bad_color; g = static_cast<uint8_t>((hi << 4) | lo); if ((hi = fromHex(hex[4])) < 0) goto bad_color; if ((lo = fromHex(hex[5])) < 0) goto bad_color; b = static_cast<uint8_t>((hi << 4) | lo); } else if (hex.size() == 3) { int v0, v1, v2; if ((v0 = fromHex(hex[0])) < 0) goto bad_color; if ((v1 = fromHex(hex[1])) < 0) goto bad_color; if ((v2 = fromHex(hex[2])) < 0) goto bad_color; r = static_cast<uint8_t>((v0 << 4) | v0); g = static_cast<uint8_t>((v1 << 4) | v1); b = static_cast<uint8_t>((v2 << 4) | v2); } else { goto bad_color; } for (int y = 0; y < H; ++y) { for (int x = 0; x < W; ++x) { size_t i2 = (static_cast<size_t>(y) * W + x) * 3; pixels[i2 + 0] = r; pixels[i2 + 1] = g; pixels[i2 + 2] = b; } } goto color_ok; bad_color: std::fprintf(stderr, "gen-texture: '%s' is not a valid hex color or 'checker'/'grid'\n", spec.c_str()); return 1; color_ok: ; } if (!stbi_write_png(outPath.c_str(), W, H, 3, pixels.data(), W * 3)) { std::fprintf(stderr, "gen-texture: stbi_write_png failed for %s\n", outPath.c_str()); return 1; } std::printf("Wrote %s\n", outPath.c_str()); std::printf(" size : %dx%d\n", W, H); std::printf(" spec : %s\n", spec.c_str()); return 0; } else if (std::strcmp(argv[i], "--add-texture-to-zone") == 0 && i + 2 < argc) { // Import an existing PNG into a zone directory. Useful // for the "I have an artist-painted texture, get it into // my project" workflow — complements --gen-texture // (procedural placeholder) and --convert-blp-png (legacy // BLP migration). // // Optional <renameTo> argument lets the user store the // PNG under a project-specific name (e.g., a generic // "stone.png" downloaded from a tileset becomes // "courtyard_floor.png" in the zone). // // Refuses to overwrite an existing destination unless the // source and destination are byte-identical (idempotent // re-runs are safe). std::string zoneDir = argv[++i]; std::string srcPng = argv[++i]; std::string renameTo; if (i + 1 < argc && argv[i + 1][0] != '-') renameTo = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir) || !fs::is_directory(zoneDir)) { std::fprintf(stderr, "add-texture-to-zone: %s is not a directory\n", zoneDir.c_str()); return 1; } if (!fs::exists(srcPng) || !fs::is_regular_file(srcPng)) { std::fprintf(stderr, "add-texture-to-zone: %s is not a file\n", srcPng.c_str()); return 1; } // Sanity-check: must end in .png (any case) so users // don't accidentally drop a .blp/.tga and get surprised // when nothing renders. std::string srcExt = fs::path(srcPng).extension().string(); std::transform(srcExt.begin(), srcExt.end(), srcExt.begin(), [](unsigned char c) { return std::tolower(c); }); if (srcExt != ".png") { std::fprintf(stderr, "add-texture-to-zone: %s is not a .png " "(use --convert-blp-png for .blp first)\n", srcPng.c_str()); return 1; } std::string destLeaf = renameTo.empty() ? fs::path(srcPng).filename().string() : renameTo; // If the rename arg lacks an extension, append .png so // common typos ("stone" -> "stone.png") just work. if (fs::path(destLeaf).extension().string().empty()) { destLeaf += ".png"; } std::string destPath = zoneDir + "/" + destLeaf; std::error_code ec; if (fs::exists(destPath)) { // Allow re-running if the bytes already match — makes // makefile-driven workflows idempotent. if (fs::file_size(srcPng, ec) == fs::file_size(destPath, ec)) { std::ifstream a(srcPng, std::ios::binary); std::ifstream b(destPath, std::ios::binary); std::stringstream sa, sb; sa << a.rdbuf(); sb << b.rdbuf(); if (sa.str() == sb.str()) { std::printf("Already present: %s (no-op)\n", destPath.c_str()); return 0; } } std::fprintf(stderr, "add-texture-to-zone: %s already exists with different " "content (delete it first if intentional)\n", destPath.c_str()); return 1; } fs::copy_file(srcPng, destPath, ec); if (ec) { std::fprintf(stderr, "add-texture-to-zone: copy failed (%s)\n", ec.message().c_str()); return 1; } uint64_t bytes = fs::file_size(destPath, ec); std::printf("Imported %s -> %s\n", srcPng.c_str(), destPath.c_str()); std::printf(" bytes : %llu\n", static_cast<unsigned long long>(bytes)); std::printf(" next : --add-texture-to-mesh <wom-base> %s\n", destPath.c_str()); return 0; } else if (std::strcmp(argv[i], "--repair-zone") == 0 && i + 1 < argc) { // Auto-fix the common manifest-vs-disk drift issues that // accumulate when a zone is hand-edited or partially copied: // - WHM/WOT files exist on disk but tile not in manifest // -> add to tiles // - manifest hasCreatures=false but creatures.json exists // and is non-empty -> set true // - manifest hasCreatures=true but no creatures.json or // empty -> clear false // // Tiles in manifest with NO disk files are NOT auto-removed // (they may indicate work-in-progress); they're warned about // so the user can decide. // // --dry-run flag previews changes without writing. std::string zoneDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "repair-zone: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "repair-zone: parse failed\n"); return 1; } int fixes = 0, warnings = 0; // Pass 1: scan disk for WHM files matching mapName_X_Y.whm // pattern. Match against manifest tiles. Anything on disk // but missing from manifest gets queued for addition. std::set<std::pair<int,int>> manifestTiles( zm.tiles.begin(), zm.tiles.end()); std::set<std::pair<int,int>> diskTiles; std::error_code ec; for (const auto& e : fs::directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string name = e.path().filename().string(); if (e.path().extension() != ".whm") continue; // Expect "<mapName>_TX_TY.whm". Parse out the two // integers between the last two underscores. std::string stem = name.substr(0, name.size() - 4); std::string prefix = zm.mapName + "_"; if (stem.size() <= prefix.size() || stem.substr(0, prefix.size()) != prefix) { continue; // doesn't match map slug } std::string coords = stem.substr(prefix.size()); auto under = coords.find('_'); if (under == std::string::npos) continue; try { int tx = std::stoi(coords.substr(0, under)); int ty = std::stoi(coords.substr(under + 1)); diskTiles.insert({tx, ty}); } catch (...) {} } // Tiles on disk but not in manifest -> add. std::vector<std::pair<int,int>> toAdd; for (const auto& d : diskTiles) { if (manifestTiles.count(d) == 0) toAdd.push_back(d); } for (const auto& [tx, ty] : toAdd) { std::printf(" %s tile (%d, %d) to manifest\n", dryRun ? "would add" : "added", tx, ty); if (!dryRun) zm.tiles.push_back({tx, ty}); fixes++; } // Tiles in manifest but no .whm on disk -> warn (not auto-removed). for (const auto& m : manifestTiles) { if (diskTiles.count(m) == 0) { std::printf(" WARN: tile (%d, %d) in manifest but no %s_%d_%d.whm on disk\n", m.first, m.second, zm.mapName.c_str(), m.first, m.second); warnings++; } } // hasCreatures flag sync. bool creaturesPresent = false; wowee::editor::NpcSpawner sp; if (sp.loadFromFile(zoneDir + "/creatures.json") && sp.spawnCount() > 0) { creaturesPresent = true; } if (zm.hasCreatures != creaturesPresent) { std::printf(" %s hasCreatures: %s -> %s\n", dryRun ? "would set" : "set", zm.hasCreatures ? "true" : "false", creaturesPresent ? "true" : "false"); if (!dryRun) zm.hasCreatures = creaturesPresent; fixes++; } if (!dryRun && fixes > 0) { if (!zm.save(manifestPath)) { std::fprintf(stderr, "repair-zone: failed to write %s\n", manifestPath.c_str()); return 1; } } std::printf("\nrepair-zone: %s%s\n", zoneDir.c_str(), dryRun ? " (dry-run)" : ""); std::printf(" fixes : %d\n", fixes); std::printf(" warnings : %d (manual decision needed)\n", warnings); if (dryRun && fixes > 0) { std::printf(" re-run without --dry-run to apply\n"); } return 0; } else if (std::strcmp(argv[i], "--repair-project") == 0 && i + 1 < argc) { // Project-wide wrapper around --repair-zone. Spawns the // binary per-zone so each zone's full repair report // streams through, then aggregates a final tally. Honors // --dry-run for safe previews. std::string projectDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "repair-project: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); std::string self = argv[0]; int totalFailed = 0; std::printf("repair-project: %s%s\n", projectDir.c_str(), dryRun ? " (dry-run)" : ""); std::printf(" zones : %zu\n", zones.size()); for (const auto& zoneDir : zones) { std::printf("\n--- %s ---\n", fs::path(zoneDir).filename().string().c_str()); // Flush so the section marker lands before the spawned // child's stdout — std::system inherits FDs but each // process has its own buffer. std::fflush(stdout); std::string cmd = "\"" + self + "\" --repair-zone \"" + zoneDir + "\"" + (dryRun ? " --dry-run" : ""); int rc = std::system(cmd.c_str()); if (rc != 0) totalFailed++; } std::printf("\n--- summary ---\n"); std::printf(" zones processed : %zu\n", zones.size()); std::printf(" failures : %d\n", totalFailed); if (dryRun) { std::printf(" re-run without --dry-run to apply changes\n"); } return totalFailed == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--gen-makefile") == 0 && i + 1 < argc) { // Generate a Makefile that rebuilds every derived output for // a zone. With this in place, designers can `make` to refresh // glb/obj/stl/html/csv/md from sources after editing // creatures.json or terrain — without remembering which // wowee_editor flag does what. The Makefile uses dependency // tracking so only stale outputs get rebuilt. std::string zoneDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "gen-makefile: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "gen-makefile: parse failed\n"); return 1; } if (outPath.empty()) outPath = zoneDir + "/Makefile"; std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "gen-makefile: cannot write %s\n", outPath.c_str()); return 1; } // Use a single absolute editor path so the Makefile works // from any cwd (running `make -C custom_zones/MyZone` etc.). std::error_code ec; std::string editorBin = fs::canonical("/proc/self/exe", ec).string(); if (ec || editorBin.empty()) editorBin = "wowee_editor"; // Per-tile WHM/WOT inputs feed the bake targets. Compose the // list once so all targets share the same dep set. std::string tileWhmDeps; for (const auto& [tx, ty] : zm.tiles) { tileWhmDeps += " " + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty) + ".whm"; } std::string slug = zm.mapName; out << "# Generated by wowee_editor --gen-makefile\n" "# Zone: " << slug << "\n" "# Run from this directory: `make` to rebuild all\n" "# derived outputs from sources, `make clean` to wipe.\n\n"; out << "EDITOR := " << editorBin << "\n"; out << "ZONE := .\n\n"; // Source dep aggregations for content-derived outputs. out << "CONTENT_SRCS := zone.json $(wildcard creatures.json) " "$(wildcard objects.json) $(wildcard quests.json)\n"; out << "TERRAIN_SRCS := zone.json" << tileWhmDeps << "\n\n"; out << ".PHONY: all clean glb obj stl html docs csv graph\n\n"; out << "all: glb obj stl html docs csv graph\n\n"; // Each target lists its dependencies so make can skip already- // up-to-date outputs. out << "glb: " << slug << ".glb\n" << slug << ".glb: $(TERRAIN_SRCS)\n" << "\t$(EDITOR) --bake-zone-glb $(ZONE)\n\n"; out << "obj: " << slug << ".obj\n" << slug << ".obj: $(TERRAIN_SRCS)\n" << "\t$(EDITOR) --bake-zone-obj $(ZONE)\n\n"; out << "stl: " << slug << ".stl\n" << slug << ".stl: $(TERRAIN_SRCS)\n" << "\t$(EDITOR) --bake-zone-stl $(ZONE)\n\n"; out << "html: " << slug << ".html\n" << slug << ".html: " << slug << ".glb\n" << "\t$(EDITOR) --export-zone-html $(ZONE)\n\n"; out << "docs: ZONE.md DEPS.md\n"; out << "ZONE.md: $(CONTENT_SRCS)\n" << "\t$(EDITOR) --export-zone-summary-md $(ZONE)\n"; out << "DEPS.md: zone.json $(wildcard objects.json) $(wildcard *.wob)\n" << "\t$(EDITOR) --export-zone-deps-md $(ZONE)\n\n"; // CSV + graph targets use '-' prefix so missing-content // (zone without creatures/quests) doesn't fail the whole // 'make all'. The editor prints the error to stderr; make // continues with the next target. out << "csv:\n" << "\t-$(EDITOR) --export-zone-csv $(ZONE)\n\n"; out << "graph:\n" << "\t-$(EDITOR) --export-quest-graph $(ZONE)\n\n"; out << "clean:\n" << "\t$(EDITOR) --strip-zone $(ZONE)\n\n"; out << "validate:\n" << "\t$(EDITOR) --validate-all $(ZONE)\n"; out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" zone : %s\n", slug.c_str()); std::printf(" tiles : %zu (terrain dep)\n", zm.tiles.size()); std::printf(" next : cd %s && make\n", zoneDir.c_str()); return 0; } else if (std::strcmp(argv[i], "--gen-project-makefile") == 0 && i + 1 < argc) { // Top-level Makefile that delegates to per-zone Makefiles. // Pairs with --gen-makefile (per-zone): one project-level // command rebuilds every zone's derived outputs in parallel. // // wowee_editor --gen-project-makefile custom_zones // make -C custom_zones -j$(nproc) # all zones in parallel std::string projectDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "gen-project-makefile: %s is not a directory\n", projectDir.c_str()); return 1; } if (outPath.empty()) outPath = projectDir + "/Makefile"; // Find zones (dirs with zone.json). std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().filename().string()); } std::sort(zones.begin(), zones.end()); if (zones.empty()) { std::fprintf(stderr, "gen-project-makefile: no zones found in %s\n", projectDir.c_str()); return 1; } std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "gen-project-makefile: cannot write %s\n", outPath.c_str()); return 1; } std::error_code ec; std::string editorBin = fs::canonical("/proc/self/exe", ec).string(); if (ec || editorBin.empty()) editorBin = "wowee_editor"; out << "# Generated by wowee_editor --gen-project-makefile\n" "# Project: " << projectDir << " (" << zones.size() << " zones)\n" "# Run from this dir: `make` to rebuild all zone outputs.\n" "# Pass -j to make for parallel zone builds across cores.\n\n"; out << "EDITOR := " << editorBin << "\n\n"; out << "ZONES := "; for (const auto& z : zones) out << z << " "; out << "\n\n"; out << ".PHONY: all clean validate index html stats $(addsuffix -bake,$(ZONES)) " "$(addsuffix -clean,$(ZONES)) $(addsuffix -validate,$(ZONES))\n\n"; // Aggregate phony targets: 'make' rebuilds all zones; 'make // ZONE-bake' targets just one. The per-zone Makefile must // exist (regenerate via --gen-makefile if not). out << "all: $(addsuffix -bake,$(ZONES)) index\n\n"; for (const auto& z : zones) { out << z << "-bake:\n"; out << "\t@if [ ! -f " << z << "/Makefile ]; then \\\n" << "\t $(EDITOR) --gen-makefile " << z << " >/dev/null; fi\n"; out << "\t$(MAKE) -C " << z << " all\n\n"; out << z << "-clean:\n"; out << "\t-$(EDITOR) --strip-zone " << z << "\n\n"; out << z << "-validate:\n"; out << "\t$(EDITOR) --validate-all " << z << "\n\n"; } // Top-level utility targets. out << "clean: $(addsuffix -clean,$(ZONES))\n\n"; out << "validate: $(addsuffix -validate,$(ZONES))\n\n"; out << "index:\n" << "\t$(EDITOR) --export-project-html .\n\n"; out << "stats:\n" << "\t$(EDITOR) --zone-stats .\n\n"; out << "tilemap:\n" << "\t$(EDITOR) --info-tilemap .\n"; out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" %zu zone(s) wired up\n", zones.size()); std::printf(" next: make -C %s -j$(nproc)\n", projectDir.c_str()); return 0; } else if (std::strcmp(argv[i], "--list-zones") == 0) { // Optional --json after the flag for machine-readable output. bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; auto zones = wowee::pipeline::CustomZoneDiscovery::scan({"custom_zones", "output"}); if (jsonOut) { nlohmann::json j = nlohmann::json::array(); for (const auto& z : zones) { nlohmann::json zoneObj; zoneObj["name"] = z.name; zoneObj["directory"] = z.directory; zoneObj["mapId"] = z.mapId; zoneObj["author"] = z.author; zoneObj["description"] = z.description; zoneObj["hasCreatures"] = z.hasCreatures; zoneObj["hasQuests"] = z.hasQuests; nlohmann::json tiles = nlohmann::json::array(); for (const auto& t : z.tiles) tiles.push_back({t.first, t.second}); zoneObj["tiles"] = tiles; j.push_back(std::move(zoneObj)); } std::printf("%s\n", j.dump(2).c_str()); return 0; } if (zones.empty()) { std::printf("No custom zones found in custom_zones/ or output/\n"); } else { std::printf("Custom zones found:\n"); for (const auto& z : zones) { std::printf(" %s — %s%s%s\n", z.name.c_str(), z.directory.c_str(), z.hasCreatures ? " [NPCs]" : "", z.hasQuests ? " [Quests]" : ""); } } return 0; } else if (std::strcmp(argv[i], "--zone-stats") == 0 && i + 1 < argc) { // Multi-zone aggregator. Walks <projectDir> for every dir // with a zone.json and emits totals across the project: // tile counts, creature/object/quest counts, on-disk byte // sizes per format. Useful for content-pack release notes // and capacity planning. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "zone-stats: %s is not a directory\n", projectDir.c_str()); return 1; } // Collect zone dirs. std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (fs::exists(entry.path() / "zone.json")) { zones.push_back(entry.path().string()); } } std::sort(zones.begin(), zones.end()); // Aggregate. struct Totals { int zoneCount = 0; int tileCount = 0; int creatures = 0, objects = 0, quests = 0; int hostileCreatures = 0; int chainedQuests = 0; uint64_t totalXp = 0; uint64_t whmBytes = 0, wotBytes = 0, wocBytes = 0; uint64_t womBytes = 0, wobBytes = 0; uint64_t pngBytes = 0, jsonBytes = 0; uint64_t otherBytes = 0; } T; T.zoneCount = static_cast<int>(zones.size()); // Per-zone breakdown for the table view (kept short — not // every field, just the high-signal ones). struct ZoneRow { std::string name; int tiles = 0, creatures = 0, objects = 0, quests = 0; uint64_t bytes = 0; }; std::vector<ZoneRow> rows; for (const auto& zoneDir : zones) { wowee::editor::ZoneManifest zm; if (!zm.load(zoneDir + "/zone.json")) continue; wowee::editor::NpcSpawner sp; sp.loadFromFile(zoneDir + "/creatures.json"); wowee::editor::ObjectPlacer op; op.loadFromFile(zoneDir + "/objects.json"); wowee::editor::QuestEditor qe; qe.loadFromFile(zoneDir + "/quests.json"); ZoneRow row; row.name = zm.mapName.empty() ? fs::path(zoneDir).filename().string() : zm.mapName; row.tiles = static_cast<int>(zm.tiles.size()); row.creatures = static_cast<int>(sp.spawnCount()); row.objects = static_cast<int>(op.getObjects().size()); row.quests = static_cast<int>(qe.questCount()); T.tileCount += row.tiles; T.creatures += row.creatures; T.objects += row.objects; T.quests += row.quests; for (const auto& s : sp.getSpawns()) { if (s.hostile) T.hostileCreatures++; } for (const auto& q : qe.getQuests()) { if (q.nextQuestId != 0) T.chainedQuests++; T.totalXp += q.reward.xp; } // Walk on-disk files in the zone (recursive — sub-dirs // like data/ may hold sidecars). Bucket by extension. std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; uint64_t sz = e.file_size(ec); if (ec) continue; row.bytes += sz; std::string ext = e.path().extension().string(); std::transform(ext.begin(), ext.end(), ext.begin(), [](unsigned char c) { return std::tolower(c); }); if (ext == ".whm") T.whmBytes += sz; else if (ext == ".wot") T.wotBytes += sz; else if (ext == ".woc") T.wocBytes += sz; else if (ext == ".wom") T.womBytes += sz; else if (ext == ".wob") T.wobBytes += sz; else if (ext == ".png") T.pngBytes += sz; else if (ext == ".json") T.jsonBytes += sz; else T.otherBytes += sz; } rows.push_back(row); } uint64_t totalBytes = T.whmBytes + T.wotBytes + T.wocBytes + T.womBytes + T.wobBytes + T.pngBytes + T.jsonBytes + T.otherBytes; if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["zoneCount"] = T.zoneCount; j["tileCount"] = T.tileCount; j["creatures"] = T.creatures; j["hostileCreatures"] = T.hostileCreatures; j["objects"] = T.objects; j["quests"] = T.quests; j["chainedQuests"] = T.chainedQuests; j["totalXp"] = T.totalXp; j["bytes"] = { {"whm", T.whmBytes}, {"wot", T.wotBytes}, {"woc", T.wocBytes}, {"wom", T.womBytes}, {"wob", T.wobBytes}, {"png", T.pngBytes}, {"json", T.jsonBytes}, {"other", T.otherBytes}, {"total", totalBytes} }; nlohmann::json zarr = nlohmann::json::array(); for (const auto& r : rows) { zarr.push_back({ {"name", r.name}, {"tiles", r.tiles}, {"creatures", r.creatures}, {"objects", r.objects}, {"quests", r.quests}, {"bytes", r.bytes} }); } j["zones"] = zarr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone stats: %s\n", projectDir.c_str()); std::printf(" zones : %d\n", T.zoneCount); std::printf(" tiles : %d total\n", T.tileCount); std::printf(" creatures : %d (%d hostile)\n", T.creatures, T.hostileCreatures); std::printf(" objects : %d\n", T.objects); std::printf(" quests : %d (%d chained, %llu total XP)\n", T.quests, T.chainedQuests, static_cast<unsigned long long>(T.totalXp)); constexpr double kKB = 1024.0; std::printf(" bytes : %.1f KB total\n", totalBytes / kKB); std::printf(" whm/wot : %.1f KB / %.1f KB\n", T.whmBytes / kKB, T.wotBytes / kKB); std::printf(" woc : %.1f KB\n", T.wocBytes / kKB); std::printf(" wom/wob : %.1f KB / %.1f KB\n", T.womBytes / kKB, T.wobBytes / kKB); std::printf(" png/json : %.1f KB / %.1f KB\n", T.pngBytes / kKB, T.jsonBytes / kKB); if (T.otherBytes > 0) { std::printf(" other : %.1f KB\n", T.otherBytes / kKB); } std::printf("\n per-zone breakdown:\n"); std::printf(" name tiles creat obj quest bytes\n"); for (const auto& r : rows) { std::printf(" %-18s %5d %5d %3d %5d %7.1f KB\n", r.name.substr(0, 18).c_str(), r.tiles, r.creatures, r.objects, r.quests, r.bytes / kKB); } return 0; } else if (std::strcmp(argv[i], "--info-tilemap") == 0 && i + 1 < argc) { // Visualize the WoW 64x64 ADT grid showing which tiles are // claimed by which zones across a project. Useful for // spotting tile-coord collisions before two zones try to // ship overlapping content, and for getting a 'where am I // working?' overview of a multi-zone project. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "info-tilemap: %s is not a directory\n", projectDir.c_str()); return 1; } // Map (tx, ty) -> vector<zone names> so collision overlaps // are visible. Walk every zone in the project. std::map<std::pair<int,int>, std::vector<std::string>> claims; std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; wowee::editor::ZoneManifest zm; if (!zm.load((entry.path() / "zone.json").string())) continue; std::string zname = zm.mapName.empty() ? entry.path().filename().string() : zm.mapName; zones.push_back(zname); for (const auto& [tx, ty] : zm.tiles) { if (tx >= 0 && tx < 64 && ty >= 0 && ty < 64) { claims[{tx, ty}].push_back(zname); } } } // Per-zone label glyph: first letter of the zone name, // uppercased so different zones get distinct chars in the // grid. Multi-letter overlap collapses to '*'. std::map<std::string, char> zoneGlyph; char nextGlyph = 'A'; for (const auto& z : zones) { if (zoneGlyph.count(z)) continue; if (!z.empty() && std::isalpha(static_cast<unsigned char>(z[0]))) { zoneGlyph[z] = static_cast<char>(std::toupper(static_cast<unsigned char>(z[0]))); } else { zoneGlyph[z] = nextGlyph++; if (nextGlyph > 'Z') nextGlyph = 'a'; } } int collisions = 0; for (const auto& [coord, owners] : claims) { if (owners.size() > 1) collisions++; } if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["zoneCount"] = zones.size(); j["claimedTiles"] = claims.size(); j["collisions"] = collisions; nlohmann::json claimsJson = nlohmann::json::array(); for (const auto& [coord, owners] : claims) { claimsJson.push_back({{"x", coord.first}, {"y", coord.second}, {"zones", owners}}); } j["claims"] = claimsJson; std::printf("%s\n", j.dump(2).c_str()); return collisions == 0 ? 0 : 1; } std::printf("Tilemap: %s\n", projectDir.c_str()); std::printf(" zones : %zu\n", zones.size()); std::printf(" tiles used : %zu\n", claims.size()); std::printf(" collisions : %d (multiple zones claiming same tile)\n", collisions); std::printf(" legend :"); for (const auto& [name, glyph] : zoneGlyph) { std::printf(" %c=%s", glyph, name.c_str()); } std::printf("\n\n"); // Render 64x64 grid. Print column header in groups of 10 // for readability. std::printf(" "); for (int x = 0; x < 64; ++x) { std::printf("%c", (x % 10 == 0) ? '0' + (x / 10) : ' '); } std::printf("\n"); std::printf(" "); for (int x = 0; x < 64; ++x) std::printf("%d", x % 10); std::printf("\n"); for (int y = 0; y < 64; ++y) { // Skip rows that have no tiles claimed — keeps the // output bounded for projects in one corner of the map. bool rowHasContent = false; for (int x = 0; x < 64 && !rowHasContent; ++x) { if (claims.count({x, y})) rowHasContent = true; } if (!rowHasContent) continue; std::printf(" y=%2d ", y); for (int x = 0; x < 64; ++x) { auto it = claims.find({x, y}); if (it == claims.end()) { std::printf("."); } else if (it->second.size() > 1) { std::printf("*"); // collision } else { std::printf("%c", zoneGlyph[it->second[0]]); } } std::printf("\n"); } if (collisions > 0) { std::printf("\n COLLISIONS:\n"); for (const auto& [coord, owners] : claims) { if (owners.size() < 2) continue; std::printf(" (%d, %d) claimed by:", coord.first, coord.second); for (const auto& o : owners) std::printf(" %s", o.c_str()); std::printf("\n"); } } return collisions == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--list-zone-deps") == 0 && i + 1 < argc) { // Enumerate every external model path a zone references — // both directly placed (objects.json) and indirectly via // doodad placements inside any WOB sitting next to the // zone manifest. Useful when packaging a content pack to // confirm every needed asset will ship. std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "list-zone-deps: %s has no zone.json\n", zoneDir.c_str()); return 1; } // Collect with usage counts so duplicates report '×N' instead // of cluttering the table. std::map<std::string, int> directM2; // m2 placements std::map<std::string, int> directWMO; // wmo placements std::map<std::string, int> doodadM2; // m2s referenced inside WOBs wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.type == wowee::editor::PlaceableType::M2) directM2[o.path]++; else if (o.type == wowee::editor::PlaceableType::WMO) directWMO[o.path]++; } } // Walk WOBs in the zone directory recursively and pull in // their doodad model paths. Sub-dirs caught too in case the // user organizes buildings under a buildings/ subfolder. int wobCount = 0; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); if (ext != ".wob") continue; wobCount++; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto bld = wowee::pipeline::WoweeBuildingLoader::load(base); for (const auto& d : bld.doodads) { if (d.modelPath.empty()) continue; doodadM2[d.modelPath]++; } } // For each direct WMO placement, also recurse into the WOB // sitting at that path (relative to the zone) so transitive // doodad deps surface — this matches the runtime's actual // load chain. for (const auto& [path, count] : directWMO) { // Strip extension since loader takes a base path. std::string base = path; if (base.size() >= 4 && base.substr(base.size() - 4) == ".wmo") base = base.substr(0, base.size() - 4); // Try relative-to-zone first, then absolute. std::string trial = zoneDir + "/" + base; if (!wowee::pipeline::WoweeBuildingLoader::exists(trial)) trial = base; if (!wowee::pipeline::WoweeBuildingLoader::exists(trial)) continue; auto bld = wowee::pipeline::WoweeBuildingLoader::load(trial); for (const auto& d : bld.doodads) { if (d.modelPath.empty()) continue; doodadM2[d.modelPath]++; } } size_t totalUnique = directM2.size() + directWMO.size() + doodadM2.size(); if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["wobCount"] = wobCount; j["totalUnique"] = totalUnique; auto toArr = [](const std::map<std::string, int>& m) { nlohmann::json a = nlohmann::json::array(); for (const auto& [path, count] : m) { a.push_back({{"path", path}, {"count", count}}); } return a; }; j["directM2"] = toArr(directM2); j["directWMO"] = toArr(directWMO); j["doodadM2"] = toArr(doodadM2); std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Zone deps: %s\n", zoneDir.c_str()); std::printf(" WOBs scanned : %d\n", wobCount); std::printf(" unique paths total : %zu\n", totalUnique); auto emit = [](const char* tag, const std::map<std::string, int>& m) { std::printf("\n %s (%zu unique):\n", tag, m.size()); if (m.empty()) { std::printf(" *none*\n"); return; } for (const auto& [path, count] : m) { if (count > 1) std::printf(" %s ×%d\n", path.c_str(), count); else std::printf(" %s\n", path.c_str()); } }; emit("Direct M2 placements", directM2); emit("Direct WMO placements", directWMO); emit("WOB doodad M2 refs", doodadM2); return 0; } else if (std::strcmp(argv[i], "--list-project-orphans") == 0 && i + 1 < argc) { // Inverse of --list-zone-deps. Walks every zone in // <projectDir>, collects the set of .wom/.wob files // sitting on disk and the set of paths actually // referenced by objects.json placements + WOB doodad // lists. Files in the first set but not the second are // orphans — candidates for removal before --pack-wcp so // the archive doesn't carry dead weight. // // Comparison is by basename (extension stripped) since // the reference paths sometimes include the extension and // sometimes don't. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "list-project-orphans: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // Project-wide reference set. Normalize by stripping // extension and any leading "./". auto normalize = [](std::string p) { while (p.size() >= 2 && p[0] == '.' && p[1] == '/') p.erase(0, 2); std::string ext = fs::path(p).extension().string(); if (ext == ".wom" || ext == ".wob" || ext == ".m2" || ext == ".wmo") { p = p.substr(0, p.size() - ext.size()); } return p; }; std::set<std::string> referencedBases; // normalized basenames for (const auto& zoneDir : zones) { wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.path.empty()) continue; // Reference can be relative to zone or just a // bare model name; record both forms for the // membership test. std::string norm = normalize(o.path); referencedBases.insert(norm); // Also try the leaf basename so unqualified // refs match. referencedBases.insert(fs::path(norm).filename().string()); } } std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; if (e.path().extension() != ".wob") continue; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto bld = wowee::pipeline::WoweeBuildingLoader::load(base); for (const auto& d : bld.doodads) { if (d.modelPath.empty()) continue; std::string norm = normalize(d.modelPath); referencedBases.insert(norm); referencedBases.insert(fs::path(norm).filename().string()); } } } // Now walk every zone again and flag orphan .wom/.wob files. struct Orphan { std::string zone, path; uint64_t bytes; }; std::vector<Orphan> orphans; uint64_t totalOrphanBytes = 0; for (const auto& zoneDir : zones) { std::string zoneName = fs::path(zoneDir).filename().string(); std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); if (ext != ".wom" && ext != ".wob") continue; std::string rel = fs::relative(e.path(), zoneDir, ec).string(); if (ec) rel = e.path().filename().string(); std::string normRel = rel.substr(0, rel.size() - ext.size()); std::string leaf = e.path().stem().string(); if (referencedBases.count(normRel) || referencedBases.count(leaf)) { continue; // referenced, not orphan } uint64_t sz = e.file_size(ec); if (ec) sz = 0; orphans.push_back({zoneName, rel, sz}); totalOrphanBytes += sz; } } std::sort(orphans.begin(), orphans.end(), [](const Orphan& a, const Orphan& b) { if (a.zone != b.zone) return a.zone < b.zone; return a.path < b.path; }); if (jsonOut) { nlohmann::json j; j["project"] = projectDir; j["referencedCount"] = referencedBases.size(); j["orphanCount"] = orphans.size(); j["orphanBytes"] = totalOrphanBytes; nlohmann::json arr = nlohmann::json::array(); for (const auto& o : orphans) { arr.push_back({{"zone", o.zone}, {"path", o.path}, {"bytes", o.bytes}}); } j["orphans"] = arr; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("Project orphans: %s\n", projectDir.c_str()); std::printf(" zones scanned : %zu\n", zones.size()); std::printf(" refs collected : %zu (normalized basenames)\n", referencedBases.size()); std::printf(" orphan .wom/.wob : %zu file(s), %.1f KB\n", orphans.size(), totalOrphanBytes / 1024.0); if (orphans.empty()) { std::printf("\n (no orphans — every model file is referenced)\n"); return 0; } std::printf("\n zone bytes path\n"); for (const auto& o : orphans) { std::printf(" %-20s %8llu %s\n", o.zone.substr(0, 20).c_str(), static_cast<unsigned long long>(o.bytes), o.path.c_str()); } return 0; } else if (std::strcmp(argv[i], "--remove-project-orphans") == 0 && i + 1 < argc) { // Destructive companion to --list-project-orphans. Reuses // the same reference-collection + orphan-detection logic // and then deletes the resulting files. --dry-run shows // what would be removed without touching anything. std::string projectDir = argv[++i]; bool dryRun = false; if (i + 1 < argc && std::strcmp(argv[i + 1], "--dry-run") == 0) { dryRun = true; i++; } namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "remove-project-orphans: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // Same normalize + reference collection as --list-project-orphans. // Keep both functions in sync if the matching rules evolve. auto normalize = [](std::string p) { while (p.size() >= 2 && p[0] == '.' && p[1] == '/') p.erase(0, 2); std::string ext = fs::path(p).extension().string(); if (ext == ".wom" || ext == ".wob" || ext == ".m2" || ext == ".wmo") { p = p.substr(0, p.size() - ext.size()); } return p; }; std::set<std::string> referencedBases; for (const auto& zoneDir : zones) { wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.path.empty()) continue; std::string norm = normalize(o.path); referencedBases.insert(norm); referencedBases.insert(fs::path(norm).filename().string()); } } std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; if (e.path().extension() != ".wob") continue; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto bld = wowee::pipeline::WoweeBuildingLoader::load(base); for (const auto& d : bld.doodads) { if (d.modelPath.empty()) continue; std::string norm = normalize(d.modelPath); referencedBases.insert(norm); referencedBases.insert(fs::path(norm).filename().string()); } } } int removed = 0, failed = 0; uint64_t freedBytes = 0; for (const auto& zoneDir : zones) { std::string zoneName = fs::path(zoneDir).filename().string(); std::error_code ec; std::vector<fs::path> toRemove; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file()) continue; std::string ext = e.path().extension().string(); if (ext != ".wom" && ext != ".wob") continue; std::string rel = fs::relative(e.path(), zoneDir, ec).string(); if (ec) rel = e.path().filename().string(); std::string normRel = rel.substr(0, rel.size() - ext.size()); std::string leaf = e.path().stem().string(); if (referencedBases.count(normRel) || referencedBases.count(leaf)) continue; toRemove.push_back(e.path()); } // Materialize the deletion list before removing so we // don't mutate the directory while iterating. for (const auto& p : toRemove) { uint64_t sz = fs::file_size(p, ec); if (ec) sz = 0; std::string rel = fs::relative(p, zoneDir, ec).string(); if (ec) rel = p.filename().string(); if (dryRun) { std::printf(" would remove: %s/%s (%llu bytes)\n", zoneName.c_str(), rel.c_str(), static_cast<unsigned long long>(sz)); removed++; freedBytes += sz; } else { if (fs::remove(p, ec)) { std::printf(" removed: %s/%s (%llu bytes)\n", zoneName.c_str(), rel.c_str(), static_cast<unsigned long long>(sz)); removed++; freedBytes += sz; } else { std::fprintf(stderr, " WARN: failed to remove %s (%s)\n", p.c_str(), ec.message().c_str()); failed++; } } } } std::printf("\nremove-project-orphans: %s%s\n", projectDir.c_str(), dryRun ? " (dry-run)" : ""); std::printf(" zones : %zu\n", zones.size()); std::printf(" refs : %zu (normalized basenames)\n", referencedBases.size()); std::printf(" %s : %d file(s)\n", dryRun ? "would remove" : "removed ", removed); std::printf(" freed : %.1f KB\n", freedBytes / 1024.0); if (failed > 0) { std::printf(" FAILED : %d (see stderr)\n", failed); } if (dryRun && removed > 0) { std::printf(" re-run without --dry-run to apply\n"); } return failed == 0 ? 0 : 1; } else if (std::strcmp(argv[i], "--export-zone-deps-md") == 0 && i + 1 < argc) { // Markdown counterpart to --list-zone-deps. Writes a sortable // GitHub-rendered table of every external model the zone // references plus on-disk presence (so PR reviewers see at a // glance whether dependencies are accounted for in the // accompanying asset bundle). std::string zoneDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "export-zone-deps-md: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; zm.load(zoneDir + "/zone.json"); if (outPath.empty()) outPath = zoneDir + "/DEPS.md"; // Same dep-collection pass as --list-zone-deps. std::map<std::string, int> directM2; std::map<std::string, int> directWMO; std::map<std::string, int> doodadM2; wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.type == wowee::editor::PlaceableType::M2) directM2[o.path]++; else if (o.type == wowee::editor::PlaceableType::WMO) directWMO[o.path]++; } } int wobCount = 0; std::error_code ec; for (const auto& e : fs::recursive_directory_iterator(zoneDir, ec)) { if (!e.is_regular_file() || e.path().extension() != ".wob") continue; wobCount++; std::string base = e.path().string(); if (base.size() >= 4) base = base.substr(0, base.size() - 4); auto bld = wowee::pipeline::WoweeBuildingLoader::load(base); for (const auto& d : bld.doodads) { if (!d.modelPath.empty()) doodadM2[d.modelPath]++; } } // Resolve dep on disk. Same heuristic as --check-zone-refs: // try both open + proprietary in conventional roots. auto stripExt = [](const std::string& p, const char* ext) { size_t n = std::strlen(ext); if (p.size() >= n) { std::string tail = p.substr(p.size() - n); std::string lower = tail; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (lower == ext) return p.substr(0, p.size() - n); } return p; }; auto resolveStatus = [&](const std::string& path, bool isWMO) { std::string base, openExt, propExt; if (isWMO) { base = stripExt(path, ".wmo"); openExt = ".wob"; propExt = ".wmo"; } else { base = stripExt(path, ".m2"); openExt = ".wom"; propExt = ".m2"; } std::vector<std::string> roots = { "", zoneDir + "/", "output/", "custom_zones/", "Data/" }; bool hasOpen = false, hasProp = false; for (const auto& root : roots) { if (fs::exists(root + base + openExt)) hasOpen = true; if (fs::exists(root + base + propExt)) hasProp = true; } if (hasOpen && hasProp) return "open + proprietary"; if (hasOpen) return "open only"; if (hasProp) return "proprietary only"; return "MISSING"; }; std::ofstream out(outPath); if (!out) { std::fprintf(stderr, "export-zone-deps-md: cannot write %s\n", outPath.c_str()); return 1; } out << "# Dependencies — " << (zm.displayName.empty() ? zm.mapName : zm.displayName) << "\n\n"; out << "*Auto-generated by `wowee_editor --export-zone-deps-md`. " "Status is best-effort — checks zone-local, output/, " "custom_zones/, Data/ roots in that order.*\n\n"; auto emitTable = [&](const char* heading, const std::map<std::string,int>& m, bool isWMO) { out << "## " << heading << " (" << m.size() << ")\n\n"; if (m.empty()) { out << "*None.*\n\n"; return; } out << "| Refs | Path | Status |\n"; out << "|---:|---|---|\n"; for (const auto& [path, count] : m) { out << "| " << count << " | `" << path << "` | " << resolveStatus(path, isWMO) << " |\n"; } out << "\n"; }; emitTable("Direct M2 placements", directM2, false); emitTable("Direct WMO placements", directWMO, true); emitTable("WOB doodad M2 refs", doodadM2, false); out << "## Summary\n\n"; out << "- Zone: `" << zm.mapName << "`\n"; out << "- WOBs scanned: " << wobCount << "\n"; out << "- Unique dependencies: " << directM2.size() + directWMO.size() + doodadM2.size() << "\n"; out.close(); std::printf("Wrote %s\n", outPath.c_str()); std::printf(" %zu M2 placements, %zu WMO placements, %zu WOB doodad refs\n", directM2.size(), directWMO.size(), doodadM2.size()); return 0; } else if (std::strcmp(argv[i], "--export-zone-spawn-png") == 0 && i + 1 < argc) { // Top-down PNG of spawn positions colored by type. Bound by // the zone's tile range so the image is properly framed. // Useful for design review (does the spawn distribution // match the intended encounter design?) and for showing // collaborators 'where are the mobs'. std::string zoneDir = argv[++i]; std::string outPath; if (i + 1 < argc && argv[i + 1][0] != '-') outPath = argv[++i]; namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "export-zone-spawn-png: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "export-zone-spawn-png: parse failed\n"); return 1; } if (zm.tiles.empty()) { std::fprintf(stderr, "export-zone-spawn-png: zone has no tiles\n"); return 1; } if (outPath.empty()) outPath = zoneDir + "/" + zm.mapName + "_spawns.png"; // Compute world-space bounds from manifest tiles. Same math // as --info-zone-extents. constexpr float kTileSize = 533.33333f; int tileMinX = 64, tileMaxX = -1; int tileMinY = 64, tileMaxY = -1; for (const auto& [tx, ty] : zm.tiles) { tileMinX = std::min(tileMinX, tx); tileMaxX = std::max(tileMaxX, tx); tileMinY = std::min(tileMinY, ty); tileMaxY = std::max(tileMaxY, ty); } float worldMinX = (32.0f - tileMaxY - 1) * kTileSize; float worldMaxX = (32.0f - tileMinY) * kTileSize; float worldMinY = (32.0f - tileMaxX - 1) * kTileSize; float worldMaxY = (32.0f - tileMinX) * kTileSize; // Image dimensions: 256px per tile so detail is visible // without inflating per-pixel cost. int tilesX = tileMaxY - tileMinY + 1; // tile.y maps to world.x int tilesY = tileMaxX - tileMinX + 1; const int kPxPerTile = 256; int imgW = tilesX * kPxPerTile; int imgH = tilesY * kPxPerTile; // Cap output size — 16-tile-wide projects shouldn't exceed // 4096 wide. Scale down if needed. int maxDim = std::max(imgW, imgH); if (maxDim > 4096) { int divisor = (maxDim + 4095) / 4096; imgW = std::max(64, imgW / divisor); imgH = std::max(64, imgH / divisor); } std::vector<uint8_t> img(imgW * imgH * 3, 32); // dark grey background // Tile-grid lines so the boundary is visible. for (int t = 1; t < tilesX; ++t) { int x = (t * imgW) / tilesX; if (x >= 0 && x < imgW) { for (int y = 0; y < imgH; ++y) { size_t off = (y * imgW + x) * 3; img[off] = img[off+1] = img[off+2] = 64; } } } for (int t = 1; t < tilesY; ++t) { int y = (t * imgH) / tilesY; if (y >= 0 && y < imgH) { for (int x = 0; x < imgW; ++x) { size_t off = (y * imgW + x) * 3; img[off] = img[off+1] = img[off+2] = 64; } } } // Plot spawn points. Map world (X, Y) to image (px, py): // px = (worldMaxX - X) / (worldMaxX - worldMinX) * imgW // py = (worldMaxY - Y) / (worldMaxY - worldMinY) * imgH // since +X world is north (up) and +Y world is west (left) // in WoW coords. float wRangeX = worldMaxX - worldMinX; float wRangeY = worldMaxY - worldMinY; auto plotPoint = [&](float wx, float wy, uint8_t r, uint8_t g, uint8_t b) { if (wRangeX <= 0 || wRangeY <= 0) return; int px = static_cast<int>((worldMaxX - wx) / wRangeX * imgW); int py = static_cast<int>((worldMaxY - wy) / wRangeY * imgH); // 3×3 dot. for (int dy = -1; dy <= 1; ++dy) { for (int dx = -1; dx <= 1; ++dx) { int x = px + dx, y = py + dy; if (x < 0 || x >= imgW || y < 0 || y >= imgH) continue; size_t off = (y * imgW + x) * 3; img[off] = r; img[off+1] = g; img[off+2] = b; } } }; // Creatures = red. wowee::editor::NpcSpawner sp; int creaturesPlotted = 0; if (sp.loadFromFile(zoneDir + "/creatures.json")) { for (const auto& s : sp.getSpawns()) { plotPoint(s.position.x, s.position.y, 220, 60, 60); creaturesPlotted++; } } // Objects = green (M2) / blue (WMO). wowee::editor::ObjectPlacer op; int objectsPlotted = 0; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.type == wowee::editor::PlaceableType::M2) { plotPoint(o.position.x, o.position.y, 60, 200, 60); } else { plotPoint(o.position.x, o.position.y, 60, 120, 220); } objectsPlotted++; } } if (!stbi_write_png(outPath.c_str(), imgW, imgH, 3, img.data(), imgW * 3)) { std::fprintf(stderr, "export-zone-spawn-png: stbi_write_png failed\n"); return 1; } std::printf("Wrote %s\n", outPath.c_str()); std::printf(" %dx%d px, tile grid %dx%d, %d creatures (red), %d objects (green/blue)\n", imgW, imgH, tilesX, tilesY, creaturesPlotted, objectsPlotted); return 0; } else if (std::strcmp(argv[i], "--check-zone-refs") == 0 && i + 1 < argc) { // Cross-reference checker: every model path in objects.json // must resolve as either an open WOM/WOB sidecar or a // proprietary M2/WMO; every quest's giver/turnIn NPC ID must // appear in creatures.json (when the zone has creatures). // Catches dangling references that --validate doesn't, since // --validate only checks open-format file presence. std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "check-zone-refs: %s has no zone.json\n", zoneDir.c_str()); return 1; } // Try to find a model on disk in any of the conventional // locations (zone-local, output/, custom_zones/, Data/). // Strips extension and tries each open + proprietary variant. auto stripExt = [](const std::string& p, const char* ext) { size_t n = std::strlen(ext); if (p.size() >= n) { std::string tail = p.substr(p.size() - n); std::string lower = tail; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (lower == ext) return p.substr(0, p.size() - n); } return p; }; auto modelExists = [&](const std::string& path, bool isWMO) { std::string base; std::vector<std::string> exts; if (isWMO) { base = stripExt(path, ".wmo"); exts = {".wob", ".wmo"}; } else { base = stripExt(path, ".m2"); exts = {".wom", ".m2"}; } std::vector<std::string> roots = { "", zoneDir + "/", "output/", "custom_zones/", "Data/" }; for (const auto& root : roots) { for (const auto& ext : exts) { if (fs::exists(root + base + ext)) return true; // Case-fold fallback for case-sensitive filesystems // (designers usually type Mixed Case but Linux // stores asset paths lowercase after extraction). std::string lower = base + ext; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (fs::exists(root + lower)) return true; } } return false; }; std::vector<std::string> errors; // Object placements -> models on disk wowee::editor::ObjectPlacer op; int objectsChecked = 0, objectsMissing = 0; if (op.loadFromFile(zoneDir + "/objects.json")) { for (size_t k = 0; k < op.getObjects().size(); ++k) { const auto& o = op.getObjects()[k]; objectsChecked++; bool isWMO = (o.type == wowee::editor::PlaceableType::WMO); if (!modelExists(o.path, isWMO)) { objectsMissing++; if (errors.size() < 30) { errors.push_back("object[" + std::to_string(k) + "] missing: " + o.path); } } } } // Quest NPCs -> creatures.json IDs (only when creatures exist; // otherwise NPC IDs may legitimately reference upstream content // outside the zone). wowee::editor::NpcSpawner sp; wowee::editor::QuestEditor qe; int questsChecked = 0, questsMissing = 0; bool hasCreatures = sp.loadFromFile(zoneDir + "/creatures.json"); std::unordered_set<uint32_t> creatureIds; if (hasCreatures) { for (const auto& s : sp.getSpawns()) creatureIds.insert(s.id); } if (qe.loadFromFile(zoneDir + "/quests.json") && hasCreatures) { for (size_t k = 0; k < qe.getQuests().size(); ++k) { const auto& q = qe.getQuests()[k]; questsChecked++; bool localGiver = (q.questGiverNpcId != 0 && creatureIds.count(q.questGiverNpcId) == 0); bool localTurn = (q.turnInNpcId != 0 && q.turnInNpcId != q.questGiverNpcId && creatureIds.count(q.turnInNpcId) == 0); // Only flag IDs that look 'small' (likely zone-local). // Production uses 6-digit IDs that reference upstream // content; designers wire those in deliberately. if (localGiver && q.questGiverNpcId < 100000) { questsMissing++; if (errors.size() < 30) { errors.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' giver " + std::to_string(q.questGiverNpcId) + " not in creatures.json"); } } if (localTurn && q.turnInNpcId < 100000) { questsMissing++; if (errors.size() < 30) { errors.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' turn-in " + std::to_string(q.turnInNpcId) + " not in creatures.json"); } } } } int totalErrors = objectsMissing + questsMissing; if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["objectsChecked"] = objectsChecked; j["objectsMissing"] = objectsMissing; j["questsChecked"] = questsChecked; j["questsMissing"] = questsMissing; j["errors"] = errors; j["passed"] = (totalErrors == 0); std::printf("%s\n", j.dump(2).c_str()); return totalErrors == 0 ? 0 : 1; } std::printf("Zone refs: %s\n", zoneDir.c_str()); std::printf(" objects checked : %d (%d missing)\n", objectsChecked, objectsMissing); std::printf(" quests checked : %d (%d bad NPC refs)\n", questsChecked, questsMissing); if (totalErrors == 0) { std::printf(" PASSED\n"); return 0; } std::printf(" FAILED — %d issue(s):\n", totalErrors); for (const auto& e : errors) std::printf(" - %s\n", e.c_str()); return 1; } else if (std::strcmp(argv[i], "--check-zone-content") == 0 && i + 1 < argc) { // Sanity-check creature/object/quest fields for plausible // values. --check-zone-refs catches dangling references; // this catches data-quality issues like creatures with 0 HP, // objects with negative scale, quests with no objectives. // Both are needed — a quest can have valid NPC IDs (refs OK) // AND no objectives (content broken). std::string zoneDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(zoneDir + "/zone.json")) { std::fprintf(stderr, "check-zone-content: %s has no zone.json\n", zoneDir.c_str()); return 1; } std::vector<std::string> warnings; int creatureWarn = 0, objectWarn = 0, questWarn = 0; // Creatures wowee::editor::NpcSpawner sp; if (sp.loadFromFile(zoneDir + "/creatures.json")) { for (size_t k = 0; k < sp.spawnCount(); ++k) { const auto& s = sp.getSpawns()[k]; if (s.name.empty()) { warnings.push_back("creature[" + std::to_string(k) + "] has empty name"); creatureWarn++; } if (s.health == 0) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has 0 health"); creatureWarn++; } if (s.level == 0) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has level 0"); creatureWarn++; } if (s.minDamage > s.maxDamage) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has minDamage > maxDamage"); creatureWarn++; } if (s.scale <= 0.0f || !std::isfinite(s.scale)) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has non-positive or non-finite scale"); creatureWarn++; } if (s.displayId == 0) { warnings.push_back("creature[" + std::to_string(k) + "] '" + s.name + "' has displayId=0 (will render invisibly)"); creatureWarn++; } } } // Objects wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (size_t k = 0; k < op.getObjects().size(); ++k) { const auto& o = op.getObjects()[k]; if (o.path.empty()) { warnings.push_back("object[" + std::to_string(k) + "] has empty path"); objectWarn++; } if (o.scale <= 0.0f || !std::isfinite(o.scale)) { warnings.push_back("object[" + std::to_string(k) + "] has non-positive or non-finite scale"); objectWarn++; } if (!std::isfinite(o.position.x) || !std::isfinite(o.position.y) || !std::isfinite(o.position.z)) { warnings.push_back("object[" + std::to_string(k) + "] has non-finite position"); objectWarn++; } } } // Quests wowee::editor::QuestEditor qe; if (qe.loadFromFile(zoneDir + "/quests.json")) { for (size_t k = 0; k < qe.questCount(); ++k) { const auto& q = qe.getQuests()[k]; if (q.title.empty()) { warnings.push_back("quest[" + std::to_string(k) + "] has empty title"); questWarn++; } if (q.objectives.empty()) { warnings.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' has no objectives (uncompletable)"); questWarn++; } if (q.reward.xp == 0 && q.reward.itemRewards.empty() && q.reward.gold == 0 && q.reward.silver == 0 && q.reward.copper == 0) { warnings.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' has no reward at all"); questWarn++; } if (q.requiredLevel == 0) { warnings.push_back("quest[" + std::to_string(k) + "] '" + q.title + "' has requiredLevel=0"); questWarn++; } } } int total = creatureWarn + objectWarn + questWarn; if (jsonOut) { nlohmann::json j; j["zone"] = zoneDir; j["creatureWarnings"] = creatureWarn; j["objectWarnings"] = objectWarn; j["questWarnings"] = questWarn; j["totalWarnings"] = total; j["warnings"] = warnings; j["passed"] = (total == 0); std::printf("%s\n", j.dump(2).c_str()); return total == 0 ? 0 : 1; } std::printf("Zone content: %s\n", zoneDir.c_str()); std::printf(" creature warnings: %d\n", creatureWarn); std::printf(" object warnings : %d\n", objectWarn); std::printf(" quest warnings : %d\n", questWarn); if (total == 0) { std::printf(" PASSED\n"); return 0; } std::printf(" FAILED — %d total warning(s):\n", total); for (const auto& w : warnings) std::printf(" - %s\n", w.c_str()); return 1; } else if (std::strcmp(argv[i], "--check-project-content") == 0 && i + 1 < argc) { // Project-level content sanity check. Walks every zone and // runs the same per-zone checks that --check-zone-content // does, aggregating warnings per zone. Exit 1 if any zone // has any warning. Designed for CI gates before --pack-wcp. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "check-project-content: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // Same per-zone walks as --check-zone-content. Reuse the // logic by counting issues directly here (cheaper than // shelling out to a sub-invocation per zone). struct ZoneRow { std::string name; int creatureWarn, objectWarn, questWarn; }; std::vector<ZoneRow> rows; int projectFailedZones = 0; for (const auto& zoneDir : zones) { ZoneRow row{fs::path(zoneDir).filename().string(), 0, 0, 0}; wowee::editor::NpcSpawner sp; if (sp.loadFromFile(zoneDir + "/creatures.json")) { for (const auto& s : sp.getSpawns()) { if (s.name.empty()) row.creatureWarn++; if (s.health == 0) row.creatureWarn++; if (s.level == 0) row.creatureWarn++; if (s.minDamage > s.maxDamage) row.creatureWarn++; if (s.scale <= 0.0f || !std::isfinite(s.scale)) row.creatureWarn++; if (s.displayId == 0) row.creatureWarn++; } } wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { if (o.path.empty()) row.objectWarn++; if (o.scale <= 0.0f || !std::isfinite(o.scale)) row.objectWarn++; if (!std::isfinite(o.position.x) || !std::isfinite(o.position.y) || !std::isfinite(o.position.z)) row.objectWarn++; } } wowee::editor::QuestEditor qe; if (qe.loadFromFile(zoneDir + "/quests.json")) { for (const auto& q : qe.getQuests()) { if (q.title.empty()) row.questWarn++; if (q.objectives.empty()) row.questWarn++; if (q.reward.xp == 0 && q.reward.itemRewards.empty() && q.reward.gold == 0 && q.reward.silver == 0 && q.reward.copper == 0) row.questWarn++; if (q.requiredLevel == 0) row.questWarn++; } } int rowTotal = row.creatureWarn + row.objectWarn + row.questWarn; if (rowTotal > 0) projectFailedZones++; rows.push_back(row); } int allPassed = (projectFailedZones == 0); int totalWarn = 0; for (const auto& r : rows) totalWarn += r.creatureWarn + r.objectWarn + r.questWarn; if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["totalZones"] = zones.size(); j["failedZones"] = projectFailedZones; j["totalWarnings"] = totalWarn; j["passed"] = bool(allPassed); nlohmann::json arr = nlohmann::json::array(); for (const auto& r : rows) { arr.push_back({{"zone", r.name}, {"creatureWarn", r.creatureWarn}, {"objectWarn", r.objectWarn}, {"questWarn", r.questWarn}}); } j["zones"] = arr; std::printf("%s\n", j.dump(2).c_str()); return allPassed ? 0 : 1; } std::printf("check-project-content: %s\n", projectDir.c_str()); std::printf(" zones : %zu (%d failed)\n", zones.size(), projectFailedZones); std::printf(" total warns : %d\n", totalWarn); std::printf("\n zone creat object quest status\n"); for (const auto& r : rows) { int rowTotal = r.creatureWarn + r.objectWarn + r.questWarn; std::printf(" %-26s %5d %5d %5d %s\n", r.name.substr(0, 26).c_str(), r.creatureWarn, r.objectWarn, r.questWarn, rowTotal == 0 ? "PASS" : "FAIL"); } if (allPassed) { std::printf("\n ALL ZONES PASSED\n"); return 0; } std::printf("\n %d zone(s) have content warnings\n", projectFailedZones); return 1; } else if (std::strcmp(argv[i], "--check-project-refs") == 0 && i + 1 < argc) { // Project-level cross-reference checker. Walks every zone // and runs the same model-path / NPC-id checks as // --check-zone-refs. Aggregates per zone with file-level // breakdown. Exit 1 if any zone has dangling refs. std::string projectDir = argv[++i]; bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "check-project-refs: %s is not a directory\n", projectDir.c_str()); return 1; } std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (!fs::exists(entry.path() / "zone.json")) continue; zones.push_back(entry.path().string()); } std::sort(zones.begin(), zones.end()); // Same model-resolve logic as --check-zone-refs, applied // per zone with the appropriate root list. auto stripExt = [](const std::string& p, const char* ext) { size_t n = std::strlen(ext); if (p.size() >= n) { std::string tail = p.substr(p.size() - n); std::string lower = tail; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (lower == ext) return p.substr(0, p.size() - n); } return p; }; struct ZoneRow { std::string name; int objCheck, objMiss, qCheck, qMiss; }; std::vector<ZoneRow> rows; int projectFailedZones = 0; for (const auto& zoneDir : zones) { ZoneRow row{fs::path(zoneDir).filename().string(), 0, 0, 0, 0}; auto modelExists = [&](const std::string& path, bool isWMO) { std::string base; std::vector<std::string> exts; if (isWMO) { base = stripExt(path, ".wmo"); exts = {".wob", ".wmo"}; } else { base = stripExt(path, ".m2"); exts = {".wom", ".m2"}; } std::vector<std::string> roots = { "", zoneDir + "/", "output/", "custom_zones/", "Data/" }; for (const auto& root : roots) { for (const auto& ext : exts) { if (fs::exists(root + base + ext)) return true; std::string lower = base + ext; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (fs::exists(root + lower)) return true; } } return false; }; wowee::editor::ObjectPlacer op; if (op.loadFromFile(zoneDir + "/objects.json")) { for (const auto& o : op.getObjects()) { row.objCheck++; bool isWMO = (o.type == wowee::editor::PlaceableType::WMO); if (!modelExists(o.path, isWMO)) row.objMiss++; } } wowee::editor::NpcSpawner sp; wowee::editor::QuestEditor qe; bool hasCreatures = sp.loadFromFile(zoneDir + "/creatures.json"); std::unordered_set<uint32_t> creatureIds; if (hasCreatures) { for (const auto& s : sp.getSpawns()) creatureIds.insert(s.id); } if (qe.loadFromFile(zoneDir + "/quests.json") && hasCreatures) { for (const auto& q : qe.getQuests()) { row.qCheck++; bool localGiver = (q.questGiverNpcId != 0 && q.questGiverNpcId < 100000 && creatureIds.count(q.questGiverNpcId) == 0); bool localTurn = (q.turnInNpcId != 0 && q.turnInNpcId < 100000 && q.turnInNpcId != q.questGiverNpcId && creatureIds.count(q.turnInNpcId) == 0); if (localGiver) row.qMiss++; if (localTurn) row.qMiss++; } } if (row.objMiss + row.qMiss > 0) projectFailedZones++; rows.push_back(row); } int allPassed = (projectFailedZones == 0); int totalMiss = 0; for (const auto& r : rows) totalMiss += r.objMiss + r.qMiss; if (jsonOut) { nlohmann::json j; j["projectDir"] = projectDir; j["totalZones"] = zones.size(); j["failedZones"] = projectFailedZones; j["totalMissing"] = totalMiss; j["passed"] = bool(allPassed); nlohmann::json arr = nlohmann::json::array(); for (const auto& r : rows) { arr.push_back({{"zone", r.name}, {"objectsChecked", r.objCheck}, {"objectsMissing", r.objMiss}, {"questsChecked", r.qCheck}, {"questsMissing", r.qMiss}}); } j["zones"] = arr; std::printf("%s\n", j.dump(2).c_str()); return allPassed ? 0 : 1; } std::printf("check-project-refs: %s\n", projectDir.c_str()); std::printf(" zones : %zu (%d failed)\n", zones.size(), projectFailedZones); std::printf(" total missing: %d\n", totalMiss); std::printf("\n zone obj_chk obj_miss q_chk q_miss status\n"); for (const auto& r : rows) { int rowMiss = r.objMiss + r.qMiss; std::printf(" %-26s %5d %5d %5d %5d %s\n", r.name.substr(0, 26).c_str(), r.objCheck, r.objMiss, r.qCheck, r.qMiss, rowMiss == 0 ? "PASS" : "FAIL"); } if (allPassed) { std::printf("\n ALL ZONES PASSED\n"); return 0; } std::printf("\n %d zone(s) have dangling refs\n", projectFailedZones); return 1; } else if (std::strcmp(argv[i], "--for-each-zone") == 0 && i + 1 < argc) { // Batch runner: enumerates zones in <projectDir> and runs the // command after '--' for each one. '{}' in the command is // substituted with the zone path (find -exec convention). // // wowee_editor --for-each-zone custom_zones -- \\ // wowee_editor --validate-all {} // // Returns the count of failed runs as the exit code (capped // at 255 so the shell can still see it). std::string projectDir = argv[++i]; // The literal '--' separates the projectDir from the command. // Skip it; everything after is the command template. if (i + 1 < argc && std::strcmp(argv[i + 1], "--") == 0) ++i; if (i + 1 >= argc) { std::fprintf(stderr, "for-each-zone: need command after '--'\n"); return 1; } // Collect command tokens until end of argv. Don't try to be // clever about quoting — just escape each token for shell // safety using single quotes (' inside is escaped as '\\''). std::vector<std::string> cmdTokens; for (int k = i + 1; k < argc; ++k) cmdTokens.push_back(argv[k]); i = argc - 1; // consume rest of argv namespace fs = std::filesystem; if (!fs::exists(projectDir) || !fs::is_directory(projectDir)) { std::fprintf(stderr, "for-each-zone: %s is not a directory\n", projectDir.c_str()); return 1; } // Find every child dir that contains a zone.json — that's the // canonical 'is this a zone?' test the rest of the editor uses. std::vector<std::string> zones; for (const auto& entry : fs::directory_iterator(projectDir)) { if (!entry.is_directory()) continue; if (fs::exists(entry.path() / "zone.json")) { zones.push_back(entry.path().string()); } } std::sort(zones.begin(), zones.end()); if (zones.empty()) { std::fprintf(stderr, "for-each-zone: no zones found in %s\n", projectDir.c_str()); return 1; } auto shellEscape = [](const std::string& s) { std::string out = "'"; for (char c : s) { if (c == '\'') out += "'\\''"; else out += c; } out += "'"; return out; }; int failed = 0; for (const auto& zone : zones) { std::string cmd; for (size_t k = 0; k < cmdTokens.size(); ++k) { if (k > 0) cmd += " "; std::string token = cmdTokens[k]; // Replace {} with zone path (every occurrence). size_t pos; while ((pos = token.find("{}")) != std::string::npos) { token.replace(pos, 2, zone); } cmd += shellEscape(token); } std::printf("[%s]\n", zone.c_str()); // Flush before std::system so the header lands above the // child's output rather than after (parent stdout is line- // buffered, child writes go straight to the terminal). std::fflush(stdout); int rc = std::system(cmd.c_str()); if (rc != 0) { failed++; std::fprintf(stderr, "for-each-zone: command exited %d for %s\n", rc, zone.c_str()); } } std::printf("\nfor-each-zone: %zu zones, %d failed\n", zones.size(), failed); return failed > 255 ? 255 : failed; } else if (std::strcmp(argv[i], "--for-each-tile") == 0 && i + 1 < argc) { // Per-tile batch runner. --for-each-zone iterates zones in // a project; this iterates tiles within a zone. The '{}' in // the command template is replaced with the tile-base path // (zoneDir/mapName_TX_TY) — the form most tile-level // editor commands take. // // wowee_editor --for-each-tile MyZone -- \\ // wowee_editor --build-woc {} // wowee_editor --for-each-tile MyZone -- \\ // wowee_editor --validate-whm {} std::string zoneDir = argv[++i]; if (i + 1 < argc && std::strcmp(argv[i + 1], "--") == 0) ++i; if (i + 1 >= argc) { std::fprintf(stderr, "for-each-tile: need command after '--'\n"); return 1; } std::vector<std::string> cmdTokens; for (int k = i + 1; k < argc; ++k) cmdTokens.push_back(argv[k]); i = argc - 1; namespace fs = std::filesystem; std::string manifestPath = zoneDir + "/zone.json"; if (!fs::exists(manifestPath)) { std::fprintf(stderr, "for-each-tile: %s has no zone.json\n", zoneDir.c_str()); return 1; } wowee::editor::ZoneManifest zm; if (!zm.load(manifestPath)) { std::fprintf(stderr, "for-each-tile: parse failed\n"); return 1; } if (zm.tiles.empty()) { std::fprintf(stderr, "for-each-tile: zone has no tiles\n"); return 1; } // Same shell-escape + cmd-substitution as --for-each-zone. auto shellEscape = [](const std::string& s) { std::string out = "'"; for (char c : s) { if (c == '\'') out += "'\\''"; else out += c; } out += "'"; return out; }; int failed = 0; // Sort tiles so order is deterministic across runs. auto tiles = zm.tiles; std::sort(tiles.begin(), tiles.end()); for (const auto& [tx, ty] : tiles) { std::string tileBase = zoneDir + "/" + zm.mapName + "_" + std::to_string(tx) + "_" + std::to_string(ty); std::string cmd; for (size_t k = 0; k < cmdTokens.size(); ++k) { if (k > 0) cmd += " "; std::string token = cmdTokens[k]; size_t pos; while ((pos = token.find("{}")) != std::string::npos) { token.replace(pos, 2, tileBase); } cmd += shellEscape(token); } std::printf("[%s (%d, %d)]\n", tileBase.c_str(), tx, ty); std::fflush(stdout); int rc = std::system(cmd.c_str()); if (rc != 0) { failed++; std::fprintf(stderr, "for-each-tile: command exited %d for (%d, %d)\n", rc, tx, ty); } } std::printf("\nfor-each-tile: %zu tiles, %d failed\n", tiles.size(), failed); return failed > 255 ? 255 : failed; } else if (std::strcmp(argv[i], "--version") == 0 || std::strcmp(argv[i], "-v") == 0) { std::printf("Wowee World Editor v1.0.0\n"); std::printf("Open formats: WOT/WHM/WOM/WOB/WOC/WCP + PNG/JSON (all novel)\n"); std::printf("By Kelsi Davis\n"); return 0; } else if (std::strcmp(argv[i], "--list-commands") == 0) { // Capture printUsage's stdout and grep for '--flag' tokens at // the start of each line. This auto-tracks the help text as // commands are added — no parallel list to maintain. Result // is a sorted, deduped, one-per-line list of recognized flags. FILE* old = stdout; // Temp file lets us read printUsage's output back. fmemopen // would be cleaner but isn't available on Windows; tmpfile is // portable. FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "list-commands: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::set<std::string> commands; char line[512]; while (std::fgets(line, sizeof(line), tmp)) { // Match leading whitespace then '--' then [a-z-]+ const char* p = line; while (*p == ' ' || *p == '\t') ++p; if (p[0] != '-' || p[1] != '-') continue; std::string flag; while (*p && (std::isalnum(static_cast<unsigned char>(*p)) || *p == '-' || *p == '_')) { flag += *p++; } if (flag.size() > 2) commands.insert(flag); } std::fclose(tmp); // Always include the meta-flags that printUsage describes // alongside others (-h/-v aliases) since the regex above only // captures double-dash forms. commands.insert("--help"); commands.insert("--version"); for (const auto& c : commands) std::printf("%s\n", c.c_str()); return 0; } else if (std::strcmp(argv[i], "--info-cli-stats") == 0) { // Meta-stats on the CLI surface: total command count + per- // category breakdown by prefix verb (--info-*, --validate-*, // --diff-*, etc.). Useful for tracking growth over time and // spotting category imbalances. bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; // Re-use --list-commands' parser. Capture printUsage stdout. FILE* old = stdout; FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "info-cli-stats: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::set<std::string> commands; char line[512]; while (std::fgets(line, sizeof(line), tmp)) { const char* p = line; while (*p == ' ' || *p == '\t') ++p; if (p[0] != '-' || p[1] != '-') continue; std::string flag; while (*p && (std::isalnum(static_cast<unsigned char>(*p)) || *p == '-' || *p == '_')) { flag += *p++; } if (flag.size() > 2) commands.insert(flag); } std::fclose(tmp); commands.insert("--help"); commands.insert("--version"); // Bucket by category — verb is the second token after '--', // up to the next dash. So '--info-zone-tree' -> 'info'. std::map<std::string, int> byCategory; int maxLen = 0; for (const auto& c : commands) { if (static_cast<int>(c.size()) > maxLen) maxLen = static_cast<int>(c.size()); size_t verbStart = 2; // skip '--' size_t verbEnd = c.find('-', verbStart); std::string verb = (verbEnd == std::string::npos) ? c.substr(verbStart) : c.substr(verbStart, verbEnd - verbStart); byCategory[verb]++; } if (jsonOut) { nlohmann::json j; j["totalCommands"] = commands.size(); j["maxFlagLength"] = maxLen; nlohmann::json cats = nlohmann::json::object(); for (const auto& [v, c] : byCategory) cats[v] = c; j["byCategory"] = cats; std::printf("%s\n", j.dump(2).c_str()); return 0; } std::printf("CLI surface stats\n"); std::printf(" total commands : %zu\n", commands.size()); std::printf(" longest flag : %d chars\n", maxLen); std::printf("\n Categories (by verb prefix, sorted by count):\n"); // Sort by count descending for the table. std::vector<std::pair<std::string, int>> sorted( byCategory.begin(), byCategory.end()); std::sort(sorted.begin(), sorted.end(), [](const auto& a, const auto& b) { return a.second > b.second; }); for (const auto& [verb, count] : sorted) { std::printf(" --%-12s %4d\n", verb.c_str(), count); } return 0; } else if (std::strcmp(argv[i], "--info-cli-categories") == 0) { // Discovery view of every CLI flag grouped by verb prefix. // Where --info-cli-stats just counts per category, this // lists every command in each category — handy for "I // know I want to gen something but what shapes/textures // are available?" FILE* old = stdout; FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "info-cli-categories: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::set<std::string> commands; char line[512]; while (std::fgets(line, sizeof(line), tmp)) { const char* p = line; while (*p == ' ' || *p == '\t') ++p; if (p[0] != '-' || p[1] != '-') continue; std::string flag; while (*p && (std::isalnum(static_cast<unsigned char>(*p)) || *p == '-' || *p == '_')) { flag += *p++; } if (flag.size() > 2) commands.insert(flag); } std::fclose(tmp); commands.insert("--help"); commands.insert("--version"); std::map<std::string, std::vector<std::string>> byCategory; for (const auto& c : commands) { size_t verbStart = 2; size_t verbEnd = c.find('-', verbStart); std::string verb = (verbEnd == std::string::npos) ? c.substr(verbStart) : c.substr(verbStart, verbEnd - verbStart); byCategory[verb].push_back(c); } std::printf("CLI commands by category (%zu total):\n\n", commands.size()); // Sort categories by count descending, commands within // each alphabetically. std::vector<std::pair<std::string, std::vector<std::string>>> sorted( byCategory.begin(), byCategory.end()); std::sort(sorted.begin(), sorted.end(), [](const auto& a, const auto& b) { if (a.second.size() != b.second.size()) return a.second.size() > b.second.size(); return a.first < b.first; }); for (const auto& [verb, cmds] : sorted) { std::printf("--%s (%zu):\n", verb.c_str(), cmds.size()); for (const auto& c : cmds) { std::printf(" %s\n", c.c_str()); } std::printf("\n"); } return 0; } else if (std::strcmp(argv[i], "--info-cli-help") == 0 && i + 1 < argc) { // Substring search through the help text. With 130+ commands, // 'is there a thing for X?' is a common ask — this answers it // without making the user scroll the full --help output: // // wowee_editor --info-cli-help quest // wowee_editor --info-cli-help validate // wowee_editor --info-cli-help glb std::string pattern = argv[++i]; // Lowercase the pattern for case-insensitive match. std::string patLower = pattern; for (auto& c : patLower) c = std::tolower(static_cast<unsigned char>(c)); // Capture printUsage stdout, walk line-by-line, print every // line containing the pattern (case-insensitive). Continuation // lines (the indented description on the line after a flag) // are emitted along with the flag line for context. FILE* old = stdout; FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "info-cli-help: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::vector<std::string> lines; char buf[1024]; while (std::fgets(buf, sizeof(buf), tmp)) { std::string s = buf; if (!s.empty() && s.back() == '\n') s.pop_back(); lines.push_back(std::move(s)); } std::fclose(tmp); int matches = 0; for (size_t k = 0; k < lines.size(); ++k) { std::string lower = lines[k]; for (auto& c : lower) c = std::tolower(static_cast<unsigned char>(c)); if (lower.find(patLower) == std::string::npos) continue; std::printf("%s\n", lines[k].c_str()); // Look ahead for a continuation line (indented and not // starting with '--'). Print it for context. if (k + 1 < lines.size()) { const auto& next = lines[k + 1]; if (!next.empty() && next[0] == ' ' && next.find("--") == std::string::npos) { std::printf("%s\n", next.c_str()); } } matches++; } if (matches == 0) { std::fprintf(stderr, "info-cli-help: no matches for '%s'\n", pattern.c_str()); return 1; } std::fprintf(stderr, "\n%d line(s) matched '%s'\n", matches, pattern.c_str()); return 0; } else if (std::strcmp(argv[i], "--validate-cli-help") == 0) { // Self-check: every flag we declare in kArgRequired (the list // of commands needing positional args) must appear in the // help text printUsage emits. Catches drift where someone // adds a handler + argument check but forgets the help line. bool jsonOut = (i + 1 < argc && std::strcmp(argv[i + 1], "--json") == 0); if (jsonOut) i++; // Capture printUsage's stdout. FILE* old = stdout; FILE* tmp = std::tmpfile(); if (!tmp) { std::fprintf(stderr, "validate-cli-help: tmpfile failed\n"); return 1; } stdout = tmp; wowee::editor::cli::printUsage(argv[0]); stdout = old; std::fseek(tmp, 0, SEEK_SET); std::string helpText; char chunk[1024]; while (std::fgets(chunk, sizeof(chunk), tmp)) helpText += chunk; std::fclose(tmp); // Walk kArgRequired and check each appears in the help. std::vector<std::string> missing; for (const char* opt : kArgRequired) { if (helpText.find(opt) == std::string::npos) { missing.push_back(opt); } } if (jsonOut) { nlohmann::json j; j["totalArgRequired"] = sizeof(kArgRequired) / sizeof(kArgRequired[0]); j["missing"] = missing; j["passed"] = missing.empty(); std::printf("%s\n", j.dump(2).c_str()); return missing.empty() ? 0 : 1; } std::printf("CLI help self-check\n"); std::printf(" kArgRequired entries : %zu\n", sizeof(kArgRequired) / sizeof(kArgRequired[0])); if (missing.empty()) { std::printf(" PASSED — every kArgRequired flag is documented\n"); return 0; } std::printf(" FAILED — %zu flag(s) missing from help text:\n", missing.size()); for (const auto& m : missing) std::printf(" - %s\n", m.c_str()); return 1; } else if (std::strcmp(argv[i], "--gen-completion") == 0 && i + 1 < argc) { // Emit a bash or zsh completion script. Re-execs the editor's // own --list-commands at completion time so newly-added flags // light up automatically without regenerating the script. std::string shell = argv[++i]; if (shell != "bash" && shell != "zsh") { std::fprintf(stderr, "gen-completion: shell must be 'bash' or 'zsh', got '%s'\n", shell.c_str()); return 1; } // Use argv[0] as the binary name in the completion so it // works whether the user installed it as 'wowee_editor' or // a custom alias. Strip directory components for the // completion-name registration (bash 'complete -F' expects // a basename). std::string self = argv[0]; auto slash = self.find_last_of('/'); std::string baseName = (slash != std::string::npos) ? self.substr(slash + 1) : self; if (shell == "bash") { std::printf( "# wowee_editor bash completion — source from ~/.bashrc:\n" "# source <(%s --gen-completion bash)\n" "_wowee_editor_complete() {\n" " local cur prev cmds\n" " COMPREPLY=()\n" " cur=\"${COMP_WORDS[COMP_CWORD]}\"\n" " prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\n" " # Cache the command list per shell session.\n" " if [[ -z \"$_WOWEE_EDITOR_CMDS\" ]]; then\n" " _WOWEE_EDITOR_CMDS=$(%s --list-commands 2>/dev/null)\n" " fi\n" " if [[ \"$cur\" == --* ]]; then\n" " COMPREPLY=( $(compgen -W \"$_WOWEE_EDITOR_CMDS\" -- \"$cur\") )\n" " return 0\n" " fi\n" " # Default: complete file paths for arg slots.\n" " COMPREPLY=( $(compgen -f -- \"$cur\") )\n" "}\n" "complete -F _wowee_editor_complete %s\n", self.c_str(), self.c_str(), baseName.c_str()); } else { // zsh — simpler descriptor-based completion. std::printf( "# wowee_editor zsh completion — source from ~/.zshrc:\n" "# source <(%s --gen-completion zsh)\n" "_wowee_editor_complete() {\n" " local -a cmds\n" " if [[ -z \"$_WOWEE_EDITOR_CMDS\" ]]; then\n" " export _WOWEE_EDITOR_CMDS=$(%s --list-commands 2>/dev/null)\n" " fi\n" " cmds=( ${(f)_WOWEE_EDITOR_CMDS} )\n" " _arguments \"*: :($cmds)\"\n" "}\n" "compdef _wowee_editor_complete %s\n", self.c_str(), self.c_str(), baseName.c_str()); } return 0; } else if (std::strcmp(argv[i], "--help") == 0 || std::strcmp(argv[i], "-h") == 0) { wowee::editor::cli::printUsage(argv[0]); return 0; } } if (dataPath.empty()) { dataPath = "Data"; LOG_INFO("No --data path specified, using default: ", dataPath); } wowee::editor::EditorApp app; if (!app.initialize(dataPath)) { LOG_ERROR("Failed to initialize editor"); return 1; } if (!adtMap.empty()) { app.loadADT(adtMap, adtX, adtY); } app.run(); app.shutdown(); return 0; }