1.1 万个数据文件加万张角色图:ArknightsGameResource 素材库里能取到什么
【免费下载链接】ArknightsGameResource明日方舟客户端素材项目地址: https://gitcode.com/gh_mirrors/ar/ArknightsGameResource
ArknightsGameResource 是明日方舟客户端素材仓库:干员头像、皮肤立绘、技能图标、敌人与物品图片,以及 gamedata 配置表、关卡 JSON、剧情文本全部随仓库提供,克隆下来即可直接使用,不需要自己从游戏包里提取。
素材库的总量与分工
仓库里可程序化利用的内容分两类:图片目录与 gamedata 数据目录。图片部分各目录的文件量级为:enemy 1748 张、skill 1668 张、portrait 1387 张、skin 1378 张、item 1306 张、map 3055 张、building_skill 544 张,加上 avatar 干员头像,图片总量过万。数据部分 gamedata 下有 5686 个 txt、4918 个 json、559 个 lua,合计 11163 个文件。
每个目录对应一种明确用途:avatar 是 180x180 的统一头像,portrait 是干员半身像(README 注明可用做十连抽卡素材),skill 是技能图标,item_rarity_img 里是按稀有度分级的物品框(sprite_item_r1 到 r6)。做机器人或 Web 查询工具时,按这个分工取图即可,不需要跨目录猜。
立绘命名规则:如何按干员 ID 定位任意皮肤
skin 目录的文件名遵循char_干员ID_角色代号_编号b.png的模式,角色代号末尾的数字表示精几(如skadi2是斯卡蒂精二)。后缀#数字是联动或主题皮肤的编号。例如:
skin/char_002_amiya_2b.png:阿米娅精二立绘,2072x2232skin/char_1016_agoat2_epoque#34b.png:能天使精二的联动皮肤,2538x1828
普通立绘普遍为 1024x1024 起,精二主立绘多在 1700~2500px 区间,陈的精二立绘skin/char_010_chen_2b.png为 1765x2030,可用于需要大幅面的展示场景;1024x1024 的规格则适合直接做角色卡片底图。
gamedata 里三类值得直接解析的文件
excel 目录是结构化配置的核心,常用表包括:char_master_table.json(干员主数据)、character_table.json(属性与技能挂载)、skill_table.json(技能数值)、stage_table.json(关卡 ID 到 levelId 的映射)、item_table.json(物品)、enemy_handbook_table.json(敌人图鉴)、gacha_table.json(卡池)。这些表都是标准 JSON,用 json 库加载即可,不需要额外解包。
levels 目录存放每个关卡的运行时数据,按主线、活动、集成战略分在 main、activities、rogue 等子目录,单个关卡 JSON 内含mapData(tile 网格、宽高)与routes(敌路起终点),是做关卡编辑器或敌路可视化的直接数据源。
story 目录按obt/main/level_main_00-01_beg.txt这类命名存放逐章节剧情文本,配合gamedata/excel/story_table.json可按关卡顺序拉取剧情全文。
用 levels_gen.py 从散表生成关卡清单
手动拼关卡数据最繁琐的一步是把 stage_table 里的关卡名和 levels 目录下的地图文件对应起来。仓库根目录的 levels_gen.py 已经实现了这条链路:它遍历stage_table.json、roguelike_topic_table.json、sandbox_perm_table.json和handbook_info_table.json中所有带 levelId 的条目,逐条读取gamedata/levels/下对应 JSON,提取地图宽高、每个 tile 的 buildableType 与 tileKey,并标记敌路起终点,最终输出levels.json。
根目录的 map.json 补充了另一半:key 是 levelId,value 是镜头坐标数组,用于在渲染关卡时决定默认视野。两者配合,等于拿到了一套免解包的关卡元数据库;levels_gen.py 本身也可以作为解析 gamedata 结构的参考实现。
同步素材与版权边界
根目录 version 文件当前内容为26-08-07-14-53-29_30b8f0,格式是时间戳加构建哈希,克隆或拉取时可据此判断素材新旧。file_dict.json 为 gamedata 下每个文件记录了 md5,做增量同步时对哈希即可,不必整体重拉。
版权上需要分清两层:仓库代码遵循 AGPL v3(见 LICENSE),但 README 声明所有静态资源版权归原作者,仅用于学习和交流,因此素材适合用于个人项目、学习研究与非商业展示,商用分发前需自行评估。
最小可执行动作:
git clone https://gitcode.com/gh_mirrors/ar/ArknightsGameResource克隆完成后,先打开 gamedata/excel/char_master_table.json 确认干员表结构,再按需进入 skin 或 gamedata/levels 取用。
【免费下载链接】ArknightsGameResource明日方舟客户端素材项目地址: https://gitcode.com/gh_mirrors/ar/ArknightsGameResource
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考