Resource Swapper

Resource Swapper (hereinafter referred to as swapper) allows users to replace game resources such as images, models, sounds, and more.

Usage

The swapper supports two modes: simple and extended. Only one mode can be active at a time.

Enabling the Swapper

1. Open the Menu Modal (F1).
2. Move to the Customization page.
3. In the Resource Swapper section, select the swapper mode.
4. Restart the client to activate the swapper.

Swapper Folder

The Voxtulate Client automatically creates a swapper folder where it checks for files to replace.

Windows

To open the swapper folder, press Win + R, type %USERPROFILE%\Documents\VoxtulateClient\swapper, and press Enter.

Simple Swapper

In this mode, the swapper replaces assets based on a predefined mapping. All available mappings can be found in swapperList.json.

1. Locate the asset URL in swapperList.json and get the file name.
2. Place the custom file in the swapper folder.
3. Save the custom file with the exact name from swapperList.json.
4. Restart the client to apply changes.

Extended Swapper

In this mode, the swapper replaces assets by matching exact file names from game requests. The swapper only checks the last part of each request URL.

1. Find the exact file name:
   1.1. Open Developer Tools (F12).
   1.2. Go to the Sources or Network tab to locate the asset file name.
   1.3. To find the file in the Sources tab, browse game asset folders.
   1.4. To find the file in the Network tab, enable recording and refresh the page to see loaded assets.
2. Place the custom file in the swapper folder.
3. Save the custom file with the exact name from Developer Tools.
4. Restart the client to apply changes.

Example

Replacing the player kill sound: https://voxiom.io/package/d6d5be65465643ffbdfc.mp3.

Simple Swapper

• Get the file name from swapperList.json: KILL_MP3.mp3.
• Place the custom file in the swapper folder.
• Rename the custom file to KILL_MP3.mp3.
• Restart the client to apply changes.

Extended Swapper

• Extract the file name: d6d5be65465643ffbdfc.mp3.
• Place the custom file in the swapper folder.
• Rename the custom file to d6d5be65465643ffbdfc.mp3.
• Restart the client to apply changes.

Notes

• Do not include folder paths in the file name.
• File extension is required.
• File extension must not duplicate.
• File must be in the correct format.
• The swapper works for both voxiom.io and historynotes.club domains.