Open
Description
Material javadoc isn't really user friendly, including the fact that it still has legacy materials which confuses new people
This would be a good addition to https://docs.papermc.io/paper/cat/admin/reference
The general idea is to make an alternative solution which is more user friendly than something made as a code documentation
My idea on how this could be done is a table
- The table has a mode at the top where the user can select between "all materials", "items" and "blocks". The selection should reflect in the link so it could be easily shareable, should be useful for plugin developers to share in documentation for users with a preselected link. This is to prevent people from accidentally putting POTATOES instead of POTATO in a list of items in configs
- The ability to filter materials based on vanilla tags
- Columns which aren't appropriate with the mode are hidden (like item meta for block mode)
- It would be good to have those columns
- Material name, as in https://jd.papermc.io/paper/1.20/org/bukkit/Material.html
- Namespaced name, from https://jd.papermc.io/paper/1.20/org/bukkit/Registry.html#MATERIAL (and how are they in nms registry and in any vanilla command)
- BlockData class
- BlockState class
- ItemMeta class
- Translatable key
- List of tags this material is part of
Of course this is just a suggestion and anything would be better than java docs