PixelGO - Items (for Pixelmon)

========================================================================= PixelGO Items - Version 2.0
 Minecraft 1.21.1 / NeoForge / Pixelmon 9.4.0
=========================================================================


------------------------------------------------------------------------- NEW: Pokemon now drop items
-------------------------------------------------------------------------

Every wild Pokemon you defeat in battle now drops exactly one PixelGO item.
Not "a chance of an item" - every single defeated Pokemon drops one, always.

The item appears on the ground where the Pokemon was standing, so walk over
to pick it up. If the Pokemon is gone by then, the item drops at your feet
instead, so you can never lose a reward.

A chat message tells you what dropped and how lucky you were:

    * Rattata dropped: Add EV ATK (10% chance)
    * Rattata *shiny* dropped: Shiny Swapper (20% chance)

Shiny Pokemon use their own, much better drop table. The Shiny Swapper can
ONLY be obtained from a shiny Pokemon - it has a 20% chance there and never
drops from a regular one.

Default drop chances:

    ITEM                                    NORMAL      SHINY
    ------------------------------------------------------------
    Add EV (each of the 6 stats)              10%         5%
    Add IV (each of the 6 stats)               5%         5%
    Random Level                               2%         3%
    Random IV                                  2%         3%
    Random EV                                  2%         3%
    Random Size                                2%         3%
    Skin Swapper                               1%         3%
    Random Fossil                              1%         5%
    Shiny Swapper                              -          20%

Note: only wild Pokemon count. Beating a trainer's Pokemon or another
player's Pokemon does not drop anything.


-------------------------------------------------------------------------------
 FIXED: Random Fossil
-------------------------------------------------------------------------------

The Random Fossil used to give you Omanyte every single time. It now works
as intended and revives a genuinely random Pokemon, picked from the entire
Pokedex.

How to use it:

    1. Put the Random Fossil in a Fossil Machine.
    2. Add a Poke Ball, like you would for any normal fossil.
    3. Wait for the machine to finish - you can watch the statue form.
    4. Right-click the machine to collect your Pokemon.

The revived Pokemon comes out at level 1, exactly like a normal fossil, and
it has the same chance of being shiny as any other fossil Pokemon.

Also fixed: the item's tooltip no longer claims it revives an Omanyte, and
the machine keeps your random result even if the server restarts while it is
still working.


-------------------------------------------------------------------------
 NEW: Item tooltips
-------------------------------------------------------------------------

Every item now explains what it does when you hover over it, so you no longer
have to guess which one adds EVs and which one rerolls them.


-------------------------------------------------------------------------
 NEW: Item rarities
-------------------------------------------------------------------------

Items now use Minecraft's rarity colours, so you can tell at a glance how
valuable a drop is:

    WHITE  (Common)     Add EV items
    YELLOW (Uncommon)   Add IV items
    CYAN   (Rare)       Random Level, Random IV, Random EV, Random Size,
                        Random Fossil
    PURPLE (Epic)       Shiny Swapper, Skin Swapper


-------------------------------------------------------------------------
 FOR SERVER OWNERS: Configuration
-------------------------------------------------------------------------

Everything about the drop system can be tuned in:

    config/pixelgoitems-common.toml

The file is created automatically the first time the mod runs. It contains:

    enabled        Turn the whole drop system on or off.
    notifyPlayer   Turn the "X dropped: Y" chat message on or off.

Then one section per item, for example:

    [drops.shiny_swapper]
        weight = 0.0
        shinyWeight = 20.0

IMPORTANT - how the numbers work:

Because every Pokemon drops exactly one item, these values are weights, not
independent percentages. An item's real chance is its weight divided by the
total of all weights.

The default values add up to exactly 100, which means you can read each one
directly as a percentage. If you keep your own totals at 100 you can carry on
reading them that way. If they do not add up to 100, everything still works
fine - the chances are simply rescaled, and the in-game chat message always
shows the real percentage.

Set a weight to 0 to remove that item from the drop pool entirely.

Every item has two values: "weight" is used against regular Pokemon, and
"shinyWeight" is used against shiny Pokemon. The shiny value replaces the
normal one, it is not added on top of it.


-------------------------------------------------------------------------
 UPGRADING FROM AN OLDER VERSION
-------------------------------------------------------------------------

If you are coming from a build that already had a pixelgoitems-common.toml,
delete it and let the mod generate a fresh one. The setting names changed
from "chance"/"shinyChance" to "weight"/"shinyWeight" when drops became a
single guaranteed item instead of separate rolls.

No changes are needed to your world or your Pokemon.