明日方舟素材获取指南:24,505 个客户端资源的分类、命名与取用
【免费下载链接】ArknightsGameResource明日方舟客户端素材项目地址: https://gitcode.com/gh_mirrors/ar/ArknightsGameResource
ArknightsGameResource 是明日方舟客户端素材的开源镜像仓库,面向需要角色立绘、图标和关卡数据做二次开发、数据整理或内容创作的开发者与玩家。全库共收录 24,505 个文件,覆盖干员立绘、半身像、头像、技能与道具图标、敌人素材、关卡地图及完整游戏数据;图片均为透明背景 PNG,立绘短边最大 2574 像素,数据以 JSON、Lua、TXT 三种格式提供。
资源盘点:10 类素材的数量与规格
按用途对全库清点如下(文件数取自当前仓库快照):
- skin:1378 张完整立绘,短边分辨率 325~2574 像素,其中 1111 张短边达到 1024 以上
- portrait:1387 张半身像,180x360 像素,适合做十连抽卡类界面
- avatar:2199 张头像,180x180 像素
- skill:1668 张技能图标;building_skill:544 张基建技能图标
- item:1306 张道具图标;item_rarity_img:6 张稀有度底框
- enemy:1748 张敌人立绘;map:3055 张关卡地图
- gamedata:11163 个数据文件(JSON、Lua、TXT)
立绘保留整幅原图,未做二次压缩,可直接进合成工程;半身像与头像已按 UI 常用尺寸裁好,拿到即用。
克隆仓库与目录结构
获取全部素材只需一条命令:
git clone https://gitcode.com/gh_mirrors/ar/ArknightsGameResource目录按资源类型划分,一级即可定位:
ArknightsGameResource/ ├── skin/ # 干员完整立绘(高清 PNG) ├── portrait/ # 干员半身像 ├── avatar/ # 干员头像 ├── skill/ # 技能图标 ├── building_skill/ # 基建技能图标 ├── item/ # 道具图标 ├── enemy/ # 敌人立绘 ├── map/ # 关卡地图 ├── gamedata/ # 游戏数据(JSON/Lua/TXT) ├── file_dict.json # 全库文件哈希清单 └── version # 素材版本戳需要哪类素材就进对应目录:抽卡界面用 portrait/,攻略站用 skin/ 加 gamedata/excel/。
文件命名规则:按编号快速定位干员
全库文件遵循统一命名,掌握规则后可跳过模糊搜索、直接拼路径取文件:
- 立绘/半身像/头像:char_编号_名字,如 char_002_amiya(阿米娅)、char_1012_skadi2(浊心斯卡蒂)
- 同一干员的第 1、2 套立绘以 _1b/_2b 区分:char_1019_siege2_1b.png、char_1019_siege2_2b.png
- 皮肤与联动图带活动标签加 #编号:char_017_huang_as#1b.png(周年庆)、char_1001_amiya2_sale#16b.png(联动)
- 技能图标:skill_icon_skchr_干员id_技能序号.png
- 敌人:enemy_编号_名字.png;地图:a001_01.png(章节-序号)
取文件的工作流由此变成两步:先从 gamedata/excel/char_master_table.json 或 file_dict.json 确认干员 id,再拼目录前缀。例如塞雷娅精二立绘就是 skin/char_1019_siege2_2b.png,不需要逐个打开目录翻找。
gamedata 数据文件怎么读
gamedata/ 共 11163 个文件,按子系统分子目录:
- excel/:核心配置表,character_table.json(干员属性)、char_master_table.json(天赋与技能)、stage_table.json(关卡索引)、gacha_table.json(抽卡)等
- levels/:3760 个关卡 JSON,含敌方布阵与地图布局
- story/:5686 个剧情文本 TXT
- battle/ 与 buff_table.json:战斗规则与 buff 模板
- [uc]lua/:游戏逻辑 Lua,含 hotfixes
- bakemuzzledata/:角色与敌人技能参数 JSON
仓库根目录另有三个派生文件:levels.json(由 levels_gen.py 生成的关卡瓦片网格)、map.json(关卡坐标)、file_dict.json(全库 MD5 清单,可做增量校验)。
数据均为结构化 JSON,json.load 即可进脚本。干员天赋表节选:
{ "master_radian_6": { "candidates": [ { "level": 1, "name": "历战精锐", "description": "在【岁的界园志异】中,电弧和其召唤物生命值+20%" } ] } }四个典型使用场景
- 抽卡模拟与干员图鉴:portrait/ 的半身像配 excel/character_table.json 的稀有度字段,可拼出完整干员卡片。
- 关卡攻略站:map/ 的地图 PNG 配 levels/ 的布阵数据,可渲染敌我站位。
- 数据工具:批量加载 excel/ 下的表再导出,做强度统计或配队校验。
- 二创与剪辑:skin/ 透明背景原图直接进 PSD 或视频工程,省去抠图环节。
更新机制:用 version 文件判断素材新旧
仓库根目录的 version 文件记录每次更新的戳(当前为 26-08-07-14-53-29_30b8f0)。本地执行git pull后,把新的 file_dict.json 与本地旧清单逐条比对哈希,差集就是本次新增或修改的素材,无需整库重拉。
下一步:从克隆到取用素材
- 执行上文 clone 命令,把仓库拉到本地;
- 按需求进目录:立绘去 skin/、半身像去 portrait/、数据去 gamedata/excel/;
- 用 char_编号_名字 规则拼文件名直接取图,或先按 file_dict.json 校验再批量处理。
两个高频问题一并说明:素材能否商用?仓库内素材版权归 Arknights/上海鹰角网络科技所有,仅限学习与交流用途,勿用于商业发布。立绘分辨率是否统一?不统一,短边从 325 到 2574 像素不等,用于网页前建议先按用途降采样。
【免费下载链接】ArknightsGameResource明日方舟客户端素材项目地址: https://gitcode.com/gh_mirrors/ar/ArknightsGameResource
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考