GlobalStructureLoot -Loot Editor 1.3.1

GlobalStructureLoot Premium 1.3.1

This update improves the PLAYER-based MMOItems level system introduced in 1.3.0.

You can now apply minimum and maximum level limits, offsets, and fallback levels when generating MMOItems based on the player's RPG level.

New features

• Added advanced PLAYER level configuration.
• Added minimum item level support.
• Added maximum item level support.
• Added positive and negative level offsets.
• Added fallback levels when the player level cannot be resolved.
• Improved debug information for player-based item level generation.
• Added validation for the new level settings.

Example

level:
  mode: PLAYER
  min: 10
  max: 100
  offset: 5
  fallback: 20

With this configuration, the plugin:

• Gets the player's RPG level.
• Adds the configured offset.
• Applies the minimum and maximum limits.
• Uses the fallback level if the player level cannot be resolved.

Example calculation

If the player is level 34 and the configuration contains:

offset: 5

The generated MMOItem will use level:

34 + 5 = 39

If the maximum level is:

max: 35

The final item level will be limited to:

35

Negative offsets

Offsets can also be negative:

level:
  mode: PLAYER
  offset: -5

A level 34 player would generate a level 29 MMOItem.

Fallback level

You can define a fallback level:

level:
  mode: PLAYER
  fallback: 20

If GlobalStructureLoot cannot determine the player's RPG level, the MMOItem will be generated at level 20.

If no fallback is configured, the plugin keeps the previous behavior and uses the default MMOItems generation system.

Backward compatibility

All previous level configurations remain supported.

Fixed level:

level: 25

Random level range:

level:
  min: 10
  max: 30

Player RPG level:

level: PLAYER

Advanced player level configuration:

level:
  mode: PLAYER
  min: 10
  max: 100
  offset: 5
  fallback: 20

Unidentified MMOItems

Player-based levels continue to work with the unidentified item system.

The item level is resolved before the MMOItem is converted into its unidentified form, allowing the generated level to be preserved when the item is later identified.

level:
  mode: PLAYER
  min: 10
  max: 100

unidentified-chance: 100.0

Other changes

• Improved validation for invalid PLAYER level configurations.
• Improved debug logs with player level, offset, limits, and final resolved level.
• Existing 1.3.0 configurations remain compatible without changes.

Added

• Added level: PLAYER for MMOItems generated by add entries.
• Added level: PLAYER for MMOItems generated by replace.to entries.
• Added player-context tracking for lootable block containers.
• Added debug output showing the detected player and resolved player level.

Behavior

• level: PLAYER uses the RPG level currently exposed by MMOItems for the player that triggered the container loot generation.
• The player level is applied before unidentified conversion, so unidentified items preserve the generated level.
• If no player context can be resolved, the item falls back to MMOItems default generation.
• Existing fixed levels, random level ranges, and configurations without level remain compatible.

Add of level variation for MMOItems

Added

• Added explicit MMOItems item-level generation for add entries.
• Added MMOItems item-level generation for replace.to entries.
• Added fixed item levels with level: 25.
• Added random item-level ranges with level.min and level.max.
• Added validation for invalid, negative, non-integer, or reversed item-level ranges.

Behavior

• Item level is generated before unidentified conversion, so unidentified MMOItems preserve the generated level.
• Omitting level keeps the previous MMOItems default generation behavior.
• Existing 1.2.0 configurations remain compatible without changes.
• level is ignored for vanilla items and for matching-only entries such as remove and replace.from.

Added

• Added native MMOItems unidentified-item support for generated loot.
• Added unidentified-chance to MMOItems entries created by add
• Added unidentified-chance to MMOItems entries used in replace.to
• Added validation for unidentified chances outside the 0-100 range.
• Added compatibility aliases: unidentify-chance and unident-chance
• Added debug indication when an added or replacement MMOItem is generated unidentified.
  
  

Behavior

• unidentified-chance: 0.0 keeps the normal identified MMOItem.
• unidentified-chance: 100.0 always generates the MMOItem in its unidentified form.
• Omitting the option keeps the previous behavior, so existing configurations remain compatible.
• The plugin generates the MMOItem first, then passes its NBT through the MMOItems type unidentified template so the hidden MMOItems data is preserved for later identification.
• If unidentified generation fails, the plugin logs a warning and safely falls back to the identified item instead of deleting the reward.

GlobalStructureLoot Lite 1.1.1

This update focuses on compatibility with newer Paper versions and improves the project documentation.

Compatibility changes:

• Improved compatibility with newer Paper versions.
• Kept Paper 1.21.4 as the minimum API target for better forward compatibility.
• Kept Java 21 as the plugin compilation target.
• No NMS or CraftBukkit internals are used.
  
  

Documentation changes:
- Clarified how loot generation works.
- Updated information about compatibility with newer Minecraft/Paper versions.
- Clarified that GlobalStructureLoot modifies loot when the loot table is generated, not necessarily when the structure itself is generated.

Important behavior clarification:

A chest from an already-generated structure can still be affected by GlobalStructureLoot if its loot table has never been generated/opened before.

Once the chest loot has already been generated, GlobalStructureLoot will not modify it retroactively.

Notes:
- No configuration changes are required.
- Existing 1.1.0 configurations remain compatible.
- This update does not add new loot rule options.
- The same plugin JAR can be used on multiple supported Paper versions as long as the required API remains compatible.

This update adds a new filtering option: **per-rule dimension filters**.

You can now decide if a rule should only apply in the Overworld, Nether, End, or custom dimensions.

Added

•  Added `dimensions` filter for rules

• Added support for:
    - `NORMAL`
    - `NETHER`
    - `THE_END`
    - `CUSTOM`
•  Added aliases:
  - `OVERWORLD` as alias for `NORMAL`
  - `END` as alias for `THE_END`
• Added validation for invalid dimension values.
•  Added dimension information to debug logs.

Example

rules:
  nether_bonus:
    enabled: true

    loot-tables:
      - "minecraft:chests/*"

    biomes: []

    dimensions:
      - NETHER

    add:
      bonus_gold:
        material: GOLD_INGOT
        chance: 10.0
        amount:
          min: 1
          max: 3