Fix light_level being overwritten for LIGHT item.

[BlitzOffline]

Fix light_level being overwritten.

Closes #197

Tested with: Paper version 1.21.4-230-ver/1.21.4@af71568 (2025-05-11T20:55:55Z) (Implementing API version 1.21.4-R0.1-SNAPSHOT)
Tested ITEM_FLAGS to make sure they still apply as well.

[NoltoxGit]

Hey,
What is lore_append_mode? 👀

[BlitzOffline]

Hey, What is lore_append_mode? 👀

It is an option that has 4 values: OVERRIDE, BOTTOM, TOP, IGNORE. It can be used in combination with the lore option and item hooks such as MMOItems.

The item hooks sometimes return custom lore as well, not just materials and model data. So based on the lore append mode value, the following will happen:

OVERRIDE - it will replace the lore returned by the item hook with the one specified in lore.
BOTTOM - it will append the lore specified in lore at the bottom of the one returned by the item hook.
TOP - it will append the lore specified in lore above the one returned by the item hook.
IGNORE - it will ignore the lore specified in lore and only use the one returned by the item hook.

Default value is OVERRIDE.

[NoltoxGit]

Hey, What is lore_append_mode? 👀

It is an option that has 4 values: OVERRIDE, BOTTOM, TOP, IGNORE. It can be used in combination with the lore option and item hooks such as MMOItems.

The item hooks sometimes return custom lore as well, not just materials and model data. So based on the lore append mode value, the following will happen:

OVERRIDE - it will replace the lore returned by the item hook with the one specified in lore. BOTTOM - it will append the lore specified in lore at the bottom of the one returned by the item hook. TOP - it will append the lore specified in lore above the one returned by the item hook. IGNORE - it will ignore the lore specified in lore and only use the one returned by the item hook.

Default value is OVERRIDE.

Is this available in the latest devbuild (#200)?

[BlitzOffline]

Yes. It is available since one of the 18X builds I think.

[NoltoxGit]

Yes. It is available since one of the 18X builds I think.

Perfect!
Because I'd never seen that in the documentation, that's why! x)

[BlitzOffline]

Yeah. We are not very consistent with our documentation. A few features from the dev builds are documented but most are not and a few other are even wrong.

We usually get the documentation up to date before a Spigot release.