Improve metadata / PDC usage

[BlitzOffline]

This PR improves the current PDC usage and adds new commands for handling use metadata.

For DeluxeMenus users:

Added:

• Commands for handling metadata (with support for placeholders):
  • show: Gets the stored value at the specified key as long as it matches the specified type
  • list: List all key-value pairs of a specified type
  • set: Set a value of specified type at the specified key (if a value exists at the given key, it will override it only if the type matches)
  • remove: Remove a value of specified type from the specified key (as long as existent value matches the given type)
  • add: Used for addition on number types (If no value exists at the given key yet, the addition will be done on a 0 value)
  • subtract: Used for subtraction on number types (If no value exists at the given key yet, the subtraction will be done on a 0 value)
  • switch: Used for switching boolean values. Since BOOLEAN type is just an alias for String, it will also work for String types as long as the values are true or false (case insensitive)
• Placeholders list (They will show in /papi info deluxemenus)

Changed:

• The %deluxemenus_meta_has_value_<key>_[type]% placeholder no longer requires a type to be specified. If no type is specified, all supported types will be checked.
• The help command has 2 variants now: OP and ADMIN. OP variant displays all DM commands, ADMIN variant displays only the commands that do not require OP.

For DeluxeMenus developers:

• Overhauled the entire PMH API:
  • Added separate methods for every available action: switch, add, remove, etc.
  • Added a new OperationResult enum to better relay PMH results.
  • Added a DataType layer above PDTs for ease of use (especially when it comes to BOOLEANS which are fancy STRINGS)
• Added some pagination utils (used in the /dm list and /dm meta list commands)

Closes #134

The merge-base changed after approval.

[NoltoxGit]

Hello !
Do you have a ETA for when this PR will be merged/stable, so I can use it on my server? 👀

[BlitzOffline]

Hello ! Do you have a ETA for when this PR will be merged/stable, so I can use it on my server? 👀

I have tested about 90% of the changes. I still have to test the meta placeholders and make sure they work properly and then we should be good to go. I'm not sure when I'll have time to do that.

[BlitzOffline]

This PR is ready for code review. Tested on Paper version 1.21.4-164-main@8eb8e44.

@NoltoxGit if you want to give this build a try before it is merged, you can use the following file (unzip it first):
DeluxeMenus-1.14.1-DEV-local-build.jar.zip

[NoltoxGit]

This PR is ready for code review. Tested on Paper version 1.21.4-164-main@8eb8e44.

@NoltoxGit if you want to give this build a try before it is merged, you can use the following file (unzip it first): DeluxeMenus-1.14.1-DEV-local-build.jar.zip

Hi,
I'll try this, thank you so much! <3

[NoltoxGit]

This PR is ready for code review. Tested on Paper version 1.21.4-164-main@8eb8e44.

@NoltoxGit if you want to give this build a try before it is merged, you can use the following file (unzip it first): DeluxeMenus-1.14.1-DEV-local-build.jar.zip

I've just tested the version, it's look work great! And have a suggestion:

• Would it be possible to make the /dmenu meta <player> list directly display all the meta assigned to it without having to specify the parameter?

[BlitzOffline]

It is possible to add such a command, but, unfortunately, due to how we store values, it would be buggy when determining what type a value is. This is the reason I did not add it in the first place.