Ads keep us online. Without them, we wouldn't exist. We don't have paywalls or sell mods - we never will. But every month we have large bills and running ads is our only way to cover them. Please consider unblocking us. Thank you from GameBanana <3

[Experimental] ONE Archive Redirector

A Mod for Sonic Heroes

No ads for members. Membership is 100% free. Sign up!

A platform-agnostic FileSystem hook based mod for Sonic Heroes that builds ONE Archives on the fly "Just in Time".

Sonic Heroes ONE Archive Redirector



Game can load ONE archives from memory?
No problem, here's another one at the FileSystem level.
Id: sonicheroes.utils.oneredirector

ONE Redirector

This is an experimental project and completely functional proof of concept. This mod creates .ONE archives, "Just in Time", as the game requests to read them from disk. Using some hooks, we then make the game load the file from memory instead of from disk.

Essentially, this allows for loading of files from outside .ONE archives, allowing mods to mix and match files rather than having one mod's files replace another mod's outright.

All done with ZERO knowledge of game code, for fun.

Table of Contents

Supported Applications

  • Sonic Heroes (PC)

Probably works with some standalone applications (e.g. HeroesONE-R) and the console versions of the game, if emulated and ran from filesystem.

How to Use

A. Add a dependency on this mod in your mod configuration.

"ModDependencies": ["sonicheroes.utils.oneredirector"]

B. Add a folder called OneRedirector in your mod folder. C. Make folders corresponding to ONE Archive names, e.g. s01_h.one.

Then, simply place files in the directory.

How to Use: Adding/Replacing Files

In order to add (or replace an existing) file, simply place the file in your ONE directory. Both PRS compressed and uncompressed files are supported.

Uncompressed files should have the full name and extension of the file SHADOW_LOCATOR.DFF. Compressed files should end with the additional extension, .prs e.g. SHADOW_LOCATOR.DFF.PRS.

How to Use: Removing Files

In order to delete a file, create an empty file with the name of the file and an additional extension .del.

e.g. Adding SHADOW_LOCATOR.DFF.DEL would prevent SHADOW_LOCATOR.DFF from being added to the ONE archive.

Note: The archive builder works in the order Delete then Add, so if a file is first deleted, it can be re-added by either the same or another mod.

Developing Mods: A Tip

Disabled by default to improve performance (caching), the configuration has a setting allows for the replacement of files as the game is running exiting the game (i.e. New ONE archive is created every time it is requested from disk.)

This means that, when enabled, if you e.g. replace the files for a character model, exit the stage and start the stage, the new model would load.

Good luck ????

How it Works

This project is a spinoff of my AFS FileSystem Redirector.

It is somewhat simplified, gimped here as the file is read in all at once and as such I don't have to worry about the file being read in chunks.

Many of the basic principles from before still apply. Only large conceptual difference is we actually build the ONE archive and keep it in memory to feed to the game, as generally ONE archives are very small < 3MB.

Files

Sign up to access this!

No comments yet

Embed

menu
Share banner
Image URL
HTML embed code
BB embed code
Markdown embed code

Credits

Key Authors
Sewer56lol
Sewer56lol Joined 2y ago
R-II Manager
Offline
6,539 points Ranked 989th
16 medals 1 legendary 2 rare
  • Created a Mod Installer Medal icon
  • Achieved Game Manager clearance Medal icon
  • Became a Game Pioneer Medal icon
  • One month a member Medal icon
  • Submitted 1 Tool Medal icon
  • Returned 100 times Medal icon
Who's that guy, I've never heard of him before.

Submitter

Sewer56lol avatar
Sewer56lol Joined 2y ago
R-II Manager
Offline
6,539 points Ranked 989th
16 medals 1 legendary 2 rare
  • Created a Mod Installer Medal icon
  • Achieved Game Manager clearance Medal icon
  • Became a Game Pioneer Medal icon
  • One month a member Medal icon
  • Submitted 1 Tool Medal icon
  • Returned 100 times Medal icon
Sewer56lol
Creator
Sign up to access this!
Sign up to access this!
Sign up to access this!

Game

Sign up to access this!

Category

License

menu
GPL V3

Attributes

Development State
Alpha

Share

  • Share on Reddit
  • Share on Twitter
  • Share on Facebook
  • 0
  • 3
  • 163
  • 21d

More from Submitter

menu

More Reloaded II Game Files Game files