INSTALLATION
1. Put the plugin .jar in your server plugins folder.
2. Restart your server.
3. Edit the config file:

plugins/GlobalStructureLootLite/config.yml

4. Reload and validate the config:

/gsl reload

BASIC CONFIG EXAMPLE

settings:
debug: false
stop-after-first-matching-rule: false
max-added-items-per-chest: 5

worlds:
whitelist: []
blacklist: []

rules:
example_rule:
enabled: true

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

biomes: []

add:
bonus_diamond:
material: DIAMOND
chance: 5.0
amount:
min: 1
max: 2

LOOT TABLE FILTERS

Use loot-tables to choose which loot tables are affected.

Example:

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

Wildcard example:

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

This matches all vanilla chest loot tables.


BIOME FILTERS

Use biomes to restrict a rule to specific biomes.

Example:

biomes:
- "minecraft:desert"

Empty list means every biome is allowed:

biomes: []


WORLD FILTERS

You can choose which worlds the plugin can affect.

settings:
worlds:
whitelist:
- world
- world_nether
blacklist:
- resource_world
Blacklist has priority over whitelist.
Correct YAML list format:
blacklist:
- world_the_end
Incorrect:
blacklist:
-world_the_end
There must be a space after the dash.
ADD ITEMS
The Lite version only supports adding vanilla Minecraft items.
Example:
add:
bonus_gold:
material: GOLD_INGOT
chance: 20.0
amount:
min: 2
max: 8
CHANCE
Chance values are percentages:
100.0 = always
50.0 = 50% chance
5.0 = 5% chance
0.0 = never
AMOUNT
Amount controls the stack size of the added item.
amount:
min: 1
max: 3
If min and max are different, a random value between them will be used.
DEBUG MODE
Enable debug mode in the config:
settings:
debug: true
Then run:
/gsl reload
Debug mode logs useful information in the console, such as generated loot table, biome, world, matched rule, and added items.
CONFIG VALIDATION
Use:
/gsl validate
This checks common config mistakes, such as invalid vanilla materials, invalid chance values, invalid amount values, invalid YAML sections, invalid world lists, and invalid filter formats.
The reload command also validates the config automatically:
/gsl reload