SPT Asset Editor 1.1.0

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

  • 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.

  • 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.