PrimalPals + T-Box Pal Dressing Facility - Compatibility Add-on 🔨 1.2 Fix

ABOUT THIS MOD

This compatibility add-on allows the clean, complete official PrimalPals package to work alongside T-Box Pal Dressing Facility All-in-One.

PrimalPals remains the automatic/default appearance source. The Guardian records the first valid Primal mesh observed for each individual Pal as its immutable BirthPrimal. A compatible appearance selected through T-Box becomes a persistent and reversible overlay: it has no timer and remains active until it is replaced or removed. Removing T-Box restores that same individual's recorded BirthPrimal instead of forcing vanilla or choosing a new random variant.

Version 1.2 Fixed is an event-driven UE4SS Lua runtime module. It replaces the selective ModelJSON method used by compatibility Versions 1.0 and 1.1.

This download contains compatibility logic and documentation only. It does not redistribute PrimalPals or T-Box models, textures, animations, PAK files, save files, personal identifiers, or PalMagic persistence data.

REQUIRED DOWNLOADS

This add-on is not standalone. Download and install every dependency manually from its official source.

- UE4SS - Okaetsu Experimental-Palworld:
  https://www.nexusmods.com/palworld/mods/3035?tab=files

- PalMagic - Runtime Model Replacer 0.2.3:
 

- T-Box Pal Dressing Facility Skin Swap:
  https://www.nexusmods.com/palworld/mods/2954?tab=files&file_id=20424
  Download the All-in-One release from the Files tab.

- PrimalPals:

 

Validated with the Windows/Steam game build v1.0.2.101103 and PalMagic 0.2.3. Future game or dependency updates may require a compatibility update. Xbox/Game Pass has not been validated.

UniPalUI, SCake, and animation packs are not required by this add-on. They may still be required by other mods in your installation. This release is designed for PalMagic and does not support DynamicPals.

IMPORTANT - UPGRADING FROM VERSION 1.0 OR 1.1

1. Close Palworld completely.
2. Remove the modified male-only PrimalPals PAK used by the old Version 1.0 experiment, if it is still installed.
3. Remove only the selective compatibility PrimalPals.json from:

   Palworld\Pal\Content\Paks\~mods\ModelJSON

4. Restore the clean, complete official PrimalPals PAK and official ModelJSON.
5. Regenerate PalMagic's _ManifestList.json if your ModelJSON set changed.

Do not delete _PalMagicPersist_*.json. It stores PalMagic's saved per-individual appearances. Do not delete unrelated ModelJSON files.

WHAT IS NEW IN VERSION 1.2 FIXED

- Replaces the legacy selective ModelJSON method with an event-driven UE4SS Guardian.
- Adds immutable per-individual BirthPrimal persistence.
- Makes compatible T-Box appearances indefinite, reversible overlays.
- Restores the exact recorded Primal variant for that individual when T-Box is removed.
- Protects compatible T-Box selections through base use, companion use, world reloads, and full game restarts in validated scenarios.
- Clears leftover Primal material overrides during restoration.
- Adds delayed world-stability gating for heavily modded startup.
- Shows one minimal in-game status notice per world entry using Palworld's own notification system.
- Includes 877 exact T-Box class-to-mesh mappings.
- Uses no continuous world scanner and retains no live UObject cache.
- Public build contains no diagnostic CSV, personal GUID seed, or verbose per-mesh logging.

⚠️ INSTALLATION ⚠️

1. Install and verify every required dependency separately.
2. Complete the V1.0/V1.1 cleanup above if applicable.
3. Close Palworld completely.
4. Extract this archive into the Palworld game root, normally:

   ...\SteamLibrary\steamapps\common\Palworld

5. Confirm the final module path is:

   Pal\Binaries\Win64\ue4ss\Mods\PalMagicTBoxGuardianV12Fixed

6. Delete the complete old PalMagicTBoxGuardianV10 folder and any other older PalMagicTBoxGuardianV* test-module folders. Do not leave V10 installed and disabled; remove it. Keep only PalMagicTBoxGuardianV12Fixed.
7. Start the game and allow the title screen/mod initialization to settle before entering a heavily modded world.

Do not extract this add-on into Paks\~mods.

EXPECTED STATUS

After a stable gameplay world is detected, Palworld displays:

   [T-Box] Guardian active.

The message is intentionally shown once per world entry. It uses Palworld's own notification system and does not require UniPalUI. If initialization cannot be completed, the Guardian instead reports that it is unavailable.

HOW TO USE IT

- Pals without a manually selected T-Box appearance remain controlled by the official PrimalPals and PalMagic setup.
- Apply or replace compatible T-Box appearances normally through the Pal Dressing Facility.
- The selected T-Box appearance remains active indefinitely on that individual until you replace or remove it.
- Removing T-Box restores the immutable BirthPrimal recorded for that individual.

This preserves the intended combination: diverse PrimalPals world appearances by default, with T-Box as a persistent and reversible per-Pal choice.

HOW IT WORKS

The Guardian reacts to PalMagic's ApplyMesh event. When the affected Pal owns a recognized T-Box appearance, it restores the exact T-Box mesh and clears incompatible leftover material overrides. When T-Box is removed, it restores the Pal's recorded BirthPrimal.

The first valid Primal mesh observed for a GUID is recorded in:

   PalMagicTBoxGuardianV12Fixed\State\birth_primal_registry.tsv

The registry is append-only and written only when a new individual baseline is learned. Keep it during normal updates. Deleting it intentionally resets every learned BirthPrimal baseline.

The Guardian does not overwrite _PalMagicPersist_*.json, continuously scan the world, or keep live game-object references cached. The public build does not create a diagnostic CSV.

VALIDATED BEHAVIOR

Controlled tests covered T-Box apply, persistence, replacement, removal, exact Primal return, world reload, and full executable restart. Lovander, Nitewing, Melpaca, Galeclaw, Mozzarina, and additional mappings were observed successfully.

The catalog contains 877 exact T-Box mappings. Every possible Pal, skin, save state, and gameplay context has not been visually tested.

KNOWN LIMITS

- The first valid Primal mesh observed becomes the immutable BirthPrimal baseline. If an already corrupted setup is observed first, close the game, correct the installation, and intentionally reset the registry before retesting.
- PalMagic "Skin mismatch found" notifications are outside this add-on's scope.
- Animation and skeleton compatibility are not modified. Incompatible animation assets may still cause a T-pose or severe deformation.
- Future Palworld, UE4SS, PalMagic, PrimalPals, or T-Box updates may require a compatibility update.
- Xbox/Game Pass has not been validated.

UNINSTALLATION

Close Palworld and remove only:

   Pal\Binaries\Win64\ue4ss\Mods\PalMagicTBoxGuardianV12Fixed

Do not delete _PalMagicPersist_*.json unless you deliberately want to reset PalMagic itself.

CREDITS

All original models, textures, frameworks, names, and assets belong to their respective PrimalPals, T-Box Pal Dressing Facility, PalMagic, and UE4SS creators.

This package contains only compatibility logic and documentation. It does not redistribute or modify their official assets.

A BRIEF NOTE

I apologize for the frequent changes while this compatibility add-on was being stabilized. Thank you for your patience, testing, and understanding.