# Better Enchanted Books

**Version:** 1.0.0  
**Minecraft Java:** 26.1–26.2 only  
**Creator:** Haider x  
**License:** All Rights Reserved

Better Enchanted Books redesigns every vanilla enchanted book according to its stored enchantment. Every book has a dedicated visual story—not a recolored shared effect. Sharpness performs crossed sword cuts, Mending pulls fragments together and stitches a crack, Loyalty throws and returns a trident, Frost Walker grows ice tiles, and every other enchantment receives its own action.

## Features

- All 43 enchantments available throughout the stable Java 26.x releases.
- One distinct animated texture and one custom animation storyboard for every enchantment.
- 80 hand-generated frames per texture at 2 ticks per frame: an 8-second loop.
- 32×32 Minecraft-style pixel art with a consistent book silhouette.
- Enchantment-specific striking, shielding, freezing, repairing, returning, splitting, piercing, weaving, growing, dissolving, charging, dashing, and bursting effects.
- No shared orbit or palette-swapped particle loop between enchantments.
- Automatic vanilla selection through `minecraft:stored_enchantments` and the component item-model system.
- Supports every normal enchantment level from 1 through its official maximum.
- Animated generic fallback for multi-enchantment or unusual books.
- No OptiFine, CIT, Fabric, Forge, mod, or shader dependency.

## Compatibility

This edition supports exactly these stable Minecraft Java releases:

- 26.1 — resource format 84.0
- 26.1.1 — resource format 84.0
- 26.1.2 — resource format 84.0
- 26.2 — resource format 88.0

There is one pack folder: `Better Enchanted Books`. All 43 designs, including Lunge, are selected natively by vanilla Minecraft.

## Project Logo

`better_enchanted_books_logo.gif` is a 256×256 animated logo designed for project listings. It displays Sharpness, Frost Walker, Mending, and Fortune one after another using frames sampled directly from their complete in-pack animation sheets, and remains below 256 KiB.

## Installation

Place the `Better Enchanted Books` folder—or the upload-ready ZIP—inside `.minecraft/resourcepacks`, then enable it from the Resource Packs screen. No companion pack or mod is required.

## Build and Verification

- `python tools/build_pack.py` regenerates and validates all 43 animated books.
- `python tools/verify_all_versions.py` verifies the selector and metadata against every installed stable 26.x client.
- `python tools/build_release_zips.py` creates the single clean upload ZIP.
