Shattered Dimensions

Texture packs

A texture pack replaces pictures in the game with new ones. You need nothing but Shattered Dimensions, an image editor that saves PNG, and optionally a zip program (Windows has one built in).

How packs work

Packs are not used while HD or 4K textures are on (see Graphics). Choose The game's own textures to use packs.

Installing and managing packs

  1. Put the pack's folder or .zip into %APPDATA%\Shattered Dimensions\texture-packs. A zip works as it is: there is no need to unzip it.
  2. In the game, press F10 and open Texture packs. Every pack found is listed with its name, type, status and number of pictures.
In the Texture packs sectionWhat it does
The checkbox beside a packSwitches that pack on or off
The arrowsChange the order: a pack higher in the list wins when two replace the same texture
ReloadReads the packs again, so a changed picture shows at once
Hold to see the original texturesShows the game's own pictures while held, to compare
Dump texturesSaves each texture the game draws, for making your own pack (below)
Open the packs folderOpens the folder in Explorer

To remove a pack, switch it off, or delete its folder or zip from the packs folder.

Packs made for 3DS emulators

Packs made for A Link Between Worlds in 3DS emulators (Citra, Azahar) work as they are: drop the folder or zip in. Supported are packs whose pack.json uses the emulators' current naming (the default when the file exists): files named tex1_<width>x<height>_<hash>_<format>.png, or listed in the pack.json. Older packs without a pack.json used a different naming that is not supported yet; the pack report lists them. DDS and KTX pictures are planned for a later version.

3DS packs can only change the game's textures, never our interface.

Making your own pack

1. Dump the textures

In the settings window (F10, Texture packs), turn on Dump textures and play. Every texture the game draws is saved once as a PNG in %APPDATA%\Shattered Dimensions\texture-dump. Go wherever the textures you want appear; turn the dump off when you are done. The dumped pictures come from your own copy of the game: keep them on your computer and do not share them.

2. Find the texture

Each file is named after the texture:

sd_<width>x<height>_<hash>_<format>.png
sd_16x16_13A407DCF5FE31C1_RGBA4.png

Browse the folder with large thumbnails. Keep the file name exactly as it is.

3. Paint the replacement

Only use art you made yourself or have the right to use.

4. Make the pack

Make a folder in texture-packs and put your PNGs anywhere inside it, in sub-folders if you like. Files with other names are ignored, so notes can stay in the folder. Press Reload to see your changes at once.

5. Restyle our interface (optional)

Our own interface is not a game texture, so it has no dump name. A pack names the pieces it replaces in a pack.json file at its top:

{
  "pack_format": 1,
  "name": "My Blue HUD",
  "id": "yourname.my-blue-hud",
  "version": "1.0",
  "author": "Your name",
  "description": "A blue rupee and a teal energy gauge.",
  "replaces": {
    "sd:hud/rupee/gem": "rupee_gem.png",
    "sd:hud/energy/fill": "energy_fill.png"
  }
}
NameWhat it isSuggested size
sd:hud/rupee/gemthe rupee beside the counter64 x 96
sd:hud/rupee/framethe counter's background256 x 64
sd:hud/energy/emptythe energy gauge's background512 x 40
sd:hud/energy/fillthe gauge's fill; its left part shows as much as there is energy512 x 40
sd:hud/energy/framethe gauge's frame, transparent inside512 x 40

"pack_format": 1 is required for "replaces". Name, version, author and description are shown in the manager.

6. Share it

Zip the pack's folder (right-click, Compress to ZIP). Players drop the zip into their packs folder without unpacking it. Share only pictures you made: never the dumped originals.

When something is wrong

The game always keeps running: a picture that cannot be used is drawn as the original.

The report saysWhat to do
is not a PNG pictureSave it again as PNG (not renamed from JPG or WebP)
larger than 8192 on a sideUse a smaller multiple of the original size
could not be unpacked, cut shortThe zip is damaged: make it again
named for another texture size or formatCopy the name from the dump again
not the shape of the texture it replacesKeep the original proportions
resized to a whole multipleIt works; for the sharpest result, use exactly 2, 3, 4 times the size
is not a name Shattered Dimensions knowsCheck the name against the table above
"replaces" but no "pack_format": 1Add "pack_format": 1 to pack.json

Packs are checked for safety: at most 100,000 files, each at most 256 MB and 8192 pixels on a side; zip entries with unsafe names, possible decompression bombs, encryption or unusual compression are refused. Nothing in a pack is ever unpacked to your disk.