Work Thread

Please use this thread to keep track of work on the hou plus OG sprites and backgrounds

----

drojf - to fill in

## Difference from previous OG sprites and backgrounds

## Parts of the mod which need to be changed to get this to work

- Modify DLL to load images based on
- last played voice + current script file combination
- current script file fallback
- global fallback
- Python script which generates a JSON database of the above three things.
- As input, takes the unmodded game script, and figures out which sprite and background calls occur after each voice line (by using git diff to 'line up' the two scripts...I think, I kinda forgot how it works)
- Also generates simpler fallback databases, which are used if no good match was found
- This is called the "mapping.json" file
- There is currently one file for backgrounds, and one file for sprites
- Minor updates to game script to enable OG mode (so far)

## How to use (in terms of where to place images, and JSON files to edit)

## How to Develop/Debug

### Python Script Output
- Even before playtesting, the output of the python script will tell you what bits need manually fixing. Even just scanning the output.json files for text like ``

### In-Game
- Press Shift-F9, then use scroll wheel to scroll to bottom of the pop-up debug window. Look under sprite mapping
- feedback if things are not working needs to be improved if devs are going to be manually fixing things

### Folder and File Structure

- Discuss old structure
- Discuss new structure with *Mapping suffix
- Discuss mapping.json file
- Discuss sprite/background split, differences in behavior

## DLL modifications

## Script modifications

So far, the only script modification is to uncomment the OG sprites line from `init.txt` so you can click on the OG sprites button. But I should make a branch anyway so it is clear and link it here.

## TODO

- [ ] Transfer information into Readme.md or wiki instead of this issue

## Trial Releases

Trial Release for Hou+ 2025-04-29: https://1drv.ms/u/c/a15ab69e5701a5bf/EVw5xKc0jP1Pn5RUr_85Yr4BBBoXDKc5LxnuoTIh0uy6yg?e=aS2dj8

The issue describes a work thread for integrating OG sprites and backgrounds into a mod. It mentions a Python script to generate JSON mapping files and DLL modifications. Start by examining the repository's existing Python scripts and the 'mapping.json' structure. Look for the debug trigger (Shift-F9) in-game to see current sprite mapping output. The TODO is to transfer this information to Readme.md or a wiki.

Written by the indexing model from the issue text.