Skip to content

SkinRestorer

akanoka.fr edited this page Feb 8, 2026 · 2 revisions

🎭 SkinRestorer Implementation

This page details how the Possessor mod interacts with the SkinRestorer API to enable perfect visual identity theft when possessing another player or an NPC.


⚙️ Technical Overview

The implementation relies on an Event Listener system. Once a possession is validated:

  1. The mod retrieves the UUID or name of the targeted host.
  2. A request is sent to the SkinRestorer API to fetch the associated skin.
  3. The "Possessor's" skin is updated in real-time without requiring a reconnection.

🛠️ System Requirements

For the implementation to work correctly, ensure the following are installed on your server:

  • SkinRestorer Mod (Version 2.5.0 or higher recommended).
  • Possessor Mod (Latest version).
  • A Forge environment with the compatible bridge.

⚠️ Common Issues (Troubleshooting)

Symptom Probable Cause Recommended Solution
Skin remains unchanged SkinRestorer API not detected Verify that the plugin/mod is correctly loaded in your logs.
Display Delay Mojang Server Latency The change may take 1 to 3 seconds depending on the connection.
"Rate Limit" Error Too many frequent changes Limit possession frequency (avoid "spamming" host swaps).
Black or Default Skin Invalid Host UUID Ensure the host has a valid skin or use a default fallback skin.

⬅️ Back to Home

Clone this wiki locally