# LibCats
\n<\/p>\n
### Short description
\nYou can make GUIs, Commands (+ subcommands), and YAML files other than config.yml easier with this plugin.
\nAlso you can get these Paper Registry things easier
\nYou can also listen to the next message the player is sending in case you wanna get an input from them<\/p>\n
### Build this yourself
\n“`shell
\ngit clone https:\/\/github.com\/JGJ52\/LibCats.git
\ncd LibCats
\n.\/gradlew build
\n“`<\/p>\n
### Include this in your project ### GUIs import java.util.List;<\/p>\n class YourGUI extends GUI { @Override @Override @Override \/\/ above this there were methods you NEED to override, or it won’t work @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override @Override public void voidd() { import java.util.List; class YourCommand extends Command { @Override @Override @Override \/\/ these 6 are the same as in GUI @Override @Override @Override @Override @Override @Override @Override @Override “`java import java.util.List;<\/p>\n class YourSubCommand extends SubCommand { @Override @Override @Override \/\/ this six again @Override @Override @Override @Override @Override @Override ### Configurations class YourConfiguration extends Configuration { @Override ### RegistryFromName class YourClass { ### Chat class YourClass { Library for my plugins (very professional)<\/p>\n","protected":false},"featured_media":93524,"template":"","meta":{"_minecraft_slug":"libcats","_minecraft_project_id":"lM9YJTQr","_minecraft_author":"jgj52","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":25,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"libcats.zip","_minecraft_size_bytes":78720,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:17:50.374001Z","_minecraft_date_created":"2026-03-30T20:21:58.212578Z","_minecraft_date_modified":"2026-04-01T18:54:22.262012Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/libcats","_minecraft_icon_attachment_id":93524,"_minecraft_imported_at":"2026-06-05T08:22:10+00:00","_minecraft_import_hash":"b24504a93837d259ac1d415fbd1f140c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-93523","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n“`xml
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories><\/p>\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n<\/dependencies>
\n“`<\/p>\n
\n“`java
\nimport hu.jgj52.libCats.Types.GUI;
\nimport net.kyori.adventure.text.Component;
\nimport org.bukkit.entity.Player;
\nimport org.bukkit.event.inventory.InventoryClickEvent;
\nimport org.bukkit.event.inventory.InventoryCloseEvent;
\nimport org.bukkit.event.inventory.InventoryDragEvent;
\nimport org.bukkit.event.player.PlayerDropItemEvent;
\nimport org.bukkit.event.player.PlayerInteractEvent;
\nimport org.bukkit.event.player.PlayerMoveEvent;
\nimport org.bukkit.inventory.Inventory;
\nimport org.bukkit.inventory.ItemStack;
\nimport org.bukkit.plugin.java.JavaPlugin;
\nimport org.jetbrains.annotations.NotNull;<\/p>\n
\n @Override
\n public void init(Player player) {
\n \/\/ when gui opens, this runs. set your items here
\n \/\/ you can set them by
\n gui.setItem(0, new ItemStack(Material.APPLE));
\n }<\/p>\n
\n public void onClick(InventoryClickEvent event) {
\n \/\/ this gets called when player clicks on inventory
\n }<\/p>\n
\n public int getSize() {
\n return 27; \/\/ size of the gui
\n }<\/p>\n
\n public JavaPlugin getPlugin() {
\n return YourPlugin.getInstance();
\n }<\/p>\n
\n \/\/ these are optional<\/p>\n
\n public @NotNull Inventory getInventory() {
\n return super.getInventory(); \/\/ this is the bukkit inventory implementation override thing.
\n \/\/ i don’t know how to call it.
\n \/\/ if you don’t know what this is, or what this is for, you can ignore this and not override it.
\n }<\/p>\n
\n public String getMessage(String msg) {
\n return super.getMessage(msg); \/\/ basically does
\n getPlugin().getConfig().getString(“guis.” + getClass().getSimpleName() \/* in this case YourGUI *\/ + “.” + msg);
\n \/\/ if you don’t want to retrieve messages from there you can override this
\n \/\/ if you are hardcoding every message you can ignore this
\n }<\/p>\n
\n public Component getComponent(String msg) {
\n return super.getComponent(msg);
\n \/\/ basically getMessage(msg) but this deserializes it with MiniMessage and makes it a component
\n \/\/ if you changed where getMessage gets messages from this changes too
\n }<\/p>\n
\n public Component getComponent(String msg, boolean notItalic) {
\n return super.getComponent(msg, notItalic); \/\/ this calls getComponent(msg) but if notItalic is true, puts on a decoration that says: its not italic
\n \/\/ useful for getting names from items
\n }<\/p>\n
\n public List
\n return super.getMessageList(msg); \/\/ same as getMessage but this gets a string list from config and not just a string. changing getMessage won’t change where this gets messages from
\n }<\/p>\n
\n public List
\n return super.getComponentList(msg); \/\/ same as getComponent but with getMessageList
\n }<\/p>\n
\n public List
\n return super.getComponentList(msg, notItalic); \/\/ same again but list
\n }<\/p>\n
\n public String getMsg(String msg) {
\n return super.getMsg(msg); \/\/ this gets it from
\n getPlugin().getConfig().get(“messages.” + msg);
\n \/\/ but same getMessage
\n }<\/p>\n
\n public Component getComp(String msg) {
\n return super.getComp(msg); \/\/ same as getComponent but uses getMsg
\n }<\/p>\n
\n public Component getComp(String msg, boolean notItalic) {
\n return super.getComp(msg, notItalic); \/\/ same again
\n }<\/p>\n
\n public List
\n return super.getMsgList(msg); \/\/ same
\n }<\/p>\n
\n public List
\n return super.getCompList(msg); \/\/ same
\n }<\/p>\n
\n public List
\n return super.getCompList(msg, notItalic); \/\/ same
\n }<\/p>\n
\n public boolean defaultInit() {
\n return super.defaultInit(); \/\/ puts black glass pane on the sides and gray glass pane elsewhere when true. true by default
\n }<\/p>\n
\n public void firstInit(Player player) {
\n super.firstInit(player); \/\/ this only runs when the first init() runs
\n }<\/p>\n
\n public void onBottomClick(InventoryClickEvent event) {
\n \/\/ same as onClick but now player clicked its inventory instead of the gui
\n }<\/p>\n
\n public void onClose(InventoryCloseEvent event) {
\n \/\/ when the gui gets closed
\n }<\/p>\n
\n public void onDrop(PlayerDropItemEvent event) {
\n \/\/ when player drops something while in the gui
\n }<\/p>\n
\n public void onMove(PlayerMoveEvent event) {
\n \/\/ when player moves while in the gui
\n }<\/p>\n
\n public void onInteract(PlayerInteractEvent event) {
\n \/\/ when player left\/right clicks to a block for example while the gui is open
\n }<\/p>\n
\n public void onDrag(InventoryDragEvent event) {
\n \/\/ when player drags something
\n \/\/ similar to onClick but not the same
\n }<\/p>\n
\n public void onBottomDrag(InventoryDragEvent event) {
\n \/\/ same as onBottomClick but onDrag
\n }<\/p>\n
\n public Component getName() {
\n return super.getName(); \/\/ by default getComponent(“name”);
\n }<\/p>\n
\n \/\/ you can open this using
\n new YourGUI().open(player);
\n }
\n}
\n“`
\n### Commands
\n“`java
\nimport hu.jgj52.libCats.Types.Command;
\nimport hu.jgj52.libCats.Types.SubCommand;
\nimport net.kyori.adventure.text.Component;
\nimport org.bukkit.command.CommandSender;
\nimport org.bukkit.entity.Player;
\nimport org.bukkit.plugin.java.JavaPlugin;
\nimport org.jetbrains.annotations.NotNull;
\nimport org.jetbrains.annotations.Nullable;<\/p>\n
\nimport java.util.function.Consumer;<\/p>\n
\n \/\/ im gonna assume your already read GUI
\n @Override
\n public JavaPlugin getPlugin() {
\n return YourPlugin.getInstance();
\n }<\/p>\n
\n public String getName() {
\n return “myCommand”; \/\/ your gonna use \/myCommand for this one in-game
\n }<\/p>\n
\n public List
\n return List.of(
\n new YourSubCommand()
\n );
\n }<\/p>\n
\n public Consumer
\n return sender -> {
\n \/\/ if set, they cant run this command if they’re not a player, and this gets run when they try to
\n \/\/ you can send them “hi you need to be a player to run this” here
\n };
\n }<\/p>\n
\n @Override
\n public String getMsg(String msg) {
\n return super.getMsg(msg);
\n }<\/p>\n
\n public List
\n return super.getCompList(msg, notItalic);
\n }<\/p>\n
\n public List
\n return super.getCompList(msg);
\n }<\/p>\n
\n public List
\n return super.getMsgList(msg);
\n }<\/p>\n
\n public Component getComp(String msg, boolean notItalic) {
\n return super.getComp(msg, notItalic);
\n }<\/p>\n
\n public Component getComp(String msg) {
\n return super.getComp(msg);
\n }<\/p>\n
\n public String getPermission() {
\n \/\/ the permission required to run this command
\n \/\/ by default its
\n return getPlugin().getName().toLowerCase() + “.command.” + getName();
\n }<\/p>\n
\n public Consumer
\n return sender -> {
\n \/\/ if set, they cant run the command without having the permission in getPermission, and if they try to
\n \/\/ then this code gets run
\n };
\n }<\/p>\n
\n public boolean execute(@NotNull CommandSender sender, org.bukkit.command.@NotNull Command command, @NotNull String s, @NotNull String @NotNull [] args, @Nullable Player player) {
\n \/\/ when they run the command without args this gets run.
\n \/\/ if you set notPlayer(), then player isn’t null
\n \/\/ you must override this
\n return true;
\n }
\n}
\n“`<\/p>\n
\nimport hu.jgj52.libCats.Types.SubCommand;
\nimport net.kyori.adventure.text.Component;
\nimport org.bukkit.command.Command;
\nimport org.bukkit.command.CommandSender;
\nimport org.bukkit.entity.Player;
\nimport org.bukkit.plugin.java.JavaPlugin;
\nimport org.jetbrains.annotations.NotNull;
\nimport org.jetbrains.annotations.Nullable;<\/p>\n
\n @Override
\n public String getName() {
\n return “hello”; \/\/ with the previous command, this becomes \/myCommand hello
\n }<\/p>\n
\n public boolean execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String s, @NotNull String @NotNull [] args, @Nullable Player player) {
\n \/\/ when “\/myCommand hello” gets run this runs also
\n \/\/ if its “\/myCommand hello otherArg” this gets run too and otherArg is args[1]
\n return true;
\n }<\/p>\n
\n public List
\n return List.of(); \/\/ “\/myCommand hello
\n }<\/p>\n
\n public boolean firstComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String s, @NotNull String @NotNull [] args) {
\n \/\/ should you be able to tab it from \/myCommand
\n \/\/ also if false nobody can run the subcommand
\n return true;
\n }<\/p>\n
\n @Override
\n public List
\n return super.getCompList(msg, notItalic);
\n }<\/p>\n
\n public List
\n return super.getCompList(msg);
\n }<\/p>\n
\n public List
\n return super.getMsgList(msg);
\n }<\/p>\n
\n public Component getComp(String msg, boolean notItalic) {
\n return super.getComp(msg, notItalic);
\n }<\/p>\n
\n public Component getComp(String msg) {
\n return super.getComp(msg);
\n }<\/p>\n
\n public String getMsg(String msg) {
\n return super.getMsg(msg);
\n }<\/p>\n
\n public JavaPlugin getPlugin() {
\n return YourPlugin.getInstance();
\n }
\n}
\n“`<\/p>\n
\n“`java
\nimport hu.jgj52.libCats.Types.Configuration;
\nimport org.bukkit.plugin.java.JavaPlugin;<\/p>\n
\n @Override
\n public JavaPlugin getPlugin() {
\n return YourPlugin.getInstance();
\n }<\/p>\n
\n public String getName() {
\n return “messages”; \/\/ the name of the yml
\n }
\n}
\n“`<\/p>\n
\n“`java
\nimport hu.jgj52.libCats.Utils.RegistryFromName;
\nimport org.bukkit.enchantments.Enchantment;<\/p>\n
\n public void run() {
\n Enchantment sharpness = RegistryFromName.ENCHANTMENT(“sharpness”);
\n List
\n }
\n}
\n“`<\/p>\n
\n“`java
\nimport hu.jgj52.libCats.Listeners.ChatListener;<\/p>\n
\n public void run() {
\n \/\/ when any value is good
\n ChatListener.add(player, message -> {
\n \/\/ print it
\n System.out.println(message);
\n \/\/ send it back for fun
\n player.sendMessage(message);
\n });
\n \/\/ when you wait for a specific value
\n \/\/ for example “done”
\n ChatListener.add(player, “done”, message -> {
\n System.out.println(player.getName() + ” said done!”);
\n });
\n }
\n}
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"