素材包规范

站上的包早就是一个样子了 —— 这页只是把它写下来。

为什么有这页

社区里的击杀图标包,十几个作者传的,结构其实高度一致 —— 一个压缩包 = 一整套风格,里面按 1~5 分等级。 这不是谁定的规矩,是大家自然而然做出来的。

但"没写下来"是有代价的:站上出现过 0 字节的压缩包被下载 21 次、 RAR 改名成 .zip 传上来、目录名编码不对导致用户在软件里 看到一串乱码风格名。这些在上传那一刻本来就能看出来。 所以这页要做两件事:把既有做法写清楚,以及说明站里会替你挡掉哪些明显的坑

击杀图标包

帆派助手里的分发单位是风格,不是单张图。一个 zip 装一整套, 用户拖进软件就能导入,不用手动解压。

标准结构(推荐)

# 软件里「导出风格包」出来的就是这个样子
我的图标包.zip
├── style.json      # 包信息:风格名、作者、版本、说明
├── 1.png  1.json   # 1 杀。png 是图集,json 是它的播放参数
├── 2.png  2.json
├── 3.png  3.json
├── 4.png  4.json
├── 5.png  5.json   # 5 杀 = ACE
├── 1hs.png 1hs.json # 可选:爆头专属图标
└── preview.png     # 可选

.png.json 必须成对, 缺一个这个等级就会被跳过。1~5 不必凑齐, 缺哪个等级用户就沿用他原来的图标。

套一层外壳目录也可以

我的图标包.zip
└── 星辰终结者/        # 只有一层、且所有文件都在里面时会自动剥掉
    ├── style.json
    ├── 1.png  1.json
    └── …
唯一要当心的一点
套了外壳时,style.json 要放进外壳里, 不能和外壳目录平级躺在压缩包最外层。 放错了外壳就剥不掉,整个包会认不出来。 站里发现这种情况会自动帮你挪回去,但自己打包时留意一下更省事。

等级命名对照表

文件(或文件夹)叫下面任意一种写法都认得出来,大小写不敏感:

等级可用的名字
1 杀1 kill1 1kill single 一杀 单杀
2 杀2 kill2 2kill double 二杀 双杀
3 杀3 kill3 3kill triple 三杀
4 杀4 kill4 4kill quad 四杀
5 杀 / ACE5 kill5 5kill ace penta 五杀 团灭

要做爆头专属图标,在上面任意写法后面接 hs / headshot / head / 爆头 即可, 例如 3hs.pngace爆头.gif

style.json

这个文件不是必需的,缺了也照样能导入。它决定的是用户在软件里看到的风格名

{
  "pack_version": 1,
  "name": "星辰终结者",     // 风格名。用户在软件里看到的就是它
  "author": "你的名字",
  "version": "1.0",
  "description": "一句话说明"
}

没有 style.json 时,风格名按这个顺序猜: 外壳目录名 → 压缩包文件名

站里会自动补
你没放 style.json 的话,上传时站里会按上面的规则 生成一份放进包里。这主要是为了治一个老毛病: 目录名用 GBK 编码打的包,用户导入后风格名会显示成 ╣┌╛ⁿ 这样的乱码 —— 名字一旦写进 style.json,就不会再有这个问题。 你自己写了的,站里绝不覆盖。

松散包也认(老素材不用重打)

从网盘下下来的素材多半不是上面那种成对格式,而是一堆图或者一堆目录。这些照样能导入:

1.gif  2.gif  3.gif  4.gif  ace.gif      # 动图
1.png  2.png  3.png  4.png  5.png        # 单张静态图
1/  2/  3/  4/  5/                       # 每个等级一个帧序列目录

代价是导入时要重新编码一次,画质会有损失。 手上有原始素材的话,建议先在软件里做好、再用「导出风格包」导出来传, 那样是零损耗的。

上传时会校验什么

原则是只拦明确坏的,其余只提示。"明确坏"只有一个含义: 帆派助手拿到这个包一定会失败。不够规范但能用的,站里一句话提醒你,然后照常上传。

会当场退回

0 字节的文件

等于没传成功。站上真出现过,还被下载了 21 次、每次都扣积分。

RAR / 7z / exe 改名成 .zip

换个扩展名不会让它变成 zip。请用压缩软件重新导出成真正的 ZIP。

压缩包本身损坏、或者里面一个文件都没有
包里有 ../ 这类越界路径

解压时会写到目标目录外面去,软件会整包拒绝。

击杀图标分类:一个能识别的等级素材都没有

装上去必然失败。对照上面的命名表改一下文件名就好。

只提示,不影响上传

缺了某几个等级

用户装上后,缺的那几级沿用他原来的图标。

某个等级只有半套(缺 .png 或 .json)

这一级会被跳过。

是松散包

导入时会重新编码,画质有损。

有 6 杀及以上的素材

当前版本只用 1~5 杀,多的会被忽略,不影响使用。

站里会自动帮你修

补上缺失的 style.json

顺带把乱码风格名的老问题一起治了。

把放错层的 style.json 挪进外壳目录

不然整个包会认不出来。

自动修改只在能让结果变好时才生效:改完会重新检查一遍, 结论没有变好就原样还回去。已有的 style.json 永远不会被覆盖。

体积与数量上限

压缩包大小30 MB
预览图JPG / PNG,100 KB 以内
包内文件数3200 个以内
解压后总大小512 MB 以内
单文件压缩比500 倍以内(防压缩炸弹)

后三条是帆派助手导入时的硬限制,站里照抄,免得你传上来了却装不进去。

其它分类

音效、语音、闪光等分类目前没有目录规范,压缩包里怎么放都行, 只要是真正的 ZIP、不是空的、路径正常就能传。 上面那几条"会当场退回"的通用检查对所有分类都生效。