¶ 自定义物品图标
¶ 示例配置文件
该行配置文件位于服务端
plugins/GermPlugin/item文件夹内详见此处 >>> 传送门
# 在游戏中按 F3+H 然后鼠标放在物品上，可以看真实的物品名和ID
# 索引名 无意义随便设置
default_icon_item:
# 代表这是一个物品图标
type: 'icon'
# 当type设置为icon时路径格式
# 物品图标贴图在材质包中时省略路径assets/germmod/
# 物品图标贴图在萌芽缓存中省略路径GermCache/
path: 'textures/misc/logo.png'
############################################
# 物品图标在GUI的槽位中的偏移值 设置了可以让物品图标移动中心位置
offsetX: 0.0
offsetY: 0.0
offsetZ: 0.0
# 在GUI中缩放设置 不能小于 0
scale: 0.5
# 在手中大小设置 不能小于 0
size: 1
############################################
# 变换设置 可以调整各状态的位置
transformSetting:
#
# 可以通过拓展配置把图标变成各种各样的物品
# 当要做一个普通的图标时 可以删除下面的 拓展配置
# 拓展配置与上面的offsetX,offsetY,offsetZ,scale,size不会同时生效
# 图标在GUI中的拓展配置
gui:
#图标在GUI中的 偏移值 设置了可以让图标移动中心位置
offsetX: 0.0
offsetY: 0.0
offsetZ: 0.0
#在GUI中缩放系数 不能小于 0
scaleX: 0.5
scaleY: 0.5
scaleZ: 0.5
# 图标在第三人称左手手中的拓展配置
# 除此之外还支持 thirdPersonRightHand 第三人称右手
# firstPersonLeftHand 第一人称左手
# firstPersonRightHand 第一人称右手
# head 头上
# ground 在地上
thirdPersonLeftHand:
#在手中大小系数 不能小于 0
scaleX: 1
scaleY: 1
scaleZ: 1
#在手中时的旋转X
rotateX: 300
rotateY: 300
rotateZ: 300
#偏移量
offsetX: 0.0
offsetY: 0.0
offsetZ: 0.0
############################################
# 匹配该模型的条件
matchCondition:
# 匹配该模型的材质要求
# 格式 物品名:子ID 或者 物品ID:子ID
# 某些物品会因为客户端的英文名字和服务端的不同报错，推荐填数字ID
type: 'DIAMOND_SWORD'
#匹配
# 当描述或者名字含有下方字符串时会替换到设置的模型
match: "测试武器"
# 当装备的名字等于该值的时候匹配模型
name: "测试武器"
# 当装备的名字存在该字符时会匹配
name2: "武器"
# 当装备的某行描述等于设定的值时匹配模型
# 格式为：行号<->值 (行号从0开始为第一行)
lore:
- "2<->&5&o测试武器"
- "7<->测试武器"
# 当装备的某个nbt等于设定的值时匹配
nbt:
- "nbtKey1<->测试武器"
- "parentNbt.childNbt<->测试武器" #当有多层NBT时用.隔开
# nbt1不等于测试武器时匹配成功
not_nbt:
- "nbt1<->测试武器"
# 脚本匹配 入参ItemStack 需要返回bool return true为该条件通过
script: |
var name = Utils.getItemName(ItemStack);
if(name.contains("+1")){
return true;
}
return false;
# 匹配时需要满足的表达式 更多表达式请看wiki https://wiki.germmc.com/gui/arithmetic.html
expressions:
- "%player_level% > -1"
# 匹配手持该物品的玩家是否正在钓鱼
- "str(%matchEntity_fishing%,true)"
# 匹配手持该物品的生物是否拥有权限 germ_item_1 (需要注意的是，如果是掉落在地面上的道具，默认的matchEntity是玩家自己，这个表达式会永久不通过)
- "str(%player_has_permission_germ_item_1:#matchEntity_name#%,true)"
# 匹配手持该物品的生物是否是自己 并且是第一人称 其他人称 FIRST_PERSON THIRD_PERSON THIRD_PERSON_REVERSE
- "str(%player_name%,%matchEntity_name%) && str(%client_person%,REAL_FIRST_PERSON)"
¶ 自定义物品图标演示教程
¶ 第一步，准备贴图文件
先准备一张需要替换的贴图，并放入textures\icon\item\wiki文件夹内
贴图文件夹路径可以自行修改设置
¶ 第二步，添加自定义物品图标配置
icon教程案例:
#代表这是一个图标 (图标也可以在 icon 文件夹中添加，不过未来可能会废弃icon文件夹，推荐在这里添加icon)
type: 'icon'
#当type设置为armour时路径格式
# 图标贴图在材质包中时省略路径assets/germmod/
# 图标贴图在萌芽缓存中省略路径GermCache/
path: 'textures/icon/item/wiki/1.png'
#图标在GUI中的 偏移值 设置了可以让图标移动中心位置
offsetX: 0.0
offsetY: 0.0
offsetZ: 0.0
#在GUI中缩放设置 不能小于 0
scale: 1
#在手中大小设置 不能小于 0
size: 1
#变换设置 可以调整各状态的位置
transformSetting:
#
# 可以通过拓展配置把图标变成各种各样的物品
# 当要做一个普通的图标时 可以删除下面的 拓展配置
# 拓展配置与上面的offsetX,offsetY,offsetZ,scale,size不会同时生效
# 图标在GUI中的拓展配置
gui:
#图标在GUI中的 偏移值 设置了可以让图标移动中心位置
offsetX: 0.0
offsetY: 0.0
offsetZ: 0.0
#在GUI中缩放系数 不能小于 0
scaleX: 1
scaleY: 1
scaleZ: 1
# 图标在第三人称左手手中的拓展配置
# 除此之外还支持 thirdPersonRightHand 第三人称右手
# firstPersonLeftHand 第一人称左手
# firstPersonRightHand 第一人称右手
# head 头上
# ground 在地上 thirdPersonRightHand:
rotateY: 90
rotateZ: 40
offsetY: -4.5
offsetZ: 0.5
firstPersonRightHand:
rotateY: 90
rotateZ: 70
offsetY: -1
offsetX: 2
thirdPersonLeftHand:
rotateY: 90
rotateZ: 40
offsetY: -4.5
offsetZ: 0.5
firstPersonLeftHand:
rotateY: 90
rotateZ: 70
offsetY: -1
offsetX: -2
#匹配的条件
matchCondition:
#匹配该模型的材质要求
#格式 物品名:子ID 或者 物品ID:子ID
#某些物品会因为客户端的英文名字和服务端的不同报错，推荐填数字ID
type: '268'
#匹配
# 当描述或者武器名字含有下方字符串时会替换到设置的模型
match: "icon教程案例"
¶ 第三步，游戏内获取物品
根据示例，进入游戏中，拿一把木剑，设置名字或者添加lore “icon教程案例”
提示：在transformSetting节点下的选项设置注意分辨是第几人称和左右手，根据实际情况适当调整