七类时装部位：head、chest、legs、feet、back、off_hand、balloon；每个部位同一时间选择一件时装。
FotiaCosmetic
用真实物品与虚拟投影统一管理时装、背饰、气球和武器皮肤。
FotiaCosmetic 是面向 Paper / Leaf 的时装与武器皮肤系统。它支持七类时装部位、九类武器、ACTUAL / VIRTUAL / HIDDEN 三种显示模式、按服务器和世界覆盖的显示规则、玩家拥有权、限时发放、独立武器菜单，以及 SQLite、MySQL、MariaDB 跨服持久化。
- 当前版本
- v1.0.0
- 服务端
- Paper / Leaf 1.21.4+（api-version 1.21.4）
- Java
- Java 21+
- 配置章节
- 5 类
01
WHAT IT DOES
这个插件能做什么
九类武器皮肤：sword、bow、axe、pickaxe、crossbow、mace、spear、trident、shield。
ACTUAL 把皮肤写入实际物品，VIRTUAL 只投影客户端外观，HIDDEN 在指定服务器或世界保留数据但停止显示。
显示规则按世界、服务器、全局依次回退，同一数据库可让不同子服采用不同外观策略。
主菜单只显示玩家拥有的时装；武器皮肤使用独立菜单，武器类型与皮肤列表都支持翻页。
背饰与气球使用 PacketEvents 虚拟实体、视距过滤和增量移动；数据库加载与保存异步执行。
永久、限时、离线与全体玩家发放共用同一拥有权服务，并提供独立 Java API 供商城和任务插件调用。
02
REQUIREMENTS
安装前需要什么
PacketEvents 2.13.x（plugin.yml 中硬依赖名为 packetevents）
硬依赖缺失时插件不会加载。请先安装依赖，再放入本插件 JAR。
CraftEngine 26.8
只在需要对应功能时安装；没有这些插件时核心功能仍可使用。
03
CONFIGURATION MAP
配置从哪里开始
主配置 config.yml
服务器标识、默认语言、数据库、资料保存、渲染距离与 GUI 防抖。
打开教程 →显示规则 display-rules.yml按全局、服务器和世界配置普通部位与武器的 ACTUAL、VIRTUAL、HIDDEN 模式。
打开教程 →时装目录 cosmetics/*.yml时装和武器皮肤的目标、分类、物品来源、模型、偏移、兼容材质与气球绳端。
打开教程 →菜单 menus/*.yml普通时装与武器皮肤的字符布局、分类、分页、状态物品和控制按钮。
打开教程 →语言 languages/*.yml九种内置语言的消息、命令帮助、分类名、武器名、菜单状态和反馈。
打开教程 →按目标阅读先选择你要修改的功能，再进入对应配置页；无需从第一份文件逐行读到最后一份。