BeastWithdraw Optional Resource Pack - Minecraft Java 26.2
==========================================================

Target Minecraft version: Java Edition 26.2
Resource-pack format: 88.0
Texture resolution: 128x128

This optional pack adds one regular texture and five amount-tier textures for
every bundled BeastWithdraw visual type. CustomModelData and AmountOverrides are
BeastWithdraw Plus features, so the pack's regular and tier models require Plus.

Included visuals and CustomModelData
------------------------------------

Type / material                 Regular  Small  Medium  Large  Premium  Legendary
XP bottle / EXPERIENCE_BOTTLE      100     110     120    130      140        150
Cash note / PAPER                  200     210     220    230      240        250
Heart satchel / PAPER              300     310     320    330      340        350
Points voucher / LAPIS_LAZULI      400     410     420    430      440        450
mcMMO credit / EMERALD             500     510     520    530      540        550
mcMMO skill book / BOOK            600     610     620    630      640        650
BeastTokens note / PLAYER_HEAD     700     710     720    730      740        750

The PAPER dispatcher includes both cash notes and heart satchels. Exact-value
fallback guards prevent either family from replacing unrelated PAPER models.
The PLAYER_HEAD dispatcher preserves Minecraft 26.2's vanilla special renderer
for every model-data value not listed above.

Installation
------------

1. Put BeastWithdraw-Optional-ResourcePack-26.2.zip in the client's
   .minecraft/resourcepacks folder and enable it in Resource Packs.
2. Use the CustomModelData values shown above in each withdraw configuration.
   Fresh default Withdraw.yml files already contain these mappings.
3. The five automatic tiers are enabled in fresh default configurations. If a
   withdraw type should not use tier visuals, set this in that withdraw file:

     Settings:
       AmountOverrides:
         Enabled: false

4. Restart the server or use the plugin's supported reload flow after editing.

Existing server configurations are preserved during updates. If your files still
contain CustomModelData: 0 or only the old large/premium examples, merge the new
regular and five-tier examples from the plugin's bundled Withdraw.yml files.

Quick tests
-----------

Automatic amount tier:
  /xpbottle 1000

Force a named Plus override regardless of amount:
  /bwa give YourName xpbottle 10 1 0 -override large

Direct Minecraft model tests:
  /give @s minecraft:experience_bottle[minecraft:custom_model_data={floats:[100.0]}]
  /give @s minecraft:experience_bottle[minecraft:custom_model_data={floats:[150.0]}]
  /give @s minecraft:paper[minecraft:custom_model_data={floats:[230.0]}]
  /give @s minecraft:book[minecraft:custom_model_data={floats:[650.0]}]

Notes
-----

- AmountOverrides are enabled by default in fresh configurations. Disable them
  on servers that are not distributing the optional pack to their players.
- Values below the first configured amount tier use the regular texture.
- The pack targets stable Minecraft Java 26.2 and uses its modern item-definition
  format. Use a separately built pack for older Minecraft resource formats.
- No animated, emissive, sound, or shader effects are included in this version.
