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

ABOUT THIS MOD

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

PrimalPals remains the automatic/default appearance source for Pals, including female models and per-individual Primal variants. When you manually apply a compatible T-Box appearance through the Pal Dressing Facility, the selected T-Box appearance is protected from PalMagic's delayed Primal reapplication and remains active on that individual Pal.

The selected T-Box appearance has no timer. It remains active until you replace or remove it. When T-Box is removed, control returns to the same Primal variant already saved by PalMagic for that individual instead of forcing vanilla or choosing a new random variant.

IMPORTANT: Version 1.2 is a UE4SS Lua runtime script. It is no longer a replacement or selective ModelJSON package.

Version 1.2 replaces the old selective ModelJSON method used by Versions 1.0 and 1.1 with an event-driven UE4SS runtime Guardian.

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

IMPORTANT - UPGRADING FROM VERSION 1.0 OR 1.1

Versions 1.0 and 1.1 used a modified PrimalPals setup or a selective PrimalPals ModelJSON. Those legacy compatibility files must not remain active with Version 1.2.

Before installing Version 1.2:

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 the selective PrimalPals.json installed by compatibility Version 1.0 or 1.1 from:

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

4. Reinstall the clean, complete official PrimalPals PAK and its official ModelJSON.
5. If your ModelJSON set changed, regenerate PalMagic's _ManifestList.json using the generator supplied by PalMagic or your official mod installation.

DO NOT DELETE:

   _PalMagicPersist_*.json

That file stores PalMagic's saved per-individual appearances. Also do not delete unrelated ModelJSON files belonging to other mods.

Do not keep the old selective V1.0/V1.1 compatibility ModelJSON active together with Version 1.2.

WHAT IS NEW IN VERSION 1.2 RC1

- Replaces the legacy selective-ModelJSON approach with an event-driven UE4SS Guardian.
- Allows the clean official PrimalPals package to remain complete, including female entries and individual variants.
- Protects manually selected T-Box appearances from delayed PalMagic mesh reapplication.
- Clears leftover Primal material overrides when restoring a T-Box appearance.
- Returns control to the same Primal variant saved for that individual when T-Box is removed.
- Preserves selected T-Box appearances through base use, companion use, world reloads, and full game restarts in validated scenarios.
- Includes 877 exact T-Box class-to-mesh mappings.
- Uses no continuous world scanner and keeps no persistent UObject cache.

OFFICIAL DOWNLOAD LINKS

Use the official releases below. The links open the Files pages used for the validated setup so the required version can be selected directly.

 

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

 

- PalMagic 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:

REQUIREMENTS

Required:

- The current Steam version of Palworld available when Version 1.2 RC1 was validated. Future game updates may require a compatibility update.
- A Palworld-compatible experimental UE4SS installation from the link above.
- PalMagic 0.2.3 from the link above.
- The clean, official, complete PrimalPals package and its official ModelJSON.
- T-Box Pal Dressing Facility All-in-One from the Nexus Mods link above.

This add-on was developed and tested against the T-Box All-in-One Nexus release. Split, partial, or independently repacked T-Box packages were not used during validation.

SCake, UniPalUI, and animation packs are optional and are not required for this compatibility add-on.

DynamicPals is not supported by this release. Version 1.2 is specifically designed around PalMagic.

INSTALLATION

1. Install a compatible experimental UE4SS release.
2. Install PalMagic 0.2.3. 
3. Install the clean, complete official PrimalPals package and official ModelJSON.
4. Install T-Box Pal Dressing Facility All-in-One.
5. Complete the upgrade cleanup described above if you previously used compatibility Version 1.0 or 1.1.
6. Close Palworld completely.
7. Extract this archive into the Palworld game root, normally:

   ...\SteamLibrary\steamapps\common\Palworld

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

The final module path must be:

   Pal\Binaries\Win64\ue4ss\Mods\PalMagicTBoxGuardianV10

If you participated in an earlier Guardian test, make sure older PalMagicTBoxGuardianV* test versions are disabled. Only V10 should have an active enabled.txt marker.

Start the game. PalMagic and the Guardian may take a few seconds to apply the final appearance after a Pal is loaded.

HOW TO USE IT

- Pals without a manually selected T-Box skin remain controlled by the official PrimalPals and PalMagic configuration.
- Apply or replace compatible T-Box skins normally through the Pal Dressing Facility.
- A selected T-Box skin remains active indefinitely on that individual Pal until you replace or remove it.
- Removing the T-Box skin returns control to the Primal variant already saved by PalMagic for that individual.

This preserves the intended combination:

PrimalPals as the diverse default world appearance system, with T-Box as a persistent and reversible appearance choice for individual Pals.

HOW IT WORKS

The Guardian reacts only when PalMagic applies a mesh. If the affected Pal currently owns a recognized T-Box appearance, the Guardian restores the exact T-Box mesh and clears incompatible leftover material overrides.

It does not continuously scan every Pal and does not keep live game-object references cached. No formal FPS benchmark has been completed, but the validated implementation is event-driven and only reacts to relevant PalMagic mesh events.

PalMagic remains responsible for the saved Primal baseline. The Guardian does not overwrite _PalMagicPersist_*.json.

VALIDATED BEHAVIOR

Controlled validation confirmed the complete apply, persist, remove, and exact-Primal-return cycle with Lovander and Nitewing, including world reloads and full executable restarts.

Additional successful technical or visual observations were recorded with Melpaca, Galeclaw, Mozzarina, and other classes.

The catalog contains 877 exact T-Box mappings. Every mapping has not been visually tested in every possible gameplay context, which is why this package is currently marked as RC1.

ANIMATION COMPATIBILITY

This package does not modify:

- Skeletons
- Animations
- Montages
- Cooked meshes or assets
- SCake
- Animation packs

Animations only work correctly when they were authored for a skeleton compatible with the currently selected model. An incompatible animation may still cause a T-pose, severe mesh deformation, or other animation problems independently of this add-on.

This package does not repair broken animation assets, convert or replace skeletons, modify SCake, or guarantee compatibility with every animation pack.

PALMAGIC PERSISTENCE AND WARNINGS

PalMagic stores per-individual appearance choices in:

   _PalMagicPersist_*.json

Do not delete this file during a normal update. Back it up before changing runtime frameworks or configuration files.

PalMagic "Skin mismatch found" notifications are separate persistence/configuration warnings. Version 1.2 does not suppress them. A delayed Primal application can also take a few seconds after an individual Pal loads.

RUNTIME LOG

Diagnostic events are written to:

   PalMagicTBoxGuardianV10\State\guardian_events.csv

The log is useful for compatibility reports. It can contain per-individual runtime identifiers, so review it before sharing it publicly.

UNINSTALLATION

1. Close Palworld.
2. Remove only this folder:

   Pal\Binaries\Win64\ue4ss\Mods\PalMagicTBoxGuardianV10

Do not remove the official PrimalPals or T-Box packages, and do not delete _PalMagicPersist_*.json unless you intentionally want to uninstall or reset those separate systems.

DOWNLOAD CONTENTS

Pal\Binaries\Win64\ue4ss\Mods\PalMagicTBoxGuardianV10\
README_EN.txt
LEIA-ME_PT-BR.txt
CHANGELOG.txt
VALIDATION_SUMMARY.md
VERSION.json
SHA256SUMS.txt

This download does not include:

- PrimalPals PAK or assets
- T-Box PAK or assets
- A replacement PrimalPals ModelJSON
- PalMagic or UE4SS
- SCake or UniPalUI
- Save files
- _PalMagicPersist_*.json
- _ManifestList.json

KNOWN LIMITS

- RC1 was validated on the current Windows/Steam game version available at the time of testing. Future Palworld updates may require a compatibility update. Xbox/Game Pass has not been validated.
- This is a PalMagic compatibility add-on, not a DynamicPals implementation.
- Animation and skeleton compatibility remain the responsibility of the selected models and animation packs.
- PalMagic "Skin mismatch found" warnings are outside this add-on's current scope.
- Although the catalog contains 877 exact mappings, not every appearance has been visually tested in every context.

CREDITS

All original models, textures, animations, 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.

Compatibility reports, bug reports, and controlled test results are always welcome. ❤️