+
+Paint Minecraft: Java Edition armor trims on the exact armor model the game uses, preview every trim material while you paint, and export the result straight into a resource pack.
+
+## How to use
+
+1. **File → New → Armor Trim**. Start empty or from a vanilla pattern, or open existing trims with **Trim → Open trim from resource pack** (Ctrl or Shift opens several at once).
+2. Paint on the model or on the `humanoid` / `humanoid_leggings` textures. The eight gray shades in the **Trim: palette & export** panel are recolored by the trim material; any other color stays as painted.
+3. Use the **Trim: preview** panel to show or hide armor pieces and layers, switch the reference armor and trim material, pose the player (including poses with the body parts pulled apart) and change the skin. Right-click a piece to show only that piece.
+4. Click **Icon** to generate the smithing template icon from a vanilla template.
+5. In vanilla every trim looks the same on armor items in the inventory. In the **Icons** tab you draw how this trim looks on each armor shape (helmet, chestplate, leggings, boots, netherite helmet and boots, turtle shell), previewed on every armor type and material. **Generators** create the icons from the trim on the player, the vanilla overlay or simple shapes. They are exported in the format of the [Visual Armor Trims](https://modrinth.com/resourcepack/visual-armor-trims) resource pack, into VAT itself if your pack contains it (Minecraft 1.21.5+).
+6. Click **Export** and save the trim into a resource pack zip (with `pack.mcmeta` and `pack.png`, e.g. in `.minecraft/resourcepacks`) or into a pack folder, then press `F3 + T` in game. Exporting another trim into the same archive adds it next to the others. After the first export, **Quick export** (`Ctrl + Alt + E`) repeats it.
+7. Click **Datapack** to add the trim pattern to a datapack zip, e.g. right in `saves/
+
`,
+ },
+ onConfirm() {
+ let vm = this.content_vue;
+ if (!vm || !vm.result_canvas) return;
+ Object.assign(gen, vm.gen);
+ let result = vm.result_canvas;
+ icon_texture.edit((canvas) => {
+ let ctx = canvas.getContext('2d');
+ ctx.imageSmoothingEnabled = false;
+ ctx.clearRect(0, 0, canvas.width, canvas.height);
+ ctx.drawImage(result, 0, 0, canvas.width, canvas.height);
+ }, {edit_name: t('generate_icon')});
+ notify(t('icon_updated'));
+ },
+ });
+ dialog.show();
+}
+
+// ============================================================================
+// Validation
+// ============================================================================
+
+function usedMask(role, w, h) {
+ let scale = w / 64;
+ let mask = new Uint8Array(w * h);
+ for (let box of USED_BOXES[role] || []) {
+ for (let [x, y, rw, rh] of boxRects(...box)) {
+ for (let yy = y * scale; yy < (y + rh) * scale; yy++) {
+ for (let xx = x * scale; xx < (x + rw) * scale; xx++) mask[yy * w + xx] = 1;
+ }
+ }
+ }
+ return mask;
+}
+const KEY_RGB = PALETTE_KEY.map(hexToRgb);
+function nearestKey(r, g, b) {
+ let best = -1, best_d = Infinity;
+ KEY_RGB.forEach((k, i) => {
+ let d = Math.abs(k[0] - r) + Math.abs(k[1] - g) + Math.abs(k[2] - b);
+ if (d < best_d) { best_d = d; best = i; }
+ });
+ return {index: best, distance: best_d};
+}
+function analyzeTexture(texture) {
+ let w = texture.canvas.width, h = texture.canvas.height;
+ let px = texture.canvas.getContext('2d').getImageData(0, 0, w, h).data;
+ let mask = usedMask(texture.trim_role, w, h);
+ let stats = {texture, w, h, opaque: 0, palette: 0, fixed: 0, semi: 0, unused: 0, near: 0, below_cutout: 0};
+ for (let i = 0; i < w * h; i++) {
+ let a = px[i * 4 + 3];
+ if (a == 0) continue;
+ if (!mask[i]) { stats.unused++; continue; }
+ stats.opaque++;
+ if (a < 255) stats.semi++;
+ if (a < 26) stats.below_cutout++;
+ let near = nearestKey(px[i * 4], px[i * 4 + 1], px[i * 4 + 2]);
+ if (near.distance == 0) stats.palette++;
+ else {
+ stats.fixed++;
+ if (near.distance <= 12) stats.near++;
+ }
+ }
+ return stats;
+}
+function validateTrim() {
+ let data = D();
+ let issues = [];
+ if (!data) return issues;
+ let label = {trim_humanoid: 'humanoid', trim_leggings: 'humanoid_leggings'};
+ let total = 0;
+ for (let texture of trimTextures()) {
+ if (!texture.canvas || !texture.canvas.width) continue;
+ let s = analyzeTexture(texture);
+ total += s.opaque;
+ let name = label[texture.trim_role];
+ if (s.w * 32 != s.h * 64) {
+ issues.push({level: 'error', text: t('size_must_be_2_1_64_32_128_64', [name, s.w, s.h])});
+ }
+ if (s.unused) {
+ issues.push({level: 'warn', text: t('px_outside_the_uv_layout_invisible_in', [name, s.unused]),
+ fix: {id: 'clear_unused', texture, label: t('remove')}});
+ }
+ if (s.semi) {
+ issues.push({level: 'warn', text: t('semi_transparent_px_trims_render_as', [name, s.semi]),
+ fix: {id: 'fix_alpha', texture, label: t('match_game')}});
+ }
+ if (s.near) {
+ issues.push({level: 'info', text: t('px_are_close_to_palette_colors_but_will', [name, s.near]),
+ fix: {id: 'snap_palette', texture, label: t('snap_to_palette')}});
+ }
+ if (s.opaque) {
+ issues.push({level: 'info', text: t('px_follow_the_material_px_keep_their', [name, s.palette, s.fixed])});
+ }
+ }
+ if (!total) issues.unshift({level: 'warn', text: t('the_trim_is_empty')});
+ let icon = findTexture('icon');
+ if (icon && icon.canvas && icon.canvas.width != icon.canvas.height) {
+ issues.push({level: 'warn', text: t('the_icon_is_not_square')});
+ }
+ if (iconTextures().length) issues.push({level: 'info', text: t('armor_icons_count', [filledIconSlots().length, ICON_SLOTS.length])});
+ let id_error = trimIdError(data.trim_id);
+ if (id_error) issues.unshift({level: 'error', text: id_error});
+ return issues;
+}
+function applyFix(fix) {
+ let texture = fix.texture;
+ texture.edit((canvas) => {
+ let ctx = canvas.getContext('2d');
+ let w = canvas.width, h = canvas.height;
+ let image = ctx.getImageData(0, 0, w, h);
+ let px = image.data;
+ let mask = usedMask(texture.trim_role, w, h);
+ for (let i = 0; i < w * h; i++) {
+ let a = px[i * 4 + 3];
+ if (a == 0) continue;
+ if (fix.id == 'clear_unused' && !mask[i]) {
+ px[i * 4] = px[i * 4 + 1] = px[i * 4 + 2] = px[i * 4 + 3] = 0;
+ } else if (fix.id == 'fix_alpha' && a < 255) {
+ px[i * 4 + 3] = a < 26 ? 0 : 255;
+ } else if (fix.id == 'snap_palette') {
+ let near = nearestKey(px[i * 4], px[i * 4 + 1], px[i * 4 + 2]);
+ if (near.distance > 0 && near.distance <= 12) {
+ let k = KEY_RGB[near.index];
+ px[i * 4] = k[0]; px[i * 4 + 1] = k[1]; px[i * 4 + 2] = k[2];
+ }
+ }
+ }
+ ctx.putImageData(image, 0, 0);
+ }, {edit_name: t('fix_trim')});
+}
+function trimIdError(id) {
+ if (!id) return t('trim_id_is_empty');
+ if (!/^[a-z0-9_.\-]+$/.test(id)) return t('trim_id_may_only_contain_a_z_0_9');
+ return '';
+}
+
+function clearPiece(piece) {
+ let boxes = PIECE_BOXES[piece];
+ for (let role in boxes) {
+ let texture = findTexture(role);
+ if (!texture) continue;
+ texture.edit((canvas) => {
+ let ctx = canvas.getContext('2d');
+ let scale = canvas.width / 64;
+ for (let box of boxes[role]) {
+ for (let [x, y, w, h] of boxRects(...box)) ctx.clearRect(x * scale, y * scale, w * scale, h * scale);
+ }
+ }, {edit_name: t('clear_trim_piece')});
+ }
+}
+
+function confirmClearPiece(piece) {
+ Blockbench.showMessageBox({
+ title: t('clear_trim_piece'),
+ message: t('erase_from_the_trim_texture_you_can_undo', [PIECE_NAMES[piece]]),
+ buttons: [t('erase'), t('cancel')], confirm: 0, cancel: 1,
+ }, (button) => { if (button == 0) clearPiece(piece); });
+}
+
+// ============================================================================
+// Pack storage: a resource pack or datapack is either a folder or a zip archive
+// ============================================================================
+
+class FolderPack {
+ constructor(root) {
+ this.kind = 'folder';
+ this.root = root;
+ this.path = root;
+ }
+ async load() {
+ return this;
+ }
+ abs(rel) {
+ return PathModule.join(this.root, ...rel.split('/'));
+ }
+ exists(rel) {
+ return pathExists(this.abs(rel));
+ }
+ async read(rel) {
+ return this.exists(rel) ? getFS().readFileSync(this.abs(rel)) : null;
+ }
+ listDir(rel) {
+ return readDir(this.abs(rel));
+ }
+ listFiles(prefix) {
+ // Every file under a folder, as pack-relative paths
+ let files = [];
+ let walk = (rel, depth) => {
+ let entries;
+ try { entries = getFS().readdirSync(this.abs(rel), {withFileTypes: true}); } catch (err) { return; }
+ for (let entry of entries) {
+ let child = rel + '/' + entry.name;
+ if (entry.isDirectory()) { if (depth < 12) walk(child, depth + 1); }
+ else files.push(child);
+ }
+ };
+ walk(prefix.replace(/\/$/, ''), 0);
+ return files;
+ }
+ write(rel, content, backup_stamp) {
+ let path = this.abs(rel);
+ if (backup_stamp) backupFile(path, this.root, backup_stamp);
+ ensureDir(PathModule.dirname(path));
+ getFS().writeFileSync(path, content);
+ }
+ async save() {}
+}
+
+class ZipPack {
+ constructor(file) {
+ this.kind = 'zip';
+ this.path = file;
+ this.zip = null;
+ this.existed = false;
+ this.dirty = false;
+ }
+ async load() {
+ let fs = getFS();
+ this.existed = fs.existsSync(this.path);
+ this.zip = this.existed ? await JSZip.loadAsync(fs.readFileSync(this.path)) : new JSZip();
+ return this;
+ }
+ exists(rel) {
+ return !!this.zip.file(rel);
+ }
+ async read(rel) {
+ let file = this.zip.file(rel);
+ return file ? Buffer.from(await file.async('uint8array')) : null;
+ }
+ listDir(rel) {
+ let prefix = rel.replace(/\/?$/, '/');
+ let names = new Set();
+ this.zip.forEach((path) => {
+ if (!path.startsWith(prefix)) return;
+ let name = path.substring(prefix.length).split('/')[0];
+ if (name) names.add(name);
+ });
+ return [...names];
+ }
+ listFiles(prefix) {
+ let files = [];
+ this.zip.forEach((path, file) => {
+ if (!file.dir && path.startsWith(prefix)) files.push(path);
+ });
+ return files;
+ }
+ write(rel, content) {
+ this.zip.file(rel, content);
+ this.dirty = true;
+ }
+ async save(backup_stamp) {
+ if (!this.dirty) return;
+ if (this.existed && backup_stamp) backupFile(this.path, PathModule.dirname(this.path), backup_stamp);
+ let content = await this.zip.generateAsync({type: 'uint8array', compression: 'DEFLATE'});
+ ensureDir(PathModule.dirname(this.path));
+ getFS().writeFileSync(this.path, Buffer.from(content));
+ this.existed = true;
+ this.dirty = false;
+ }
+}
+
+function packStorage(path) {
+ return /\.zip$/i.test(path) ? new ZipPack(path) : new FolderPack(path);
+}
+async function readPackText(pack, rel) {
+ let buffer = await pack.read(rel);
+ return buffer ? buffer.toString('utf-8').replace(/^/, '') : null;
+}
+function writeJSON(pack, rel, json, previous_text, backup_stamp) {
+ // Keep the indentation, line endings and trailing newline of the file being replaced
+ let text = previous_text || '';
+ let out = JSON.stringify(json, null, detectIndent(text)) + (text.endsWith('\n') || !text ? '\n' : '');
+ if (text.includes('\r\n')) out = out.replace(/\n/g, '\r\n');
+ pack.write(rel, out, backup_stamp);
+}
+async function writeJSONIfChanged(pack, rel, json, backup_stamp, indent = 2) {
+ // Files whose content is already the same stay untouched, so a pack under git shows only real changes
+ let text = await readPackText(pack, rel);
+ if (text) {
+ try {
+ if (JSON.stringify(JSON.parse(text)) == JSON.stringify(json)) return false;
+ } catch (err) {}
+ writeJSON(pack, rel, json, text, backup_stamp);
+ } else {
+ pack.write(rel, JSON.stringify(json, null, indent) + '\n');
+ }
+ return true;
+}
+async function samePNG(pack, rel, canvas) {
+ // Compares pixels, not bytes: an image saved by another editor is not rewritten if nothing was painted
+ let buffer = await pack.read(rel);
+ if (!buffer || !canvas || !canvas.width) return false;
+ try {
+ let old = await dataURLToCanvas(bufferToDataURL(buffer));
+ if (old.width != canvas.width || old.height != canvas.height) return false;
+ let a = old.getContext('2d').getImageData(0, 0, old.width, old.height).data;
+ let b = canvas.getContext('2d').getImageData(0, 0, canvas.width, canvas.height).data;
+ for (let i = 0; i < a.length; i += 4) {
+ if (a[i + 3] == 0 && b[i + 3] == 0) continue;
+ if (a[i] != b[i] || a[i + 1] != b[i + 1] || a[i + 2] != b[i + 2] || a[i + 3] != b[i + 3]) return false;
+ }
+ return true;
+ } catch (err) {
+ return false;
+ }
+}
+async function writeTextureIfChanged(pack, rel, texture, backup_stamp) {
+ if (await samePNG(pack, rel, texture.canvas)) return false;
+ pack.write(rel, textureBuffer(texture), backup_stamp);
+ return true;
+}
+function zipFileName(name) {
+ name = String(name || '').trim().replace(/\.zip$/i, '');
+ return /^[^\\/:*?"<>|]+$/.test(name) ? name : '';
+}
+
+// ============================================================================
+// Minecraft versions
+// ============================================================================
+
+// Versions whose resource pack layout matches what the plugin exports (1.21.2+)
+const MC_VERSIONS = [
+ {id: '26.2', name: '26.2', rp: 88, dp: 107, new_meta: true},
+ {id: '26.1.2', name: '26.1.2', rp: 84, dp: 101, new_meta: true},
+ {id: '1.21.11', name: '1.21.11', rp: 75, dp: 94, new_meta: true},
+ {id: '1.21.9', name: '1.21.9 – 1.21.10', rp: 69, dp: 88, new_meta: true},
+ {id: '1.21.7', name: '1.21.7 – 1.21.8', rp: 64, dp: 81},
+ {id: '1.21.6', name: '1.21.6', rp: 63, dp: 80},
+ {id: '1.21.5', name: '1.21.5', rp: 55, dp: 71},
+ {id: '1.21.4', name: '1.21.4', rp: 46, dp: 61, template_item: true},
+ {id: '1.21.2', name: '1.21.2 – 1.21.3', rp: 42, dp: 57, template_item: true},
+];
+const DEFAULT_MC_VERSION = '1.21.11';
+
+function mcVersion(id) {
+ return MC_VERSIONS.find(v => v.id == id) || MC_VERSIONS.find(v => v.id == DEFAULT_MC_VERSION);
+}
+function versionOptions() {
+ let options = {};
+ for (let v of MC_VERSIONS) options[v.id] = v.name;
+ return options;
+}
+function mcmetaText(version, kind) {
+ let format = kind == 'rp' ? version.rp : version.dp;
+ let pack = {description: 'Armor trims'};
+ if (version.new_meta) {
+ pack.min_format = format;
+ pack.max_format = format;
+ } else {
+ pack.pack_format = format;
+ }
+ return JSON.stringify({pack}, null, '\t') + '\n';
+}
+function mcmetaFormat(json) {
+ let pack = json && json.pack || {};
+ let value = pack.max_format ?? pack.pack_format ?? pack.min_format;
+ return Array.isArray(value) ? value[0] : value;
+}
+
+// ============================================================================
+// Export to resource pack
+// ============================================================================
+
+function rpTargetPath(e) {
+ if (e.pack_type == 'folder') return e.pack_path || '';
+ let name = zipFileName(e.zip_name);
+ return e.zip_dir && name ? PathModule.join(e.zip_dir, name + '.zip') : '';
+}
+function exportPlan(data) {
+ let e = data.export;
+ let id = data.trim_id;
+ let ns = e.namespace || 'minecraft';
+ let plan = {target: rpTargetPath(e), type: e.pack_type, id, ns, files: [], atlas: null, version: mcVersion(data.mc_version)};
+ plan.files.push({kind: 'texture', role: 'trim_humanoid', rel: `assets/${ns}/textures/trims/entity/humanoid/${id}.png`});
+ plan.files.push({kind: 'texture', role: 'trim_leggings', rel: `assets/${ns}/textures/trims/entity/humanoid_leggings/${id}.png`});
+ if (e.icon) {
+ let tex_id = parseResourceId(e.icon_texture.replace(/\{id\}/g, id));
+ let model_id = parseResourceId(e.icon_model.replace(/\{id\}/g, id));
+ plan.icon_texture_id = tex_id.ns + ':' + tex_id.path;
+ plan.icon_model_id = model_id.ns + ':' + model_id.path;
+ plan.files.push({kind: 'texture', role: 'icon', icon: true, rel: `assets/${tex_id.ns}/textures/${tex_id.path}.png`});
+ plan.files.push({kind: 'model', icon: true, rel: `assets/${model_id.ns}/models/${model_id.path}.json`,
+ content: JSON.stringify({parent: e.icon_parent || 'minecraft:item/generated', textures: {layer0: plan.icon_texture_id}}, null, 4)});
+ }
+ // Vanilla patterns are already listed in the vanilla atlas
+ plan.vanilla = ns == 'minecraft' && VANILLA_PATTERNS.includes(id);
+ if (e.register_atlas && !plan.vanilla) plan.atlas = 'assets/minecraft/atlases/armor_trims.json';
+ return plan;
+}
+function exportPlanErrors(data, plan) {
+ let errors = [];
+ let e = data.export;
+ let id_error = trimIdError(data.trim_id);
+ if (id_error) errors.push(id_error);
+ if (e.pack_type == 'folder') {
+ if (!e.pack_path) errors.push(t('no_resource_pack_folder_selected'));
+ else if (!isDirectory(e.pack_path)) errors.push(t('resource_pack_folder_not_found') + e.pack_path);
+ } else {
+ if (!e.zip_dir) errors.push(t('no_zip_folder'));
+ else if (pathExists(e.zip_dir) && !isDirectory(e.zip_dir)) errors.push(t('dp_not_folder') + e.zip_dir);
+ if (!zipFileName(e.zip_name)) errors.push(t('invalid_zip_name'));
+ }
+ if (!isValidNamespace(e.namespace || 'minecraft')) errors.push(t('invalid_texture_namespace'));
+ if (e.icon) {
+ for (let id of [plan.icon_texture_id, plan.icon_model_id]) {
+ let p = parseResourceId(id);
+ if (!isValidNamespace(p.ns) || !isValidPath(p.path)) errors.push(t('invalid_icon_path') + id);
+ }
+ }
+ return errors;
+}
+function detectIndent(text) {
+ let m = text && text.match(/\n([ \t]+)"/);
+ if (!m) return 4;
+ return m[1].includes('\t') ? '\t' : m[1].length;
+}
+function updateAtlasJSON(text, texture_ids, sync_permutations, permutations = VANILLA_PERMUTATIONS) {
+ let json;
+ if (text) {
+ json = JSON.parse(text);
+ } else {
+ json = {sources: []};
+ }
+ if (!Array.isArray(json.sources)) json.sources = [];
+ let is_palette_source = (s) => s && /(^|:)paletted_permutations$/.test(s.type || '') &&
+ normalizeId(s.palette_key || '') == 'minecraft:trims/color_palettes/trim_palette';
+ let source = json.sources.find(is_palette_source);
+ let changes = [];
+ // Follow the style already used in the file (with or without "minecraft:")
+ let prefixed = source && Array.isArray(source.textures) && source.textures.length ? source.textures.some(t => t.startsWith('minecraft:')) : false;
+ if (!source) {
+ source = {type: 'paletted_permutations', textures: [], palette_key: 'trims/color_palettes/trim_palette', permutations: {}};
+ for (let perm of permutations) source.permutations[perm] = 'trims/color_palettes/' + perm;
+ json.sources.push(source);
+ changes.push(t('created_paletted_permutations_source'));
+ }
+ if (!Array.isArray(source.textures)) source.textures = [];
+ for (let id of texture_ids) {
+ let listed = json.sources.some(s => Array.isArray(s.textures) && s.textures.some(t => normalizeId(t) == normalizeId(id)));
+ if (!listed) {
+ let p = parseResourceId(id);
+ source.textures.push(p.ns == 'minecraft' && !prefixed ? p.path : p.ns + ':' + p.path);
+ changes.push(t('added_texture') + id);
+ }
+ }
+ if (sync_permutations) {
+ if (!source.permutations || typeof source.permutations != 'object') source.permutations = {};
+ let perm_prefixed = Object.values(source.permutations).some(v => String(v).startsWith('minecraft:'));
+ for (let perm of permutations) {
+ if (!(perm in source.permutations)) {
+ source.permutations[perm] = (perm_prefixed ? 'minecraft:' : '') + 'trims/color_palettes/' + perm;
+ changes.push(t('added_palette') + perm);
+ }
+ }
+ }
+ return {json, changes};
+}
+function textureBuffer(texture) {
+ return dataURLToBuffer(texture.canvas.toDataURL('image/png'));
+}
+function packIconBuffer() {
+ // pack.png for a new pack: the template icon scaled up without smoothing
+ let icon = findTexture('icon');
+ if (!icon || !icon.canvas || !icon.canvas.width) return null;
+ let {canvas, ctx} = makeCanvas(128, 128);
+ ctx.drawImage(icon.canvas, 0, 0, 128, 128);
+ return dataURLToBuffer(canvas.toDataURL('image/png'));
+}
+const BACKUPS_KEPT = 10;
+function isUnderGit(path) {
+ // A folder pack (or the folder of a zip) inside a git work tree already has its history
+ if (!path) return false;
+ let dir = /\.zip$/i.test(path) ? PathModule.dirname(path) : path;
+ for (let i = 0; i < 32 && dir; i++) {
+ if (pathExists(PathModule.join(dir, '.git'))) return true;
+ let parent = PathModule.dirname(dir);
+ if (parent == dir) break;
+ dir = parent;
+ }
+ return false;
+}
+function backupStamp(data, target) {
+ if (!data.export.backup || isUnderGit(target)) return null;
+ return new Date().toISOString().replace(/[:.]/g, '-');
+}
+function pruneBackups() {
+ let root = PathModule.join(SystemInfo.user_data_directory, 'armor_trim_editor_backups');
+ let stamps = readDir(root).filter(name => /^\d{4}-\d\d-\d\dT/.test(name)).sort();
+ for (let name of stamps.slice(0, Math.max(0, stamps.length - BACKUPS_KEPT))) {
+ try { getFS().rmSync(PathModule.join(root, name), {recursive: true, force: true}); } catch (err) { console.warn('[Trim Editor] backup cleanup:', err); }
+ }
+}
+function backupFile(path, pack, stamp) {
+ let fs = getFS();
+ if (!fs.existsSync(path)) return;
+ let rel = PathModule.relative(pack, path);
+ let target = PathModule.join(SystemInfo.user_data_directory, 'armor_trim_editor_backups', stamp, PathModule.basename(pack), rel);
+ ensureDir(PathModule.dirname(target));
+ fs.copyFileSync(path, target);
+}
+function planHeader(pack) {
+ if (pack.kind == 'zip') return `📦 ${PathModule.basename(pack.path)} — ${pack.existed ? t('archive_update') : t('archive_new')}`;
+ return `📁 ${pack.path}`;
+}
+async function describePlan(plan, data) {
+ let pack = await packStorage(plan.target).load();
+ let mark = (rel) => pack.exists(rel) ? '♻ ' : '＋ ';
+ let lines = [planHeader(pack)];
+ lines.push((pack.exists('pack.mcmeta') ? '· ' : '＋ ') + 'pack.mcmeta');
+ if (!pack.exists('pack.png') && (pack.kind == 'zip' || !pack.exists('pack.mcmeta')) && findTexture('icon')) lines.push('＋ pack.png');
+ let icon_empty = iconIsEmpty(findTexture('icon'));
+ for (let file of plan.files) lines.push(file.icon && icon_empty ? '· ' + t('template_icon_empty_skipped') + ': ' + file.rel : mark(file.rel) + file.rel);
+ if (plan.atlas) lines.push((pack.exists(plan.atlas) ? '✎ ' : '＋ ') + plan.atlas);
+ if (data) lines.push(...await describeArmorIcons(pack, data));
+ return lines;
+}
+async function runExport(quiet = false) {
+ let data = D();
+ if (!data) return;
+ let plan = exportPlan(data);
+ let errors = exportPlanErrors(data, plan);
+ if (errors.length) {
+ Blockbench.showMessageBox({title: t('cannot_export'), icon: 'error', message: errors.map(escapeHTML).join('
+
+ arrow_forward
+
+
+ ${t('base')}
${t('result')}
+
+
+
+
+
+
+
+ {{ gen.contrast.toFixed(2) }}
+
+ ${t('the_glyph_cyan_pixels_of_vanilla')}
+ {{ status }}
+ ')}); + return; + } + let written = []; + let stamp = backupStamp(data, plan.target); + try { + let pack = await packStorage(plan.target).load(); + // Folder packs back up each overwritten file, zip archives are backed up as a whole on save + let file_stamp = pack.kind == 'folder' ? stamp : null; + let created = !pack.exists('pack.mcmeta'); + if (created) { + pack.write('pack.mcmeta', mcmetaText(plan.version, 'rp')); + written.push('pack.mcmeta'); + } + if (!pack.exists('pack.png') && (pack.kind == 'zip' || created)) { + let icon = packIconBuffer(); + if (icon) { + pack.write('pack.png', icon); + written.push('pack.png'); + } + } + let unchanged = 0; + let notes = []; + // An empty template icon would only replace a real one or add junk files + let icon_empty = iconIsEmpty(findTexture('icon')); + if (icon_empty && plan.files.some(file => file.icon)) notes.push(t('template_icon_empty_skipped')); + for (let file of plan.files) { + if (file.icon && icon_empty) continue; + let changed; + if (file.kind == 'texture') { + let texture = findTexture(file.role); + if (!texture) continue; + changed = await writeTextureIfChanged(pack, file.rel, texture, file_stamp); + } else { + changed = await writeJSONIfChanged(pack, file.rel, JSON.parse(file.content), file_stamp, 4); + } + if (changed) written.push(file.rel); + else unchanged++; + } + let atlas_changes = []; + if (plan.atlas) { + let text = await readPackText(pack, plan.atlas) || ''; + let ids = [`${plan.ns}:trims/entity/humanoid/${plan.id}`, `${plan.ns}:trims/entity/humanoid_leggings/${plan.id}`]; + // Resin came with 1.21.4, copper_darker with 1.21.9 + let permutations = VANILLA_PERMUTATIONS.filter(perm => (perm != 'copper_darker' || plan.version.rp >= 69) && (perm != 'resin' || plan.version.rp >= 46)); + let result = updateAtlasJSON(text, ids, data.export.sync_permutations, permutations); + if (result.changes.length) { + writeJSON(pack, plan.atlas, result.json, text, file_stamp); + written.push(plan.atlas); + } + atlas_changes = result.changes; + } + if (data.export.backup && !stamp) notes.push(t('backup_skipped_git')); + let icons_summary = data.export.armor_icons ? await exportArmorIcons(pack, data, file_stamp, written, notes) : ''; + await pack.save(stamp); + if (stamp) pruneBackups(); + let e = data.export; + Prefs.set({pack_type: e.pack_type, pack_path: e.pack_path, zip_dir: e.zip_dir, zip_name: e.zip_name, namespace: e.namespace, + icon_texture: e.icon_texture, icon_model: e.icon_model, icon_parent: e.icon_parent, mc_version: data.mc_version}); + data.last_export = {time: Date.now(), files: written.length}; + if (quiet) { + let extra = notes.length ? notes[0] : unchanged ? t('files_unchanged', [unchanged]) : ''; + notify(t('trim_exported_files', [plan.id, written.length]) + (extra ? ' · ' + extra : ''), notes.length ? 5000 : 2500); + } else { + showExportResult(plan, pack, written, atlas_changes, notes, icons_summary, unchanged); + } + } catch (err) { + showError(t('export_failed'), err); + } +} +function itemSnippet(plan) { + return JSON.stringify({threshold: 0, model: {type: 'minecraft:model', model: plan.icon_model_id}}, null, 4); +} +function showExportResult(plan, pack, written, atlas_changes, notes = [], icons_summary = '', unchanged = 0) { + let html = `
${t('written_to')}: ${escapeHTML(pack.path)}
`; + html += `${t('files_written')}: ${written.length}
- ${written.map(p => `
- ${escapeHTML(p)} `).join('')}
${t('files_unchanged', [unchanged])}
`; + if (atlas_changes.length) html += `${t('atlas')}: ${atlas_changes.map(escapeHTML).join(', ')}
`; + if (icons_summary) html += `${escapeHTML(icons_summary)}
`; + if (plan.vanilla) html += `${t('vanilla_atlas_note')}
`; + if (notes.length) html += `${notes.map(escapeHTML).join('
')}
${t('in_game_press_f3_t_to_reload_resources')}
`; + new Dialog({ + id: 'armor_trim_editor_export_result', + title: t('trim_exported'), + width: 580, + component: {template: `${html}
`},
+ buttons: [t('copy_items_entry'), t('datapack'), t('open_folder'), t('done')],
+ cancelIndex: 3,
+ confirmIndex: 3,
+ onButton(index) {
+ if (index == 0 && plan.icon_model_id) {
+ Clipbench.setText(itemSnippet(plan));
+ notify(t('copied_fill_in_the_threshold'));
+ return false;
+ }
+ if (index == 1) {
+ setTimeout(openDatapackDialog, 50);
+ return;
+ }
+ if (index == 2) {
+ revealInFolder(pack.kind == 'zip' ? pack.path : pack.abs(plan.files[0].rel));
+ return false;
+ }
+ },
+ }).show();
+}
+function planHolder(dialog, id) {
+ let holder = dialog.object && dialog.object.querySelector('#' + id);
+ if (!holder && dialog.object) {
+ holder = document.createElement('div');
+ holder.id = id;
+ holder.className = 'te_export_plan';
+ dialog.object.querySelector('.dialog_content').appendChild(holder);
+ }
+ return holder;
+}
+
+function openExportDialog() {
+ let data = D();
+ if (!data) return;
+ let e = data.export;
+ let preview_run = 0;
+ let dialog = new Dialog({
+ id: 'armor_trim_editor_export',
+ title: t('export_trim_to_resource_pack'),
+ width: 640,
+ form: {
+ trim_id: {label: t('trim_id'), type: 'text', value: data.trim_id,
+ description: t('file_name_and_pattern_asset_id_as_in_the')},
+ pack_type: {label: t('rp_type'), type: 'inline_select', value: e.pack_type || 'zip',
+ options: {zip: t('rp_type_zip'), folder: t('rp_type_folder')}},
+ zip_dir: {label: t('zip_dir'), type: 'folder', value: e.zip_dir, description: t('zip_dir_desc'), condition: (f) => f.pack_type != 'folder'},
+ zip_name: {label: t('zip_name'), type: 'text', value: e.zip_name, description: t('zip_name_desc'), condition: (f) => f.pack_type != 'folder'},
+ pack_path: {label: t('resource_pack_folder'), type: 'folder', value: e.pack_path, description: t('rp_folder_desc'), condition: (f) => f.pack_type == 'folder'},
+ mc_version: {label: t('dp_version'), type: 'select', options: versionOptions(), value: mcVersion(data.mc_version).id, description: t('mc_version_desc')},
+ namespace: {label: t('texture_namespace'), type: 'text', value: e.namespace || 'minecraft',
+ description: t('namespace_of_the_pattern_asset_id')},
+ _atlas: {type: 'info', text: t('atlas_assets_minecraft_atlases_armor')},
+ register_atlas: {label: t('register_in_atlas'), type: 'checkbox', value: e.register_atlas},
+ sync_permutations: {label: t('add_missing_vanilla_palettes'), type: 'checkbox', value: e.sync_permutations,
+ description: t('e_g_copper_darker_without_it_a_copper')},
+ _icon: {type: 'info', text: t('template_icon_id_is_replaced_with_the')},
+ icon: {label: t('export_icon_and_model'), type: 'checkbox', value: e.icon},
+ icon_texture: {label: t('icon_texture'), type: 'text', value: e.icon_texture, condition: (f) => f.icon},
+ icon_model: {label: t('icon_model'), type: 'text', value: e.icon_model, condition: (f) => f.icon},
+ icon_parent: {label: t('model_parent'), type: 'text', value: e.icon_parent, condition: (f) => f.icon},
+ _armor_icons: {type: 'info', text: t('armor_icons_export_info')},
+ armor_icons: {label: t('export_armor_icons'), type: 'checkbox', value: e.armor_icons, description: t('export_armor_icons_desc')},
+ icon_colors: {label: t('icon_colors'), type: 'select', value: e.icon_colors || 'palette', condition: (f) => f.armor_icons,
+ options: {palette: t('icon_colors_palette'), fixed: t('icon_colors_fixed')}},
+ _other: {type: 'info', text: t('other')},
+ backup: {label: t('back_up_overwritten_files'), type: 'checkbox', value: e.backup,
+ description: t('copies_go_to_blockbench_data_armor_trim')},
+ },
+ async onFormChange(result) {
+ let run = ++preview_run;
+ let tmp = JSON.parse(JSON.stringify(data));
+ applyExportForm(tmp, result);
+ let plan = exportPlan(tmp);
+ let errors = exportPlanErrors(tmp, plan);
+ let html;
+ if (errors.length) {
+ html = `${errors.map(escapeHTML).join('
')}
`;
+ } else {
+ try {
+ html = `')}
${(await describePlan(plan, tmp)).map(escapeHTML).join('
')}
`;
+ } catch (err) {
+ html = `')}
${escapeHTML(err.message || String(err))}
`;
+ }
+ }
+ if (run != preview_run) return;
+ let holder = planHolder(this, 'te_export_plan');
+ if (holder) holder.innerHTML = `${t('dp_will_be_written')}
` + html;
+ },
+ onConfirm(result) {
+ applyExportForm(data, result);
+ updatePreviewUniforms();
+ refreshPanels();
+ runExport(false);
+ },
+ });
+ dialog.show();
+ setTimeout(() => dialog.onFormChange && dialog.onFormChange(dialog.getFormResult()), 50);
+}
+function applyExportForm(data, result) {
+ let new_id = sanitizeId(result.trim_id);
+ if (data === Project.armor_trim_editor && new_id && Project.name == data.trim_id) {
+ Project.name = new_id;
+ if (typeof setProjectTitle == 'function') setProjectTitle();
+ }
+ data.trim_id = new_id;
+ data.mc_version = result.mc_version;
+ let e = data.export;
+ e.pack_type = result.pack_type == 'folder' ? 'folder' : 'zip';
+ if (result.pack_path !== undefined) e.pack_path = result.pack_path;
+ if (result.zip_dir !== undefined) e.zip_dir = result.zip_dir;
+ if (result.zip_name !== undefined) e.zip_name = zipFileName(result.zip_name) || result.zip_name;
+ e.namespace = sanitizeId(result.namespace) || 'minecraft';
+ e.register_atlas = result.register_atlas;
+ e.sync_permutations = result.sync_permutations;
+ e.icon = result.icon;
+ if (result.icon_texture !== undefined) e.icon_texture = result.icon_texture.trim();
+ if (result.icon_model !== undefined) e.icon_model = result.icon_model.trim();
+ if (result.icon_parent !== undefined) e.icon_parent = result.icon_parent.trim();
+ e.armor_icons = result.armor_icons;
+ if (result.icon_colors !== undefined) e.icon_colors = result.icon_colors;
+ e.backup = result.backup;
+}
+function quickExport() {
+ let data = D();
+ if (!data) return;
+ if (!rpTargetPath(data.export) || !data.last_export) {
+ openExportDialog();
+ return;
+ }
+ runExport(true);
+}
+
+// ============================================================================
+// Datapack generator
+// ============================================================================
+
+const LANG_CODE = /^[a-z]{2,3}_[a-z]{2,4}$/;
+
+function patternKey(data) {
+ return (data.export.namespace || 'minecraft') + ':' + data.trim_id;
+}
+function titleCase(id) {
+ return id.split(/[_\-.]+/).filter(Boolean).map(w => w[0].toUpperCase() + w.substring(1)).join(' ');
+}
+function parseNames(text) {
+ let names = [], skipped = [];
+ for (let line of String(text || '').split(/\r?\n/)) {
+ line = line.trim();
+ if (!line) continue;
+ let i = line.indexOf('=');
+ let code = i > 0 ? line.substring(0, i).trim().toLowerCase() : '';
+ let name = i > 0 ? line.substring(i + 1).trim() : '';
+ if (!LANG_CODE.test(code)) {
+ skipped.push(line);
+ } else if (name) {
+ names.push({code, name});
+ }
+ }
+ return {names, skipped};
+}
+async function langNamesFromPack(data) {
+ // Existing names of this pattern in the resource pack, as "code=name" lines
+ let target = rpTargetPath(data.export);
+ let key = `trim_pattern.${data.export.namespace || 'minecraft'}.${data.trim_id}`;
+ let lines = [];
+ if (target && pathExists(target)) {
+ try {
+ let pack = await packStorage(target).load();
+ for (let file of pack.listDir('assets/minecraft/lang')) {
+ if (!file.endsWith('.json')) continue;
+ try {
+ let json = JSON.parse(await readPackText(pack, 'assets/minecraft/lang/' + file));
+ if (typeof json[key] == 'string') lines.push(file.replace('.json', '') + '=' + json[key]);
+ } catch (err) {}
+ }
+ } catch (err) {}
+ }
+ if (!lines.some(l => l.startsWith('en_us='))) lines.unshift('en_us=' + titleCase(data.trim_id));
+ if (Language.code == 'ru' && !lines.some(l => l.startsWith('ru_ru='))) lines.push('ru_ru=');
+ return lines.join('\n');
+}
+
+function datapackPlan(data) {
+ let d = data.datapack;
+ let ns = data.export.namespace || 'minecraft';
+ let id = data.trim_id;
+ let version = mcVersion(data.mc_version);
+ let name = zipFileName(d.name);
+ let plan = {file: d.dir && name ? PathModule.join(d.dir, name + '.zip') : '', ns, id, version, key: ns + ':' + id, lang: [], skipped: []};
+ plan.pattern_rel = `data/${ns}/trim_pattern/${id}.json`;
+ plan.pattern = {
+ asset_id: ns + ':' + id,
+ description: {translate: `trim_pattern.${ns}.${id}`},
+ decal: !!d.decal,
+ };
+ // Before 1.21.5 a pattern needs a template item; structure_void cannot be obtained in survival
+ if (version.template_item) plan.pattern.template_item = 'minecraft:structure_void';
+ let {names, skipped} = parseNames(d.names);
+ plan.skipped = skipped;
+ plan.rp_target = rpTargetPath(data.export);
+ if (names.length && plan.rp_target) {
+ for (let entry of names) plan.lang.push(Object.assign({rel: `assets/minecraft/lang/${entry.code}.json`}, entry));
+ }
+ plan.names_without_pack = names.length > 0 && !plan.rp_target;
+ return plan;
+}
+function datapackErrors(data, plan) {
+ let errors = [];
+ let d = data.datapack;
+ let id_error = trimIdError(data.trim_id);
+ if (id_error) errors.push(id_error);
+ if (!d.dir) errors.push(t('dp_no_folder'));
+ else if (pathExists(d.dir) && !isDirectory(d.dir)) errors.push(t('dp_not_folder') + d.dir);
+ if (!zipFileName(d.name)) errors.push(t('invalid_zip_name'));
+ if (plan.rp_target && data.export.pack_type == 'folder' && !isDirectory(plan.rp_target)) errors.push(t('resource_pack_folder_not_found') + plan.rp_target);
+ return errors;
+}
+async function describeDatapackPlan(plan) {
+ let dp = await new ZipPack(plan.file).load();
+ let lines = [planHeader(dp)];
+ lines.push((dp.exists('pack.mcmeta') ? '· ' : '＋ ') + 'pack.mcmeta');
+ lines.push((dp.exists(plan.pattern_rel) ? '♻ ' : '＋ ') + plan.pattern_rel);
+ if (plan.lang.length) {
+ let rp = await packStorage(plan.rp_target).load();
+ let key = `trim_pattern.${plan.ns}.${plan.id}`;
+ for (let entry of plan.lang) {
+ let mark = '＋ ';
+ if (rp.exists(entry.rel)) {
+ let current;
+ try { current = JSON.parse(await readPackText(rp, entry.rel))[key]; } catch (err) {}
+ mark = current === entry.name ? '· ' : '✎ ';
+ }
+ lines.push(mark + t('dp_rp') + PathModule.basename(rp.path) + ' › ' + entry.rel + ` — ${entry.name}`);
+ }
+ }
+ return lines;
+}
+async function runDatapackExport() {
+ let data = D();
+ if (!data) return;
+ let plan = datapackPlan(data);
+ let errors = datapackErrors(data, plan);
+ if (errors.length) {
+ Blockbench.showMessageBox({title: t('dp_title'), icon: 'error', message: errors.map(escapeHTML).join('')}); + return; + } + let stamp = backupStamp(data, plan.file); + let written = [], notes = []; + try { + let dp = await new ZipPack(plan.file).load(); + if (!dp.exists('pack.mcmeta')) { + dp.write('pack.mcmeta', mcmetaText(plan.version, 'dp')); + written.push('pack.mcmeta'); + } else { + let format; + try { format = mcmetaFormat(JSON.parse(await readPackText(dp, 'pack.mcmeta'))); } catch (err) {} + if (format != plan.version.dp) notes.push(t('dp_format_mismatch', [String(format), plan.version.name, plan.version.dp])); + } + dp.write(plan.pattern_rel, JSON.stringify(plan.pattern, null, 2) + '\n'); + written.push(plan.pattern_rel); + await dp.save(stamp); + if (stamp) pruneBackups(); + + if (plan.lang.length) { + let rp = await packStorage(plan.rp_target).load(); + let file_stamp = rp.kind == 'folder' ? stamp : null; + if (!rp.exists('pack.mcmeta')) rp.write('pack.mcmeta', mcmetaText(plan.version, 'rp')); + let key = `trim_pattern.${plan.ns}.${plan.id}`; + for (let entry of plan.lang) { + let text = await readPackText(rp, entry.rel) || ''; + let json = text ? JSON.parse(text) : {}; + if (json[key] === entry.name) continue; + json[key] = entry.name; + writeJSON(rp, entry.rel, json, text, file_stamp); + written.push(t('dp_rp') + PathModule.basename(rp.path) + ' › ' + entry.rel); + } + await rp.save(stamp); + } + if (plan.names_without_pack) notes.push(t('dp_names_need_pack')); + for (let line of plan.skipped) notes.push(t('dp_bad_name_line', [line])); + Prefs.set({datapack_dir: data.datapack.dir, datapack_name: data.datapack.name, mc_version: data.mc_version}); + showDatapackResult(plan, written, notes); + } catch (err) { + showError(t('dp_title'), err); + } +} +async function openDatapackDialog() { + let data = D(); + if (!data) return; + let d = data.datapack; + if (!d.names) d.names = await langNamesFromPack(data); + let preview_run = 0; + let dialog = new Dialog({ + id: 'armor_trim_editor_datapack', + title: t('dp_title'), + width: 640, + form: { + _pattern: {type: 'info', text: t('dp_pattern_info', [patternKey(data)])}, + dir: {label: t('dp_dir'), type: 'folder', value: d.dir, description: t('dp_dir_desc')}, + name: {label: t('zip_name'), type: 'text', value: d.name, description: t('dp_name_desc')}, + version: {label: t('dp_version'), type: 'select', options: versionOptions(), value: mcVersion(data.mc_version).id}, + decal: {label: 'Decal', type: 'checkbox', value: d.decal, description: t('dp_decal_desc')}, + names: {label: t('dp_names'), type: 'textarea', height: 64, value: d.names, + description: t('dp_names_desc', [`${data.export.namespace || 'minecraft'}.${data.trim_id}`])}, + }, + async onFormChange(result) { + let run = ++preview_run; + let tmp = JSON.parse(JSON.stringify(data)); + Object.assign(tmp.datapack, {dir: result.dir, name: result.name, decal: result.decal, names: result.names}); + tmp.mc_version = result.version; + let plan = datapackPlan(tmp); + let errors = datapackErrors(tmp, plan); + let html; + if (errors.length) { + html = `
${errors.map(escapeHTML).join('
')}
`;
+ } else {
+ try {
+ html = `')}
${(await describeDatapackPlan(plan)).map(escapeHTML).join('
')}
`;
+ } catch (err) {
+ html = `')}
${escapeHTML(err.message || String(err))}
`;
+ }
+ if (plan.names_without_pack) html += `${t('dp_names_need_pack')}
`;
+ }
+ if (run != preview_run) return;
+ let holder = planHolder(this, 'te_datapack_plan');
+ if (holder) holder.innerHTML = `${t('dp_will_be_written')}
` + html;
+ },
+ onConfirm(result) {
+ Object.assign(d, {dir: result.dir, name: zipFileName(result.name) || result.name, decal: result.decal, names: result.names});
+ updatePreviewUniforms();
+ refreshPanels();
+ data.mc_version = result.version;
+ runDatapackExport();
+ },
+ });
+ dialog.show();
+ setTimeout(() => dialog.onFormChange && dialog.onFormChange(dialog.getFormResult()), 50);
+}
+
+function giveCommand(key) {
+ return `/give @s minecraft:diamond_chestplate[minecraft:trim={material:"minecraft:redstone",pattern:"${key}"}]`;
+}
+function paperCode(key) {
+ let p = parseResourceId(key);
+ let namespaced = p.ns == 'minecraft' ? `NamespacedKey.minecraft("${p.path}")` : `NamespacedKey.fromString("${p.ns}:${p.path}")`;
+ return [
+ 'TrimPattern pattern = RegistryAccess.registryAccess()',
+ ' .getRegistry(RegistryKey.TRIM_PATTERN)',
+ ` .get(${namespaced});`,
+ 'if (pattern != null) {',
+ ' ArmorTrim trim = new ArmorTrim(TrimMaterial.REDSTONE, pattern);',
+ ' item.editMeta(ArmorMeta.class, meta -> meta.setTrim(trim));',
+ '}',
+ ].join('\n');
+}
+function gameGuideHTML(key) {
+ return `
+ ${t('guide_server_h')}
+-
+
- ${t('guide_server_1')} +
- ${t('guide_server_2')} +
- ${t('guide_server_3')} +
${t('guide_give_h')}
+${escapeHTML(giveCommand(key))}
+ ${t('guide_material')} ${t('guide_smithing')}
+${t('guide_plugin_h')}
+${escapeHTML(paperCode(key))}
+ ${t('guide_plugin_note')}
`; +} +function guideButtons(key) { + return { + buttons: [t('copy_give'), t('copy_code'), t('done')], + onButton(index) { + if (index == 0) { + Clipbench.setText(giveCommand(key)); + notify(t('copied')); + return false; + } + if (index == 1) { + Clipbench.setText(paperCode(key)); + notify(t('copied')); + return false; + } + }, + }; +} +function showDatapackResult(plan, written, notes) { + let html = `${t('written_to')}: ${escapeHTML(plan.file)}
`; + html += `${t('files_written')}: ${written.length}
- ${written.map(p => `
- ${escapeHTML(p)} `).join('')}
${escapeHTML(note)}
`; + html += gameGuideHTML(plan.key); + new Dialog(Object.assign({ + id: 'armor_trim_editor_datapack_result', + title: t('dp_done_title'), + width: 640, + component: {template: `${html}
`},
+ cancelIndex: 2,
+ confirmIndex: 2,
+ }, guideButtons(plan.key))).show();
+}
+function openGameGuide() {
+ let data = D();
+ let key = data ? patternKey(data) : 'minecraft:my_trim';
+ new Dialog(Object.assign({
+ id: 'armor_trim_editor_guide',
+ title: t('guide_title'),
+ width: 640,
+ component: {template: `${gameGuideHTML(key)}
`},
+ cancelIndex: 2,
+ confirmIndex: 2,
+ }, guideButtons(key))).show();
+}
+
+// ============================================================================
+// Import
+// ============================================================================
+
+async function scanPackTrims(pack) {
+ let found = {};
+ let add = (ns, id, key, rel) => {
+ let k = ns + ':' + id;
+ if (!found[k]) found[k] = {ns, id, humanoid: null, leggings: null, registered: false};
+ if (key) found[k][key] = rel;
+ };
+ for (let ns of pack.listDir('assets')) {
+ for (let [layer, key] of [['humanoid', 'humanoid'], ['humanoid_leggings', 'leggings']]) {
+ let dir = `assets/${ns}/textures/trims/entity/${layer}`;
+ for (let file of pack.listDir(dir)) {
+ let m = file.match(/^([a-z0-9_.\-]+)\.png$/);
+ if (m) add(ns, m[1], key, dir + '/' + file);
+ }
+ }
+ }
+ try {
+ let atlas = JSON.parse(await readPackText(pack, 'assets/minecraft/atlases/armor_trims.json'));
+ for (let source of atlas.sources || []) {
+ for (let t of source.textures || []) {
+ let p = parseResourceId(t);
+ let m = p.path.match(/^trims\/entity\/humanoid(?:_leggings)?\/(.+)$/);
+ if (m) {
+ add(p.ns, m[1]);
+ found[p.ns + ':' + m[1]].registered = true;
+ }
+ }
+ }
+ } catch (err) {}
+ return Object.values(found).sort((a, b) => a.id.localeCompare(b.id));
+}
+async function readPackPNG(pack, rel) {
+ if (!rel) return null;
+ let buffer = await pack.read(rel);
+ return buffer ? bufferToDataURL(buffer) : null;
+}
+function iconRel(pattern, id) {
+ let p = parseResourceId(pattern.replace(/\{id\}/g, id));
+ return `assets/${p.ns}/textures/${p.path}.png`;
+}
+async function guessIconPattern(pack, ids) {
+ // The folder that holds a picture for most of the trims is where the template icons live
+ let counts = new Map();
+ for (let ns of pack.listDir('assets')) {
+ for (let rel of pack.listFiles(`assets/${ns}/textures/`)) {
+ let m = rel.match(/^assets\/([^/]+)\/textures\/(.+)\/([^/]+)\.png$/);
+ if (!m || /(^|\/)trims\//.test(m[2])) continue;
+ let name = m[3], pattern = null;
+ if (ids.has(name)) pattern = `${m[1]}:${m[2]}/{id}`;
+ else if (name.endsWith('_armor_trim_smithing_template') && ids.has(name.slice(0, -29))) pattern = `${m[1]}:${m[2]}/{id}_armor_trim_smithing_template`;
+ if (pattern) counts.set(pattern, (counts.get(pattern) || 0) + 1);
+ }
+ }
+ let best = [...counts].sort((a, b) => b[1] - a[1])[0];
+ return best && best[1] >= Math.max(1, Math.ceil(ids.size / 2)) ? {pattern: best[0], count: best[1]} : null;
+}
+function openImportDialog() {
+ let prefs = Prefs.get();
+ let pack = prefs.import_path || rpTargetPath({pack_type: prefs.pack_type, pack_path: prefs.pack_path, zip_dir: prefs.zip_dir, zip_name: prefs.zip_name}) || '';
+ let dialog = new Dialog({
+ id: 'armor_trim_editor_import',
+ title: t('open_trim_from_resource_pack'),
+ width: 600,
+ component: {
+ data() {
+ return {pack, list: [], selected: [], last: '', icon_pattern: prefs.icon_texture || DEFAULT_ICON_ID, icon_typed: false, error: '', filter: '', storage: null, guessed: false};
+ },
+ computed: {
+ filtered() {
+ let f = this.filter.toLowerCase();
+ return this.list.filter(t => !f || t.id.includes(f) || t.ns.includes(f));
+ },
+ },
+ methods: {
+ pickFolder() {
+ let path = Blockbench.pickDirectory({title: t('resource_pack_folder'), startpath: this.pack || undefined, resource_id: 'armor_trim_editor_pack'});
+ if (path) { this.pack = path; this.scan(); }
+ },
+ pickZip() {
+ Blockbench.import({extensions: ['zip'], type: t('rp_type_zip'), readtype: 'none', resource_id: 'armor_trim_editor_pack'}, (files) => {
+ if (files[0] && files[0].path) { this.pack = files[0].path; this.scan(); }
+ });
+ },
+ confirmDialog() {
+ if (Dialog.open && Dialog.open.id == 'armor_trim_editor_import') Dialog.open.confirm();
+ },
+ pick(trim, event) {
+ // Click selects one trim, Ctrl adds or removes one, Shift selects a range
+ let key = trim.ns + ':' + trim.id;
+ let keys = this.filtered.map(t => t.ns + ':' + t.id);
+ if (event.shiftKey && this.last && keys.includes(this.last)) {
+ let [a, b] = [keys.indexOf(this.last), keys.indexOf(key)].sort((x, y) => x - y);
+ this.selected = keys.slice(a, b + 1);
+ return;
+ }
+ if (event.ctrlKey || event.metaKey) {
+ this.selected = this.selected.includes(key) ? this.selected.filter(k => k != key) : this.selected.concat([key]);
+ } else {
+ this.selected = [key];
+ }
+ this.last = key;
+ },
+ selectAll() { this.selected = this.filtered.map(t => t.ns + ':' + t.id); },
+ async scan() {
+ this.error = '';
+ this.list = [];
+ this.storage = null;
+ try {
+ if (!this.pack || !pathExists(this.pack)) return;
+ if (!/\.zip$/i.test(this.pack) && !isDirectory(this.pack)) return;
+ let storage = await packStorage(this.pack).load();
+ let list = await scanPackTrims(storage);
+ let icons_root = await findIconsRoot(storage, mcVersion(Prefs.get().mc_version));
+ this.guessed = false;
+ // A remembered path that misses icons (another pack, a stray file) gives way to the folder that has most of them
+ let found = list.filter(trim => storage.exists(iconRel(this.icon_pattern, trim.id))).length;
+ if (list.length && found < list.length && !this.icon_typed) {
+ let guess = await guessIconPattern(storage, new Set(list.map(trim => trim.id)));
+ if (guess && guess.pattern != this.icon_pattern && guess.count > found) {
+ this.icon_pattern = guess.pattern;
+ this.guessed = true;
+ }
+ }
+ for (let trim of list) {
+ trim.icon = await readPackPNG(storage, iconRel(this.icon_pattern, trim.id));
+ trim.armor_icons = ICON_SLOTS.some(slot => storage.exists(`${icons_root.prefix}assets/minecraft/textures/${slot.texture}/${trim.ns}/${trim.id}.png`));
+ }
+ this.storage = storage;
+ this.list = list;
+ if (!list.length) this.error = t('no_trims_found_in_this_pack');
+ } catch (err) {
+ this.error = err.message || String(err);
+ }
+ },
+ },
+ mounted() { this.scan(); },
+ template: `
+
+
`,
+ },
+ onConfirm() {
+ let vm = this.content_vue;
+ let trims = vm ? vm.list.filter(t => vm.selected.includes(t.ns + ':' + t.id)) : [];
+ if (!trims.length || !vm.storage) return false;
+ Prefs.set({import_path: vm.pack, icon_texture: vm.icon_pattern});
+ let storage = vm.storage, pattern = vm.icon_pattern;
+ (async () => {
+ // One tab per trim, opened one after another
+ for (let trim of trims) await importFromPack(storage, trim, pattern);
+ if (trims.length > 1) notify(t('trims_opened', [trims.length]), 3000);
+ })().catch(err => showError(t('could_not_create_trim'), err));
+ },
+ });
+ dialog.show();
+}
+async function importFromPack(storage, trim, icon_pattern) {
+ // A trim that is already open from the same pack gets its tab back instead of a second copy
+ let open = (ModelProject.all || []).find(project => {
+ let data = project.armor_trim_editor;
+ return data && data.trim_id == trim.id && (data.export.namespace || 'minecraft') == trim.ns && rpTargetPath(data.export) == storage.path;
+ });
+ if (open) {
+ open.select();
+ return;
+ }
+ let target = storage.kind == 'zip'
+ ? {pack_type: 'zip', zip_dir: PathModule.dirname(storage.path), zip_name: PathModule.basename(storage.path).replace(/\.zip$/i, '')}
+ : {pack_type: 'folder', pack_path: storage.path};
+ await importTrim({
+ trim_id: trim.id,
+ humanoid: await readPackPNG(storage, trim.humanoid),
+ leggings: await readPackPNG(storage, trim.leggings),
+ icon: await readPackPNG(storage, iconRel(icon_pattern, trim.id)),
+ armor_icons: await readArmorIcons(storage, trim.ns, trim.id),
+ export: Object.assign({namespace: trim.ns, icon_texture: icon_pattern, icon_model: icon_pattern}, target),
+ });
+}
+async function importTrim(opts) {
+ let res = 1;
+ for (let url of [opts.humanoid, opts.leggings]) {
+ if (!url) continue;
+ let img = await loadImage(url);
+ res = Math.max(res, Math.round(img.naturalWidth / 64));
+ }
+ await startNewTrim(Object.assign({resolution: res}, opts));
+}
+
+// ============================================================================
+// New trim / settings dialogs
+// ============================================================================
+
+function openNewTrimDialog() {
+ let prefs = Prefs.get();
+ let patterns = {empty: t('empty')};
+ for (let p of VANILLA_PATTERNS) patterns['vanilla:' + p] = t('vanilla') + p;
+ let skins = {};
+ for (let s of DEFAULT_SKINS) skins[s] = s[0].toUpperCase() + s.substring(1);
+ let armors = {};
+ for (let a of ARMOR_MATERIALS) armors[a.id] = a.name;
+ new Dialog({
+ id: 'armor_trim_editor_new',
+ title: t('new_armor_trim'),
+ width: 520,
+ form: {
+ trim_id: {label: t('trim_id'), type: 'text', value: 'new_trim'},
+ base: {label: t('start_from'), type: 'select', options: patterns, value: 'empty'},
+ resolution: {label: t('resolution'), type: 'select', value: '1', options: {'1': '64×32 (16x)', '2': '128×64 (32x)', '4': '256×128 (64x)'}},
+ skin: {label: t('skin'), type: 'select', options: skins, value: 'steve'},
+ armor: {label: t('armor_under_trim'), type: 'select', options: armors, value: 'diamond'},
+ armor_icons: {label: t('armor_icons'), type: 'select', value: prefs.new_icons || 'project', description: t('new_icons_desc'),
+ options: {project: t('new_icons_project'), vanilla: t('new_icons_vanilla'), empty: t('new_icons_empty')}},
+ },
+ async onConfirm(result) {
+ let id = sanitizeId(result.trim_id) || 'new_trim';
+ let opts = {
+ trim_id: id,
+ resolution: parseInt(result.resolution) || 1,
+ armor: result.armor,
+ skin: {source: 'default', id: result.skin, slim: !!DEFAULT_SLIM[result.skin], name: ''},
+ icons_source: result.armor_icons == 'empty' ? null : result.armor_icons,
+ };
+ Prefs.set({new_icons: result.armor_icons});
+ if (result.base.startsWith('vanilla:')) {
+ let pattern = result.base.substring(8);
+ try {
+ opts.humanoid = await Assets.trim(pattern, 'humanoid');
+ opts.leggings = await Assets.trim(pattern, 'humanoid_leggings');
+ let template = await Assets.template(pattern);
+ if (template) opts.icon = template;
+ opts.resolution = 1;
+ } catch (err) {
+ showError(t('could_not_load_vanilla_trim'), err);
+ return;
+ }
+ }
+ startNewTrim(opts);
+ },
+ }).show();
+}
+
+function openSettingsDialog() {
+ let candidates = [];
+ try { candidates = Assets.candidates(); } catch (err) {}
+ let options = {};
+ for (let c of candidates) options[c.path] = `${c.version} — ${c.source}`;
+ let current = Assets.resolvePath();
+ if (current && !options[current]) options[current] = current;
+ options.custom = t('other_file');
+ new Dialog({
+ id: 'armor_trim_editor_settings',
+ title: t('trim_editor_settings'),
+ width: 640,
+ form: {
+ jar: {label: t('minecraft_client_jar'), type: 'select', options, value: current || 'custom'},
+ custom_jar: {label: t('jar_path'), type: 'file', extensions: ['jar'], filetype: 'JAR', condition: (f) => f.jar == 'custom'},
+ info: {type: 'info', text: t('the_jar_provides_default_skins_armor')},
+ },
+ onConfirm(result) {
+ let path = result.jar == 'custom' ? result.custom_jar : result.jar;
+ if (path) {
+ Assets.setPath(path);
+ notify(t('jar_saved'));
+ }
+ },
+ }).show();
+}
+
+function openHelpDialog() {
+ let rows = [
+ ['humanoid', t('helmet_0_0_at_1_0_and_outer_hat_32_0_at')],
+ ['humanoid_leggings', t('leggings_waist_16_16_at_0_5_legs_0_16_at')],
+ ];
+ let html = `
+
+
+
+
+ ${t('icon_pattern_guessed')}
+
+ -
+
-
+
+ {{ t.id }} {{ t.ns }} + +
+
{{ error }}
+ ${t('a_trim_is_drawn_on_the_same_model_as_the')}
+| ${r[0]} | ${r[1]} |
${t('two_layers_on_the_helmet_are_the_left')}
+${t('left_arm_and_leg_reuse_the_right_side')}
+${t('palette_only_the_8_grays_e0e0e0_000000')}
+${t('transparency_trims_render_as_cutout')}
+${t('server_the_pattern_is_registered_by_a')}
+${t('armor_icons_help_short')}
`; + new Dialog({id: 'armor_trim_editor_help', title: t('how_armor_trims_work'), width: 700, + component: {template: `${html}
`},
+ buttons: [t('guide_menu'), t('armor_icons_full'), t('done')], cancelIndex: 2, confirmIndex: 2,
+ onButton(index) {
+ if (index == 0) setTimeout(openGameGuide, 50);
+ if (index == 1) setTimeout(openArmorIconsHelp, 50);
+ }}).show();
+}
+
+// ============================================================================
+// Armor icons: the trim pattern on armor items in the inventory
+// ============================================================================
+
+// Vanilla draws one shared overlay on every trimmed armor icon, only its color follows the material.
+// Visual Armor Trims (Thanos, CC BY-SA 4.0) gives each pattern overlays of its own, one per armor shape:
+// four shapes shared by most armor and three items that are shaped differently.
+const ICON_SLOTS = [
+ {id: 'helmet', piece: 'helmet', generic: true, texture: 'trims/items/helmet_trim'},
+ {id: 'chestplate', piece: 'chestplate', generic: true, texture: 'trims/items/chestplate_trim'},
+ {id: 'leggings', piece: 'leggings', generic: true, texture: 'trims/items/leggings_trim'},
+ {id: 'boots', piece: 'boots', generic: true, texture: 'trims/items/boots_trim'},
+ {id: 'netherite_helmet', piece: 'helmet', item: 'netherite_helmet', texture: 'item/netherite_helmet/trim', copy_from: 'helmet'},
+ {id: 'turtle_helmet', piece: 'helmet', item: 'turtle_helmet', texture: 'item/turtle_helmet/trim', copy_from: 'helmet'},
+ {id: 'netherite_boots', piece: 'boots', item: 'netherite_boots', texture: 'item/netherite_boots/trim', copy_from: 'boots'},
+];
+// Every armor item: the icon it uses and the trim material that gets the darker palette on it
+const ARMOR_ITEMS = [];
+for (let [armor, prefix, material] of [['leather', 'leather', null], ['chainmail', 'chainmail', null], ['iron', 'iron', 'iron'], ['gold', 'golden', 'gold'],
+ ['diamond', 'diamond', 'diamond'], ['copper', 'copper', 'copper'], ['netherite', 'netherite', 'netherite']]) {
+ for (let piece of PIECE_ORDER) {
+ let item = prefix + '_' + piece;
+ let own_shape = armor == 'netherite' && (piece == 'helmet' || piece == 'boots');
+ ARMOR_ITEMS.push({item, armor, piece, slot: own_shape ? item : piece, material, leather: armor == 'leather'});
+ }
+}
+ARMOR_ITEMS.push({item: 'turtle_helmet', armor: 'turtle_scute', piece: 'helmet', slot: 'turtle_helmet', material: null, leather: false});
+const ITEM_PREFIX = {leather: 'leather', chainmail: 'chainmail', iron: 'iron', gold: 'golden', diamond: 'diamond', copper: 'copper', netherite: 'netherite'};
+const ICON_SHAPES = ['outline', 'inner_outline', 'stripes_h', 'stripes_v', 'diagonal', 'diagonal2', 'checker', 'dots',
+ 'band_top', 'band_middle', 'band_bottom', 'fill'];
+const ICON_SHEET_WIDTH = ICON_SLOTS.length * 16;
+
+function iconSlot(id) {
+ return ICON_SLOTS.find(s => s.id == id);
+}
+function iconTexture(slot_id) {
+ return findTexture('aicon_' + slot_id);
+}
+function iconTextures() {
+ return ICON_SLOTS.map(s => iconTexture(s.id)).filter(Boolean);
+}
+function filledIconSlots() {
+ return ICON_SLOTS.filter(slot => !iconIsEmpty(iconTexture(slot.id)));
+}
+function iconSlotItem(slot, armor) {
+ // The item drawn under an icon: the selected armor where it uses this icon, iron otherwise
+ if (!slot.generic) return slot.item;
+ let item = (ITEM_PREFIX[armor] || 'iron') + '_' + slot.id;
+ return ARMOR_ITEMS.some(a => a.item == item && a.slot == slot.id) ? item : 'iron_' + slot.id;
+}
+function itemTrimMaterial(item) {
+ let entry = ARMOR_ITEMS.find(a => a.item == item);
+ return entry ? entry.material : null;
+}
+function iconPaletteId(data, item, material = data.preview.material) {
+ if (!material || material == 'none' || data.export.icon_colors == 'fixed') return null;
+ return effectivePaletteId(material, itemTrimMaterial(item));
+}
+function iconCardBox(index) {
+ // Left of the player as seen from the front: the four common icons on top, the three special ones below
+ let slot = ICON_SLOTS[index];
+ let column = slot.generic ? index : {netherite_helmet: 0, turtle_helmet: 1, netherite_boots: 3}[slot.id];
+ let x1 = 98 - column * 18;
+ let y0 = slot.generic ? 18 : 0;
+ return {x0: x1 - 16, x1, y0, y1: y0 + 16};
+}
+function iconCardsBounds() {
+ let boxes = ICON_SLOTS.map((s, i) => iconCardBox(i));
+ return {
+ x0: Math.min(...boxes.map(b => b.x0)), x1: Math.max(...boxes.map(b => b.x1)),
+ y0: Math.min(...boxes.map(b => b.y0)), y1: Math.max(...boxes.map(b => b.y1)),
+ };
+}
+
+const item_canvas_cache = new Map();
+async function armorItemCanvas(item, leather_color = '#a06540') {
+ let key = item + (item.startsWith('leather_') ? leather_color : '');
+ if (item_canvas_cache.has(key)) return item_canvas_cache.get(key);
+ let {canvas, ctx} = makeCanvas(16, 16);
+ let found = false;
+ try {
+ let piece = item.substring(item.lastIndexOf('_') + 1);
+ // Copper armor only exists in newer jars
+ let url = await Assets.image(`assets/minecraft/textures/item/${item}.png`);
+ if (!url) url = await Assets.image(`assets/minecraft/textures/item/iron_${piece}.png`);
+ if (url) {
+ let image = await dataURLToCanvas(url);
+ ctx.drawImage(item.startsWith('leather_') ? tintCanvas(image, leather_color) : image, 0, 0, 16, 16);
+ found = true;
+ }
+ if (item.startsWith('leather_')) {
+ let overlay = await Assets.image(`assets/minecraft/textures/item/${item}_overlay.png`);
+ if (overlay) ctx.drawImage(await dataURLToCanvas(overlay), 0, 0, 16, 16);
+ }
+ } catch (err) {
+ console.warn('[Trim Editor] armor item:', err);
+ }
+ if (found) item_canvas_cache.set(key, canvas);
+ return canvas;
+}
+const slot_masks = {};
+async function iconSlotMask(slot) {
+ // Union of the silhouettes of every item that uses this icon
+ if (slot_masks[slot.id]) return slot_masks[slot.id];
+ let mask = new Uint8Array(256);
+ for (let entry of ARMOR_ITEMS.filter(a => a.slot == slot.id)) {
+ let px = (await armorItemCanvas(entry.item)).getContext('2d').getImageData(0, 0, 16, 16).data;
+ for (let i = 0; i < 256; i++) if (px[i * 4 + 3] > 0) mask[i] = 1;
+ }
+ if (!mask.some(v => v)) {
+ // No jar: the whole square
+ mask.fill(1);
+ return mask;
+ }
+ slot_masks[slot.id] = mask;
+ return mask;
+}
+function maskAt(mask, x, y) {
+ return x >= 0 && y >= 0 && x < 16 && y < 16 && !!mask[y * 16 + x];
+}
+function maskEdge(mask, x, y) {
+ return maskAt(mask, x, y) && (!maskAt(mask, x - 1, y) || !maskAt(mask, x + 1, y) || !maskAt(mask, x, y - 1) || !maskAt(mask, x, y + 1));
+}
+function erodeMask(mask) {
+ // Keeps the item's own dark outline free
+ let inner = new Uint8Array(256);
+ for (let y = 0; y < 16; y++) {
+ for (let x = 0; x < 16; x++) inner[y * 16 + x] = maskAt(mask, x, y) && !maskEdge(mask, x, y) ? 1 : 0;
+ }
+ return inner.some(v => v) ? inner : mask;
+}
+function maskBBox(mask) {
+ let box = null;
+ for (let y = 0; y < 16; y++) {
+ for (let x = 0; x < 16; x++) {
+ if (!mask[y * 16 + x]) continue;
+ if (!box) box = {x0: x, y0: y, x1: x, y1: y};
+ box.x0 = Math.min(box.x0, x); box.x1 = Math.max(box.x1, x);
+ box.y0 = Math.min(box.y0, y); box.y1 = Math.max(box.y1, y);
+ }
+ }
+ return box || {x0: 0, y0: 0, x1: 15, y1: 15};
+}
+function canvasOf(texture) {
+ let {canvas, ctx} = makeCanvas(16, 16);
+ if (texture && texture.canvas && texture.canvas.width) ctx.drawImage(texture.canvas, 0, 0, 16, 16);
+ return canvas;
+}
+function recolorCanvas(source, palette_id) {
+ let palette = palette_id && PALETTES[palette_id];
+ if (!palette) return source;
+ let {canvas, ctx} = makeCanvas(source.width, source.height);
+ ctx.drawImage(source, 0, 0);
+ let image = ctx.getImageData(0, 0, canvas.width, canvas.height);
+ let px = image.data;
+ let map = new Map(KEY_RGB.map((key, i) => [key.join(','), hexToRgb(palette[i])]));
+ for (let i = 0; i < px.length; i += 4) {
+ if (px[i + 3] == 0) continue;
+ let to = map.get(px[i] + ',' + px[i + 1] + ',' + px[i + 2]);
+ if (to) { px[i] = to[0]; px[i + 1] = to[1]; px[i + 2] = to[2]; }
+ }
+ ctx.putImageData(image, 0, 0);
+ return canvas;
+}
+function composeIcon(base, overlay, palette_id) {
+ let {canvas, ctx} = makeCanvas(16, 16);
+ if (base) ctx.drawImage(base, 0, 0, 16, 16);
+ if (overlay) ctx.drawImage(recolorCanvas(overlay, palette_id), 0, 0, 16, 16);
+ return canvas;
+}
+function iconIsEmpty(texture) {
+ if (!texture || !texture.canvas || !texture.canvas.width) return true;
+ let px = texture.canvas.getContext('2d').getImageData(0, 0, texture.canvas.width, texture.canvas.height).data;
+ for (let i = 3; i < px.length; i += 4) if (px[i] > 0) return false;
+ return true;
+}
+function textureReady(texture) {
+ if (!texture || !texture.img || (texture.img.complete && texture.img.naturalWidth)) return Promise.resolve();
+ return new Promise(resolve => {
+ texture.img.addEventListener('load', () => setTimeout(resolve, 20), {once: true});
+ setTimeout(resolve, 1500);
+ });
+}
+
+// --- Project textures and cards ---------------------------------------------
+
+function ensureArmorIcons(overlays = {}) {
+ if (!D()) return false;
+ let created = false;
+ let group = Group.all.find(g => g.name == 'armor_icons' && !(g.parent instanceof Group));
+ if (!group) {
+ group = new Group({name: 'armor_icons', origin: [0, 0, 0]});
+ group.init();
+ group.addTo();
+ group.isOpen = false;
+ }
+ let sheet = findTexture('aicon_bases');
+ if (!sheet) {
+ sheet = createTexture('aicon_bases', t('armor_icon_bases'), blankDataURL(ICON_SHEET_WIDTH, 16), ICON_SHEET_WIDTH, 16);
+ created = true;
+ }
+ ICON_SLOTS.forEach((slot, index) => {
+ let overlay = iconTexture(slot.id);
+ if (!overlay) {
+ overlay = createTexture('aicon_' + slot.id, 'icon_' + slot.id, overlays[slot.id] || blankDataURL(16, 16), 16, 16);
+ created = true;
+ }
+ let box = iconCardBox(index);
+ let card = (role, texture, uv, z, locked, name) => {
+ if (Cube.all.find(c => c.trim_role == role)) return;
+ let cube = new Cube({name, trim_role: role, from: [box.x0, box.y0, z], to: [box.x1, box.y1, z], box_uv: false, locked, color: locked ? 5 : 2});
+ cube.addTo(group).init();
+ for (let face in cube.faces) cube.faces[face].texture = null;
+ cube.faces.north.texture = texture.uuid;
+ cube.faces.north.uv = uv.slice();
+ cube.faces.south.texture = texture.uuid;
+ cube.faces.south.uv = [uv[2], uv[1], uv[0], uv[3]];
+ created = true;
+ };
+ // The icon sits a hair in front of the item under it, so the brush always lands on the icon
+ card('aicon/' + slot.id, overlay, [0, 0, 16, 16], -0.05, false, t('armor_icon_card', [t('slot_' + slot.id)]));
+ card('aiconbase/' + slot.id, sheet, [index * 16, 0, index * 16 + 16, 16], 0, true, t('armor_icon_base_card', [t('slot_' + slot.id)]));
+ });
+ if (created) Canvas.updateAll();
+ return created;
+}
+async function refreshArmorIcons() {
+ let data = D();
+ let sheet = findTexture('aicon_bases');
+ if (!data || !sheet) return;
+ let {canvas, ctx} = makeCanvas(ICON_SHEET_WIDTH, 16);
+ for (let [index, slot] of ICON_SLOTS.entries()) {
+ ctx.drawImage(await armorItemCanvas(iconSlotItem(slot, data.armor.material), data.armor.leather_color), index * 16, 0);
+ }
+ await setTextureImage(sheet, canvas.toDataURL('image/png'));
+ updatePreviewUniforms();
+}
+function updateIconUniforms(data) {
+ for (let slot of ICON_SLOTS) {
+ let texture = iconTexture(slot.id);
+ if (!texture || !patchMaterial(texture)) continue;
+ let palette_id = iconPaletteId(data, iconSlotItem(slot, data.armor.material));
+ let palette = palette_id && PALETTES[palette_id];
+ let uniforms = texture.getOwnMaterial().uniforms;
+ uniforms.TRIM_MODE.value = (palette ? 1 : 0) + (data.preview.highlight ? 2 : 0);
+ uniforms.TRIM_DECAL.value = 0;
+ uniforms.TRIM_ARMOR_MAP.value = null;
+ if (palette) palette.forEach((hex, i) => uniforms.TRIM_VALS.value[i].set(...hexToRgb(hex).map(v => v / 255)));
+ }
+}
+
+// Flat painting: only the icons, straight in front of an orthographic camera that does not rotate
+let icon_focus = null;
+function isIconFocus() {
+ return !!(icon_focus && Project && icon_focus.project == Project.uuid);
+}
+function setIconFocus(on) {
+ let data = D();
+ let preview = Preview.selected;
+ if (!preview) return;
+ if (on && data && !isIconFocus()) {
+ ensureArmorIcons();
+ icon_focus = {
+ project: Project.uuid,
+ camera: {position: preview.camera.position.toArray(), target: preview.controls.target.toArray(),
+ projection: preview.isOrtho ? 'orthographic' : 'perspective', zoom: preview.camera.zoom},
+ };
+ applyVisibility();
+ let b = iconCardsBounds();
+ let cx = (b.x0 + b.x1) / 2, cy = (b.y0 + b.y1) / 2;
+ let zoom = Math.min(preview.width / 40 / (b.x1 - b.x0 + 10), preview.height / 40 / (b.y1 - b.y0 + 10));
+ preview.loadAnglePreset({position: [cx, cy, -300], target: [cx, cy, 0], projection: 'orthographic', zoom});
+ preview.controls.enableRotate = false;
+ let selected = iconTextures().find(texture => texture.selected);
+ let first = iconTexture(ICON_SLOTS[0].id);
+ if (!selected && first) first.select();
+ } else if (!on && icon_focus) {
+ let camera = icon_focus.camera;
+ let own = isIconFocus();
+ icon_focus = null;
+ preview.controls.enableRotate = true;
+ if (own) {
+ applyVisibility();
+ preview.loadAnglePreset(camera);
+ }
+ }
+ refreshPanels();
+}
+
+// --- Generators -------------------------------------------------------------
+
+function trimFrontView(piece) {
+ // Front view of one painted armor piece, one pixel per texel; the player's right side is on the left
+ let humanoid = findTexture('trim_humanoid'), leggings = findTexture('trim_leggings');
+ let draw = (ctx, texture, sx, sy, sw, sh, dx, dy, mirror) => {
+ if (!texture || !texture.canvas || !texture.canvas.width) return;
+ let s = texture.canvas.width / 64;
+ ctx.save();
+ if (mirror) {
+ ctx.translate(dx + sw, dy);
+ ctx.scale(-1, 1);
+ dx = 0; dy = 0;
+ }
+ ctx.drawImage(texture.canvas, sx * s, sy * s, sw * s, sh * s, dx, dy, sw, sh);
+ ctx.restore();
+ };
+ let canvas, ctx;
+ if (piece == 'helmet') {
+ ({canvas, ctx} = makeCanvas(8, 8));
+ draw(ctx, humanoid, 8, 8, 8, 8, 0, 0);
+ draw(ctx, humanoid, 40, 8, 8, 8, 0, 0);
+ } else if (piece == 'chestplate') {
+ ({canvas, ctx} = makeCanvas(16, 12));
+ draw(ctx, humanoid, 44, 20, 4, 12, 0, 0);
+ draw(ctx, humanoid, 20, 20, 8, 12, 4, 0);
+ draw(ctx, humanoid, 44, 20, 4, 12, 12, 0, true);
+ } else if (piece == 'leggings') {
+ ({canvas, ctx} = makeCanvas(8, 16));
+ draw(ctx, leggings, 20, 28, 8, 4, 0, 0);
+ draw(ctx, leggings, 4, 20, 4, 12, 0, 4);
+ draw(ctx, leggings, 4, 20, 4, 12, 4, 4, true);
+ } else {
+ ({canvas, ctx} = makeCanvas(8, 6));
+ draw(ctx, humanoid, 4, 26, 4, 6, 0, 0);
+ draw(ctx, humanoid, 4, 26, 4, 6, 4, 0, true);
+ }
+ return canvas;
+}
+function fitIntoMask(source, mask, target) {
+ // Stretch a picture over the bounding box of a silhouette and keep what lands inside it
+ let box = maskBBox(mask);
+ let w = box.x1 - box.x0 + 1, h = box.y1 - box.y0 + 1;
+ let src = source.getContext('2d').getImageData(0, 0, source.width, source.height).data;
+ for (let y = box.y0; y <= box.y1; y++) {
+ for (let x = box.x0; x <= box.x1; x++) {
+ if (!mask[y * 16 + x]) continue;
+ let u = Math.min(source.width - 1, Math.floor((x - box.x0 + 0.5) * source.width / w));
+ let v = Math.min(source.height - 1, Math.floor((y - box.y0 + 0.5) * source.height / h));
+ let i = (v * source.width + u) * 4;
+ if (src[i + 3] == 0) continue;
+ let o = (y * 16 + x) * 4;
+ for (let c = 0; c < 4; c++) target[o + c] = src[i + c];
+ }
+ }
+}
+function shapeHit(opts, x, y, mask, inner) {
+ let {shape, step, size} = opts;
+ if (shape == 'outline') return maskEdge(mask, x, y);
+ if (shape == 'inner_outline') return inner !== mask && maskEdge(inner, x, y);
+ if (!maskAt(inner, x, y)) return false;
+ let box = maskBBox(inner);
+ let rx = x - box.x0, ry = y - box.y0;
+ let band = (center) => y >= center - Math.floor((size - 1) / 2) && y <= center + Math.floor(size / 2);
+ switch (shape) {
+ case 'fill': return true;
+ case 'stripes_h': return ry % step < size;
+ case 'stripes_v': return rx % step < size;
+ case 'diagonal': return (rx + ry) % step < size;
+ case 'diagonal2': return ((rx - ry) % step + step) % step < size;
+ case 'checker': return (Math.floor(rx / size) + Math.floor(ry / size)) % 2 == 0;
+ case 'dots': return rx % step == 0 && ry % step == 0;
+ case 'band_top': return y - box.y0 < size;
+ case 'band_middle': return band(Math.floor((box.y0 + box.y1) / 2));
+ case 'band_bottom': return box.y1 - y < size;
+ }
+ return false;
+}
+async function generateIcon(slot, opts, current) {
+ // current: the icons as they are now (for drawing on top and for copying)
+ let mask = await iconSlotMask(slot);
+ let inner = erodeMask(mask);
+ let {canvas, ctx} = makeCanvas(16, 16);
+ if (opts.mode == 'add' && opts.source != 'clear' && current[slot.id]) ctx.drawImage(current[slot.id], 0, 0);
+ let image = ctx.getImageData(0, 0, 16, 16);
+ let px = image.data;
+ if (opts.source == 'project') {
+ fitIntoMask(trimFrontView(slot.piece), inner, px);
+ } else if (opts.source == 'vanilla') {
+ let url = null;
+ try { url = await Assets.image(`assets/minecraft/textures/trims/items/${slot.piece}_trim.png`); } catch (err) {}
+ if (url) {
+ let src = (await dataURLToCanvas(url)).getContext('2d').getImageData(0, 0, 16, 16).data;
+ for (let i = 0; i < 256; i++) {
+ if (!mask[i] || src[i * 4 + 3] == 0) continue;
+ for (let c = 0; c < 4; c++) px[i * 4 + c] = src[i * 4 + c];
+ }
+ }
+ } else if (opts.source == 'copy') {
+ let from = slot.copy_from && current[slot.copy_from];
+ if (from) {
+ // Crop the common icon to its silhouette, then fit it into this item's silhouette
+ let from_box = maskBBox(erodeMask(await iconSlotMask(iconSlot(slot.copy_from))));
+ let {canvas: crop, ctx: crop_ctx} = makeCanvas(from_box.x1 - from_box.x0 + 1, from_box.y1 - from_box.y0 + 1);
+ crop_ctx.drawImage(from, -from_box.x0, -from_box.y0);
+ fitIntoMask(crop, inner, px);
+ }
+ } else if (opts.source == 'shape') {
+ let [r, g, b] = hexToRgb(opts.color);
+ for (let y = 0; y < 16; y++) {
+ for (let x = 0; x < 16; x++) {
+ if (!shapeHit(opts, x, y, mask, inner)) continue;
+ let o = (y * 16 + x) * 4;
+ px[o] = r; px[o + 1] = g; px[o + 2] = b; px[o + 3] = 255;
+ }
+ }
+ }
+ ctx.putImageData(image, 0, 0);
+ return canvas;
+}
+function currentIcons() {
+ let current = {};
+ for (let slot of ICON_SLOTS) current[slot.id] = canvasOf(iconTexture(slot.id));
+ return current;
+}
+function generatorApplies(opts, slot) {
+ return opts.source != 'copy' || !!slot.copy_from;
+}
+function canvasIsEmpty(canvas) {
+ let px = canvas.getContext('2d').getImageData(0, 0, canvas.width, canvas.height).data;
+ for (let i = 3; i < px.length; i += 4) if (px[i] > 0) return false;
+ return true;
+}
+async function generateOrKeep(slot, opts, current) {
+ // E.g. a trim with nothing on the front of the helmet gives an empty helmet icon: keep the one drawn instead
+ let canvas = await generateIcon(slot, opts, current);
+ if (opts.source != 'clear' && canvasIsEmpty(canvas) && current[slot.id] && !canvasIsEmpty(current[slot.id])) return null;
+ return canvas;
+}
+async function applyIconGenerator(opts, slot_ids, undo = true) {
+ let current = currentIcons();
+ let results = [];
+ let kept = 0;
+ for (let id of slot_ids) {
+ let slot = iconSlot(id);
+ let texture = iconTexture(id);
+ if (!slot || !texture || !generatorApplies(opts, slot)) continue;
+ await textureReady(texture);
+ let canvas = await generateOrKeep(slot, opts, current);
+ if (canvas) results.push([texture, canvas]);
+ else kept++;
+ }
+ if (!results.length) return kept;
+ if (undo) Undo.initEdit({textures: results.map(r => r[0]), bitmap: true});
+ for (let [texture, canvas] of results) {
+ texture.edit((target) => {
+ let ctx = target.getContext('2d');
+ ctx.imageSmoothingEnabled = false;
+ ctx.clearRect(0, 0, target.width, target.height);
+ ctx.drawImage(canvas, 0, 0, target.width, target.height);
+ }, {no_undo: true});
+ }
+ if (undo) Undo.finishEdit(t('generate_armor_icons'));
+ return kept;
+}
+
+function openArmorIconGenerators() {
+ let data = D();
+ if (!data) return;
+ ensureArmorIcons();
+ let keys = PALETTE_KEY.map(hex => ({hex, name: hex.toUpperCase()}));
+ let dialog = new Dialog({
+ id: 'armor_trim_editor_armor_icons',
+ title: t('armor_icons_title'),
+ width: 700,
+ component: {
+ data() {
+ return {
+ slots: ICON_SLOTS.map(s => ({id: s.id, name: t('slot_' + s.id), on: true})),
+ source: 'project',
+ sources: ['project', 'vanilla', 'shape', 'copy', 'clear'].map(id => ({id, name: t('icon_source_' + id)})),
+ shapes: ICON_SHAPES.map(id => ({id, name: t('shape_' + id)})),
+ shape: 'inner_outline', step: 3, size: 1, color: '#c0c0c0', custom: '#c0c0c0', keys,
+ mode: 'replace',
+ material: data.export.icon_colors == 'fixed' ? 'none' : data.preview.material,
+ materials: [{id: 'none', name: t('as_painted_2')}].concat(TRIM_MATERIALS.map(m => ({id: m.id, name: m.name}))),
+ };
+ },
+ computed: {
+ opts() {
+ return {source: this.source, shape: this.shape, step: this.step, size: this.size, color: this.color, mode: this.mode};
+ },
+ hint() {
+ if (this.source == 'project') return t('icon_source_project_hint');
+ if (this.source == 'copy') return t('icon_source_copy_hint');
+ if (this.source == 'vanilla') return t('icon_source_vanilla_hint');
+ return t('icon_palette_hint');
+ },
+ },
+ watch: {
+ opts: {deep: true, handler() { this.render(); }},
+ material() { this.render(); },
+ slots: {deep: true, handler() { this.render(); }},
+ },
+ methods: {
+ async render() {
+ let run = this.run = (this.run || 0) + 1;
+ let current = currentIcons();
+ for (let entry of this.slots) {
+ let slot = iconSlot(entry.id);
+ let item = iconSlotItem(slot, data.armor.material);
+ let overlay = entry.on && generatorApplies(this.opts, slot) ? (await generateOrKeep(slot, this.opts, current) || current[slot.id]) : current[slot.id];
+ let base = await armorItemCanvas(item, data.armor.leather_color);
+ if (run != this.run) return;
+ let icon = composeIcon(base, overlay, iconPaletteId(data, item, this.material));
+ let target = this.$refs['c_' + entry.id] && this.$refs['c_' + entry.id][0];
+ if (!target) continue;
+ let ctx = target.getContext('2d');
+ ctx.imageSmoothingEnabled = false;
+ ctx.clearRect(0, 0, target.width, target.height);
+ ctx.drawImage(icon, 0, 0, target.width, target.height);
+ }
+ },
+ all(on) { this.slots.forEach(s => s.on = on); },
+ },
+ mounted() { this.render(); },
+ template: `
+
+
`,
+ },
+ onConfirm() {
+ let vm = this.content_vue;
+ if (!vm) return;
+ let ids = vm.slots.filter(s => s.on).map(s => s.id);
+ applyIconGenerator(vm.opts, ids).then((kept) => {
+ refreshPanels();
+ if (kept) notify(t('icons_kept_empty_result', [kept]), 4000);
+ }).catch(err => showError(t('armor_icons_title'), err));
+ },
+ });
+ dialog.show();
+}
+
+function openIconGrid() {
+ let data = D();
+ if (!data) return;
+ ensureArmorIcons();
+ let armor_name = (id) => (ARMOR_MATERIALS.find(a => a.id == id) || {}).name || id;
+ new Dialog({
+ id: 'armor_trim_editor_icon_grid',
+ title: t('icon_grid_title'),
+ width: 640,
+ component: {
+ data() {
+ return {
+ piece: 'chestplate',
+ pieces: PIECE_ORDER.map(id => ({id, name: PIECE_NAMES[id]})),
+ cols: [{id: 'none', name: t('as_painted_2'), color: ''}].concat(TRIM_MATERIALS.map(m => ({id: m.id, name: m.name, color: m.color}))),
+ fixed: data.export.icon_colors == 'fixed',
+ };
+ },
+ computed: {
+ rows() {
+ return ARMOR_ITEMS.filter(a => a.piece == this.piece).map(a => ({item: a.item, name: armor_name(a.armor), slot: a.slot}));
+ },
+ },
+ watch: {piece() { this.$nextTick(() => this.draw()); }},
+ methods: {
+ async draw() {
+ let overlays = currentIcons();
+ for (let row of this.rows) {
+ let base = await armorItemCanvas(row.item, data.armor.leather_color);
+ for (let col of this.cols) {
+ let ref = this.$refs[row.item + '/' + col.id];
+ let target = ref && ref[0];
+ if (!target) continue;
+ let ctx = target.getContext('2d');
+ ctx.imageSmoothingEnabled = false;
+ ctx.clearRect(0, 0, 16, 16);
+ ctx.drawImage(composeIcon(base, overlays[row.slot], iconPaletteId(data, row.item, col.id)), 0, 0);
+ }
+ }
+ },
+ },
+ mounted() { this.draw(); },
+ template: `
+
+
+
+
+
+ {{ s.name }}
+
+ ${t('select_all')}
+ ${t('select_none')}
+ · ${t('armor_icons_click_cards')}
+
+
+
+
+
+
+
+
+ {{ step }}
+ {{ size }}
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {{ hint }}
+
+
+
+
`,
+ },
+ singleButton: true,
+ }).show();
+}
+
+function openArmorIconsHelp() {
+ let html = ['armor_icons_help_why', 'armor_icons_help_what', 'armor_icons_help_slots', 'armor_icons_help_colors',
+ 'armor_icons_help_paint', 'armor_icons_help_export'].map(key => `
+
+ {{ p.name }}
+ {{ c.color ? '' : '—' }} | |
|---|---|
| {{ r.name }} | ++ |
{{ fixed ? '${t('icon_grid_hint_fixed')}' : '${t('icon_grid_hint')}' }}
+${t(key)}
`).join(''); + new Dialog({id: 'armor_trim_editor_armor_icons_help', title: t('armor_icons_full'), width: 680, + component: {template: `${html}
`},
+ buttons: [t('armor_icons_generators'), t('done')], cancelIndex: 1, confirmIndex: 1,
+ onButton(index) { if (index == 0) setTimeout(openArmorIconGenerators, 50); }}).show();
+}
+
+// --- Export into the resource pack -------------------------------------------
+
+function iconMaterials() {
+ return TRIM_MATERIALS.map(m => m.id);
+}
+function hasDarkerPalette(material, version) {
+ // Copper armor and its darker palette came with 1.21.9
+ let def = TRIM_MATERIALS.find(m => m.id == material);
+ return !!(def && def.armor) && (material != 'copper' || version.rp >= 69);
+}
+function overlayCovers(entry, rp) {
+ // Overlay ranges come as a number, [min, max], {min_inclusive, max_inclusive} or min_format/max_format
+ let range = entry.formats;
+ let min = entry.min_format, max = entry.max_format;
+ if (typeof range == 'number') min = max = range;
+ else if (Array.isArray(range)) [min, max] = range;
+ else if (range && typeof range == 'object') { min = range.min_inclusive; max = range.max_inclusive; }
+ if (Array.isArray(min)) min = min[0];
+ if (Array.isArray(max)) max = max[0];
+ return (min === undefined || rp >= min) && (max === undefined || rp <= max);
+}
+async function iconsAtlasName(pack, prefix, version) {
+ for (let name of ['items.json', 'blocks.json']) {
+ let text = await readPackText(pack, `${prefix}assets/minecraft/atlases/${name}`);
+ if (text && text.includes('"separator"') && text.includes('minecraft/gold')) return name;
+ }
+ // Item textures moved to their own atlas in 1.21.11
+ return version.rp >= 75 ? 'items.json' : 'blocks.json';
+}
+async function findIconsRoot(pack, version) {
+ // Visual Armor Trims usually lives in an overlay; later overlays win, so they are checked first
+ let prefixes = [];
+ try {
+ let meta = JSON.parse(await readPackText(pack, 'pack.mcmeta'));
+ for (let entry of (meta.overlays && meta.overlays.entries) || []) {
+ if (entry && entry.directory && overlayCovers(entry, version.rp)) prefixes.push(entry.directory + '/');
+ }
+ } catch (err) {}
+ prefixes.reverse();
+ prefixes.push('');
+ for (let prefix of prefixes) {
+ let text = await readPackText(pack, prefix + 'assets/minecraft/items/iron_chestplate.json');
+ if (text && text.includes('"minecraft:component"') && text.includes('minecraft:trim')) {
+ return {prefix, vat: text.includes('minecraft:has_component'), atlas: await iconsAtlasName(pack, prefix, version)};
+ }
+ }
+ return {prefix: '', vat: false, atlas: await iconsAtlasName(pack, '', version)};
+}
+function modelTints(node) {
+ if (!node || typeof node != 'object') return null;
+ if (node.tints) return node.tints;
+ for (let child of [node.fallback, node.on_false, node.cases && node.cases[0] && node.cases[0].model]) {
+ let tints = modelTints(child);
+ if (tints) return tints;
+ }
+ return null;
+}
+function injectItemCases(def, key, modelFor, with_fallback) {
+ // Adds or replaces the cases of one pattern; modelFor == null removes them. False for an unknown layout.
+ let root = def && def.model;
+ if (!root || root.type != 'minecraft:select' || root.property != 'minecraft:trim_material' || !Array.isArray(root.cases)) return false;
+ let tints = modelTints(root);
+ let make = (model) => Object.assign({type: 'minecraft:model', model}, tints ? {tints: JSON.parse(JSON.stringify(tints))} : {});
+ for (let material_case of root.cases) {
+ let values = Array.isArray(material_case.when) ? material_case.when : [material_case.when];
+ let inner = material_case.model;
+ let is_select = inner && inner.type == 'minecraft:select' && inner.property == 'minecraft:component' && inner.component == 'minecraft:trim';
+ if (!is_select) {
+ if (!modelFor) continue;
+ // A plain vanilla model stays as the fallback for every other pattern
+ inner = material_case.model = {type: 'minecraft:select', property: 'minecraft:component', component: 'minecraft:trim', cases: [], fallback: inner};
+ }
+ if (!Array.isArray(inner.cases)) inner.cases = [];
+ let keep = new Set();
+ if (modelFor) {
+ for (let value of values) {
+ let material = parseResourceId(value).path;
+ if (!TRIM_MATERIALS.some(m => m.id == material)) continue;
+ let when = {pattern: key, material: 'minecraft:' + material};
+ let existing = inner.cases.find(c => c.when && c.when.pattern == key && c.when.material == when.material);
+ if (existing) existing.model = make(modelFor(material));
+ else inner.cases.push(existing = {when, model: make(modelFor(material))});
+ keep.add(existing);
+ }
+ }
+ inner.cases = inner.cases.filter(c => !(c.when && c.when.pattern == key) || keep.has(c));
+ }
+ // Visual Armor Trims sends materials it does not know through a chain of conditions, one per pattern
+ let fallback = root.fallback;
+ if (with_fallback && fallback && fallback.type == 'minecraft:condition' && fallback.property == 'minecraft:has_component') {
+ let parent = fallback, side = 'on_true', node = fallback.on_true;
+ while (node && node.type == 'minecraft:condition' && node.property == 'minecraft:component') {
+ if (node.value && node.value.pattern == key) {
+ if (modelFor) node.on_true = make(modelFor('_fallback'));
+ else parent[side] = node.on_false;
+ return true;
+ }
+ parent = node; side = 'on_false'; node = node.on_false;
+ }
+ if (modelFor) parent[side] = {type: 'minecraft:condition', property: 'minecraft:component', predicate: 'trim', value: {pattern: key}, on_true: make(modelFor('_fallback')), on_false: node};
+ }
+ return true;
+}
+function iconPermutations(version) {
+ let permutations = {};
+ for (let material of iconMaterials()) {
+ permutations['minecraft/' + material] = 'minecraft:trims/color_palettes/' + material;
+ if (hasDarkerPalette(material, version)) permutations[`minecraft/${material}/darker`] = `minecraft:trims/color_palettes/${material}_darker`;
+ }
+ return permutations;
+}
+function isIconSource(source) {
+ return source && /(^|:)paletted_permutations$/.test(source.type || '') && source.separator == '/' &&
+ source.permutations && source.permutations['minecraft/gold'];
+}
+function isSingleSource(source, ids) {
+ return source && /(^|:)single$/.test(source.type || '') && ids.has(normalizeId(source.resource || ''));
+}
+function updateIconsAtlas(atlas, texture_ids, fixed, version) {
+ // Icons that follow the material go into the paletted source, fixed ones are single sprites
+ if (!Array.isArray(atlas.sources)) atlas.sources = [];
+ let ids = new Set(texture_ids);
+ let changed = false;
+ let source = atlas.sources.find(isIconSource);
+ if (fixed) {
+ if (source && Array.isArray(source.textures)) {
+ let count = source.textures.length;
+ source.textures = source.textures.filter(id => !ids.has(normalizeId(id)));
+ changed = count != source.textures.length;
+ }
+ for (let id of texture_ids) {
+ if (atlas.sources.some(s => isSingleSource(s, new Set([id])))) continue;
+ atlas.sources.push({type: 'minecraft:single', resource: id});
+ changed = true;
+ }
+ } else {
+ let count = atlas.sources.length;
+ atlas.sources = atlas.sources.filter(s => !isSingleSource(s, ids));
+ changed = count != atlas.sources.length;
+ if (!source) {
+ source = {type: 'minecraft:paletted_permutations', textures: [], palette_key: 'minecraft:trims/color_palettes/trim_palette',
+ permutations: iconPermutations(version), separator: '/'};
+ atlas.sources.push(source);
+ }
+ if (!Array.isArray(source.textures)) source.textures = [];
+ for (let id of texture_ids) {
+ if (source.textures.some(texture => normalizeId(texture) == id)) continue;
+ source.textures.push(id);
+ changed = true;
+ }
+ }
+ return {changed, source};
+}
+async function exportArmorIcons(pack, data, file_stamp, written, notes) {
+ let filled = filledIconSlots();
+ if (!filled.length) return '';
+ let version = mcVersion(data.mc_version);
+ if (version.rp < 55) {
+ notes.push(t('armor_icons_old_version'));
+ return '';
+ }
+ let ns = data.export.namespace || 'minecraft';
+ let id = data.trim_id;
+ let key = patternKey(data);
+ let fixed = data.export.icon_colors == 'fixed';
+ let root = await findIconsRoot(pack, version);
+ let assets = root.prefix + 'assets/minecraft/';
+
+ for (let slot of filled) {
+ let rel = `${assets}textures/${slot.texture}/${ns}/${id}.png`;
+ if (await writeTextureIfChanged(pack, rel, iconTexture(slot.id), file_stamp)) written.push(rel);
+ }
+
+ let atlas_rel = `${assets}atlases/${root.atlas}`;
+ let atlas_text = await readPackText(pack, atlas_rel) || '';
+ let atlas = atlas_text ? JSON.parse(atlas_text) : {sources: []};
+ let texture_ids = filled.map(slot => `minecraft:${slot.texture}/${ns}/${id}`);
+ let {changed, source} = updateIconsAtlas(atlas, texture_ids, fixed, version);
+ if (changed) {
+ writeJSON(pack, atlas_rel, atlas, atlas_text, file_stamp);
+ written.push(atlas_rel);
+ }
+ // Visual Armor Trims has a palette for materials it does not know
+ let with_fallback = root.vat && !fixed && !!(source && source.permutations && source.permutations['minecraft/_fallback']);
+ let materials = iconMaterials().concat(with_fallback ? ['_fallback'] : []);
+
+ let models = 0, items = 0, missing = [];
+ for (let entry of ARMOR_ITEMS) {
+ if (entry.armor == 'copper' && version.rp < 69) continue;
+ let slot = iconSlot(entry.slot);
+ // Items whose icon is empty keep whatever the pack already has for this pattern
+ if (!filled.includes(slot)) continue;
+ let used = true;
+ let model_id = `minecraft:item/${entry.item}/${ns}/${id}`;
+ let layer = entry.leather ? 'layer2' : 'layer1';
+ let texture_id = `minecraft:${slot.texture}/${ns}/${id}`;
+ if (used) {
+ let base = {parent: 'minecraft:item/' + entry.item};
+ if (fixed) base.textures = {[layer]: texture_id};
+ if (await writeJSONIfChanged(pack, `${assets}models/item/${entry.item}/${ns}/${id}.json`, base)) models++;
+ if (!fixed) {
+ for (let material of materials) {
+ let darker = material == entry.material ? '/darker' : '';
+ let model = {parent: model_id, textures: {[layer]: `${texture_id}/minecraft/${material}${darker}`}};
+ if (await writeJSONIfChanged(pack, `${assets}models/item/${entry.item}/${ns}/${id}/minecraft/${material}.json`, model)) models++;
+ }
+ }
+ }
+ let item_rel = `${assets}items/${entry.item}.json`;
+ let item_text = await readPackText(pack, item_rel) || '';
+ let def = null;
+ try { def = item_text ? JSON.parse(item_text) : null; } catch (err) {}
+ let source_text = item_text;
+ if (!def) {
+ if (!used) continue;
+ try { source_text = await Assets.text(`assets/minecraft/items/${entry.item}.json`); } catch (err) {}
+ if (!source_text) {
+ missing.push(entry.item);
+ continue;
+ }
+ def = JSON.parse(source_text);
+ }
+ let model_for = used ? (fixed ? () => model_id : (material => `${model_id}/minecraft/${material}`)) : null;
+ let before = JSON.stringify(def);
+ if (!injectItemCases(def, key, model_for, root.vat && (fixed || with_fallback))) {
+ notes.push(t('armor_icons_unknown_item', [item_rel]));
+ continue;
+ }
+ if (item_text && JSON.stringify(def) == before) continue;
+ writeJSON(pack, item_rel, def, source_text, file_stamp);
+ items++;
+ }
+ if (missing.length) notes.push(t('armor_icons_no_vanilla_item', [missing.join(', ')]));
+ return t('armor_icons_written', [models, items, root.prefix ? root.prefix.slice(0, -1) : t('pack_root')]);
+}
+async function describeArmorIcons(pack, data) {
+ let filled = filledIconSlots();
+ if (!data.export.armor_icons || !filled.length) return [];
+ let version = mcVersion(data.mc_version);
+ if (version.rp < 55) return ['· ' + t('armor_icons_old_version')];
+ let root = await findIconsRoot(pack, version);
+ let where = root.prefix ? root.prefix.slice(0, -1) : t('pack_root');
+ return ['＋ ' + t('armor_icons_plan', [filled.length, ICON_SLOTS.length, where, root.vat ? t('armor_icons_mode_vat') : t('armor_icons_mode_own')])];
+}
+async function readArmorIcons(pack, ns, id, root) {
+ let icons = {};
+ root = root || await findIconsRoot(pack, mcVersion(Prefs.get().mc_version));
+ for (let slot of ICON_SLOTS) {
+ let url = await readPackPNG(pack, `${root.prefix}assets/minecraft/textures/${slot.texture}/${ns}/${id}.png`);
+ if (url) icons[slot.id] = url;
+ }
+ return icons;
+}
+
+// ============================================================================
+// Panels
+// ============================================================================
+
+const panels = {};
+let icon_timer = null;
+function refreshPanels() {
+ for (let id in panels) {
+ let vue = panels[id] && panels[id].inside_vue;
+ if (vue && vue.refresh) vue.refresh();
+ }
+}
+function drawSkinHead(canvas) {
+ let texture = findTexture('skin');
+ if (!canvas || !texture || !texture.canvas || !texture.canvas.width) return;
+ let ctx = canvas.getContext('2d');
+ let s = texture.canvas.width / 64;
+ ctx.imageSmoothingEnabled = false;
+ ctx.clearRect(0, 0, canvas.width, canvas.height);
+ ctx.drawImage(texture.canvas, 8 * s, 8 * s, 8 * s, 8 * s, 0, 0, canvas.width, canvas.height);
+ ctx.drawImage(texture.canvas, 40 * s, 8 * s, 8 * s, 8 * s, 0, 0, canvas.width, canvas.height);
+}
+
+function showPreviewTabOnce() {
+ // On first use, bring the preview tab to the front of the panel it is attached to
+ if (Prefs.get().preview_tab_shown) return;
+ let panel = panels.view;
+ let host = panel && panel.getHostPanel && panel.getHostPanel();
+ if (host && host.selectTab) host.selectTab(panel);
+ Prefs.set({preview_tab_shown: true});
+}
+
+function createPanels() {
+ panels.view = track(new Panel('armor_trim_editor_view', {
+ name: t('trim_preview'),
+ icon: 'checkroom',
+ condition: {formats: [FORMAT_ID]},
+ growable: true,
+ resizable: true,
+ default_position: {slot: 'right_bar', attached_to: 'outliner', attached_index: 0, float_position: [0, 0], float_size: [320, 460], height: 400},
+ component: {
+ data() {
+ return {
+ d: null,
+ tab: 'view',
+ pieces: PIECE_ORDER.map(id => ({id, name: PIECE_NAMES[id]})),
+ layers: [
+ {id: 'trim', name: t('trim')},
+ {id: 'armor', name: t('armor')},
+ {id: 'skin', name: t('skin')},
+ {id: 'skin_outer', name: t('skin_overlay')},
+ {id: 'icon', name: t('icon')},
+ {id: 'armor_icons', name: t('armor_icons')},
+ ],
+ icon_slots: ICON_SLOTS.map(s => ({id: s.id, name: t('slot_' + s.id)})),
+ icon_focus: false,
+ selected_icon: '',
+ materials: TRIM_MATERIALS,
+ armors: ARMOR_MATERIALS,
+ poses: POSES,
+ skins: DEFAULT_SKINS,
+ nickname: '',
+ loading: '',
+ };
+ },
+ computed: {
+ skinLabel() {
+ if (!this.d) return '';
+ let s = this.d.skin;
+ if (s.source == 'player') return s.name;
+ if (s.source == 'file') return t('from_file');
+ return s.id[0].toUpperCase() + s.id.substring(1);
+ },
+ poseName() {
+ let pose = this.d && POSES.find(p => p.id == this.d.pose.id);
+ return pose ? pose.name : '';
+ },
+ materialName() {
+ if (!this.d || this.d.preview.material == 'none') return t('as_painted');
+ let mat = TRIM_MATERIALS.find(m => m.id == this.d.preview.material);
+ let palette = effectivePaletteId(this.d.preview.material, this.d.armor.material);
+ return (mat ? mat.name : '') + (palette.endsWith('_darker') ? t('darker_palette') : '');
+ },
+ },
+ watch: {
+ tab() { this.$nextTick(() => { drawSkinHead(this.$refs.head); this.drawIcons(); }); },
+ },
+ methods: {
+ refresh() {
+ this.d = D();
+ this.icon_focus = isIconFocus();
+ this.$nextTick(() => { drawSkinHead(this.$refs.head); this.drawIcons(); });
+ },
+ toggleFocus() { setIconFocus(!isIconFocus()); },
+ selectIcon(id) {
+ let texture = iconTexture(id);
+ if (texture) texture.select();
+ this.drawIcons();
+ },
+ iconGenerators() { openArmorIconGenerators(); },
+ iconGrid() { openIconGrid(); },
+ iconsHelp() { openArmorIconsHelp(); },
+ setIconColors(mode) { this.d.export.icon_colors = mode; updatePreviewUniforms(); this.drawIcons(); },
+ drawIcons() {
+ if (this.tab != 'icons' || !this.d || !isTrimProject()) return;
+ let selected = iconTextures().find(texture => texture.selected);
+ this.selected_icon = selected ? selected.trim_role : '';
+ let sheet = findTexture('aicon_bases');
+ for (let [index, slot] of ICON_SLOTS.entries()) {
+ let ref = this.$refs['icon_' + slot.id];
+ let target = ref && ref[0];
+ if (!target) continue;
+ let ctx = target.getContext('2d');
+ ctx.imageSmoothingEnabled = false;
+ ctx.clearRect(0, 0, 16, 16);
+ if (sheet && sheet.canvas && sheet.canvas.width) {
+ let s = sheet.canvas.width / ICON_SHEET_WIDTH;
+ ctx.drawImage(sheet.canvas, index * 16 * s, 0, 16 * s, 16 * s, 0, 0, 16, 16);
+ }
+ let texture = iconTexture(slot.id);
+ if (texture && texture.canvas && texture.canvas.width) {
+ ctx.drawImage(recolorCanvas(canvasOf(texture), iconPaletteId(this.d, iconSlotItem(slot, this.d.armor.material))), 0, 0);
+ }
+ }
+ },
+ togglePiece(id) { this.d.view.pieces[id] = !this.d.view.pieces[id]; applyVisibility(); },
+ soloPiece(id) {
+ let pieces = this.d.view.pieces;
+ let solo = PIECE_ORDER.every(p => pieces[p] == (p == id));
+ for (let p of PIECE_ORDER) pieces[p] = solo ? true : p == id;
+ applyVisibility();
+ },
+ toggleLayer(id) { this.d.view.layers[id] = !this.d.view.layers[id]; applyVisibility(); },
+ toggleHelmet(key) { this.d.view[key] = !this.d.view[key]; applyVisibility(); },
+ setArmor() { refreshArmor(); },
+ setMaterial(id) { this.d.preview.material = id; updatePreviewUniforms(); this.drawIcons(); },
+ toggleHighlight() { this.d.preview.highlight = !this.d.preview.highlight; updatePreviewUniforms(); },
+ toggleDecal() { this.d.datapack.decal = !this.d.datapack.decal; updatePreviewUniforms(); },
+ setPose(id) {
+ this.d.pose.id = id;
+ PoseRuntime.ticks = 0;
+ },
+ resetHead() { this.d.pose.head_yaw = 0; this.d.pose.head_pitch = 0; },
+ async setDefaultSkin(id) {
+ this.d.skin.source = 'default';
+ this.d.skin.id = id;
+ this.d.skin.slim = !!DEFAULT_SLIM[id];
+ this.loading = '…';
+ await refreshSkin();
+ this.loading = '';
+ },
+ async setSlim(slim) {
+ this.d.skin.slim = slim;
+ if (this.d.skin.source == 'default') await refreshSkin();
+ else { applySkinModel(); this.refresh(); }
+ },
+ loadSkinFile() {
+ Blockbench.import({extensions: ['png'], type: 'PNG', readtype: 'image', resource_id: 'armor_trim_editor_skin'}, async (files) => {
+ if (!files[0]) return;
+ try {
+ await setCustomSkin(files[0].content, undefined, 'file');
+ } catch (err) { showError(t('skin_not_loaded'), err); }
+ });
+ },
+ async loadNickname() {
+ let name = this.nickname.trim();
+ if (!/^[A-Za-z0-9_]{2,16}$/.test(name)) {
+ notify(t('invalid_nickname'));
+ return;
+ }
+ this.loading = t('loading');
+ try {
+ await loadPlayerSkin(name);
+ } catch (err) {
+ showError(t('skin_not_loaded'), err);
+ }
+ this.loading = '';
+ },
+ },
+ template: `
+
+
+
+ visibility${t('view')}
+ accessibility_new${t('pose')}
+ face${t('skin')}
+ grid_view${t('icons_tab')}
+
+
+
+
+ ${t('armor_pieces')}${t('right_click_solo')}
+
+
+ {{ p.name }}
+
+
+ ${t('helmet_1_0')}
+ ${t('helmet_1_5_outer')}
+
+
+ {{ l.name }}
+ ${t('armor')}
+
+
+
+
+ ${t('trim_material')}: {{ materialName }}
+
+
+ block
+
+
+
+
+
+
+ ${t('highlight_palette')}
+ Decal
+ {{ poseName }}
+
+
+
+ {{ p.icon }}
+
+
+ {{ d.pose.paused ? 'play_arrow' : 'pause' }}
+ ${t('speed')}
+
+
+
+ restart_alt
+ ${t('head_2')}
+
+
+ restart_alt
+ ${t('head_3')}
+
+ ${t('animation_freezes_while_you_paint_poses')}
+
+
+
+
+
+
+
+ {{ skinLabel }}
{{ d.skin.slim ? '${t('slim_arms')}' : '${t('wide_arms')}' }} {{ loading }}
${t('default_skins')}
+
+
+ {{ s[0].toUpperCase() + s.substring(1) }}
+ ${t('player_skin_by_name')}
+
+
+ download
+ folder_open
+
+
+
+ ${t('wide_arms_2')}
+ ${t('slim_arms_2')}
+ ${t('armor_uses_the_same_wide_arms_for_slim')}
+
+
+
+ ${t('armor_icons_short')} ${t('what_is_this')}
+
+
+
+
+
+ {{ s.name }}
+
+
+
+
+
+
+
+
+ block
+
+ ${t('icon_colors')}
+
+
+ ${t('icon_colors_palette')}
+ ${t('icon_colors_fixed')}
+ {{ d.export.icon_colors == 'fixed' ? '${t('icon_colors_fixed_hint')}' : '${t('icon_colors_palette_hint')}' }}
+
+
+
${t('trim_palette')}
+
+
+
+
+
+
+ ${t('top_color_to_paint_with_bottom_result')}
+
+
+ {{ d.trim_id }} → {{ packShort }}
+
+
+ ${t('no_problems_found')}
+
+ {{ issue.level == 'error' ? 'error' : issue.level == 'warn' ? 'warning' : 'info' }}
+ {{ issue.text }}
+
+
+ ${i.level == 'error' ? '⛔' : i.level == 'warn' ? '⚠️' : 'ℹ️'} ${escapeHTML(i.text)}
`).join('') || t('no_problems_found'); + Blockbench.showMessageBox({title: t('trim_check'), message: html}); + }, + })); + actions.armor_icons = track(new Action('armor_trim_editor_armor_icons', { + name: t('armor_icons_generators_action'), icon: 'auto_awesome', category: 'edit', condition, + click: () => openArmorIconGenerators(), + })); + actions.icon_grid = track(new Action('armor_trim_editor_icon_grid', { + name: t('icon_grid_title'), icon: 'apps', category: 'view', condition, + click: () => openIconGrid(), + })); + actions.icon_focus = track(new Action('armor_trim_editor_icon_focus', { + name: t('paint_armor_icons'), icon: 'crop_free', category: 'view', condition, + click: () => setIconFocus(!isIconFocus()), + })); + actions.icons_help = track(new Action('armor_trim_editor_armor_icons_help', { + name: t('armor_icons_full'), icon: 'help_outline', category: 'help', + click: () => openArmorIconsHelp(), + })); + actions.datapack = track(new Action('armor_trim_editor_datapack', { + name: t('datapack'), icon: 'dns', category: 'file', condition, + click: () => openDatapackDialog(), + })); + actions.guide = track(new Action('armor_trim_editor_guide', { + name: t('guide_menu'), icon: 'sports_esports', category: 'help', + click: () => openGameGuide(), + })); + actions.settings = track(new Action('armor_trim_editor_settings', { + name: t('trim_editor_settings_2'), icon: 'settings', category: 'settings', + click: () => { try { openSettingsDialog(); } catch (err) { showError(t('error'), err); } }, + })); + actions.help = track(new Action('armor_trim_editor_help', { + name: t('how_trims_work'), icon: 'help', category: 'help', + click: () => openHelpDialog(), + })); + + menu = new BarMenu('armor_trim_editor', [ + 'armor_trim_editor_new', 'armor_trim_editor_import', '_', + 'armor_trim_editor_export', 'armor_trim_editor_quick_export', 'armor_trim_editor_datapack', '_', + 'armor_trim_editor_icon', 'armor_trim_editor_check', + {name: t('clear_trim_piece'), id: 'armor_trim_editor_clear', icon: 'layers_clear', condition: () => isTrimProject(), + children: PIECE_ORDER.map(piece => ({name: PIECE_NAMES[piece], icon: 'clear', click: () => confirmClearPiece(piece)}))}, + '_', + 'armor_trim_editor_icon_focus', 'armor_trim_editor_armor_icons', 'armor_trim_editor_icon_grid', + '_', + 'armor_trim_editor_settings', 'armor_trim_editor_guide', 'armor_trim_editor_help', 'armor_trim_editor_armor_icons_help', + ], {name: t('trim'), condition: () => isTrimProject()}); + // Keep "Help" as the last menu + if (MenuBar.menus.help) { + let help = MenuBar.menus.help; + delete MenuBar.menus.help; + MenuBar.menus.help = help; + } + MenuBar.update(); + MenuBar.addAction(actions.import, 'file.import'); + MenuBar.addAction(actions.export, 'file.export'); +} + +function onProjectChange() { + PoseRuntime.last_time = 0; + if (icon_focus && !isIconFocus()) { + // The flat icon view belongs to the project it was opened in + icon_focus = null; + if (Preview.selected) Preview.selected.controls.enableRotate = true; + } + if (isTrimProject()) { + D(); + setTimeout(() => { + if (!isTrimProject()) return; + // Projects from 1.0 get the armor icons on first open + if (ensureArmorIcons()) refreshArmorIcons(); + updatePreviewUniforms(); + applyVisibility(); + refreshPanels(); + }, 50); + } +} + +let frame_counter = 0; +function onFrame() { + if (!isTrimProject()) return; + PoseRuntime.frame(); + // Pixel grids on the locked reference cubes only add noise + for (let cube of Cube.all) { + let grid = cube.mesh && cube.mesh.grid_box; + if (grid && grid.visible && cube.trim_role && (cube.trim_role.startsWith('skin/') || cube.trim_role.startsWith('armor/') || cube.trim_role.startsWith('aiconbase/'))) { + grid.visible = false; + } + } + if (++frame_counter % 60 == 0) { + // Materials get rebuilt when textures reload; re-apply the preview patch + for (let texture of trimTextures()) { + let mat = texture.getOwnMaterial && texture.getOwnMaterial(); + if (mat && mat.uniforms && (!mat.uniforms.TRIM_MODE || mat.uniforms.TRIM_ARMOR_MAP.value !== armorMapFor(texture))) { + updatePreviewUniforms(); + return; + } + } + for (let texture of iconTextures()) { + let mat = texture.getOwnMaterial && texture.getOwnMaterial(); + if (mat && mat.uniforms && !mat.uniforms.TRIM_MODE) { + updatePreviewUniforms(); + return; + } + } + } +} +function onPointer(event) { + if (event.type == 'pointerdown' && event.target && event.target.tagName == 'CANVAS' && event.target.closest && event.target.closest('.preview')) { + PoseRuntime.mouse_down = true; + } else if (event.type == 'pointerup') { + PoseRuntime.mouse_down = false; + } +} + +Plugin.register(PLUGIN_ID, { + title: 'Armor Trim Editor', + author: 'BbIJABNPOBATEJb', + description: 'Paint Minecraft: Java Edition armor trims on an exact armor model with poses, skins and a live material preview, draw how they look on armor icons, then export them straight into a resource pack and a datapack.', + icon: 'checkroom', + version: PLUGIN_VERSION, + min_version: '5.0.0', + variant: 'desktop', + tags: ['Minecraft: Java Edition', 'Paint', 'Exporter'], + creation_date: '2026-09-27', + has_changelog: true, + contributes: { + formats: [FORMAT_ID], + }, + website: 'https://github.com/BbIJABNPOBATEJb/Armor-Trim-Editor', + repository: 'https://github.com/BbIJABNPOBATEJb/Armor-Trim-Editor', + bug_tracker: 'https://github.com/BbIJABNPOBATEJb/Armor-Trim-Editor/issues', + onload() { + track(Blockbench.addCSS(CSS)); + registerFormat(); + registerActions(); + createPanels(); + track(Blockbench.on('select_project', onProjectChange)); + track(Blockbench.on('load_project', onProjectChange)); + track(Blockbench.on('render_frame', onFrame)); + document.addEventListener('pointerdown', onPointer, true); + document.addEventListener('pointerup', onPointer, true); + if (isTrimProject()) onProjectChange(); + }, + onunload() { + document.removeEventListener('pointerdown', onPointer, true); + document.removeEventListener('pointerup', onPointer, true); + clearInterval(icon_timer); + if (icon_focus && Preview.selected) Preview.selected.controls.enableRotate = true; + icon_focus = null; + try { PoseRuntime.reset(); } catch (err) {} + for (let project of ModelProject.all || []) { + for (let texture of project.textures || []) { + try { unpatchMaterial(texture); } catch (err) {} + } + } + MenuBar.removeAction('file.import.armor_trim_editor_import'); + MenuBar.removeAction('file.export.armor_trim_editor_export'); + for (let item of deletables.splice(0)) { + try { item.delete(); } catch (err) { console.warn(err); } + } + if (menu) { menu.delete(); menu = null; MenuBar.update(); } + for (let property of properties.splice(0)) property.delete(); + if (format) { format.delete(); format = null; } + }, +}); + +// ============================================================================ +// Translations. English is the base language, others are added through Language.addTranslations +// ============================================================================ + +function getTranslations() { + return { + en: { + quartz: "Quartz", + iron: "Iron", + netherite: "Netherite", + redstone: "Redstone", + copper: "Copper", + gold: "Gold", + emerald: "Emerald", + diamond: "Diamond", + lapis: "Lapis", + amethyst: "Amethyst", + resin: "Resin", + no_armor: "No armor", + leather: "Leather", + chainmail: "Chainmail", + iron_2: "Iron", + copper_2: "Copper", + gold_2: "Gold", + diamond_2: "Diamond", + netherite_2: "Netherite", + turtle_shell: "Turtle shell", + helmet: "helmet", + helmet_outer_layer: "helmet, outer layer", + chestplate_body: "chestplate, body", + chestplate_right_arm: "chestplate, right arm", + chestplate_left_arm: "chestplate, left arm", + leggings_waist: "leggings, waist", + leggings_right_leg: "leggings, right leg", + leggings_left_leg: "leggings, left leg", + boots_right: "boots, right", + boots_left: "boots, left", + head: "head", + hat_layer: "hat layer", + body: "body", + jacket: "jacket", + right_arm: "right arm", + right_sleeve: "right sleeve", + left_arm: "left arm", + left_sleeve: "left sleeve", + right_leg: "right leg", + right_pants: "right pants", + left_leg: "left leg", + left_pants: "left pants", + helmet_2: "Helmet", + chestplate: "Chestplate", + leggings: "Leggings", + boots: "Boots", + file_access_requires_the_desktop_app: "File access requires the desktop app.", + needed_to_read_the_minecraft_jar_skins: "Needed to read the Minecraft jar (skins, armor, palettes) and to write trims into your resource pack.", + file_access_was_denied: "File access was denied.", + to_reveal_the_exported_trim_in_the_file: "To reveal the exported trim in the file explorer.", + minecraft_client_jar_not_found_set_it_in: "Minecraft client jar not found. Set it in \"Trim → Settings\".", + armor_preview: "⚙ armor (preview)", + armor_leggings_preview: "⚙ armor leggings (preview)", + skin_preview: "⚙ skin (preview)", + trim: "Trim", + armor: "Armor", + skin: "Skin", + item_icon: "Item icon", + could_not_create_trim: "Could not create trim", + player_not_found: "Player not found", + standing: "Standing", + idle: "Idle", + walking: "Walking", + sprinting: "Sprinting", + sneaking: "Sneaking", + sneak_walk: "Sneak walk", + riding: "Riding", + attack: "Attack", + bow: "Bow", + crossbow: "Crossbow", + shield: "Shield", + trident: "Trident", + spyglass: "Spyglass", + arms_forward: "Arms forward", + t_pose: "T-pose", + waving: "Waving", + swimming: "Swimming", + elytra: "Elytra", + pack: "Pack: ", + current_icon: "Current icon", + simple_tablet: "Simple tablet", + template: "Template: ", + template_netherite_upgrade: "Template: netherite upgrade", + icon_generator: "Icon generator", + recolor_glyph: "Recolor glyph", + keep: "Keep", + remove_glyph: "Remove glyph", + the_trim_is_empty_nothing_to_sample: "The trim is empty, nothing to sample.", + base: "Base", + result: "Result", + body_color: "Body color", + glyph_color: "Glyph color", + glyph: "Glyph", + contrast: "Contrast", + sample_colors_from_trim: "Sample colors from trim", + the_glyph_cyan_pixels_of_vanilla: "The glyph (cyan pixels of vanilla templates) is recolored separately. Touch the icon up by hand afterwards — texture \"icon\".", + generate_icon: "Generate icon", + icon_updated: "Icon updated", + size_must_be_2_1_64_32_128_64: "%0: size %1×%2 must be 2:1 (64×32, 128×64…)", + px_outside_the_uv_layout_invisible_in: "%0: %1 px outside the UV layout — invisible in game", + remove: "Remove", + semi_transparent_px_trims_render_as: "%0: %1 semi-transparent px — trims render as cutout: alpha < 10% vanishes, the rest becomes opaque", + match_game: "Match game", + px_are_close_to_palette_colors_but_will: "%0: %1 px are close to palette colors but will not be recolored", + snap_to_palette: "Snap to palette", + px_follow_the_material_px_keep_their: "%0: %1 px follow the material, %2 px keep their color", + the_trim_is_empty: "The trim is empty.", + the_icon_is_not_square: "The icon is not square.", + fix_trim: "Fix trim", + trim_id_is_empty: "Trim ID is empty.", + trim_id_may_only_contain_a_z_0_9: "Trim ID may only contain a-z, 0-9, _ . -", + clear_trim_piece: "Clear trim piece", + erase_from_the_trim_texture_you_can_undo: "Erase \"%0\" from the trim texture? You can undo it (Ctrl+Z).", + erase: "Erase", + cancel: "Cancel", + no_resource_pack_folder_selected: "No resource pack folder selected.", + resource_pack_folder_not_found: "Resource pack folder not found: ", + invalid_texture_namespace: "Invalid texture namespace.", + invalid_icon_path: "Invalid icon path: ", + created_paletted_permutations_source: "created paletted_permutations source", + added_texture: "added texture ", + added_palette: "added palette ", + cannot_export: "Cannot export", + trim_exported_files: "Trim \"%0\" exported (%1 files)", + export_failed: "Export failed", + files_written: "Files written", + atlas: "Atlas", + in_game_press_f3_t_to_reload_resources: "In game: press F3+T to reload resources.", + trim_exported: "Trim exported", + copy_items_entry: "Copy items entry", + open_folder: "Open folder", + done: "Done", + copied_fill_in_the_threshold: "Copied (fill in the threshold)", + export_trim_to_resource_pack: "Export trim to resource pack", + trim_id: "Trim ID", + file_name_and_pattern_asset_id_as_in_the: "File name and pattern asset_id (as in the datapack trim_pattern).", + resource_pack_folder: "Resource pack folder", + texture_namespace: "Texture namespace", + namespace_of_the_pattern_asset_id: "Namespace of the pattern asset_id.", + atlas_assets_minecraft_atlases_armor: "**Atlas** `assets/minecraft/atlases/armor_trims.json`", + register_in_atlas: "Register in atlas", + add_missing_vanilla_palettes: "Add missing vanilla palettes", + e_g_copper_darker_without_it_a_copper: "E.g. copper_darker: without it a copper trim on copper armor shows a missing texture.", + template_icon_id_is_replaced_with_the: "**Template icon** (`{id}` is replaced with the trim ID)", + export_icon_and_model: "Export icon and model", + icon_texture: "Icon texture", + icon_model: "Icon model", + model_parent: "Model parent", + other: "**Other**", + back_up_overwritten_files: "Back up overwritten files", + copies_go_to_blockbench_data_armor_trim: "Copies go to Blockbench data/armor_trim_editor_backups. Not for packs under git, which already keep the history; only the latest 10 backups are kept.", + open_trim_from_resource_pack: "Open trim from resource pack", + no_trims_found_in_this_pack: "No trims found in this pack.", + pack_2: "Pack", + icon: "Icon", + search: "Search", + atlas_2: "atlas", + empty: "Empty", + vanilla: "Vanilla: ", + new_armor_trim: "New armor trim", + start_from: "Start from", + resolution: "Resolution", + armor_under_trim: "Armor under trim", + could_not_load_vanilla_trim: "Could not load vanilla trim", + other_file: "Other file…", + trim_editor_settings: "Trim Editor settings", + minecraft_client_jar: "Minecraft client jar", + jar_path: "Jar path", + the_jar_provides_default_skins_armor: "The jar provides default skins, armor textures, template icons and vanilla trims. Nothing from it is copied into your pack.", + jar_saved: "Jar saved", + helmet_0_0_at_1_0_and_outer_hat_32_0_at: "helmet (0,0) at 1.0 and outer \"hat\" (32,0) at 1.5; chestplate body (16,16) and arms (40,16) at 1.0; boots: legs (0,16) at 0.9", + leggings_waist_16_16_at_0_5_legs_0_16_at: "leggings: waist (16,16) at 0.5, legs (0,16) at 0.4", + a_trim_is_drawn_on_the_same_model_as_the: "A trim is drawn on the same model as the armor. Numbers are how far each box is inflated around the player (in pixels).", + two_layers_on_the_helmet_are_the_left: "\"Two layers\" on the helmet are the left (head, 1.0) and right (hat, 1.5) halves of the humanoid top row. Pixels on the right float 0.5 px above the helmet.", + left_arm_and_leg_reuse_the_right_side: "Left arm and leg reuse the right side area (mirrored) — they cannot differ.", + palette_only_the_8_grays_e0e0e0_000000: "Palette: only the 8 grays (#E0E0E0 … #000000) are recolored by the material. Any other color stays as painted. A trim material matching the armor (gold on gold) uses the \"_darker\" palette.", + transparency_trims_render_as_cutout: "Transparency: trims render as cutout — alpha below 10% is discarded, everything else is opaque.", + server_the_pattern_is_registered_by_a: "Server: the pattern is registered by a datapack (data/<ns>/trim_pattern/<id>.json, asset_id = <ns>:<id>). decal: true draws the trim only on top of armor pixels.", + how_armor_trims_work: "How armor trims work", + trim_preview: "Trim: preview", + skin_overlay: "Skin overlay", + from_file: "from file", + as_painted: "as painted", + darker_palette: " (darker palette)", + skin_not_loaded: "Skin not loaded", + invalid_nickname: "Invalid nickname", + loading: "loading…", + view: "View", + pose: "Pose", + armor_pieces: "Armor pieces", + vanilla_atlas_note: "This is a vanilla pattern name, so the vanilla atlas already registers it.", + right_click_solo: "right click — solo", + left_half_of_the_humanoid_top_row_0_0: "Left half of the humanoid top row (0,0)", + helmet_1_0: "Helmet 1.0", + right_half_of_the_humanoid_top_row_32_0: "Right half of the humanoid top row (32,0), floats 0.5 px above the helmet", + helmet_1_5_outer: "Helmet 1.5 (outer)", + leather_dye: "Leather dye", + trim_material: "Trim material", + as_painted_2: "As painted", + pink_follow_the_material_cyan_keep_their: "Pink follow the material, cyan keep their color", + highlight_palette: "Highlight palette", + play: "Play", + pause: "Pause", + speed: "Speed", + reset_head: "Reset head", + head_2: "Head ↔", + head_3: "Head ↕", + animation_freezes_while_you_paint_poses: "Animation freezes while you paint. Poses are preview-only and never saved into the textures.", + slim_arms: "slim arms", + wide_arms: "wide arms", + default_skins: "Default skins", + player_skin_by_name: "Player skin by name", + name: "Name", + load: "Load", + skin_from_file: "Skin from file", + wide_arms_2: "Wide arms", + slim_arms_2: "Slim arms", + armor_uses_the_same_wide_arms_for_slim: "Armor uses the same wide arms for slim skins in game.", + trim_palette_export: "Trim: palette & export", + no_resource_pack: "no resource pack", + trim_palette: "Trim palette", + top_color_to_paint_with_bottom_result: "Top: color to paint with, bottom: result with the selected material. Other colors stay fixed.", + export: "Export", + export_with_the_last_settings_ctrl_alt_e: "Export with the last settings (Ctrl+Alt+E)", + quick: "Quick", + check: "Check", + no_problems_found: "No problems found.", + armor_trim: "Armor Trim", + paint_minecraft_armor_trims_on_an: "Paint Minecraft armor trims on an accurate armor model with poses and resource pack export", + exact_armor_model_from_the_game_client: "* Exact armor model from the game client: helmet (1.0 + outer 1.5), chestplate, leggings, boots\n* Material preview (quartz, gold, …) while painting\n* Player poses and animations, skins (default, file, player name)\n* Template icon generator and resource pack export with atlas registration", + new_trim: "New trim", + new_trim_2: "New trim…", + open_trim_from_resource_pack_2: "Open trim from resource pack…", + error: "Error", + export_trim_to_resource_pack_2: "Export trim to resource pack…", + quick_export_trim: "Quick export trim", + icon_generator_2: "Icon generator…", + check_trim: "Check trim", + trim_check: "Trim check", + trim_editor_settings_2: "Trim Editor settings…", + how_trims_work: "How trims work", + datapack: "Datapack…", + datapack_short: "Datapack", + dp_title: "Trim pattern datapack", + dp_pattern_info: "Pattern **%0**. The trim ID and namespace come from the export settings.", + dp_version: "Minecraft version", + dp_decal_desc: "Draw the trim only over armor pixels. Preview it with the Decal switch in the View tab.", + dp_names: "Names", + dp_names_desc: "One per line: language=name, e.g. en_us=Clouds. Written to assets/minecraft/lang/world/datapacks of the main world, or pick that folder in the generator right away.",
+ guide_server_2: "Restart the server: new trim patterns are loaded only when the world starts, /reload does not add them.",
+ guide_server_3: "Players need the resource pack with the textures (the Export button).",
+ guide_give_h: "Command",
+ guide_material: "The material only recolors the 8 palette grays; a trim painted in its own colors looks the same with any material, e.g. redstone.",
+ guide_smithing: "The pattern has no smithing template, so it can only be applied by commands or plugins.",
+ guide_plugin_h: "Bukkit / Paper plugin",
+ guide_plugin_note: "On Spigot use Registry.TRIM_PATTERN.get(key). If the pattern is null, the datapack was not loaded.",
+ rp_type: "Save as",
+ rp_type_zip: "Zip archive",
+ rp_type_folder: "Folder",
+ zip_dir: "Archive folder",
+ zip_dir_desc: "For example .minecraft/resourcepacks. A new archive gets pack.mcmeta and pack.png.",
+ zip_name: "Archive name",
+ zip_name_desc: "Without .zip. An existing archive is updated, everything else in it is kept.",
+ rp_folder_desc: "An unpacked resource pack. pack.mcmeta is created if the folder has none.",
+ mc_version_desc: "Sets the format in pack.mcmeta of a new pack.",
+ no_zip_folder: "No folder for the archive selected.",
+ invalid_zip_name: "Invalid archive name.",
+ archive_new: "new archive",
+ archive_update: "will be updated",
+ written_to: "Written to",
+ dp_dir: "Datapacks folder",
+ dp_dir_desc: "For example saves/world/datapacks основного мира или сразу выберите эту папку в генераторе.",
+ guide_server_2: "Перезапустите сервер: новые паттерны отделки загружаются только при запуске мира, /reload их не добавит.",
+ guide_server_3: "Игрокам нужен ресурспак с текстурами (кнопка Экспорт).",
+ guide_give_h: "Командой",
+ guide_material: "Материал перекрашивает только 8 серых оттенков палитры; отделка, нарисованная своими цветами, выглядит одинаково с любым материалом, например redstone.",
+ guide_smithing: "У паттерна нет кузнечного шаблона, поэтому наложить его можно только командой или плагином.",
+ guide_plugin_h: "Плагин Bukkit / Paper",
+ guide_plugin_note: "На Spigot используйте Registry.TRIM_PATTERN.get(key). Если паттерн null — датапак не загрузился.",
+ rp_type: "Сохранить как",
+ rp_type_zip: "Zip-архив",
+ rp_type_folder: "Папка",
+ zip_dir: "Папка для архива",
+ zip_dir_desc: "Например .minecraft/resourcepacks. В новый архив добавляются pack.mcmeta и pack.png.",
+ zip_name: "Имя архива",
+ zip_name_desc: "Без .zip. Если архив уже есть, он обновляется, всё остальное в нём сохраняется.",
+ rp_folder_desc: "Распакованный ресурспак. Если в папке нет pack.mcmeta, он будет создан.",
+ mc_version_desc: "Задаёт формат в pack.mcmeta нового пака.",
+ no_zip_folder: "Не выбрана папка для архива.",
+ invalid_zip_name: "Недопустимое имя архива.",
+ archive_new: "новый архив",
+ archive_update: "будет обновлён",
+ written_to: "Записано в",
+ dp_dir: "Папка datapacks",
+ dp_dir_desc: "Например saves/<мир>/datapacks. Датапак сохраняется zip-архивом.",
+ dp_name_desc: "Без .zip. Если датапак уже есть, он обновляется, остальные отделки в нём сохраняются.",
+ folder_or_zip: "Папка или .zip",
+ pose_spread: "Стойка, части раздвинуты",
+ pose_tpose_spread: "T-поза, части раздвинуты",
+ decal_preview_desc: "Превью «decal»: true — пиксели отделки рисуются только поверх пикселей брони, поэтому внешний слой шлема и дыры в броне остаются пустыми. Эта же настройка пишется в датапак.",
+ armor_icons: "Иконки брони",
+ armor_icons_full: "Отделка на иконках брони",
+ icons_tab: "Иконки",
+ armor_icon_bases: "⚙ предметы брони (превью)",
+ armor_icon_card: "Иконка брони: %0",
+ armor_icon_base_card: "⚙ предмет: %0",
+ slot_helmet: "Шлем",
+ slot_chestplate: "Нагрудник",
+ slot_leggings: "Поножи",
+ slot_boots: "Ботинки",
+ slot_netherite_helmet: "Незеритовый шлем",
+ slot_turtle_helmet: "Черепаший панцирь",
+ slot_netherite_boots: "Незеритовые ботинки",
+ armor_icons_short: "В ванилле любая отделка на предметах брони в инвентаре выглядит одинаково. Здесь вы рисуете, как эта отделка выглядит на каждой форме брони.",
+ what_is_this: "Как это работает",
+ paint_icons: "Рисовать иконки",
+ paint_armor_icons: "Рисовать иконки брони",
+ back_to_player: "Назад к игроку",
+ all_variants: "Все варианты",
+ armor_icons_generators: "Генераторы",
+ armor_icons_generators_action: "Генераторы иконок брони…",
+ icon_colors: "Цвета иконок",
+ icon_colors_palette: "По материалу",
+ icon_colors_fixed: "Свои (без материала)",
+ icon_colors_palette_hint: "Серые цвета палитры перекрашиваются в материал отделки, как на игроке.",
+ icon_colors_fixed_hint: "Иконка используется как нарисована, с любым материалом. Для цветных, не монохромных отделок.",
+ armor_icons_title: "Генераторы иконок брони",
+ armor_icons_click_cards: "нажмите на карточку, чтобы включить или пропустить её",
+ select_all: "Все",
+ select_none: "Ни одной",
+ icon_source: "Источник",
+ icon_source_project: "Из отделки на игроке",
+ icon_source_vanilla: "Ванильный рисунок",
+ icon_source_shape: "Фигура",
+ icon_source_copy: "Копия с обычных шлема и ботинок",
+ icon_source_clear: "Очистить",
+ icon_source_project_hint: "Вид спереди нарисованной части брони вписывается в силуэт предмета. Быстрый старт: потом поправьте вручную.",
+ icon_source_vanilla_hint: "Рисунок, который игра показывает для любой отделки. Основа, поверх которой можно рисовать.",
+ icon_source_copy_hint: "Незеритовый шлем, черепаший панцирь и незеритовые ботинки получают рисунок обычного шлема или ботинок, вписанный в их форму.",
+ icon_palette_hint: "Фигуры обрезаются по силуэту предмета. Серые цвета палитры следуют за материалом, остальные цвета остаются как есть.",
+ shape: "Фигура",
+ shape_step: "Шаг",
+ shape_size: "Толщина",
+ shape_color: "Цвет",
+ custom_color: "Свой цвет",
+ shape_outline: "Контур",
+ shape_inner_outline: "Внутренний контур",
+ shape_stripes_h: "Горизонтальные полосы",
+ shape_stripes_v: "Вертикальные полосы",
+ shape_diagonal: "Диагональные полосы",
+ shape_diagonal2: "Диагональ в другую сторону",
+ shape_checker: "Шахматка",
+ shape_dots: "Точки",
+ shape_band_top: "Полоса сверху",
+ shape_band_middle: "Полоса посередине",
+ shape_band_bottom: "Полоса снизу",
+ shape_fill: "Заливка",
+ icon_mode: "Текущий рисунок",
+ icon_mode_replace: "Заменить",
+ icon_mode_add: "Рисовать поверх",
+ preview_material: "Материал превью",
+ generate_armor_icons: "Генерация иконок брони",
+ icon_grid_title: "Иконки брони: все варианты",
+ icon_grid_hint: "Строки — виды брони, столбцы — материалы отделки; первый столбец — иконка как нарисована. Где материал отделки совпадает с бронёй, используется тёмная палитра, как в игре.",
+ icon_grid_hint_fixed: "Свои цвета: иконка одинакова с любым материалом отделки.",
+ armor_icons_help_why: "Зачем. В ванильном Minecraft шлем, нагрудник, поножи или ботинки с отделкой в инвентаре всегда показывают один и тот же рисунок, меняется только цвет материала. Нагрудники с разными отделками выглядят одинаково.",
+ armor_icons_help_what: "Что делает. Здесь вы рисуете, как именно эта отделка выглядит на иконке предмета. В ресурспак пишется свой рисунок для каждой формы брони, перекрашенный под каждый материал. Так работает ресурспак Visual Armor Trims от Thanos (CC BY-SA 4.0).",
+ armor_icons_help_slots: "Семь иконок. Шлем, нагрудник, поножи и ботинки общие для кожаной, кольчужной, железной, золотой, алмазной и медной брони, а также незеритовых нагрудника и поножей. Незеритовый шлем, черепаший панцирь и незеритовые ботинки имеют свою форму и получают отдельные иконки. Пустые иконки не экспортируются: для таких предметов в паке остаётся то, что там уже есть.",
+ armor_icons_help_colors: "Цвета. Рисуйте 8 серыми цветами палитры, как саму отделку: они станут цветами материала (на броне из того же материала — тёмная палитра). Остальные цвета остаются как есть. Для цветных отделок выберите Свои (без материала): тогда иконка одинакова с любым материалом.",
+ armor_icons_help_paint: "Рисование. Рисовать иконки показывает иконки плоско перед камерой; предмет брони под иконкой — только превью. Можно также выбрать текстуру иконки и рисовать в 2D-редакторе. Генераторы заполняют иконки из отделки на игроке, ванильного рисунка или простых фигур; Все варианты показывает каждую броню с каждым материалом.",
+ armor_icons_help_export: "Экспорт. Если в ресурспаке уже есть Visual Armor Trims (в том числе в оверлее), отделка добавляется в него: текстуры, атлас, модели и определения предметов. Иначе плагин пишет свои определения предметов на основе ванильных. Нужен Minecraft 1.21.5 или новее.",
+ armor_icons_help_short: "Иконки брони: в ванилле отделка на любом предмете брони в инвентаре выглядит одинаково. Во вкладке «Иконки» можно нарисовать для этой отделки свой вид, он экспортируется в формате Visual Armor Trims.",
+ armor_icons_count: "Иконки брони: нарисовано %0 из %1. Пустые не экспортируются, для них в паке остаётся то, что есть.",
+ armor_icons_export_info: "**Иконки брони** — отделка на предметах брони в инвентаре",
+ export_armor_icons: "Экспортировать иконки брони",
+ export_armor_icons_desc: "Свои иконки предметов брони для этой отделки. Visual Armor Trims в паке находится и дополняется.",
+ armor_icons_old_version: "Иконки брони не экспортированы: нужен Minecraft 1.21.5 или новее.",
+ armor_icons_no_vanilla_item: "%0: нет определения предмета в jar Minecraft, пропущено.",
+ armor_icons_unknown_item: "%0 имеет неожиданный формат и не изменён.",
+ armor_icons_written: "Иконки брони: моделей %0, определений предметов %1 (%2)",
+ pack_root: "корень пака",
+ armor_icons_plan: "иконки брони: %0 из %1 → %2, %3",
+ armor_icons_mode_vat: "добавляются в Visual Armor Trims",
+ armor_icons_mode_own: "свои определения предметов",
+ armor_icons_tag: "иконки брони",
+ new_icons_desc: "Иконки этой отделки на предметах брони в инвентаре. Их можно перегенерировать или дорисовать позже.",
+ new_icons_project: "Сгенерировать из отделки",
+ new_icons_vanilla: "Ванильный рисунок",
+ new_icons_empty: "Пустые",
+ files_unchanged: "Без изменений, не перезаписано: %0",
+ import_multi_hint: "Ctrl или Shift — открыть несколько, каждую в своей вкладке",
+ trims_opened: "Открыто отделок: %0",
+ template_icon_empty_skipped: "Иконка шаблона пустая и не экспортирована",
+ backup_skipped_git: "Без резервной копии: пак под git",
+ icons_kept_empty_result: "Оставлено как нарисовано: %0 (генератор дал пустую иконку)",
+ icon_pattern_guessed: "Иконки шаблонов найдены в паке, путь подставлен автоматически.",
+ },
+ };
+}
+
+})();
diff --git a/plugins/armor_trim_editor/changelog.json b/plugins/armor_trim_editor/changelog.json
new file mode 100644
index 00000000..9570018b
--- /dev/null
+++ b/plugins/armor_trim_editor/changelog.json
@@ -0,0 +1,42 @@
+{
+ "1.0.0": {
+ "title": "1.0.0",
+ "date": "2026-09-27",
+ "author": "BbIJABNPOBATEJb",
+ "categories": [
+ {
+ "title": "New Features",
+ "list": [
+ "Initial release"
+ ]
+ }
+ ]
+ },
+ "1.1.0": {
+ "title": "1.1.0",
+ "date": "2026-09-29",
+ "author": "BbIJABNPOBATEJb",
+ "categories": [
+ {
+ "title": "New Features",
+ "list": [
+ "Armor icons: draw how the trim looks on armor items in the inventory, with a preview on every armor type and trim material",
+ "Armor icon generators: from the trim on the player, the vanilla overlay or simple shapes",
+ "Armor icons are exported in the Visual Armor Trims format, into Visual Armor Trims itself if the pack contains it"
+ ]
+ },
+ {
+ "title": "Improvements",
+ "list": [
+ "Vanilla palettes are only added to the atlas for Minecraft versions that have them (copper_darker, resin)",
+ "Several trims can be opened from a resource pack at once, each in its own tab; a trim that is already open gets its tab back",
+ "Export only rewrites files whose content changed and keeps the line endings of edited JSON files",
+ "Re-exporting armor icons keeps the order of existing item model cases",
+ "Empty armor icons leave the pack entries of those items untouched, and a generator never replaces a drawn icon with an empty one",
+ "An empty template icon is not exported; the import finds the template icon path by itself",
+ "No backups for packs under git, and only the latest 10 backups are kept"
+ ]
+ }
+ ]
+ }
+}