Minecraft Textures

This is a library containing all the textures I use for my generators.

Textures from 1.12 to 1.21.9 currently available.

npm install minecraft-textures

Usage

Check if a version is available:

import hasVersion, { versions, latestVersion } from 'minecraft-textures';

const version = '1.21';
if (hasVersion(version)) {
  const textures = await import(
    `minecraft-textures/dist/textures/json/${version}.json`
  );
}

console.log(versions); // all available versions
console.log(latestVersion); // '1.21'

The textures are base64-encoded PNG images:

const textures = await import(
  'minecraft-textures/dist/textures/json/1.21.json'
);

// textures.items is an array of { readable, id, texture }
const item = textures.items[0];
console.log(item.readable); // "Diamond Sword"
console.log(item.id); // "minecraft:diamond_sword"
console.log(item.texture); // "data:image/png;base64,..."

For ID-based lookups, use the .id.json files:

const textures = await import(
  'minecraft-textures/dist/textures/json/1.21.id.json'
);

const sword = textures.items['minecraft:diamond_sword'];
// { readable: "Diamond Sword", texture: "data:image/png;base64,..." }

Update Notes

1.20

• The ordering of the JSON files have been updated to match the order of the items in the Search Items creative tab.

1.17

• The file names were updated to be the actual version (i.e. 1.17.ts rather than 117.ts)

1.16

• The versions are now dynamically imported. You will need to import the path provided by byVersion.
  • For anyone using the .json files, you can now use something like this:
    • https://unpkg.com/minecraft-textures/dist/textures/json/1.16.json

License

Please credit destruc7i0n (https://thedestruc7i0n.ca) if you use this. Its not required, but is appreciated.

The Minecraft item icons are owned by Mojang Studios.

This project is not affiliated with Mojang Studios.