Skip to content

Introduction to custom outcomes and lucky block types

I2000C edited this page Aug 5, 2022 · 3 revisions

Outcome packs

In NewAmazingLuckyBlocks, there are things called OutcomePacks.
An outcome pack is a set of outcomes.
Finally, an outcome pack is a list of rewards.

Rewards are every event that will occur when you break a LuckyBlock.
There are the next types of rewards:

  • Item rewards
  • Command rewards
  • Entity rewards
  • EntityTower rewards
  • Firework rewards
  • Sound rewards
  • Structure rewards
  • Block rewards
  • Lightning rewards
  • Dark hole rewards
  • Mini volcano rewards
  • Message rewards
  • Effect rewards
  • Explosion rewards
  • Block replacing sphere rewards
  • Trap rewards

A description of each reward type can be found here.

In order to create, edit or remove outcome packs, outcomes or rewards, you need to open the LuckyBlocks menu.

LuckyBlock types

In addition to Outcome packs, there are LuckyBlock types.
A LuckyBlock type is a concrete LuckyBlock with its material/texture, name, description, permissions, crafting and outcome packs.
The last one is the list of every outcome pack of the LuckyBlock type.

When you break a LuckyBlock, the plugin searchs the LuckyBlock type associated to it.
Then chooses an outcome pack from its outcome pack list based in their probabilities.
Finally, from the selected outcome pack, it selects an outcome (again using their probabilities).
These outcome is the outcome that will be executed.

In order to create, edit or remove LuckyBlock types, you need to open the LuckyBlocks menu.