Bedrock Skin Restorer [GeyserMC/Floodgate]

Minecraft 版本： 24w18a 24w19a 24w19b 24w20a 24w21a 24w21b 1.21-pre1 1.21-pre2 1.21-pre3 1.21-pre4 1.21-rc1 1.21 1.21.1-rc1 1.21.1 24w33a 24w34a 24w35a 24w36a 24w37a 24w38a 24w39a 24w40a 1.21.2-pre1 1.21.2-pre2 1.21.2-pre3 1.21.2-pre4 1.21.2-pre5 1.21.2-rc1 1.21.2-rc2 1.21.2 1.21.3 24w44a 24w45a 24w46a 1.21.4-pre1 1.21.4-pre2 1.21.4-pre3 1.21.4-rc1 1.21.4-rc2 1.21.4-rc3 1.21.4 25w02a 25w03a 25w04a 25w05a 25w06a 25w07a 25w08a 25w09a 25w09b 25w10a 1.21.5-pre1 1.21.5-pre2 1.21.5-pre3 1.21.5-rc1 1.21.5-rc2 1.21.5 25w14craftmine 25w15a 25w16a 25w17a 25w18a 25w19a 25w20a 25w21a 1.21.6-pre1 1.21.6-pre2 1.21.6-pre3 1.21.6-pre4 1.21.6-rc1 1.21.6 1.21.7-rc1 1.21.7-rc2 1.21.7 1.21.8-rc1 1.21.8 25w31a 25w32a 25w33a 25w34a 25w34b 25w35a 25w36a 25w36b 25w37a 1.21.9-pre1 1.21.9-pre2 1.21.9-pre3 1.21.9-pre4 1.21.9-rc1 1.21.9 1.21.10-rc1 1.21.10 25w41a 25w42a 25w43a 25w44a 25w45a 25w46a 1.21.11-pre1 1.21.11-pre2 1.21.11-pre3 1.21.11-pre4 1.21.11-pre5 1.21.11-rc1 1.21.11-rc2 1.21.11-rc3 1.21.11 26.1-snapshot-1 26.1-snapshot-2 26.1-snapshot-3 26.1-snapshot-4 26.1-snapshot-5 26.1-snapshot-6 26.1-snapshot-7 26.1-snapshot-8 26.1-snapshot-9 26.1-snapshot-10 26.1-snapshot-11 26.1-pre-1 26.1-pre-2 26.1-pre-3 26.1-rc-1 26.1-rc-2 26.1-rc-3 26.1 26.1.1-rc-1 26.1.1 26w14a 26.2-snapshot-1 26.1.2-rc-1 26.1.2 26.2-snapshot-2 26.2-snapshot-3 26.2-snapshot-4 26.2-snapshot-5 26.2-snapshot-6 26.2-snapshot-7 26.2-snapshot-8 26.2-pre-1 26.2-pre-2 26.2-pre-3 26.2-pre-4 26.2-pre-5 26.2-pre-6 26.2-rc-1 26.2-rc-2 26.2

平台： bukkit folia paper purpur spigot

标签： management optimization utility

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!

(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

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

# 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." 
# ^ 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: 2
# ^ 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.