extract and reinject files into Witch of the Holy Night (Steam)
Requires python >= 3.10, numpy, Pillow, zlib.
imagequant is necessary on some ciconstances to quantize some images before
injection.
.hfa archive files contents are accessed through HfaArchive objects.
import os
from mahoyo_tools import hfa
GAME_DIR = "path/to/steamapps/common/WITCH ON THE HOLY NIGHT"
hfa_name = "data00000"
hfa_path = os.path.join(game_dir, f"{hfa_name}.hfa")
archive = hfa.HfaArchive(hfa_path)An optional mode parameter can be set to 'rw' in the HfaArchive
constructor to automatically replace the original file content when the archive
is closed. Otherwise, the original file will stay untouched unless specifically
written to.
archive = hfa.HfaArchive(hfa_path, 'rw')To access the content, open the archive using either the open() method or
the with syntax.
Once all accesses to the archive content is complete, use the close() method
to close the file or exit the with block.
If the mode parameter in the constructor was set to 'rw', then the original
file content is replaced when closing the file.
An opened archive maps entry names or indices to HfaArchiveEntry objects
that hold entry info and are used to access entry data.
entry = archive[entry_name]
# or
entry = archive[index]Enties can be used as files to access the entry data, through one of the following methods :
read(),write(),seek()andtell()that reproduce the behaviour of python'sio.BufferedRandomobjects;dataproperty to get and set all the data bytes of the entry;to_file()andfrom_file()to load in / from a file all the entry data bytes;extract()andinject()that decompress the content of the entry to a file, or compress the content of the file to the entry bytes (c.f. below).
Contents of an archive entry can be extracte or injected using the extract()
and inject() methods.
When possible, the extract() method decompresses the content of the archive
entry to the destination file passed in parameter.
The inject() method compresses the content of a file back to the archive
entry.
Some limitations apply, depending on the file format :
mzpimages may require theimagequantpython package to reduce the palette sizeto 256 colors before injection;ctdscripts are decompressed, but are reinjected as-is, as the LenZuCompressor compression algorithm has not yet been efficiently re-written (this should not impact the game);ccitfont files are not transformed to an other format. use theFontclass (described below) to modify the font files;chsfiles cannot be decompiled yet, and are therefore extracted and re-injected as-is;
MZP images can be injected with no compression (resulting in a fast injection
but a very high file size), or with higher compression. Specify the parameter
compression_level = 0 | 1 | 2 in the inject method to set the compression
level to 0 (literal, no compression), 1 (literal + RLE) or 2 (literal + RLE +
BACKREF). Default value is 0 (no compression)
The fonts in the game are separated in multiple files and formats :
mzpimages where the characters are drawnccitfiles that list all the characters, their position in the images and their dimensions
mzp font images can be generated properly using the font.svg file included
in the repository. A guide to generate the images using Inkscape is included in
it.
Once the images are generated, inject them in the game files using the script:
from os import path
from mahoyo_tools import hfa
from PIL import Image
game_dir = "path/to/steamapps/common/WITCH ON THE HOLY NIGHT"
input_dir = "path/to/png/files"
font_images = [
"FONT_en_H00", # page 1 of standard characters
"FONT_en_H01", # page 2 of standard characters
"FONT_en_font3_00", # font used in nz (special) chapters
"FONT_en_italic_00" # italic characters used in the game
]
# open the fonts archive
with hfa.HfaArchive(path.join(game_dir, "data00100.hfa"), 'rw') as hfa :
# iterate over font file names
for file_name in font_images :
# replace the image in the archive
png_path = path.join(input_dir, f"{file_name}.png")
hfa[f"{file_name}.mzp"].inject(png_path, compression_level = 2)ccit files can be generated using the ccit.Font class and injected in the
game files using the script:
# { character: width }
# max width is 73
font = Font({
' ':26, '!':21, '"':27, '#':45, '$':45, '%':65, '&':52, "'":17, '(':27, ')':27, '*':33, '+':45, ',':21, '-':31,
'.':21, '/':37, '0':43, '1':30, '2':43, '3':44, '4':44, '5':44, '6':43, '7':43, '8':43, '9':44, ':':21, ';':21,
'<':45, '=':45, '>':45, '?':41, '@':59, 'A':55, 'B':49, 'C':54, 'D':51, 'E':45, 'F':43, 'G':55, 'H':49, 'I':19,
'J':40, 'K':51, 'L':43, 'M':59, 'N':49, 'O':57, 'P':47, 'Q':57, 'R':50, 'S':49, 'T':49, 'U':49, 'V':53, 'W':67,
'X':53, 'Y':55, 'Z':49, '[':25,'\\':37, ']':25, '^':45, '_':45, '`':26, 'a':44, 'b':45, 'c':43, 'd':45, 'e':44,
'f':32, 'g':43, 'h':41, 'i':19, 'j':24, 'k':42, 'l':19, 'm':59, 'n':41, 'o':45, 'p':45, 'q':45, 'r':31, 's':41,
't':31, 'u':41, 'v':43, 'w':59, 'x':45, 'y':43, 'z':41, '{':30, '|':17, '}':30, '~':43, '±':45, '·':21, '×':43,
'à':44, 'è':44, 'ì':19, 'ò':45, 'ù':41, 'ỳ':43, 'á':44, 'é':44, 'í':19, 'ó':45, 'ú':41, 'ý':43, 'æ':58, 'œ':60,
'â':44, 'ê':44, 'î':24, 'ô':45, 'û':41, 'ŷ':43, 'ä':44, 'ë':44, 'ï':24, 'ö':45, 'ü':41, 'ÿ':43, 'ç':43, 'ß':35,
'ā':44, 'ē':44, 'ī':24, 'ō':45, 'ū':41, 'å':44, 'ñ':41, '❶':26, '❷':26, '❸':26, '❹':26, '❺':26, '❻':26, '❼':26,
'À':55, 'È':45, 'Ì':19, 'Ò':57, 'Ù':49, 'Ỳ':55, 'Á':55, 'É':45, 'Í':19, 'Ó':57, 'Ú':49, 'Ý':55, 'Æ':65, 'Œ':71,
'Â':55, 'Ê':45, 'Î':24, 'Ô':57, 'Û':49, 'Ŷ':55, 'Ä':55, 'Ë':45, 'Ï':24, 'Ö':57, 'Ü':49, 'Ÿ':55, 'Ç':55, '❽':26,
'Ā':55, 'Ē':45, 'Ī':24, 'Ō':57, 'Ū':49, 'Å':55, 'Ñ':49, '❾':26, '❿':26, '⓫':26, '⓬':26, '⓭':26, '⓮':26, '⓯':26,
'÷':45, '¡':21, '¿':41, '「':73, '」':73, '『':73, '』':73, '«': 43, '»': 43, 'ー': 73, '²': 28
})
with HfaArchive(f"{path_to_game}/data00100.hfa", 'rw') as archive :
archive["Font010000.ccit"].inject(font.to_ccit())Repeat this script for Font010100.ccit (italic font) and Font010200.ccit (nz font)
If you have empty slots between characters in the font image, you must fill the empty slots of the ccit file with unused characters (here ❶, ❷, ..., ⓯)