SPT Asset Editor 1.1.1

Do not ask when mod authors will update their mods or if they can upload older versions of their mods.
Bothering mod authors will lead to warnings and repeat offenses will lead to bans.
Due to an unusually high volume of traffic, our site may be experiencing intermittent slowdowns. If you notice any issues, log out of your account and browse anonymously so you can better utilize caching or try using forge.sp-tarkov.com to search for and download mods.

A user-friendly tool to extract, preview, modify, and restore Texture2D images within SPT's .assets and .bundle files.

SPT Asset Editor

This tool allows you to easily manage and modify Texture2D assets found in SPT's .assets and .bundle files. Whether you want to change item icons, UI elements, or other textures, this editor provides a simple interface to do so.

Key Features:

  • Load & Analyze: Opens and reads both .assets and .bundle files.
  • Texture Browser: Automatically lists all detected Texture2D assets within the loaded file.
  • Image Preview: Displays selected textures and their properties (resolution, format).
  • Extract Original: Save original textures as .png or .tga files.
    • Option to remove alpha channel when saving PNGs.
  • Replace Texture: Easily replace existing textures with your custom images (supports various formats like PNG, JPG, TGA, etc.).
    • Automatic resizing to fit the original texture dimensions.
    • Handles transparency correctly.
  • Restore Original: Revert textures back to their state from the last saved backup.
  • Automatic Backups: Creates backups automatically when saving changes to prevent data loss.
  • Post Item Image Changer: A dedicated function to easily find and modify the bundle files for post item images.

How to Use:

  1. Download: Get the latest release from the [Files Tab / Releases Link - modify as needed].
  2. Extract: Unzip the downloaded archive.
  3. Run: Launch SPTAssetEditor.exe.
  4. Open File: Go to File -> Open (or Ctrl+O) and select the .assets or .bundle file you want to edit. You'll be prompted to set a backup directory on first load per file.
  5. Browse & Select: Choose a texture from the list in the Asset Browser (left panel).
  6. Modify:
    • To extract: Click "Save Original Texture".
    • To replace: Use the "Select Image..." button in the Image Editor panel (bottom-right), choose your custom image, and click "Replace Image".
  7. Save Changes: Go to File -> Save (or Ctrl+S).

Changing Post Item Images :

  1. Click the "Change Post Item Images" button at the top of the Asset Browser.
  2. Confirm the info message and select your SPT game installation folder.
  3. The tool will find relevant bundle files (e.g., item_barter_flyers_letter...). Select the one you want to edit from the list.
  4. Modify the textures as described in step 6 & 7 above.

⚠️ Important Notes ⚠️

False Positive Virus Detection:
This application is built using Python (with PyInstaller), which may trigger false positive detections from antivirus software.
There is no malicious code or virus intentionally included. However, if you're concerned, feel free to avoid using the tool.

SPT Use Only:
This tool is designed exclusively for use with SPT (Single Player Tarkov).
❌ Do NOT use this on live Escape from Tarkov files.
Modifying live game files can lead to corrupted installs and will likely result in a BattlEye ban.
You have been warned.

Backups:
Always back up your original game files before making any major modifications, even though this tool includes a built-in backup system.

.assets/.resS File Handling:
When editing .assets files, ensure the corresponding .resS files are in the same directory.
Otherwise, texture data may not load or save correctly.

🛑 Mod Submission Guidelines Reminder 🛑

According to the SPT File Submission Guidelines:

  • You must not upload bundles that replace original EFT or SPT files.
  • File overwriting and other destructive edits are forbidden.
  • All changes must be applied at runtime using the mod loader.

This tool is a standalone asset editing utility, not a mod.
While it enables creation of custom bundles, users are fully responsible for how they use or share those files.
If you plan to submit any content to the SPT Hub, make sure it follows the official guidelines.

Credits:

  • Developed by [GoLani11]
  • Utilizes UnityPy, texture2ddecoder, Pillow, and PyQt5.
  • Inspired by AssetStudio and UABEA.
  • Development assisted by Cursor AI.

Images

Heart 11 Thumbs Up 1

  • it is impossible to change the texture of the mods TacticalGearComponent = assaultvest6_blk.bundle


    your soft ware works correctly with the battlepass mods for exemple but not with this mod : /

    • Thank you for reporting the issue and letting me know about this.

      I have confirmed the problem you reported and am currently working on a fix.

      An update with the fix will be released soon, so please wait for it.

    • The issue you mentioned has been resolved.

      Please download the latest version, and let me know if you still encounter any problems.

  • hey i keep getting this message "params must be an instance of BC7CompressionBlockParams" when trying to swap out the texture. I'm trying to edit the M4A1 and just put a simple texture over the top to make a skin. The changes dont save even if i save the bundle.

    • I'm currently a bit busy and won't be able to check right away. If you could let me know the exact name of the bundle you're modifying, I'll make sure to look into it and get back to you within a week

    • its the client_assets.bundle for the M4A1 in the textures folder.

    • The issue you mentioned has been resolved.


      Please download the latest version, and let me know if you still encounter any problems.

    • yes the compression issue was fixed, thank you.

      some bundles don't load anything when opened but im not sure if that's a user error or if maybe the tool cant find the textures.

    • Hmm.. there could be a couple of reasons for this issue.

      As you mentioned, it's possible that my program failed to recognize the Texture2D component. Alternatively, the bundle might simply not contain a Texture2D in the first place.

      Could you please try checking the bundle using AssetStudioGUI?

      If you do find the image file (the Texture2D) in the bundle with AssetStudioGUI, then it likely indicates an issue with my program. If that's the case, please provide me with the bundle file and its path, and I will investigate it.

  • hey, i have been texturing weapns, des this wrk with modded items?, i can open them but it dosent have any effect in game

    • I haven't had time to test the modded item yet. Could you let me know which mod you're currently using?

    • i have been trying to do it with epic's all in one
      it has the same issues with some weapons (m4a1)

    • I'm currently a bit busy and won't be able to check right away. If you could let me know the exact name of the bundle you're modifying, I'll make sure to look into it and get back to you within a week.

    • The issue you mentioned has been resolved.


      Please download the latest version, and let me know if you still encounter any problems.

    • yo thats awesome i will try it out later

      Thumbs Up 1

  • it was not possible to replace the texture of the clothes, apparently the program does not have such an opportunity ?

    • Could you let me know where the clothing-related asset files are located? The main purpose of this program is to allow modification of item and map mesh images, but I haven't had a chance to test it with clothing yet.

    • \Games\Escape From Tarkov \EscapeFromTarkov_Data\StreamingAssets\Windows\assets\content\characters\character\ prefabs

    • I edited the clothing texture from the path you mentioned, and it worked well. Please make sure you clicked the save button after editing the image. Also, try clicking the "Clean Temp Files" option in the SPT.Launcher settings and then run the game.

    • Yes! Thanks, everything worked out.

      Thumbs Up 1

  • Could this be used to replace armor plate textures?

    • Yes, it's possible. You can use this program to extract the armor plate image you want to edit, modify it using an image editing program (e.g., Photoshop), and then apply it back.

  • Can I modify optic reticles too?

    • Hmm… When I made this program, it was designed to easily extract and replace static Texture2D assets like poster item images or meshes. I'm not too familiar with how reticles work, but if they’re dynamic images or use a different format, they likely aren’t supported.

      Thumbs Up 1

    • Ye, I tried but doesn't work.

      Thumbs Up 1

  • Awesome tool! You've really done something for the community with this one. Can't wait to see what comes from it.

    Now I'm going to be looking at ever texture in the game like "hummm I could replace you "

    Happy 1

    • That’s exactly the kind of response I was hoping for.

      Thank you for taking interest in my program, and have fun SPT!

  • Thank you so much for making this tool! I was heavily inspired by your Korean SPT logo mod and used it as framework to make custom SPT themes. Now with this tool it will be even easier! Great work as usual.


    axg50zR.png


    ZFEzZ5O.png


    BR6UENC.png

    Thumbs Up 1

    • The SPT Korean Tarkov Logo Changer mod was one of the first mods I created when I started developing for SPT, so it's quite rough and basic. It provides a backup file but works by overwriting the original files.


      For version 3.11, I’m planning to improve this so that it no longer overwrites original files. While there’s no issue with using the mod as it is, if you plan to modify it and share it on the hub, please be aware that the current method may violate the File Submission Guidelines. I recommend adjusting the implementation before sharing.


      Have fun SPT!

  • This is huge, guys bugcatrainbow animeproudclap animedance2

    Happy 1

    • Thank you for taking interest in my program.

      Have fun SPT!

      Heart 1

  • Would this work on past versions of the game?

    • I don't have time and I don't have the previous version to check, but it's probably possible.

  • is it possible to like retexture some base game weapons like their colours with this mod?

    • Yes, it's possible. You can use this program to extract the weapon image you want to edit, modify it using an image editing program (e.g., Photoshop), and then apply it back.

    • if its possible where i can find the base gun assets/bundles in? where are they located at

    • You can find the weapons you want to modify in the following path:

      SPT Folder\EscapeFromTarkov_Data\StreamingAssets\Windows\assets\content\weapons

      Weapon parts are also scattered across various subfolders within the content directory. You'll need to explore a bit and find them yourself.

      Have fun SPT!

  • A brief notice, just to clarify for anyone who may intend to create replacement bundles and upload them as mods:


    As per the File Submission Guidelines, bundles that are edited and are intended to replace the original game assets are not allowed to be uploaded as a mod. Loading the bundles via a server-side mod is, of course, completely fine - replacing original ones are not.


    Under section for "Inappropriate Content":


    Files may not replace existing EFT or SPT data. File overwriting or other forms of destructive edits are forbidden. All files must edit values at launch using the mod loader.

    Thinking 1 Thumbs Up 3

    • Thanks for the clarification. My program is a standalone tool designed to help with custom assets, bundle creation, and it includes safeguards to prevent modifying the live game files. I’ll make sure to remind users to follow the guidelines when using it.

      Thumbs Up 1