PICKLOOT: PERFECTION UI THEME 3.5.0
MINECRAFT JAVA 1.21.1 / NEOFORGE

ABOUT

The Perfection UI Theme gives PickLoot a warm, classic pixel-art identity.
It replaces the loot cards, selected state, pickup-key prompt, tutorial frame,
five rarity diamonds and selection sound while remaining compatible with both
PickLoot's semi-inclined 3D mode and flat presentation.

REQUIREMENTS

- Minecraft Java 1.21.1
- NeoForge
- PickLoot 3.5.0 or newer

INSTALLATION

1. Keep this resource pack as a ZIP.
2. Place it in the Minecraft resourcepacks folder.
3. Enable it above other packs that modify assets/pickloot.
4. Use F3 + T to reload visual or sound changes while testing.

INCLUDED THEME ASSETS

assets/pickloot/textures/gui/sprites/hud/card_frame.png
  Normal card used in 3D and flat modes.
assets/pickloot/textures/gui/sprites/hud/card_selected_frame.png
  Highlighted selected-card frame.
assets/pickloot/textures/gui/sprites/hud/key_frame.png
  Border for the contextual pickup key.
assets/pickloot/textures/gui/sprites/hud/hotbar.png
  Background behind the configurable pickup key.
assets/pickloot/textures/gui/sprites/hud/tutorial_frame.png
  Additional frame for the temporary controls panel.
assets/pickloot/textures/gui/sprites/hud/rarity_<level>.png
  Five colored 16x16 rarity diamonds.
assets/pickloot/textures/gui/sprites/hud/rarity_<level>_mask.png
  Tintable masks for configuration-driven rarity colors.
assets/pickloot/sounds/ui/selection_scroll.ogg
  Sound played when the selected loot entry changes.

PERFORMANCE

The active card textures are pre-expanded to 176x28 and the tutorial frame to
176x42. This prevents Minecraft 1.21.1 from repeating a tiny nine-slice center
thousands of times per frame. Compact design sources are stored outside assets.

RARITY COLORS

Enable useRarityTextureColors to display the exact colors painted into the five
rarity_<level>.png sprites. Disable it to use the tintable masks and PickLoot's
configurable RGB rarity colors. Item- and tag-specific colors can be configured
through config/pickloot-rarities.json.

CONFIGURATION EXAMPLES

The config-examples directory contains examples for Configuration, native
NeoForge options, smart filters and custom item rarities. These examples do not
apply while left inside the resource-pack ZIP. Copy the desired files to the
Minecraft or modpack config directory.

The smart filter is disabled by default and can be enabled with its configurable
PickLoot key.

AI-ASSISTED CUSTOMIZATION

AI_RESOURCE_PACK_GUIDE.md explains how an AI can safely modify or repair the
interface without breaking file paths, alpha transparency, nine-slice metadata,
flat/3D compatibility or performance.

RARITY_TABLE_1.21.1.md documents the automatic hierarchy included in PickLoot.

LICENSE AND VALIDATION

Do not remove or modify:

- LICENSE
- assets/pickloot/pickloot_template.json
- assets/pickloot/pickloot_license.txt

PickLoot validates the official template marker and embedded license during
resource reload. Invalid protected replacements fall back to the built-in HUD.

Private modifications are permitted. Publication, redistribution and
monetization of derivative protected assets are governed by the included custom
LICENSE. Read it completely before publishing a modified version.

Copyright 2026 KubePixel. All Rights Reserved.
