Issues with Appeal Card / Navigator Import in KFC-7.1.4 and WebUI psd_level Import

[Zenar11]

Hello,

First of all, thank you for all your hard work on this project. I've been using it extensively and really appreciate the effort you've put into it.

Recently, however, I encountered a few issues after updating to the latest plugin version. I managed to resolve them on my own, but I wanted to share my findings in case they might be helpful.

I'm currently using game version 2026030300.

---

1. Appeal Card Import Issue After Updating the Plugin

After updating to the latest plugin version, I noticed that not all Appeal Cards were being unlocked or displayed correctly in-game when editing profiles.

When I downgraded back to the version I had been using previously (KFC-7.0.1), the problem disappeared.

While investigating, I found what appears to be the relevant code:

sdvx@asphyxia/handlers/profiles.ts

function unlockAppealCards(items: Partial<Item>[], version: number) {
  console.log("Unlocking Appeal Cards");
  let maxId = [0, 1904, 3001, 3595, 3595, 5553, 7000]
  items = items.filter(i => i.type !== 1);

  // isn't this causing maxId[7] = undefined?
  for (let i = 0; i < maxId[version]; ++i)
    items.push({ type: 1, id: i, param: 1 });

  return items;
}

In the older version I had been using, the loop limit was hardcoded to 7000 rather than using maxId[version].

After changing:

maxId[version]

to

maxId[version - 1]

all Appeal Cards appeared correctly in-game and the issue was resolved.

I made the same adjustment for the unlockNavigators() function as well.

function unlockNavigators(items: Partial<Item>[], version: number) {
  console.log("Unlocking Navigators and Genesis Cards");
  let maxGenId = [0, 0, 762, 1211, 1211, 1408, 1408];
  items = items.filter(i => i.type !== 11 && i.type !== 4 && i.type !== 8);

  // maxGenId[version] -> maxGenId[version - 1]
  for (let i = 0; version >= 3 && version < 7 && i < maxGenId[version - 1]; ++i)
    items.push({ type: 4, id: i, param: 15 });

  for (let i = 0; version == 3 && i < maxGenId[version - 1]; ++i)
    items.push({ type: 8, id: i, param: 9999 });

  for (let i = 0; version >= 6 && i < 300; ++i)
    items.push({ type: 11, id: i, param: 15 });

  return items;
}

Of course, since I'm using version = 7, unlockNavigators() is probably not causing any visible problems for me. However, I thought it might potentially affect other versions, so I updated it as well.

---

2. WebUI "Update WebUI Assets" Error

When running WebUI → Update WebUI Assets, I encountered the following error:

Running....

Getting new music_db info
Importing SDVX7 mdb
Copying new nemsys files from gamedata
Copying new subbg files from gamedata
Copying new bgm files from gamedata
Copying new chat stamps from gamedata
Copying new valgene_item files from gamedata
Copying new appeal titles from gamedata
Copying new appeal card data from gamedata
Extracting textures from IFS files
/data/graphics/ver06/arena_rank.ifs:
/data/graphics/ver06/psd_level.ifs:
/data/graphics/ver07/psd_level.ifs:
[ERROR] MD5 mismatch - /data/graphics/ver07/psd_level.ifs
/data/graphics/ver06/psd_skill.ifs:
Updating course_data.json
Update complete!

[ERROR] MD5 mismatch - /data/graphics/ver07/psd_level.ifs

The issue appears to be that the MD5 hash for psd_level.ifs no longer matches the value expected by the plugin.

I searched through several communities but couldn't find any real solution. Most responses simply suggested that the game files might be corrupted and recommended reinstalling them.

Eventually, I found what seems to be the relevant configuration in:

sdvx@asphyxia/data/webui.ts

{
  'file': '/data/graphics/ver07/psd_level.ifs',
  'asset_folder': 'difficulty7',
  'data': [
    {
      'md5': '623cbb528d26836595f2837bae054a29',
      ...
    }
  ]
},

From what I understand, this section defines the expected MD5 hash and texture extraction information for the file.

My guess is that the file /data/graphics/ver07/psd_level.ifs was updated somewhere between game version 2026030300 and 20260512xx, causing the MD5 mismatch.

I suspect the change may be related to the newly added NBL difficulty level icons, although I cannot confirm this.

As a temporary workaround, I simply commented out the entire JSON block shown above, and the WebUI update process completed successfully afterward.

I hope this information is helpful. Thanks again for all the work you've put into the project.

[22vv0]

1. Appeal Card Import Issue
   This is definitely an oversight. Will fix asap.

2. WebUI "Update WebUI Assets" Error
   MD5 mismatches are bound to happen if your gamedata's ifs md5 does not match any on the plugin's list of ifs to extract. The only psd_level.ifs that would match is the one that was updated for NBL difficulty, correct.
   These are more accurately warnings and can be ignored.