Arknights Story Reader

A simple python program that help you convert Arknights raw story data into other readable format.

You can find raw story data in Kengxxiao/ArknightsGameData

CN/JP/EN/KR server files tested

Only support story. Guides, tutorial and pop-up msg in battle are not supported yet.

usage:

New: Method 1 (Recommended, require openpyxl module)

py xlsxconvert.py [-h] [-C] [-c] path

Convert arknights story raw data into xlsx file.

positional arguments: path The file path or folder path of raw story files

optional arguments:

-h, --help show this help message and exit

-C, --Character (may not work properly, submit an issue if you run into exception!) Show Character CG file name

-c, --comment Show Code Comment in raw story file

Require openpyxl module, if you haven't installed openpyxl, run the following command first

pip install openpyxl

====

Method 2 (No extra module required, deprecated)

py csvconvert.py path [path ...]

Convert arknights story raw data into csv file.

positional arguments: path The filepaths or folder of raw story file, separate with space, if the path is folder path, it will try to convert all .txt files into csv

v1.8.6

Fix the issue that the regex can't match other Character syntax

Change the CG source of csvconvert.py to aceship toolbox

v1.8

Fix the issue that the regex misread BackgroundTween as an image type (Credit: Biscuits#4183)

Add single file support to xlsxconvert.py

Add optional args to show Character CG file names or Code Comment in raw story files (Some comments in CN chapter 7 are very interesting you know)

v1.7

Fix the issue that a syntax error in raw story txt cause an unhandled exception

Now automatically record all characters' name appear in the whole textsheet and append them to the end of the textsheet named "Characters" (Method 1 only)

v1.6

New command to convert all raw story files into one xlsx file.

Now automatically link the image and background to the Aceship Toolbox CG Gallery

v1.5

Now automatically link the image and background to the mooncell wiki (doesn't support for earlier event like Grani)

Now support folder path, which will convert all .txt file in the folder

v1.4

Fix some issues

v1.3

Now support multiple arguments

v1.2

Fix the encoding issue, now will force encode with utf-8 if UnicodeEncodeError orrured, so there may have some decoding problem when open the csv files with Microsoft Excel.

v1.1

Fix the regex to fully match the image in EN server

v1.0 CSV Convertor

initial release

To-do list: (maybe never)

• json convertor
• link the cg or background image to Mooncell Wiki or Aceship Toolbox
• Prettify the output into html or anything looks better.