Notes

This is not a Geyser extention, do not place the *.jar there! The plugin is mainly built for Paper, but the Paper ecosystem (Bukkit/Spigot/Purpur) also works. Folia is untested and may break, if so.

What It Does

The plugin simply show a Bedrock player's skin on your server, as Floodgate is currently unreliable in doing its job.

How This Is Achieved

Grabs your raw skin file via GeyserMC's Global API and overrides the player's default skin with the corrected version upon certain actions modifiable via a config.

Why Use It

Lightweight plugin (Compatible with the Paper ecosystem, multiversion), plug-and-play; It has config, but all game-changer options are disabled by default.

Competitors (And Downsides)

BedrockSkinUtility: It can display 4D geometry and accessories, however; To even see it, you must install a client-side mod. Immediately eliminating usabilty.

GeyserSkinManager: It might work on really old Minecraft versions. As of now, it is entirely broken.

SkinsRestorer, Floodgate, and GeyserExtras: I've personally NEVER gotten these to even function. Honest!

Compatibility

DiscordSRV is the only known incompatibility, not that it prevents the plugin from functioning, but the updated skin will likely not show up in things like Discord-to-server bridge channels.

This is likely a non-issue to clients.

config.yml

# ---------------------------------------------------------------------------------------------------------------------------

# Bedrock Skin Restorer

# ---------------------------------------------------------------------------------------------------------------------------

fetch-retries: 2
# ^ How many times the plugin tries to fetch the Floodgate player's skin after the first attempt.
#   Higher values increase the chance that the skin will be fetched successfully,
#   (for example, if an arbitrary error occurs), but may also impact performance via API requests.

fetch-on-join: true
# ^ Whether to attempt to fetch the Floodgate player's skin upon joining.
 
 
fetch-on-character-refresh: false
# ^ Whether to fetch or re-fetch the Floodgate player's skin when respawning,
#   changing dimensions, or switching servers/hubs.

# ---------------------------------------------------------------------------------------------------------------------------

manual-fetch: false
# ^ Whether to allow the Floodgate players to fetch manually.
#   If *false*, ONLY OPs can run the command below.


manual-fetch-command: "/bedrockskin"
# ^ The command players can call to attempt to fetch their skin, customizable.


manual-fetch-command-java: "[Bedrock Skin Restorer] You are not a Floodgate user!"
# ^ Error message if a Java player tries to run the command


manual-fetch-command-noperm: "[Bedrock Skin Restorer] You don't have permission to execute this." 
# ^ Error message if they don't have permission for manual fetching


manual-fetch-command-error: "[Bedrock Skin Restorer] Failed to fetch skin from GeyserMC's API, try again later."
# ^ General errir message if it fails to fetch.

# ---------------------------------------------------------------------------------------------------------------------------

config-version: 1
# ^ DO NOT CHANGE UNLESS YOU REALLY KNOW WHAT YOU ARE DOING!!
#   Basic explanation: Tells the plugin in what context it should interpret the config file.