Minor issue regarding custom path for external music files

[Starryk79]

Hi,

i hade stored custom music files in the music folder instead of data/music. It worked with FFNx without Junction when i adjusted the path accordingly in the ffnx.toml. With Junction however this was always overwritten again with data/music.
I tried to figure out how Junction actually works and where that default entry comes from but I couldn't. In the end i just copied the contents of the music folder to data/music and unsurprisingly it worked then.
That is why i consider this a minor issue.
Maybe that is necessary so that Junction can do what looks like magic with the installed mods not affecting the FF 8 folders and seeming only to exist as iroj files.
Still I wanted to bring it up, because it also could be a bug instead of a feature.

Best regards
Starryk

[julianxhokaxhiu]

Hello,

I'd suggest joining our Discord channels for support on mod development. Here we cover only software bugs and clearly this is not the case as other mods have successfully used this layer already. Another suggestion would be to pick the closest existing mod and look at how it is build to mimic the same behavior. Hope this helps.

Cheers and BR,
Julian

[barkermn01]

This is a great answer. I’d like to expand on how the “Junction VIII Magic” system actually works—because despite how it's been identified here, there’s no real magic involved 😄. It’s a well-structured and deliberate system that if you understand rewrite for web servers you will understand, when it comes to handling mods in both IRO-based and non-IRO modes. The system is built on the IROS methodology, which underpins how IROJ files function.

🔧 How the Rewrite Rule System Works

At the heart of Junction VIII is a rewrite rule mechanism. This system governs how modded files are discovered and loaded by the game, and it overrides the default file resolution behavior of FFNX. Here's how it works:

1. Mod Directory Registration

Each mod declares one or more directories or files it uses, via its mod.xml file. These directories contain the mod’s assets—such as textures, audio, or scripts.

2. Mod Load Order

The application processes these registered directories in the order defined by the user in the mod list. This order is crucial because it determines which mod takes priority when multiple mods modify the same file.

3. File Matching and Redirection

When the game requests a file, the system checks each registered directory in sequence. As soon as it finds a matching file, it redirects the request to that file. This first-match-wins behavior is why mod order matters so much. if it does not get a rule match the default game files will be used.

4. Custom Content Handling

If you include custom content—like audio files—it must be registered through Junction VIII. This can be done in one of two ways:

• By creating a mod.xml file that defines the directories and purpose of your content.
• Or by adding your custom folders to the “Additional Folders to Monitor” section in the General Settings of Junction VIII.

If your content isn’t registered using one of these methods, the rewrite system won’t know to look for it, and the game will revert to the default game files, which may not include your custom files.

✅ Summary

The Junction VIII rewrite system ensures that mods are loaded and prioritized correctly, whether you're using IRO-based mods (via IROS/IROJ) or non-IRO setups. Most importantly, it overrides FFNX’s default file handling, giving modders precise control over how and when their content is loaded. However, for this to work as intended, all custom content must be properly registered—otherwise, it won’t be recognized or used by the system.