离线皮肤补丁

离线皮肤补丁

对于离线账户玩家,皮肤和披风在多人游戏中正常显示和切换

装饰

概述

StraySkins 是一款专为离线账户环境设计的皮肤管理模组。它能让离线账户玩家像正版账户玩家一样拥有并切换自己的皮肤和披风,并在多人服务器上正确地向自己和他人展示。

使用方法

  1. 将你的皮肤/披风图片放入模组文件夹中:

    • 客户端:客户端实例/strayskins/skin/(皮肤)、客户端实例/strayskins/cape/(披风),加入服务器时自动上传

    • 服务端:服务器目录/strayskins/skin/(皮肤)、服务器目录/strayskins/cape/(披风),对所有玩家可见

    • 文件名必须与你的游戏内名称一致,例如 Steve.png(支持中文及其他字符)

  2. 在游戏中运行 /strayskins 自动加载你自己的皮肤和披风。

  3. 如果你的启动器已设置皮肤,加入服务器时会自动生效。建议使用 HMCL 启动器设置外观后再启动。

命令预览

  • /strayskins:加载自己的皮肤和披风(skin/<玩家名>.png + cape/<玩家名>.png)

  • /strayskins skin:加载自己的皮肤(skin/<玩家名>.png)

  • /strayskins skin <文件>:加载指定皮肤文件

  • /strayskins cape:加载自己的披风(cape/<玩家名>.png)

  • /strayskins cape <文件>:加载指定披风文件

  • /strayskins any:随机加载皮肤和披风

  • /strayskins any skin:随机加载皮肤

  • /strayskins any cape:随机加载披风

  • /strayskins clear [skin|cape]:清除皮肤、披风或全部

  • /strayskins list:列出所有可用文件

  • /strayskins player:列出历史玩家及其对应的皮肤/披风文件状态

  • /strayskins player <玩家>:加载某位历史玩家的外观

  • /strayskins mojang [玩家名]:从 Mojang 获取正版玩家的皮肤

  • /strayskins body:切换宽/窄模型

  • /strayskins fake <假玩家> ...:管理单个假玩家的外观

  • /strayskins fake @a ...:批量管理所有假玩家的外观(需要管理员权限)

  • /strayskins help:显示所有命令的使用说明

加入时自动加载

当新玩家首次加入时,模组会自动加载与玩家名称匹配的皮肤/披风文件;如果没有匹配的文件,则随机加载外观。已设置外观的玩家在重新加入服务器时会从自己的玩家文件夹中自动恢复外观;如果外观文件缺失,聊天栏中会显示提示。

支持单人游戏、局域网游戏和专用服务器。

文件夹结构

strayskins/ 文件夹:

  • skin/:皮肤库。所有可用的皮肤文件都放在这里;皮肤命令(skin <文件>、随机皮肤)会从该文件夹中选取文件。skin/<玩家名>.png 是你自己的皮肤。

  • cape/:披风库。cape/<玩家名>.png 是你自己的披风。

  • player/:玩家外观存档。每个玩家一个子文件夹(player/<玩家名>/),包含 skin.pngcape.png 和存档文件 <玩家名>.json;重新加入时从该文件夹恢复外观。

  • player.txt:玩家名与 UUID 的映射,用于记录历史玩家。

  • fake/:假玩家外观文件夹(需要安装 FakePlayer 模组)。

    • fake/skin/:假玩家皮肤库

    • fake/cape/:假玩家披风库

    • fake/fake.txt:假玩家名与 UUID 的映射

注意事项

  • 客户端和服务端必须同时安装(且版本匹配)才能完整显示皮肤。

  • 皮肤文件:尺寸为 64 的倍数且为 1:1 正方形(如 64x64、128x128、256x256...),使用带透明背景的 PNG 图片。

  • 披风文件:尺寸为 64x32 的倍数,2:1 横向矩形(如 64x32、128x64...)。

  • 服务端皮肤/披风文件不应超过 4MB;建议客户端文件不超过 1.4MB。

  • 服务器文件夹中的皮肤对所有玩家可见;客户端文件夹仅供自己使用(加入时上传)。

  • 与 FakePlayer 模组配合使用时,假玩家功能完整可用;未安装时,正常皮肤功能不受影响。