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 来循环皮肤,但这会更加繁琐,并且仍然会对性能产生影响。
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
你是这个资源的作者?登录后可认领此资源。
相似资源
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
查看物品与配方
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
AE2:一款流行的自动化与存储模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧