Dynamic Skins

模组

· 作者 diacritics-owo

根据条件动态设置你的皮肤(目前仅限客户端)

0 本站下载 0 关注 更新于 2 年前

需要前置:Rhino、Fabric API

最新 1.2.1 · 1.20.1 · Fabric / Quilt

一键开服(送7天)

Dynamic Skins

根据条件动态设置你的皮肤(目前仅客户端生效)

入门指南

安装模组并启动游戏一次后,配置文件文件夹中会生成一个名为 dynamic-skins.js 的文件(如果你不知道它在哪里,Dynamic Skins 会在首次启动时的日志中贴心地告诉你文件路径)。

Dynamic Skins 提供了一个非常简单的 JavaScript API,允许你根据自定义的条件替换玩家皮肤。请注意,皮肤替换仅在 你的 客户端上生效。只有你能看到修改后的皮肤。 另外请注意,这只会改变游戏内的皮肤,因此皮肤选择器模组或标签页/社交互动界面不会受到影响。

示例配置:

if (
  data.target.player.profile.username === data.client.player.profile.username && // 仅替换你自己的皮肤 - 如果没有这一行,当你游泳时会发现所有人的皮肤都变了
  data.client.player.isTouchingWater &&
  data.client.player.isSwimming
) {
  skin.set("minecraft:textures/entity/zombie/drowned_outer_layer.png");
}

另一个例子:

// 当任何人手持三叉戟时,他们的皮肤将被更改
if (data.target.player.equipment.mainhand === "minecraft:trident") {
  skin.set("minecraft:textures/entity/zombie/drowned_outer_layer.png");
}

此配置将在每帧渲染每个玩家时执行一次。

配置缓存

配置在模组初始化时读取一次并缓存在内存中,对其进行的更新除非你运行 /dynamic-skins cache reload,否则不会被读取。或者,你可以打开 Dynamic Skins 的 Mod Menu 配置页面并点击“Reload configuration”。每次更新配置后,你必须重新加载才能使其生效。

错误处理

如果 Dynamic Skins 在执行配置时遇到错误,日志中将记录该错误以及一条表明 Dynamic Skins 已停止的消息。你可以运行命令 /dynamic-skins error 来显示该错误。要重新启动它,你必须运行 /dynamic-skins error reset 或打开 Mod Menu 页面(如果已经打开则重新打开)并点击现在可见的“Restart”按钮。请注意,重启将重新加载配置。

自定义皮肤

目前,Dynamic Skins 仅允许你通过资源位置(格式为 namespace:path/to/image.png)设置皮肤。要使用自定义皮肤,你可以创建一个 resource pack。

示例资源包结构:

|- pack.mcmeta
|- pack.png
|- assets
   |- skins
      |- my_skin.png

然后你可以使用 skin.set('skins:my_skin.png')。

高级用法

Dynamic Skins 允许你设置跨玩家和帧持久化的状态。这允许你通过循环不同的帧来制作动画皮肤。请注意,长周期的动画会导致帧率显著下降。

示例:

if (
  data.target.player.profile.username === data.client.player.profile.username
) {
  state.set(
    "cycle",
    ((state.get("cycle") === null ? 0 : state.get("cycle")) % 32) + 1
  );

  const s = state.get("cycle").toString();

  skin.set(`skins:skin${"0".repeat(2 - s.length)}${s}.png`);
}

上面的示例将使你的皮肤从 skins:01.png 到 skins:32.png 持续循环。

也可以不使用状态而通过 skin.value 来循环皮肤,但这会更加繁琐,并且仍然会对性能产生影响。

a gif of the skin cycling through different gradients

API

Skin

value: string

set(value: string): void


Data

client: ClientData

target: TargetData


ClientData

player: PlayerData


TargetData

player: PlayerData


PlayerData

profile: ProfileData

equipment: EquipmentData

isTouchingWater: boolean

isClimbing: boolean

isSwimming: boolean

isSneaking: boolean

isOnFire: boolean

isInLava: boolean

isSprinting: boolean


ProfileData

username: string


EquipmentData

head: string

chest: string

legs: string

feet: string

mainhand: string

offhand: string


State

set(key: string, value: any): void

get(key: string): any

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源