HelloSkin用户使用文档

Appearance

游戏内加载相关 ​

皮肤 Mod 常见 这不是我自己设置的皮肤 ​

这个问题通常出现在使用皮肤 Mod（如 CustomSkinLoader）加载皮肤的用户当中。

以 CustomSkinLoader 为例，它的默认加载顺序为 Mojang > HelloSkin。
所以，如果你的角色名与某位正版用户相同，那么 CustomSkinLoader 会优先加载那位正版用户的皮肤。

你可以在 新手指引 > 配置 CustomSkinLoader > 工作原理 章节中了解到 CustomSkinLoader 的工作流程和原理。

🛠️ 要解决此问题，可以参照 新手指引 > 配置 CustomSkinLoader > 手动修改配置文件 章节进行操作。

皮肤 Mod 常见 别人看不到我的材质 ​

通常，只有在多人游戏中使用皮肤 Mod 时才会遇到此问题。

在此情境下，只有 正确安装并配置 皮肤 Mod 后才能加载来自 HelloSkin 的材质。

🛠️ 如果你想让别人也看见你的材质，请让他们也正确安装并配置皮肤 Mod。

皮肤 Mod 常见 为什么我在网站上设置好了材质，但是在游戏中不显示 / 没更新？ ​

仅皮肤 Mod（如 CustomSkinLoader）

以下内容仅针对使用皮肤 Mod 加载材质的用户。

如果你使用外置登录加载材质，并遇到了如标题所说的问题，请阅读 下一条目👇。

需要重新进入游戏

当你在 HelloSkin 中更新了角色的材质，大多数的皮肤 Mod 都需要重新进入游戏。

只有这样，Mod 才会重新从 HelloSkin 获取角色的材质信息。

除此之外，皮肤 Mod 还可能会将你的材质信息进行缓存，这种情况请参考下方的解决方案。

与正版玩家重名的情况

如果有正版玩家的玩家名与你在 HelloSkin 上的角色名相同，在没有对 CustomSkinLoader 进行调整的情况下，你就会看到正版玩家的皮肤。

若正版玩家没有设置皮肤，你将会看到 Steve 或 Alex 的皮肤。这非常容易让人产生困惑和误解。

这种情况下，你应该参考上方的 # 皮肤 Mod 常见 这不是我自己设置的皮肤。

对于使用皮肤 Mod 加载材质的用户，这是个很常见的问题。大多数情况下，这个问题是以下四个原因引起的：

1. 你没有正确地安装和配置皮肤 Mod

🛠️ 解决方案：正确安装并配置 CustomSkinLoader。

你可以在 新手指引 > 配置 CustomSkinLoader 中学习如何正确配置皮肤 CustomSkinLoader；

2. 你安装的其它 Mod（如 NonUpdate / 不再有更新）干扰了皮肤 Mod 与 HelloSkin 之间的连接

🛠️ 解决方案：删除这些 Mod，或让它们绕过皮肤 Mod 与 HelloSkin 之间的连接。

可参考 登入失败：身份验证正在停机维护 的解决方案。

3. 你的材质被皮肤 Mod 缓存了 🎯 最为常见

🛠️ 解决方案：等待几分钟后再试。

如果还是没有更新，尝试清除皮肤 Mod 的缓存，即直接删除对应的文件夹：

  • CustomSkinLoader 的缓存文件夹为 .minecraft/CustomSkinLoader/caches
  • SkinPort 的缓存文件夹为 .minecraft/cachedImages
4. 你使用了 Alex 模型的皮肤，并且你的 Minecraft 版本低于 1.8

🛠️ 解决方案：

  • 对于 1.7.10，请使用 SkinPort 加载材质。SkinPort 在 1.7.10 上提供了对 Alex 模型的支持。
    参考 新手指引 > 配置 CustomSkinLoader > SkinPort 进行配置。
  • 对于更低版本，目前无解，你只能更换为 Steve 模型的皮肤。

外置登录 常见 单人游戏中可以正常显示皮肤，但在多人游戏中就不行 ​

这种情况往往在使用 Yggdrasil 外置登录进行服务器联机时出现。

由于 Minecraft 的材质加载机制，在多人游戏中，只有 在服务端正确配置了 Yggdrasil 外置登录 时，才能正常地在多人游戏中显示你在 HelloSkin 上设置的材质。

🛠️ 如果你有在服务器联机中加载材质的需求，并且你是服主，请在服务端正确配置 Yggdrasil 外置登录

😕 只是一个普通的服务器玩家？

如果你并不是服主或服务器管理员，你可能无法在服务端配置 Yggdrasil 外置登录。

这种情况下，你可以安装皮肤 Mod，虽然这样只能使你自己看到自己或他人的皮肤。

🛠️ 推荐你安装 CustomSkinLoader。此外，你可能还需要「手动修改配置文件」。

幸运的是，这份手册中详细介绍了 CustomSkinLoader 的配置方法。

外置登录 登入失败：身份验证正在停机维护 ​

请检查你是否安装了会阻止网络请求的 Mod，这会影响到外置登录的正常工作。

比较常见的 Mod 有：

🛠️ 通常来说，直接删除这类 Mod 是最简单快速的解决方案。但这违背了你安装此类 Mod 的初衷。

👇 此处特别列出上述 Mod 的 配置方法，以便在禁用更新的同时不影响 HelloSkin 外置登录的正常工作。

🛠️ NonUpdate

将 HelloSkin 的域名添加至 .minecraft/nu-whitelist.txt：

txt
minecraft.net
mojang.com
// ...

helloskin.cn
🛠️ NonUpdate Reloaded

将 HelloSkin 的域名添加至 .minecraft/config/nonupdate_reloaded.json:

jsonc
{
  // ...
  "whitelist": [
    "$eminecraftservices.com",
    "$emojang.com",
    "$eminecraft.net"
    "$ehelloskin.cn"
  ],
  // ...
}

外置登录 外置登录进入服务器时提示「无效的会话」/ accessToken 无效 ​

🛠️ 请先尝试退出游戏并在启动器中删除账号，然后重新登录。

外置登录 启动器下载 authlib-injector 失败 ​

此问题比较罕见，但一般都是网络原因引起的，请在启动器中更换下载源后再试。

如果你使用 HMCL 3，如果更换下载源后仍然报错，请手动下载 authlib-injector，将其放入 %appdata%\.hmcl\（Windows）或 $HOME/.hmcl/（Linux 和 macOS）中并重命名为 authlib-injector.jar。使用其他启动器的用户请咨询启动器作者。

皮肤 Mod 为什么我无法使用 Universal Skin Mod 加载材质了？ ​

由于一些技术上的原因，HelloSkin 自 2020 年 1 月起不再支持 UniSkinAPI。你仍然可以通过传统加载方式加载材质，但我们建议使用 Universal Skin Mod 加载材质的用户尽快更换到 CustomSkinLoader。

HelloSkin 支持 Minecraft 中国版（国服）吗？ ​

取决于你使用的皮肤 Mod 是否支持 Minecraft 中国版。

我们没有进行过测试，但从我们目前了解的信息来看，在对 Minecraft 中国版客户端进行一些特殊处理后，CustomSkinLoader 可以在 Minecraft 中国版中很好地运行。

我们不建议用户在 Minecraft 中国版中使用 HelloSkin，这可能给你带来被网易封禁的风险。我们不会对想要在 Minecraft 中国版中使用 HelloSkin 的用户提供技术支持，就算你是捐助者也一样。用户在 Minecraft 中国版中使用 HelloSkin 是用户的个人行为，与我们无关。