From 6a33c20427a2516686003f361f58bc8ffb972f47 Mon Sep 17 00:00:00 2001
From: Alexey Martemyanov <mallexxx@gmail.com>
Date: Thu, 11 Jun 2026 00:25:28 +0600
Subject: [PATCH] [2026-06-10] N64 HTS texture packs: update doc with installed
 packs, sources, process

---
 family/how-to/htpc-emulators-setup.md | 71 +++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/family/how-to/htpc-emulators-setup.md b/family/how-to/htpc-emulators-setup.md
index 24094d96..a1dc25b6 100644
--- a/family/how-to/htpc-emulators-setup.md
+++ b/family/how-to/htpc-emulators-setup.md
@@ -317,6 +317,77 @@ python3 /tmp/artwork_windows.py        # скачать обложки с SteamG
 
 ---
 
+---
+
+## N64 — Hi-Res Texture Packs (HTS)
+
+**Платформа:** RetroArch core `mupen64plus_next_libretro.so`
+
+**Формат:** `HTS` — кешированные текстуры GLideN64. Файлы `*_HIRESTEXTURES.hts` кладутся в:
+```
+~/.var/app/org.libretro.RetroArch/config/retroarch/system/Mupen64plus/cache/
+```
+
+**Настройки в `Mupen64Plus-Next.opt`** (обязательно):
+```
+txHiresEnable = "True"
+txHiresFullAlphaChannel = "True"
+EnableEnhancedHighResStorage = "True"
+EnableEnhancedTextureStorage = "True"
+EnableTextureCache = "True"
+txCacheCompression = "True"
+txFilterMode = "None"           # для HTS не нужен
+```
+
+**Источник пакетов:** [EvilGames.eu](https://evilgames.eu/texture-packs.htm) — GhostlyDark's Reloaded серия
+
+### Имя файла HTS = ROM Header Name
+
+Имя `.hts` файла должно совпадать с **внутренним именем ROM** (не с именем файла). Проверить:
+```bash
+# Показать ROM header name
+head -c 25 /path/to/rom.z64 | strings
+# Или через Python:
+python3 -c "rom=open('/path/to/rom.z64','rb').read(); print(rom[0x20:0x20+20].decode('ascii','ignore').strip())"
+```
+
+### Установленные HTS (июнь 2026)
+
+| ROM Header | Игра | Размер HTS | Пакет | Прогресс |
+|-----------|------|-----------|-------|----------|
+| `BANJO TOOIE` | Banjo-Tooie | 132MB | BT Reloaded v0.1.1 | UI only |
+| `Banjo-Kazooie` | Banjo-Kazooie | 2.0GB | BK Reloaded v0.2.0 | UI only |
+| `SMASH BROTHERS` | Super Smash Bros | 1.2GB | SSB Reloaded v2.0.1 | 100% |
+| `MARIOKART64` | Mario Kart 64 | 12GB | MK64 Reloaded v2026.04.03 | 100% |
+| `SUPER MARIO 64` | Super Mario 64 | 4.9GB | SM64 Reloaded v2.6.0 | 100% |
+
+### Ожидают установки (качаются)
+
+| ROM Header | Игра | Размер скачивания | Пакет |
+|-----------|------|-------------------|-------|
+| `ZELDA OOT` | Zelda: Ocarina of Time | 3.7GB | OoT Reloaded v11.0.0 |
+| `ZELDA MAJORA` | Zelda: Majora's Mask | 4.7GB | MM Reloaded v11.0.2 |
+
+### Несовместимые форматы
+
+**GlideHQ (подпапки)** — старые пакеты в формате `hires_texture/ROM_NAME/` — **не работают** с Mupen64Plus-Next в RetroArch. Только HTS.
+
+**Rice (плоские PNG)** — можно скомпилировать в HTS через RMG (Rosalie's Mupen GUI), но только с запущенной игрой в GUI режиме. Headless не работает.
+
+**Conker (Conker BFD)** — есть только PNG (60MB) на диске, готового HTS нет. Нужна компиляция.
+
+### Процесс установки
+
+```bash
+CACHE="$HOME/.var/app/org.libretro.RetroArch/config/retroarch/system/Mupen64plus/cache"
+# Извлечь HTS из архива напрямую в кэш
+7z x /path/to/pack.7z -so "ROMNAME_HIRESTEXTURES.hts" > "$CACHE/ROMNAME_HIRESTEXTURES.hts"
+```
+
+**Важно:** `/tmp` — tmpfs (16GB). Для пакетов >1GB качать сразу на `/run/media/system/Data/N64/`.
+
+---
+
 ## TODO: DOS / Windows Standalone
 
 - [ ] Discworld (DOS) — настроить через DOSBox в RetroArch или DOSBox Staging standalone