mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-05-09 10:33:51 +00:00
feat(editor): add --info-zone-density for spawn distribution analysis
Per-tile content density. Catches sparse zones (5 mobs across 16
tiles → boring) and over-stuffed ones (200 mobs in 1 tile → frame-
rate bomb). Reports overall averages plus per-tile bucket counts:
wowee_editor --info-zone-density custom_zones/MyZone
Zone density: custom_zones/MyZone
tiles : 4
totals : 47 creatures, 23 objects, 8 quests
per-tile : 11.75 creatures, 5.75 objects, 2.00 quests
Per-tile breakdown:
tile creatures objects
(28, 30) 12 7
(29, 30) 18 4
(29, 31) 9 8
(30, 30) 8 4
Spawn-to-tile bucketing reverses the WoW grid transform from world
position back to tile (tx, ty) coords. Out-of-zone spawns silently
drop (they show up in --check-zone-refs / --check-zone-content as
their own warning class).
Useful for difficulty-curve work ('how packed is this hub vs this
zone-edge?'), perf budgeting ('which tile do I need to lod-out
first?'), and content-pacing reviews ('is the early game too empty?').
JSON mode emits per-tile records for dashboards. Verified on a
1-tile mvp-zone: 1 creature + 1 object + 1 quest, all bucketed
into the correct tile (28, 30).
This commit is contained in:
Kelsi
parent
f4e8623d58
commit
33b231b8a2
1 changed files with 106 additions and 0 deletions
|
|
@ -652,6 +652,8 @@ static void printUsage(const char* argv0) {
|
||||||
std::printf(" Compute the zone's bounding box (XY tile range, Z height min/max)\n");
|
std::printf(" Compute the zone's bounding box (XY tile range, Z height min/max)\n");
|
||||||
std::printf(" --info-zone-water <zoneDir> [--json]\n");
|
std::printf(" --info-zone-water <zoneDir> [--json]\n");
|
||||||
std::printf(" Aggregate water-layer stats across all tiles (layer count, types, area)\n");
|
std::printf(" Aggregate water-layer stats across all tiles (layer count, types, area)\n");
|
||||||
|
std::printf(" --info-zone-density <zoneDir> [--json]\n");
|
||||||
|
std::printf(" Per-tile density (creatures/objects/quests per tile + overall avg)\n");
|
||||||
std::printf(" --export-zone-summary-md <zoneDir> [out.md]\n");
|
std::printf(" --export-zone-summary-md <zoneDir> [out.md]\n");
|
||||||
std::printf(" Render a markdown documentation page for a zone (manifest + content)\n");
|
std::printf(" Render a markdown documentation page for a zone (manifest + content)\n");
|
||||||
std::printf(" --export-zone-csv <zoneDir> [outDir]\n");
|
std::printf(" --export-zone-csv <zoneDir> [outDir]\n");
|
||||||
|
|
@ -814,6 +816,7 @@ int main(int argc, char* argv[]) {
|
||||||
"--validate-png", "--validate-blp",
|
"--validate-png", "--validate-blp",
|
||||||
"--zone-summary", "--info-zone-tree", "--info-project-tree",
|
"--zone-summary", "--info-zone-tree", "--info-project-tree",
|
||||||
"--info-zone-bytes", "--info-zone-extents", "--info-zone-water",
|
"--info-zone-bytes", "--info-zone-extents", "--info-zone-water",
|
||||||
|
"--info-zone-density",
|
||||||
"--export-zone-summary-md", "--export-quest-graph",
|
"--export-zone-summary-md", "--export-quest-graph",
|
||||||
"--export-zone-csv", "--export-zone-html", "--export-project-html",
|
"--export-zone-csv", "--export-zone-html", "--export-project-html",
|
||||||
"--export-project-md", "--export-zone-checksum",
|
"--export-project-md", "--export-zone-checksum",
|
||||||
|
|
@ -5071,6 +5074,109 @@ int main(int argc, char* argv[]) {
|
||||||
std::printf(" (no water in this zone)\n");
|
std::printf(" (no water in this zone)\n");
|
||||||
}
|
}
|
||||||
return 0;
|
return 0;
|
||||||
|
} else if (std::strcmp(argv[i], "--info-zone-density") == 0 && i + 1 < argc) {
|
||||||
|
// Per-tile content density. Catches sparse zones (5 mobs
|
||||||
|
// across 16 tiles → boring) and over-stuffed ones (200 mobs
|
||||||
|
// in 1 tile → frame-rate bomb). Per-tile bucket uses tile
|
||||||
|
// (tx, ty) computed from world position by reversing the
|
||||||
|
// WoW grid transform.
|
||||||
|
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,
|
||||||
|
"info-zone-density: %s has no zone.json\n", zoneDir.c_str());
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
wowee::editor::ZoneManifest zm;
|
||||||
|
if (!zm.load(manifestPath)) {
|
||||||
|
std::fprintf(stderr, "info-zone-density: parse failed\n");
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
// Per-(tx, ty) bucket of counts.
|
||||||
|
struct TileBucket { int creatures = 0, objects = 0; };
|
||||||
|
std::map<std::pair<int,int>, TileBucket> tiles;
|
||||||
|
for (const auto& [tx, ty] : zm.tiles) tiles[{tx, ty}] = {};
|
||||||
|
// Reverse the WoW grid transform: world (X, Y) -> tile (tx, ty).
|
||||||
|
// From --info-zone-extents:
|
||||||
|
// worldX = (32 - tileY) * 533.33 - subX
|
||||||
|
// worldY = (32 - tileX) * 533.33 - subY
|
||||||
|
// So:
|
||||||
|
// tileX = floor(32 - worldY / 533.33)
|
||||||
|
// tileY = floor(32 - worldX / 533.33)
|
||||||
|
constexpr float kTileSize = 533.33333f;
|
||||||
|
auto worldToTile = [](float wx, float wy) -> std::pair<int,int> {
|
||||||
|
int tx = static_cast<int>(std::floor(32.0f - wy / kTileSize));
|
||||||
|
int ty = static_cast<int>(std::floor(32.0f - wx / kTileSize));
|
||||||
|
return {tx, ty};
|
||||||
|
};
|
||||||
|
wowee::editor::NpcSpawner sp;
|
||||||
|
int totalCreat = 0;
|
||||||
|
if (sp.loadFromFile(zoneDir + "/creatures.json")) {
|
||||||
|
totalCreat = static_cast<int>(sp.spawnCount());
|
||||||
|
for (const auto& s : sp.getSpawns()) {
|
||||||
|
auto t = worldToTile(s.position.x, s.position.y);
|
||||||
|
auto it = tiles.find(t);
|
||||||
|
if (it != tiles.end()) it->second.creatures++;
|
||||||
|
// Out-of-zone spawns silently dropped — they'll
|
||||||
|
// surface in --check-zone-refs / --check-zone-content.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
wowee::editor::ObjectPlacer op;
|
||||||
|
int totalObj = 0;
|
||||||
|
if (op.loadFromFile(zoneDir + "/objects.json")) {
|
||||||
|
totalObj = static_cast<int>(op.getObjects().size());
|
||||||
|
for (const auto& o : op.getObjects()) {
|
||||||
|
auto t = worldToTile(o.position.x, o.position.y);
|
||||||
|
auto it = tiles.find(t);
|
||||||
|
if (it != tiles.end()) it->second.objects++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
wowee::editor::QuestEditor qe;
|
||||||
|
int totalQ = 0;
|
||||||
|
if (qe.loadFromFile(zoneDir + "/quests.json")) {
|
||||||
|
totalQ = static_cast<int>(qe.questCount());
|
||||||
|
}
|
||||||
|
int tileCount = static_cast<int>(tiles.size());
|
||||||
|
double avgCreatPerTile = tileCount > 0 ? double(totalCreat) / tileCount : 0.0;
|
||||||
|
double avgObjPerTile = tileCount > 0 ? double(totalObj) / tileCount : 0.0;
|
||||||
|
double questsPerTile = tileCount > 0 ? double(totalQ) / tileCount : 0.0;
|
||||||
|
if (jsonOut) {
|
||||||
|
nlohmann::json j;
|
||||||
|
j["zone"] = zoneDir;
|
||||||
|
j["tileCount"] = tileCount;
|
||||||
|
j["totals"] = {{"creatures", totalCreat},
|
||||||
|
{"objects", totalObj},
|
||||||
|
{"quests", totalQ}};
|
||||||
|
j["averages"] = {{"creaturesPerTile", avgCreatPerTile},
|
||||||
|
{"objectsPerTile", avgObjPerTile},
|
||||||
|
{"questsPerTile", questsPerTile}};
|
||||||
|
nlohmann::json arr = nlohmann::json::array();
|
||||||
|
for (const auto& [coord, b] : tiles) {
|
||||||
|
arr.push_back({{"tile", {coord.first, coord.second}},
|
||||||
|
{"creatures", b.creatures},
|
||||||
|
{"objects", b.objects}});
|
||||||
|
}
|
||||||
|
j["perTile"] = arr;
|
||||||
|
std::printf("%s\n", j.dump(2).c_str());
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
std::printf("Zone density: %s\n", zoneDir.c_str());
|
||||||
|
std::printf(" tiles : %d\n", tileCount);
|
||||||
|
std::printf(" totals : %d creatures, %d objects, %d quests\n",
|
||||||
|
totalCreat, totalObj, totalQ);
|
||||||
|
std::printf(" per-tile : %.2f creatures, %.2f objects, %.2f quests\n",
|
||||||
|
avgCreatPerTile, avgObjPerTile, questsPerTile);
|
||||||
|
std::printf("\n Per-tile breakdown:\n");
|
||||||
|
std::printf(" tile creatures objects\n");
|
||||||
|
for (const auto& [coord, b] : tiles) {
|
||||||
|
std::printf(" (%2d, %2d) %5d %5d\n",
|
||||||
|
coord.first, coord.second, b.creatures, b.objects);
|
||||||
|
}
|
||||||
|
return 0;
|
||||||
} else if (std::strcmp(argv[i], "--export-zone-summary-md") == 0 && i + 1 < argc) {
|
} else if (std::strcmp(argv[i], "--export-zone-summary-md") == 0 && i + 1 < argc) {
|
||||||
// Render a Markdown documentation page for a zone. Useful for
|
// Render a Markdown documentation page for a zone. Useful for
|
||||||
// designers tracking changes between versions, generating
|
// designers tracking changes between versions, generating
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue