aklive2d

A project that builds showcase webpage for Arknights Live2D-equipped operators. Showcase webpage can be used as a wallpaper for Wallpaper Engine on Windows or Plash on macOS (not tested).

Upcoming Updates

Version: 2023 Summer Fest

~~Eyjafjalla the Hvít Aska~~
~~Holiday / Gavial the Invincible~~
~~Summer Flowers / Goldenglow~~

Softwares

For Windows users: Use Wallpaper Engine or other softwares that support using webpage as desktop wallpaper.
For macOS users: Use Plash, however, I don't have macOS machine, so your mileage may vary.
For Linux users: You power user should be able to find your solutions!

Supported Operators

A list of supported operators can be found at Directory page.

Usage

Command Line Tool

$ npm run generate {operator_name}
To generate operator assets for showcase page

$ npm run dev {operator_name}
Live showcase page server for development

$ npm run build {operator_name}
Build showcase webpage for an operator

$ npm run build-all
To generate all operator assets for showcase page

$ npm run init {operator_name}
To initialize folder and config file for an operator

$ npm run readme {operator_name}
To add operator info to README.md

$ npm run directory
To generate directory.json

$ npm run charword
To generate the latest charword_table.json

Webpage & JavaScript

Add query string settings to bring up the settings panel to adjust your settings. Then use appropriate JavaScript code to load your settings

settings.setFPS(integer) // set FPS
settings.setLogoDisplay(boolean) // display logo or not
settings.setLogoRatio(float) // the ratio of the logo
settings.setLogoOpacity(float) // the opacity of the logo
settings.setLogo(url) // change the logo, url: image url, removeInvert: boolean
settings.resetLogoImage() // reset to the default logo
settings.setDefaultBackground(url) // change the default background, url: image filename from `background` folder
settings.setBackgoundImage(url) // change the background, url: image url
settings.resetBackground() // reset to the default background
settings.positionPadding("left", integer) // left padding
settings.positionPadding("right", integer) // right padding
settings.positionPadding("top", integer) // top padding
settings.positionPadding("bottom", integer) // bottom padding
settings.positionReset() // reset the position

settings.open() // open settings panel
settings.close() // close settings panel
settings.reset() // reset settings

Config

General Config

folder: 
  operator: ./operator/ # folder for operator assets
  release: ./release/ # folder for released showcase page
operators:
  chen: !include config/chen.yaml # include the config for the operator under folder `config/chen.yaml`
  dusk: !include config/dusk.yaml
  dusk_everything_is_a_miracle: !include config/dusk_everything_is_a_miracle.yaml
  ling: !include config/ling.yaml
  nearl: !include config/nearl.yaml
  nian: !include config/nian.yaml
  nian_unfettered_freedom: !include config/nian_unfettered_freedom.yaml
  phatom_focus: !include config/phatom_focus.yaml
  rosmontis: !include config/rosmontis.yaml
  skadi: !include config/skadi.yaml
  skadi_sublimation: !include config/skadi_sublimation.yaml
  w: !include config/w.yaml
  w_fugue: !include config/w_fugue.yaml
  specter: !include config/specter.yaml
  gavial: !include config/gavial.yaml
  surtr_colorful_wonderland: !include config/surtr_colorful_wonderland.yaml
  lee_trust_your_eyes: !include config/lee_trust_your_eyes.yaml
  texas_the_omertosa: !include config/texas_the_omertosa.yaml
  nearl_relight: !include config/nearl_relight.yaml
  rosmontis_become_anew: !include config/rosmontis_become_anew.yaml
  passager_dream_in_a_moment: !include config/passager_dream_in_a_moment.yaml
  mizuki_summer_feast: !include config/mizuki_summer_feast.yaml

Operator Config

link: chen # the link to access showcase page for this operator
type: operator # operator live2d or skin live2d
date: 2021/08 # release date
title: 'Arknights: Ch''en/Chen the Holungday - 明日方舟：假日威龙陈' # page title
filename: dyn_illust_char_1013_chen2 # live2d assets name
logo: logo_rhodes_override # operator logo
fallback_name: char_1013_chen2_2 # fallback image name
viewport_left: 0 # live2d view port settings
viewport_right: 0
viewport_top: 1
viewport_bottom: 1
invert_filter: false # operator logo invert filter

LICENSE

The LICENSE file applies to all files unless listed specifically.

LICENSE_SPINE file applies to following files including adapted code for this repo:

src/libs/spine-player.css
src/libs/spine-player.js

all files under operator folder and its sub-folders

Instructions on Extracting In-Game Assets

I'm still struggling to find a command-line tool to extract in-game assets. But AssetRipper seems to have a command-line interface, I'm too lazy to have a deeper inverstigation.

Assets Name	Location	Type
Logos	spritepack/ui_camp_logo_h2_0.ab	Sprite
Logos for collaboration	spritepack/ui_camp_logo_h2_linkage_0.ab	Sprite
Logo Mapping	gamedata/art/handbookpos_table.json³	TextAsset
Dynaimc Character	arts/dynchars/	Texture2D & TextAsset
Static Image	Operator: chararts/ ; Skin: skinpack/	Texture2D
Background	arts/ui/homebackground/wrapper/	Sprite
Voice Clips	audio/sound_beta_2/voice{_*}/	AudioClip
Voice Lines³	gamedata/excel/charword_table.ab	TextAsset
Portrait Images¹	arts/charportraits	Texture2D
Home Music²	audio/sound_beta_2/music	AudioClip

¹: portrait_hub is required to locate the image

²: gamedata/excel/display_meta_table.json->homeBackgroundData³ and gamedata/excel/audio_data.json³ is required to locate the music.

³: Data is encryped, decryped version can be obtained from ArknightsGameData for the Chinese version and Kengxxiao/ArknightsGameData_YoStar for other regions.

AvoidantPerDis / aklive2d