Skip to content

Repository files navigation

UTextureTools

Live App: https://hypermodule.github.io/utexturetools/

A web app for making simple texture mods for UE5 games. It is inspired by matyalatte's great UE4-DDS-Tools, which unfortunately is no longer maintained. The main addition provided by this app is support for Virtual Textures and UE 5.5–5.8. The project is open-source (MIT license) and contributions are welcome. Some advanced texture types (like texture arrays and cubemaps) are not supported.

The app currently assumes that the texture asset is supplied in "legacy format" (.uasset + .uexp + .ubulk), so it's intended to be used together with a packaging tool like retoc (for IoStore games) or repak (for plain pak games).

If you find a case that this tool can't handle, remember that you can use UE itself to make texture mods; you can learn about this in Dmgvol's great modding guide (which also links to a very helpful UE modding discord). Happy modding!

Building

The normal build and test workflow requires Node.js 22.18.0 or newer and npm. No native build tools are needed because the compiled WebAssembly codec is checked into the repository.

Install the dependencies and build the browser application using the checked-in wasm/bcencdec.wasm file:

npm ci
npm run build:browser

The compiled JavaScript and WebAssembly are written to dist/. To serve the application, include the root index.html, style.css, and vendor/jszip/ alongside that directory.

Rebuilding the WebAssembly codec

If you change the codec or its WebAssembly build configuration, install CMake and Emscripten (the project currently uses Emscripten 6.0.8) and run:

npm ci
npm run build:wasm
npm run build:browser

The first build command regenerates wasm/bcencdec.wasm; the second includes the regenerated artifact in dist/.

Testing

After installing the dependencies with npm ci, run the test suite with:

npm test

Run the TypeScript type checker separately with:

npm run typecheck

About

Web app for making texture swap mods for UE5 games.

Resources

Stars

1 star

Watchers

1 watching

Forks

Contributors

Languages