Bedrock Skin Restorer [GeyserMC/Floodgate]

Notes

The plugin is mainly built for Paper. (Paper/Bukkit/Spigot/Purpur/Folia), this is not a Geyser Extention.

4D geometry or custom player model support can't and won't be added. It is not possible without server-side (on Forge, NeoForge, Fabric, Quilt servers) or client-side (Forge, NeoForge, Fabric, Quilt) mods anyway

What It Does, How This Is Achieved

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

Grabs your raw skin file via GeyserMC's Global API (Within the Skins Sub-article) 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)

SkinsRestorer: Requires manually assigning skins, which involves getting your hands on their skin file. Immediately returns to default skin if the player rejoins. ** BedrockSkinUtility**: It can display 4D geometry and accessories, however; To even see it, you must install a client-side mod. Immediately eliminating usabilty. This also entirely relies on my plugin being installed anway. ** GeyserSkinManager**: It might work on really old Minecraft versions. As of now, it is entirely broken.

GeyserExtras, Floodgate (+ auth option in Geyser config): Doesn't work at all. Despite claiming it does.

(In)Compatibility

DiscordSRV: 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.

SkinsRestorer: Performs a risky and likely incompatible method of teleporting a player character to the void to refresh or load a skin. consider increasing the skin applying delay if this happens.

config.yml

(May be outdated, or show newer info for a newer version of the plugin)

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

# 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-join-delay-ticks: 15
# ^ How long to wait after a Floodgate player joins before attempting to fetch/apply their skin.
#   20 ticks is roughly 1 second. Keeping this delayed gives Geyser/Floodgate time to finish
#   the Bedrock player's initial spawn and session setup. Use alongside compatibility-mode when needed.
 
 
fetch-on-character-refresh: false
# ^ Whether to fetch or re-fetch the Floodgate player's skin when respawning,
#   changing dimensions, or switching servers/hubs.

fetch-on-character-refresh-delay-ticks: 15
# ^ How long to wait after a Floodgate player "refreshes" before attempting to fetch/apply their skin.
#   20 ticks is roughly 1 second. Keeping this delayed gives Geyser/Floodgate time to finish
#   the Bedrock player's initial spawn and session setup. Use alongside compatibility-mode when needed.

compatibility-mode:
  skins-restorer: false
  bedrock-auto-auth: false
# ^ Only enable if you experience issues, these are experimental patches.
#   Do not add an entry, it does nothing.
#   SkinsRestorer - Skips automatic join/respawn skin fetches when SkinsRestorer is already busy.
#   Bedrock Auto-Auth - Checks that Bukkit still considers the player entity valid.

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

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 command!" 
# ^ 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 error message if it fails to fetch.

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