ВЕРСИИ (1)

# Quacky's Better Totems — Version 1.0.0 **Release Date:** May 30, 2026 ## Overview Quacky's Better Totems brings full customization to Minecraft's Totem of Undying. Choose custom textures, sounds, particle colors, and animation effects. Profile-based configuration with ModMenu UI. Client-side only. ## Features ### Texture Customization - **PNG Import** — drop custom `.png` files into `config/quackys_better_totems/totems/` - **Auto-Processing** — transparent border auto-crop, proportional downscaling (max 64px) - **Animated Texture Support** — import full resource-pack ZIPs with `.png.mcmeta` animation metadata - **Model Override** — custom `.json` models embedded in ZIP packs; UV auto-rescaled for 1.21.11 compatibility - **Live Preview** — texture changes apply instantly via resource reload - **Disk Caching** — SHA-256 content-hash cache; files edited = auto re-process ### Sound Customization - **OGG Support** — drop `.ogg` files into `config/quackys_better_totems/sounds/` - **Per-Player Sounds** — separate sound + volume + pitch for: - Self (your totem pop) - Others (unrelated players) - Teammates (same scoreboard team) - **Volume & Pitch Control** — range 0.0–4.0 per sound ### Particle Effects - **Custom Colors** — RGB sliders for self, others, teammates particle dust - **Density Control** — scale particle count 0–3× vanilla (0 = none, 1 = vanilla) - **Vanilla Fallback** — disable color to use default particles ### Animation Tweaks - **Scale** — resize floating totem pop 0.1–2× - **Spin Speed** — Y-axis rotation 0–3× (0 = frozen, 1 = vanilla) - **Test Button** — "Test Totem Pop" plays full animation + sound without consuming item ### Profiles - **Create** — "New Profile" button - **Name** — inline rename (editable text field) - **Duplicate** — copy settings as template - **Delete** — remove (min. 1 profile required) - **Cycle** — ◀/▶ buttons to switch active profile - **Persistence** — auto-save to `config.json` ### User Interface - **ModMenu Integration** — entire GUI in-game, no manual config files - **Scrollable Layout** — single-column, compact button layout - **Profile Management** — inline rename field, delete/duplicate buttons - **Folder Links** — "Open Totems Folder" / "Open Sounds Folder" buttons for drag-and-drop ## Technical Highlights ### Performance - **Zero Per-Tick Logic** — mixin fires only on `EntityStatus 35` (totem activation) - **Disk Caching** — processed textures cached by SHA-256 content hash - **GPU Texture Reuse** — resource packs served from cache; no re-encode - **Resource Reload Integration** — single-call mixin injects texture pack at highest priority - **Async-Safe Image Processing** — `BufferedImage`/`ImageIO` used; no GL context required ### Architecture - **Modular Managers**: - `TotemCacheManager` — SHA-256 hash, disk LRU cache - `TotemImageProcessor` — crop, downscale, PNG encode - `TotemDirectoryWatcher` — on-demand file scan (no background thread) - `TotemReloadManager` — orchestrate texture/sound selection + resource reload - `TotemZipImporter` — extract, validate, model JSON patch - **Mixin Injection Points**: - `ClientPlayNetworkHandlerMixin` — intercept totem pop, branch on entity type (self/other/teammate) - `ReloadableResourceManagerImplMixin` — inject texture pack at resource load time - `InGameOverlayRendererMixin` — scale animation spin speed - **Resource Packs**: - `QbtResourcePack` — single PNG texture override (legacy) - `DirectoryResourcePack` — full pack serve (for ZIP imports) ### Compatibility - **Minecraft Version** — 1.21.11 (exact; Yarn API drift) - **Loaders** — Fabric 0.16.0+ required - **Dependencies** — Fabric API, ModMenu (no optional mods) - **Client Launchers** — Lunar Client, Modrinth App, Feather, vanilla Fabric - **Conflict-Free** — uses LWJGL TinyFileDialogs (no AWT/Swing), no known mod conflicts ## File Structure ``` config/quackys_better_totems/ ├── config.json # Profile data + active profile ID ├── totems/ # PNG + ZIP totem imports │ ├── custom_totem.png │ └── Duck Totem (Animated).zip ├── sounds/ # OGG sound files │ ├── pop_sound.ogg │ └── others_sound.ogg └── cache/ # Auto-managed processed textures (SHA-256 named) ├── abc123def456...png └── 789ghi012jkl...png ``` ## Installation 1. Install **Fabric Loader** ≥0.16.0 for MC 1.21.11 2. Add to `mods/`: - Fabric API 0.141.4+1.21.11 or newer - ModMenu 17.0.0 or newer - `quackys-better-totems-1.0.0.jar` 3. Launch game via Fabric ## Usage 1. Open **Mod Menu** → **Quacky's Better Totems** → configure 2. **Dashboard**: toggle mod, switch profile, test pop 3. **Profiles**: rename, duplicate, delete, cycle 4. **Editor**: - Import PNG/OGG via file picker - Set colors (RGB sliders, self/others/teammates) - Adjust scale, spin, particle density - Set per-player sounds (volume, pitch) 5. **Save & Close** to persist ## Known Limitations - HUD totem texture override not wired (item-model rewrite in 1.21.11 is invasive) - HUD color tint uses removed `RenderSystem.setShaderColor` API; color visible in particles only ## License MIT. Quack responsibly. ## Author **DeQuackDealer** --- **Build Info** - JAR: 174 KB - Gradle: 9.4.0 - Loom: 1.16.2 - Java: 25.0.1