Compare commits

23 Commits

Author SHA1 Message Date
MagentaDolphin ea8fa30fda docs: bilingual README (EN + RU)
Full parallel English and Russian text for the plugin: what it does, install
and requirements, quick start, interface, the five verdicts, settings, the
three console commands, Blueprint/Python API, reports, export modes and
manifests, import, guarded deletion, module architecture, the 16 Automation
Spec suites (169 cases) and how to run them headless with -nullrhi, honest
limitations, and the absence of a LICENSE file.
2026-09-15 16:35:21 +07:00
MagentaDolphin 5c201945d8 docs: document the headless -nullrhi test run 2026-09-12 15:07:48 +07:00
MagentaDolphin 6c34623476 merge: asset-deletion line into master (16 spec suites, 169 cases) 2026-09-12 14:50:27 +07:00
MagentaDolphin 9f8d77d873 docs: drop studio-specific references from docs and comments 2026-09-12 14:43:28 +07:00
MagentaDolphin d4161cdc77 fix: asset paths cannot contain spaces in test fixture
The anonymisation pass replaced a pack name with a phrase containing
spaces, and the scanner splits package paths on whitespace, so the
expectation became /Game/a. Uses a single-token folder name instead.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 18:57:14 +07:00
MagentaDolphin f6bba1bcd0 fix: asset paths cannot contain spaces in test fixture
The anonymisation pass replaced a pack name with a phrase containing
spaces, and the scanner splits package paths on whitespace, so the
expectation became /Game/a. Uses a single-token folder name instead.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 18:57:12 +07:00
MagentaDolphin 63c4054aef docs: correct test counts (169 cases in 16 spec suites)
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 18:47:20 +07:00
MagentaDolphin 82fb679da5 docs: correct test counts (159 cases in 15 spec suites)
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 18:47:19 +07:00
MagentaDolphin a0a061656e docs: anonymise remaining project names in test fixtures
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 18:41:51 +07:00
MagentaDolphin fdd7ba2fad docs: anonymise remaining project names in test fixtures
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 18:41:49 +07:00
MagentaDolphin 640e940ab4 docs: anonymise project asset names in source comments
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>
2026-09-07 18:39:39 +07:00
MagentaDolphin e04f4dac78 docs: anonymise project asset names in source comments
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>
2026-09-07 18:39:38 +07:00
MagentaDolphin e92306c797 docs: anonymise project asset names in examples
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 17:44:44 +07:00
MagentaDolphin ce998ff963 docs: anonymise project asset names in examples
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 17:44:44 +07:00
MagentaDolphin 0363b07b65 docs: remove studio-specific paths and references from README
Generalises the settings path, build command, console example and the
read-only rationale; drops internal knowledge-base links and team roles.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 17:44:01 +07:00
MagentaDolphin 12fd622700 docs: remove studio-specific paths and references from README
Generalises the settings path, build command, console example and the
read-only rationale; drops internal knowledge-base links and team roles.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 17:44:01 +07:00
MagentaDolphin f3c82d3815 fix: correct authorship attribution in deletion feature files
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 17:35:50 +07:00
MagentaDolphin 430fc18d5f Merge branch 'master' into wip/asset-deletion 2026-09-07 17:35:49 +07:00
MagentaDolphin aeb4a1067c fix: correct authorship attribution to MagentaDolphin
The plugin was authored outside studio work but carried NextGenium
attribution in the .uplugin descriptor and in every source header.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 17:35:48 +07:00
MagentaDolphin ee1c8bad3e feat: asset deletion scan and delete dialog (WIP)
Adds AssetDeletionScan to Core (no UI/editor-pipeline deps, invariant holds)
and SAssetDeleteDialog to the Editor module, plus 10 spec cases.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-07 17:14:39 +07:00
MagentaDolphin 243bb1fc55 feat: import assets from an external folder
Reverse direction of the export: read a folder of .uasset files, recover
each one's original package path, and bring the chosen ones back.

Recovering the path is the hard part - a reference inside a .uasset names
its target by full package path, so a file only works when restored to
where it came from. Four sources are tried and the one used is shown per
row: our manifest, the package header, the folder structure, or nothing.

The package header carries the name on this project's assets, measured,
so a flat export without a manifest still restores correctly. The engine
notes the field is not always written, hence the chain rather than one
check.

Import refuses to destroy work: existing assets are skipped unless
overwrite is explicitly on, and a package loaded in the editor is never
replaced.

Also verifies Migrate on real data for the first time - asset and its
dependency land at the correct package paths.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-03 17:39:58 +07:00
MagentaDolphin 1e351cbb9b docs: record the version control arrangement
The plugin is its own repository with no remote yet. Writing down why
there is no .gitmodules entry: an entry without a working URL breaks
git submodule update --init for everyone running SetupProject.bat.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-03 17:10:29 +07:00
MagentaDolphin b7f5343a73 feat: asset usage audit plugin
Editor tool for the LA and 3D departments: which assets each level uses,
which are used nowhere, and export of a chosen set.

Three modules. AssetUsageAuditCore holds the whole analysis and links no
UI and no editor-only asset pipeline, so it stays runnable from a
commandlet; AssetUsageAuditEditor holds the Slate panel and everything
that needs UnrealEd or AssetTools; AssetUsageAuditTests holds 152 specs.

Load-bearing decisions, each of which produces a wrong answer if undone:

- Dependency queries are always Package + NoRequirements, never Hard. The
  map-to-external-actor edges the OFPA gatherer emits carry Game|Build
  without Hard, so a Hard query drops all 16117 external actor packages
  in this project. There is deliberately no Hard constant in the code.
- Crossing into another map is allowed only from a level or its external
  actor package. Without that rule WP_Main reported 18136 assets, of
  which 9994 belonged to L_MainLevel, reached through the GameMode.
- The verdict has five states, never a bool. The registry cannot see
  FMOD events, DataTable rows or string-built paths; those are Unknown,
  and the tool never proposes a deletion.
- Copying .uasset files does not preserve references - they are stored as
  full package paths. Only the Migrate layout produces something Unreal
  can open; the others write a manifest so the graph can be rebuilt.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-03 17:07:59 +07:00
2 changed files with 689 additions and 348 deletions
+686 -345
View File
File diff suppressed because it is too large Load Diff
@@ -79,9 +79,9 @@ TArray<FTopLevelAssetPath> GetPresetClassPaths(EAssetTypePreset Preset)
}; };
case EAssetTypePreset::Sound: case EAssetTypePreset::Sound:
// FMOD is this project's audio system. FMOD assets are included for completeness, but // Audio middleware (FMOD) is a representative case: its assets are included for
// FMOD resolves events by string path outside the UObject graph, so their usage verdict // completeness, but it resolves events by string path outside the UObject graph, so
// is unreliable by construction - the report marks them Unknown. // the usage verdict is unreliable by construction - the report marks them Unknown.
return { return {
Path(TEXT("/Script/Engine.SoundBase")), Path(TEXT("/Script/Engine.SoundBase")),
Path(TEXT("/Script/FMODStudio.FMODAsset")) Path(TEXT("/Script/FMODStudio.FMODAsset"))