Hainy Pixelmon Lucky Blocks

# Hainy Pixelmon Lucky Blocks

⚠️ This mod is still under active development, but already fully
functional and tested in-game on my own Pixelmon server.

A Pixelmon addon that adds Lucky Blocks, spawned as you travel
through a Lucky Trail mechanic: the more distance you cover — on
foot, flying, riding a Pokemon, any means of travel counts — the
higher your chance of triggering a spawn. Each spawn generates
between 1 and 3 blocks.

When a spawn grants 3 Common Lucky Blocks at once, there's an
additional chance that a Jackpot Block also spawns nearby, as a
bonus — its spawn is publicly announced to the whole server.

Breaking that Jackpot Block first rolls a chance for a Super
Jackpot Block to spawn nearby (this spawn is also publicly
announced to the whole server). If it doesn't happen, a reward is
drawn from:

- A Legendary or Mythical Pokemon, shiny, with perfect IVs
- A bundle of rare items (Master Ball, Rare Candy, Ability Patch,
  Golden Bottle Cap, PP Max...)
- A bundle of bonus Lucky Blocks

Breaking the Super Jackpot Block always grants a Legendary or
Mythical shiny Pokemon with perfect IVs, plus the item bundle and
the bonus Lucky Block bundle, both in doubled quantity.

## Available blocks

(final names still being decided)

- Common Lucky Block
- Rare Lucky Block
- Master Lucky Block
- Legendary Lucky Block
- Item Lucky Block
- Alternate Forms Lucky Block
- Shiny Lucky Block
- Jackpot Block
- Super Jackpot Block

## Configuration

The mod is fully configurable through its config file, including:

- The spacing between Lucky Trail spawn attempts
- The threshold determining the success probability of an attempt
- The weighting of getting a pack of 3 Common Lucky Blocks instead
  of 1 or 2
- The probability of a Jackpot Block spawning after a pack of 3
  Commons
- The probability of a Super Jackpot Block spawning when breaking
  a Jackpot Block

Requires Pixelmon to function (see project dependency).

Feedback and suggestions are welcome, the mod keeps evolving!

# Hainy Pixelmon Lucky Blocks

⚠️ Ce mod est encore en développement actif, mais déjà pleinement
fonctionnel et testé en jeu sur mon propre serveur Pixelmon.

Un addon Pixelmon qui ajoute des Lucky Blocks, générés au fil de tes
déplacements via un mécanisme de Sillage de Chance : plus tu
parcours de distance (à pied, en volant, à dos de Pokémon, peu
importe le moyen), plus tu as de chances de déclencher un spawn.
Chaque spawn fait apparaître entre 1 et 3 blocs.

Quand un spawn donne 3 Lucky Blocks Communs à la fois, il y a en
plus une chance qu'un Bloc Jackpot apparaisse à proximité, en bonus
— son apparition est annoncée publiquement à tout le serveur.

Casser ce Bloc Jackpot déclenche d'abord une chance qu'un Bloc
Super Jackpot apparaisse à proximité (cette apparition est elle
aussi annoncée publiquement à tout le serveur). Si ce n'est pas le
cas, une récompense est tirée parmi :

- Un Pokémon Légendaire ou Fabuleux, shiny, avec IV parfaits
- Un lot d'objets rares (Master Ball, Rare Candy, Ability Patch,
  Golden Bottle Cap, PP Max...)
- Un lot de Lucky Blocks bonus supplémentaires

Casser le Bloc Super Jackpot donne toujours un Pokémon Légendaire
ou Fabuleux shiny IV parfait, ainsi que le lot d'objets et le lot
de Lucky Blocks bonus, ces deux derniers en quantité doublée.

## Blocs disponibles

(noms définitifs encore en réflexion)

- Lucky Block Commun
- Lucky Block Rare
- Lucky Block Master
- Lucky Block Légendaire
- Lucky Block Item
- Lucky Block Formes Alternatives
- Lucky Block Shiny
- Bloc Jackpot
- Bloc Super Jackpot

## Configuration

Le mod est entièrement paramétrable via son fichier de config,
notamment :

- L'espacement entre les tentatives de spawn du Sillage de Chance
- Le seuil déterminant la probabilité de réussite d'une tentative
- La pondération d'obtenir un paquet de 3 Lucky Blocks Communs au
  lieu de 1 ou 2
- La probabilité qu'un Bloc Jackpot apparaisse suite à un paquet
  de 3 Communs
- La probabilité qu'un Bloc Super Jackpot apparaisse à la casse
  d'un Bloc Jackpot

Nécessite Pixelmon pour fonctionner (voir la dépendance du projet).

Des retours et suggestions sont les bienvenus, le mod continue
d'évoluer !