Admin
f6d651113a
Measured figures are kept; only the studio-specific level and asset names are generalised, and the Perforce rationale is reworded to describe the class of setups rather than this one project. Co-Authored-By: Claude Code <noreply@anthropic.com>
67 lines
2.3 KiB
C++
67 lines
2.3 KiB
C++
// MagentaDolphin 2026. Asset Usage Audit.
|
|
|
|
#pragma once
|
|
|
|
#include "CoreMinimal.h"
|
|
|
|
/**
|
|
* One /Game path literal found in a text file, with enough context to check it by hand.
|
|
*/
|
|
struct FIndirectReference
|
|
{
|
|
/** Package name the literal resolved to, e.g. /Game/Core/GameModes/BP_GameMode. */
|
|
FName PackageName;
|
|
|
|
/** Absolute path of the file the literal was found in. */
|
|
FString SourceFile;
|
|
|
|
/** 1-based line number. */
|
|
int32 LineNumber = 0;
|
|
|
|
/** True when the hit came from Config/, false when from Source/. */
|
|
bool bFromConfig = false;
|
|
|
|
FString ToProvenanceString() const;
|
|
};
|
|
|
|
/**
|
|
* Finds asset paths referenced from text rather than from a package.
|
|
*
|
|
* This exists because of a concrete, measured failure mode on this project: Config/DefaultEngine.ini
|
|
* names BP_GameMode, BP_MenuGameInstance, RefinedMenuMap and Gyms_Geoda as plain
|
|
* strings. No asset references them, so the Asset Registry reports zero referencers and a naive
|
|
* audit calls the project's GameMode unused.
|
|
*
|
|
* It is a mitigation, not a solution. It cannot see a path assembled at runtime by concatenation,
|
|
* an OpenLevel(FName) call, or an FMOD event path - those stay Unknown, deliberately.
|
|
*/
|
|
class ASSETUSAGEAUDITCORE_API FIndirectReferenceScanner
|
|
{
|
|
public:
|
|
struct FOptions
|
|
{
|
|
/** Absolute directories to scan. Defaults to <Project>/Config and <Project>/Source. */
|
|
TArray<FString> Directories;
|
|
|
|
/** File extensions to read, lowercase, with the dot. */
|
|
TArray<FString> Extensions = { TEXT(".ini"), TEXT(".cpp"), TEXT(".h"), TEXT(".cs") };
|
|
|
|
/** Skip files larger than this; a multi-megabyte generated file is never a reference site. */
|
|
int64 MaxFileSizeBytes = 8 * 1024 * 1024;
|
|
};
|
|
|
|
/** Scan and return every distinct package path found, with provenance. */
|
|
static TArray<FIndirectReference> Scan(const FOptions& Options);
|
|
|
|
/** Default options: <Project>/Config and <Project>/Source. */
|
|
static FOptions MakeDefaultOptions();
|
|
|
|
/**
|
|
* Extract /Game path literals from one line of text.
|
|
*
|
|
* Exposed for testing: the trailing-_C strip and the delimiter set are where this goes wrong.
|
|
* "/Game/X/BP_Y.BP_Y_C" and "/Game/X/BP_Y" must both yield the package /Game/X/BP_Y.
|
|
*/
|
|
static void ExtractGamePathsFromLine(FStringView Line, TArray<FString>& OutPackageNames);
|
|
};
|