Implemented click handler logic#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Touchie771 merged 1 commit into from
Nov 23, 2025
Merged

Implemented click handler logic #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
154 changes: 154 additions & 0 deletions src/main/java/me/touchie771/minecraftGUI/api/ClickHandler.java
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
package me.touchie771.minecraftGUI.api;

import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;

import java.util.Arrays;
import java.util.EnumSet;
import java.util.function.Consumer;

/**
* Handles click events for menu slots with filtering and cancellation options.
*
* <p>This class provides a way to register callbacks for inventory clicks with
* fine-grained control over which click types are handled and whether the event
* should be automatically cancelled.</p>
*
* <p>Example usage:
* <pre>{@code
* ClickHandler handler = ClickHandler.newBuilder()
* .callback(event -> {
* Player player = (Player) event.getWhoClicked();
* player.sendMessage("You clicked the item!");
* })
* .filter(ClickType.LEFT, ClickType.RIGHT)
* .autoCancel(true)
* .build();
* }</pre></p>
*/
public class ClickHandler {

private final Consumer<InventoryClickEvent> callback;
private final EnumSet<ClickType> allowedClickTypes;
private final boolean autoCancel;

/**
* Creates a new ClickHandler with the specified configuration.
* This constructor is package-private and should only be called by ClickHandlerBuilder.
*
* @param builder the configured builder containing handler properties
* @throws IllegalArgumentException if builder or callback is null
*/
ClickHandler(@NotNull ClickHandlerBuilder builder) {
if (builder.callback == null) {
throw new IllegalArgumentException("Callback cannot be null");
}
this.callback = builder.callback;
this.allowedClickTypes = builder.allowedClickTypes != null ?
EnumSet.copyOf(builder.allowedClickTypes) : EnumSet.allOf(ClickType.class);
this.autoCancel = builder.autoCancel;
}

/**
* Handles the given inventory click event if it matches the configured filters.
*
* @param event the inventory click event to handle
*/
public void handleClick(@NotNull InventoryClickEvent event) {

// Check if the click type is allowed
if (!allowedClickTypes.contains(event.getClick())) {
return;
}

// Auto-cancel if configured
if (autoCancel) {
event.setCancelled(true);
}

// Execute the callback
try {
callback.accept(event);
} catch (Exception e) {
// Log the exception but don't rethrow to avoid breaking other handlers
System.err.println("Error in ClickHandler callback: " + e.getMessage());
}

}

/**
* Creates a new ClickHandlerBuilder instance for constructing click handlers.
* This is the recommended way to create new ClickHandler instances.
*
* @return a new ClickHandlerBuilder ready for configuration
*/
@Contract(" -> new")
public static @NotNull ClickHandlerBuilder newBuilder() {
return new ClickHandlerBuilder();
}

/**
* Builder class for creating ClickHandler instances with a fluent API.
*
* <p>This builder allows you to configure all aspects of a click handler before creation:
* the callback function, allowed click types, and auto-cancellation behavior.</p>
*/
public static class ClickHandlerBuilder {

private Consumer<InventoryClickEvent> callback;
private EnumSet<ClickType> allowedClickTypes;
private boolean autoCancel = true;

/**
* Sets the callback function to execute when a click event is handled.
*
* @param callback the consumer that will receive the click event
* @return this builder instance for method chaining
* @throws IllegalArgumentException if callback is null
*/
public ClickHandlerBuilder callback(@NotNull Consumer<InventoryClickEvent> callback) {
this.callback = callback;
return this;
}

/**
* Sets which click types should be handled.
* If not specified, all click types will be handled.
*
* @param clickTypes the click types to handle
* @return this builder instance for method chaining
*/
public ClickHandlerBuilder filter(@NotNull ClickType... clickTypes) {
if (clickTypes == null || clickTypes.length == 0) {
this.allowedClickTypes = EnumSet.allOf(ClickType.class);
} else {
this.allowedClickTypes = EnumSet.copyOf(Arrays.asList(clickTypes));
}
return this;
}

/**
* Sets whether the event should be automatically cancelled before executing the callback.
* Default is true.
*
* @param autoCancel true to auto-cancel events, false otherwise
* @return this builder instance for method chaining
*/
public ClickHandlerBuilder autoCancel(boolean autoCancel) {
this.autoCancel = autoCancel;
return this;
}

/**
* Builds and returns a new ClickHandler instance with the configured properties.
*
* @return a new ClickHandler instance
* @throws IllegalArgumentException if callback is not set
*/
public ClickHandler build() {
return new ClickHandler(this);
}
}
}
134 changes: 123 additions & 11 deletions src/main/java/me/touchie771/minecraftGUI/api/Menu.java
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,14 +2,20 @@

import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;

/**
* Represents a Minecraft GUI menu that can be displayed to players.
Expand All@@ -32,6 +38,7 @@ public class Menu {

private final Inventory menu;
private final HashSet<SlotItem> items;
private final MenuClickHandler clickHandler;

/**
* Creates a new menu from the specified builder.
Expand All@@ -40,15 +47,29 @@ public class Menu {
* @param builder the configured builder containing menu properties
* @throws IllegalArgumentException if builder is null
*/
public Menu(@NotNull MenuBuilder builder) {
public Menu(@NotNull MenuBuilder builder, @NotNull Plugin plugin) {
this.menu = Bukkit.createInventory(null, builder.inventorySize, builder.inventoryTitle);
this.items = new HashSet<>(builder.items);
this.clickHandler = new MenuClickHandler(this.menu, plugin.getLogger());

// Copy click handlers from builder
for (Map.Entry<Integer, ClickHandler> entry : builder.clickHandlers.entrySet()) {
this.clickHandler.setClickHandler(entry.getKey(), entry.getValue());
}

// Set close handler from builder
if (builder.closeHandler != null) {
this.clickHandler.setCloseHandler(builder.closeHandler);
}

for (SlotItem item : items) {
ItemStack itemStack = new ItemStack(item.material(), item.quantity());
itemStack.editMeta(meta -> meta.displayName(item.itemName()));
menu.setItem(item.itemSlot(), itemStack);
}

// Register event handlers
registerEvents(plugin);
}

/**
Expand DownExpand Up@@ -126,17 +147,69 @@ public HashSet<SlotItem> getItems() {
}

/**
* Returns the SlotItem at the specified slot position.
* This is useful for handling inventory click events.
* Registers a click handler for the specified slot.
*
* @param slot the slot position to check (0-53 for chest inventories)
* @return the SlotItem at the specified slot, or null if the slot is empty
* @param slot the slot position (0-53 for chest inventories)
* @param handler the click handler to register
* @throws IllegalArgumentException if slot is invalid or handler is null
*/
public void onClick(int slot, @NotNull ClickHandler handler) {
if (slot < 0 || slot > 53) {
throw new IllegalArgumentException("Slot must be between 0 and 53");
}
clickHandler.setClickHandler(slot, handler);
}

/**
* Removes the click handler for the specified slot.
*
* @param slot the slot position to remove the handler from
*/
public void removeClickHandler(int slot) {
clickHandler.removeClickHandler(slot);
}

/**
* Gets the click handler for the specified slot.
*
* @param slot the slot position
* @return the ClickHandler for the slot, or null if none is registered
*/
public @Nullable ClickHandler getClickHandler(int slot) {
return clickHandler.getClickHandler(slot);
}

/**
* Sets a handler that will be called when the inventory is closed.
*
* @param closeHandler the consumer that will receive the close event
*/
public void onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
clickHandler.setCloseHandler(closeHandler);
}

/**
* Removes the close handler.
*/
public void removeCloseHandler() {
clickHandler.removeCloseHandler();
}

/**
* Registers this menu's event handlers with Bukkit.
* This method is called automatically in the constructor.
*/
private void registerEvents(Plugin plugin) {
Bukkit.getPluginManager().registerEvents(clickHandler, plugin);
}

/**
* Unregisters this menu's event handlers.
* This method is automatically called when the inventory is closed to prevent memory leaks.
* You only need to call this manually if you want to unregister events before closing the menu.
*/
public SlotItem getItemAt(int slot) {
return this.items.stream()
.filter(item -> item.itemSlot() == slot)
.findFirst()
.orElse(null);
public void unregisterEvents() {
clickHandler.unregister();
}

/**
Expand DownExpand Up@@ -171,6 +244,14 @@ public static class MenuBuilder {
private int inventorySize;
private Component inventoryTitle;
private final HashSet<SlotItem> items = new HashSet<>();
private final Map<Integer, ClickHandler> clickHandlers = new HashMap<>();
private Consumer<InventoryCloseEvent> closeHandler;
private Plugin plugin;

public MenuBuilder plugin(@NotNull Plugin plugin) {
this.plugin = plugin;
return this;
}

/**
* Sets the size of the inventory.
Expand DownExpand Up@@ -244,7 +325,38 @@ public Menu build() {
if (inventoryTitle == null) {
throw new IllegalArgumentException("Inventory title cannot be null");
}
return new Menu(this);
if (plugin == null) {
throw new IllegalArgumentException("Plugin cannot be null");
}
return new Menu(this, plugin);
}

/**
* Registers a click handler for the specified slot.
*
* @param slot the slot position (0-53 for chest inventories)
* @param handler the click handler to register
* @return this builder instance for method chaining
* @throws IllegalArgumentException if slot is invalid or handler is null
*/
public MenuBuilder onClick(int slot, @NotNull ClickHandler handler) {
if (slot < 0 || slot > 53) {
throw new IllegalArgumentException("Slot must be between 0 and 53");
}
clickHandlers.put(slot, handler);
return this;
}

/**
* Sets a handler that will be called when the inventory is closed.
*
* @param closeHandler the consumer that will receive the close event
* @return this builder instance for method chaining
* @throws IllegalArgumentException if closeHandler is null
*/
public MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
this.closeHandler = closeHandler;
return this;
}
}
}
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
Implemented click handler logic#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

Touchie771
merged 1 commit into

from

Nov 23, 2025
 Merged


Implemented click handler logic
#2
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


154 changes: 154 additions & 0 deletions
src/main/java/me/touchie771/minecraftGUI/api/ClickHandler.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
package me.touchie771.minecraftGUI.api;

import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;

import java.util.Arrays;
import java.util.EnumSet;
import java.util.function.Consumer;

/**
 * Handles click events for menu slots with filtering and cancellation options.
 * 
 * <p>This class provides a way to register callbacks for inventory clicks with
 * fine-grained control over which click types are handled and whether the event
 * should be automatically cancelled.</p>
 * 
 * <p>Example usage:
 * <pre>{@code
 * ClickHandler handler = ClickHandler.newBuilder()
 * .callback(event -> {
 * Player player = (Player) event.getWhoClicked();
 * player.sendMessage("You clicked the item!");
 * })
 * .filter(ClickType.LEFT, ClickType.RIGHT)
 * .autoCancel(true)
 * .build();
 * }</pre></p>
 */
public class ClickHandler {

 private final Consumer<InventoryClickEvent> callback;
 private final EnumSet<ClickType> allowedClickTypes;
 private final boolean autoCancel;

 /**
 * Creates a new ClickHandler with the specified configuration.
 * This constructor is package-private and should only be called by ClickHandlerBuilder.
 * 
 * @param builder the configured builder containing handler properties
 * @throws IllegalArgumentException if builder or callback is null
 */
 ClickHandler(@NotNull ClickHandlerBuilder builder) {
 if (builder.callback == null) {
 throw new IllegalArgumentException("Callback cannot be null");
 }
 this.callback = builder.callback;
 this.allowedClickTypes = builder.allowedClickTypes != null ? 
 EnumSet.copyOf(builder.allowedClickTypes) : EnumSet.allOf(ClickType.class);
 this.autoCancel = builder.autoCancel;
 }

 /**
 * Handles the given inventory click event if it matches the configured filters.
 *
 * @param event the inventory click event to handle
 */
 public void handleClick(@NotNull InventoryClickEvent event) {

 // Check if the click type is allowed
 if (!allowedClickTypes.contains(event.getClick())) {
 return;
 }

 // Auto-cancel if configured
 if (autoCancel) {
 event.setCancelled(true);
 }

 // Execute the callback
 try {
 callback.accept(event);
 } catch (Exception e) {
 // Log the exception but don't rethrow to avoid breaking other handlers
 System.err.println("Error in ClickHandler callback: " + e.getMessage());
 }

 }

 /**
 * Creates a new ClickHandlerBuilder instance for constructing click handlers.
 * This is the recommended way to create new ClickHandler instances.
 * 
 * @return a new ClickHandlerBuilder ready for configuration
 */
 @Contract(" -> new")
 public static @NotNull ClickHandlerBuilder newBuilder() {
 return new ClickHandlerBuilder();
 }

 /**
 * Builder class for creating ClickHandler instances with a fluent API.
 * 
 * <p>This builder allows you to configure all aspects of a click handler before creation:
 * the callback function, allowed click types, and auto-cancellation behavior.</p>
 */
 public static class ClickHandlerBuilder {

 private Consumer<InventoryClickEvent> callback;
 private EnumSet<ClickType> allowedClickTypes;
 private boolean autoCancel = true;

 /**
 * Sets the callback function to execute when a click event is handled.
 * 
 * @param callback the consumer that will receive the click event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if callback is null
 */
 public ClickHandlerBuilder callback(@NotNull Consumer<InventoryClickEvent> callback) {
 this.callback = callback;
 return this;
 }

 /**
 * Sets which click types should be handled.
 * If not specified, all click types will be handled.
 * 
 * @param clickTypes the click types to handle
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder filter(@NotNull ClickType... clickTypes) {
 if (clickTypes == null || clickTypes.length == 0) {
 this.allowedClickTypes = EnumSet.allOf(ClickType.class);
 } else {
 this.allowedClickTypes = EnumSet.copyOf(Arrays.asList(clickTypes));
 }
 return this;
 }

 /**
 * Sets whether the event should be automatically cancelled before executing the callback.
 * Default is true.
 * 
 * @param autoCancel true to auto-cancel events, false otherwise
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder autoCancel(boolean autoCancel) {
 this.autoCancel = autoCancel;
 return this;
 }

 /**
 * Builds and returns a new ClickHandler instance with the configured properties.
 * 
 * @return a new ClickHandler instance
 * @throws IllegalArgumentException if callback is not set
 */
 public ClickHandler build() {
 return new ClickHandler(this);
 }
 }
}

134 changes: 123 additions & 11 deletions
src/main/java/me/touchie771/minecraftGUI/api/Menu.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,14 +2,20 @@

import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;

/**
 * Represents a Minecraft GUI menu that can be displayed to players.
Expand All@@ -32,6 +38,7 @@ public class Menu {

 private final Inventory menu;
 private final HashSet<SlotItem> items;
 private final MenuClickHandler clickHandler;

 /**
 * Creates a new menu from the specified builder.
Expand All@@ -40,15 +47,29 @@ public class Menu {
 * @param builder the configured builder containing menu properties
 * @throws IllegalArgumentException if builder is null
 */
 public Menu(@NotNull MenuBuilder builder) {
 public Menu(@NotNull MenuBuilder builder, @NotNull Plugin plugin) {
 this.menu = Bukkit.createInventory(null, builder.inventorySize, builder.inventoryTitle);
 this.items = new HashSet<>(builder.items);
 this.clickHandler = new MenuClickHandler(this.menu, plugin.getLogger());

 // Copy click handlers from builder
 for (Map.Entry<Integer, ClickHandler> entry : builder.clickHandlers.entrySet()) {
 this.clickHandler.setClickHandler(entry.getKey(), entry.getValue());
 }

 // Set close handler from builder
 if (builder.closeHandler != null) {
 this.clickHandler.setCloseHandler(builder.closeHandler);
 }

 for (SlotItem item : items) {
 ItemStack itemStack = new ItemStack(item.material(), item.quantity());
 itemStack.editMeta(meta -> meta.displayName(item.itemName()));
 menu.setItem(item.itemSlot(), itemStack);
 }

 // Register event handlers
 registerEvents(plugin);
 }

 /**
Expand DownExpand Up@@ -126,17 +147,69 @@ public HashSet<SlotItem> getItems() {
 }

 /**
 * Returns the SlotItem at the specified slot position.
 * This is useful for handling inventory click events.
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position to check (0-53 for chest inventories)
 * @return the SlotItem at the specified slot, or null if the slot is empty
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public void onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandler.setClickHandler(slot, handler);
 }

 /**
 * Removes the click handler for the specified slot.
 * 
 * @param slot the slot position to remove the handler from
 */
 public void removeClickHandler(int slot) {
 clickHandler.removeClickHandler(slot);
 }

 /**
 * Gets the click handler for the specified slot.
 * 
 * @param slot the slot position
 * @return the ClickHandler for the slot, or null if none is registered
 */
 public @Nullable ClickHandler getClickHandler(int slot) {
 return clickHandler.getClickHandler(slot);
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 */
 public void onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 clickHandler.setCloseHandler(closeHandler);
 }

 /**
 * Removes the close handler.
 */
 public void removeCloseHandler() {
 clickHandler.removeCloseHandler();
 }

 /**
 * Registers this menu's event handlers with Bukkit.
 * This method is called automatically in the constructor.
 */
 private void registerEvents(Plugin plugin) {
 Bukkit.getPluginManager().registerEvents(clickHandler, plugin);
 }

 /**
 * Unregisters this menu's event handlers.
 * This method is automatically called when the inventory is closed to prevent memory leaks.
 * You only need to call this manually if you want to unregister events before closing the menu.
 */
 public SlotItem getItemAt(int slot) {
 return this.items.stream()
 .filter(item -> item.itemSlot() == slot)
 .findFirst()
 .orElse(null);
 public void unregisterEvents() {
 clickHandler.unregister();
 }

 /**
Expand DownExpand Up@@ -171,6 +244,14 @@ public static class MenuBuilder {
 private int inventorySize;
 private Component inventoryTitle;
 private final HashSet<SlotItem> items = new HashSet<>();
 private final Map<Integer, ClickHandler> clickHandlers = new HashMap<>();
 private Consumer<InventoryCloseEvent> closeHandler;
 private Plugin plugin;

 public MenuBuilder plugin(@NotNull Plugin plugin) {
 this.plugin = plugin;
 return this;
 }

 /**
 * Sets the size of the inventory.
Expand DownExpand Up@@ -244,7 +325,38 @@ public Menu build() {
 if (inventoryTitle == null) {
 throw new IllegalArgumentException("Inventory title cannot be null");
 }
 return new Menu(this);
 if (plugin == null) {
 throw new IllegalArgumentException("Plugin cannot be null");
 }
 return new Menu(this, plugin);
 }

 /**
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public MenuBuilder onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandlers.put(slot, handler);
 return this;
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if closeHandler is null
 */
 public MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 this.closeHandler = closeHandler;
 return this;
 }
 }
}
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Implemented click handler logic#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

Touchie771
merged 1 commit into

from

Nov 23, 2025
 Merged


Implemented click handler logic
#2
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


154 changes: 154 additions & 0 deletions
src/main/java/me/touchie771/minecraftGUI/api/ClickHandler.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
package me.touchie771.minecraftGUI.api;

import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;

import java.util.Arrays;
import java.util.EnumSet;
import java.util.function.Consumer;

/**
 * Handles click events for menu slots with filtering and cancellation options.
 * 
 * <p>This class provides a way to register callbacks for inventory clicks with
 * fine-grained control over which click types are handled and whether the event
 * should be automatically cancelled.</p>
 * 
 * <p>Example usage:
 * <pre>{@code
 * ClickHandler handler = ClickHandler.newBuilder()
 * .callback(event -> {
 * Player player = (Player) event.getWhoClicked();
 * player.sendMessage("You clicked the item!");
 * })
 * .filter(ClickType.LEFT, ClickType.RIGHT)
 * .autoCancel(true)
 * .build();
 * }</pre></p>
 */
public class ClickHandler {

 private final Consumer<InventoryClickEvent> callback;
 private final EnumSet<ClickType> allowedClickTypes;
 private final boolean autoCancel;

 /**
 * Creates a new ClickHandler with the specified configuration.
 * This constructor is package-private and should only be called by ClickHandlerBuilder.
 * 
 * @param builder the configured builder containing handler properties
 * @throws IllegalArgumentException if builder or callback is null
 */
 ClickHandler(@NotNull ClickHandlerBuilder builder) {
 if (builder.callback == null) {
 throw new IllegalArgumentException("Callback cannot be null");
 }
 this.callback = builder.callback;
 this.allowedClickTypes = builder.allowedClickTypes != null ? 
 EnumSet.copyOf(builder.allowedClickTypes) : EnumSet.allOf(ClickType.class);
 this.autoCancel = builder.autoCancel;
 }

 /**
 * Handles the given inventory click event if it matches the configured filters.
 *
 * @param event the inventory click event to handle
 */
 public void handleClick(@NotNull InventoryClickEvent event) {

 // Check if the click type is allowed
 if (!allowedClickTypes.contains(event.getClick())) {
 return;
 }

 // Auto-cancel if configured
 if (autoCancel) {
 event.setCancelled(true);
 }

 // Execute the callback
 try {
 callback.accept(event);
 } catch (Exception e) {
 // Log the exception but don't rethrow to avoid breaking other handlers
 System.err.println("Error in ClickHandler callback: " + e.getMessage());
 }

 }

 /**
 * Creates a new ClickHandlerBuilder instance for constructing click handlers.
 * This is the recommended way to create new ClickHandler instances.
 * 
 * @return a new ClickHandlerBuilder ready for configuration
 */
 @Contract(" -> new")
 public static @NotNull ClickHandlerBuilder newBuilder() {
 return new ClickHandlerBuilder();
 }

 /**
 * Builder class for creating ClickHandler instances with a fluent API.
 * 
 * <p>This builder allows you to configure all aspects of a click handler before creation:
 * the callback function, allowed click types, and auto-cancellation behavior.</p>
 */
 public static class ClickHandlerBuilder {

 private Consumer<InventoryClickEvent> callback;
 private EnumSet<ClickType> allowedClickTypes;
 private boolean autoCancel = true;

 /**
 * Sets the callback function to execute when a click event is handled.
 * 
 * @param callback the consumer that will receive the click event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if callback is null
 */
 public ClickHandlerBuilder callback(@NotNull Consumer<InventoryClickEvent> callback) {
 this.callback = callback;
 return this;
 }

 /**
 * Sets which click types should be handled.
 * If not specified, all click types will be handled.
 * 
 * @param clickTypes the click types to handle
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder filter(@NotNull ClickType... clickTypes) {
 if (clickTypes == null || clickTypes.length == 0) {
 this.allowedClickTypes = EnumSet.allOf(ClickType.class);
 } else {
 this.allowedClickTypes = EnumSet.copyOf(Arrays.asList(clickTypes));
 }
 return this;
 }

 /**
 * Sets whether the event should be automatically cancelled before executing the callback.
 * Default is true.
 * 
 * @param autoCancel true to auto-cancel events, false otherwise
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder autoCancel(boolean autoCancel) {
 this.autoCancel = autoCancel;
 return this;
 }

 /**
 * Builds and returns a new ClickHandler instance with the configured properties.
 * 
 * @return a new ClickHandler instance
 * @throws IllegalArgumentException if callback is not set
 */
 public ClickHandler build() {
 return new ClickHandler(this);
 }
 }
}

134 changes: 123 additions & 11 deletions
src/main/java/me/touchie771/minecraftGUI/api/Menu.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,14 +2,20 @@

import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;

/**
 * Represents a Minecraft GUI menu that can be displayed to players.
Expand All@@ -32,6 +38,7 @@ public class Menu {

 private final Inventory menu;
 private final HashSet<SlotItem> items;
 private final MenuClickHandler clickHandler;

 /**
 * Creates a new menu from the specified builder.
Expand All@@ -40,15 +47,29 @@ public class Menu {
 * @param builder the configured builder containing menu properties
 * @throws IllegalArgumentException if builder is null
 */
 public Menu(@NotNull MenuBuilder builder) {
 public Menu(@NotNull MenuBuilder builder, @NotNull Plugin plugin) {
 this.menu = Bukkit.createInventory(null, builder.inventorySize, builder.inventoryTitle);
 this.items = new HashSet<>(builder.items);
 this.clickHandler = new MenuClickHandler(this.menu, plugin.getLogger());

 // Copy click handlers from builder
 for (Map.Entry<Integer, ClickHandler> entry : builder.clickHandlers.entrySet()) {
 this.clickHandler.setClickHandler(entry.getKey(), entry.getValue());
 }

 // Set close handler from builder
 if (builder.closeHandler != null) {
 this.clickHandler.setCloseHandler(builder.closeHandler);
 }

 for (SlotItem item : items) {
 ItemStack itemStack = new ItemStack(item.material(), item.quantity());
 itemStack.editMeta(meta -> meta.displayName(item.itemName()));
 menu.setItem(item.itemSlot(), itemStack);
 }

 // Register event handlers
 registerEvents(plugin);
 }

 /**
Expand DownExpand Up@@ -126,17 +147,69 @@ public HashSet<SlotItem> getItems() {
 }

 /**
 * Returns the SlotItem at the specified slot position.
 * This is useful for handling inventory click events.
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position to check (0-53 for chest inventories)
 * @return the SlotItem at the specified slot, or null if the slot is empty
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public void onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandler.setClickHandler(slot, handler);
 }

 /**
 * Removes the click handler for the specified slot.
 * 
 * @param slot the slot position to remove the handler from
 */
 public void removeClickHandler(int slot) {
 clickHandler.removeClickHandler(slot);
 }

 /**
 * Gets the click handler for the specified slot.
 * 
 * @param slot the slot position
 * @return the ClickHandler for the slot, or null if none is registered
 */
 public @Nullable ClickHandler getClickHandler(int slot) {
 return clickHandler.getClickHandler(slot);
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 */
 public void onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 clickHandler.setCloseHandler(closeHandler);
 }

 /**
 * Removes the close handler.
 */
 public void removeCloseHandler() {
 clickHandler.removeCloseHandler();
 }

 /**
 * Registers this menu's event handlers with Bukkit.
 * This method is called automatically in the constructor.
 */
 private void registerEvents(Plugin plugin) {
 Bukkit.getPluginManager().registerEvents(clickHandler, plugin);
 }

 /**
 * Unregisters this menu's event handlers.
 * This method is automatically called when the inventory is closed to prevent memory leaks.
 * You only need to call this manually if you want to unregister events before closing the menu.
 */
 public SlotItem getItemAt(int slot) {
 return this.items.stream()
 .filter(item -> item.itemSlot() == slot)
 .findFirst()
 .orElse(null);
 public void unregisterEvents() {
 clickHandler.unregister();
 }

 /**
Expand DownExpand Up@@ -171,6 +244,14 @@ public static class MenuBuilder {
 private int inventorySize;
 private Component inventoryTitle;
 private final HashSet<SlotItem> items = new HashSet<>();
 private final Map<Integer, ClickHandler> clickHandlers = new HashMap<>();
 private Consumer<InventoryCloseEvent> closeHandler;
 private Plugin plugin;

 public MenuBuilder plugin(@NotNull Plugin plugin) {
 this.plugin = plugin;
 return this;
 }

 /**
 * Sets the size of the inventory.
Expand DownExpand Up@@ -244,7 +325,38 @@ public Menu build() {
 if (inventoryTitle == null) {
 throw new IllegalArgumentException("Inventory title cannot be null");
 }
 return new Menu(this);
 if (plugin == null) {
 throw new IllegalArgumentException("Plugin cannot be null");
 }
 return new Menu(this, plugin);
 }

 /**
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public MenuBuilder onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandlers.put(slot, handler);
 return this;
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if closeHandler is null
 */
 public MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 this.closeHandler = closeHandler;
 return this;
 }
 }
}
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Implemented click handler logic#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

Touchie771
merged 1 commit into

from

Nov 23, 2025
 Merged


Implemented click handler logic
#2
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


154 changes: 154 additions & 0 deletions
src/main/java/me/touchie771/minecraftGUI/api/ClickHandler.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
package me.touchie771.minecraftGUI.api;

import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;

import java.util.Arrays;
import java.util.EnumSet;
import java.util.function.Consumer;

/**
 * Handles click events for menu slots with filtering and cancellation options.
 * 
 * <p>This class provides a way to register callbacks for inventory clicks with
 * fine-grained control over which click types are handled and whether the event
 * should be automatically cancelled.</p>
 * 
 * <p>Example usage:
 * <pre>{@code
 * ClickHandler handler = ClickHandler.newBuilder()
 * .callback(event -> {
 * Player player = (Player) event.getWhoClicked();
 * player.sendMessage("You clicked the item!");
 * })
 * .filter(ClickType.LEFT, ClickType.RIGHT)
 * .autoCancel(true)
 * .build();
 * }</pre></p>
 */
public class ClickHandler {

 private final Consumer<InventoryClickEvent> callback;
 private final EnumSet<ClickType> allowedClickTypes;
 private final boolean autoCancel;

 /**
 * Creates a new ClickHandler with the specified configuration.
 * This constructor is package-private and should only be called by ClickHandlerBuilder.
 * 
 * @param builder the configured builder containing handler properties
 * @throws IllegalArgumentException if builder or callback is null
 */
 ClickHandler(@NotNull ClickHandlerBuilder builder) {
 if (builder.callback == null) {
 throw new IllegalArgumentException("Callback cannot be null");
 }
 this.callback = builder.callback;
 this.allowedClickTypes = builder.allowedClickTypes != null ? 
 EnumSet.copyOf(builder.allowedClickTypes) : EnumSet.allOf(ClickType.class);
 this.autoCancel = builder.autoCancel;
 }

 /**
 * Handles the given inventory click event if it matches the configured filters.
 *
 * @param event the inventory click event to handle
 */
 public void handleClick(@NotNull InventoryClickEvent event) {

 // Check if the click type is allowed
 if (!allowedClickTypes.contains(event.getClick())) {
 return;
 }

 // Auto-cancel if configured
 if (autoCancel) {
 event.setCancelled(true);
 }

 // Execute the callback
 try {
 callback.accept(event);
 } catch (Exception e) {
 // Log the exception but don't rethrow to avoid breaking other handlers
 System.err.println("Error in ClickHandler callback: " + e.getMessage());
 }

 }

 /**
 * Creates a new ClickHandlerBuilder instance for constructing click handlers.
 * This is the recommended way to create new ClickHandler instances.
 * 
 * @return a new ClickHandlerBuilder ready for configuration
 */
 @Contract(" -> new")
 public static @NotNull ClickHandlerBuilder newBuilder() {
 return new ClickHandlerBuilder();
 }

 /**
 * Builder class for creating ClickHandler instances with a fluent API.
 * 
 * <p>This builder allows you to configure all aspects of a click handler before creation:
 * the callback function, allowed click types, and auto-cancellation behavior.</p>
 */
 public static class ClickHandlerBuilder {

 private Consumer<InventoryClickEvent> callback;
 private EnumSet<ClickType> allowedClickTypes;
 private boolean autoCancel = true;

 /**
 * Sets the callback function to execute when a click event is handled.
 * 
 * @param callback the consumer that will receive the click event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if callback is null
 */
 public ClickHandlerBuilder callback(@NotNull Consumer<InventoryClickEvent> callback) {
 this.callback = callback;
 return this;
 }

 /**
 * Sets which click types should be handled.
 * If not specified, all click types will be handled.
 * 
 * @param clickTypes the click types to handle
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder filter(@NotNull ClickType... clickTypes) {
 if (clickTypes == null || clickTypes.length == 0) {
 this.allowedClickTypes = EnumSet.allOf(ClickType.class);
 } else {
 this.allowedClickTypes = EnumSet.copyOf(Arrays.asList(clickTypes));
 }
 return this;
 }

 /**
 * Sets whether the event should be automatically cancelled before executing the callback.
 * Default is true.
 * 
 * @param autoCancel true to auto-cancel events, false otherwise
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder autoCancel(boolean autoCancel) {
 this.autoCancel = autoCancel;
 return this;
 }

 /**
 * Builds and returns a new ClickHandler instance with the configured properties.
 * 
 * @return a new ClickHandler instance
 * @throws IllegalArgumentException if callback is not set
 */
 public ClickHandler build() {
 return new ClickHandler(this);
 }
 }
}

134 changes: 123 additions & 11 deletions
src/main/java/me/touchie771/minecraftGUI/api/Menu.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,14 +2,20 @@

import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;

/**
 * Represents a Minecraft GUI menu that can be displayed to players.
Expand All@@ -32,6 +38,7 @@ public class Menu {

 private final Inventory menu;
 private final HashSet<SlotItem> items;
 private final MenuClickHandler clickHandler;

 /**
 * Creates a new menu from the specified builder.
Expand All@@ -40,15 +47,29 @@ public class Menu {
 * @param builder the configured builder containing menu properties
 * @throws IllegalArgumentException if builder is null
 */
 public Menu(@NotNull MenuBuilder builder) {
 public Menu(@NotNull MenuBuilder builder, @NotNull Plugin plugin) {
 this.menu = Bukkit.createInventory(null, builder.inventorySize, builder.inventoryTitle);
 this.items = new HashSet<>(builder.items);
 this.clickHandler = new MenuClickHandler(this.menu, plugin.getLogger());

 // Copy click handlers from builder
 for (Map.Entry<Integer, ClickHandler> entry : builder.clickHandlers.entrySet()) {
 this.clickHandler.setClickHandler(entry.getKey(), entry.getValue());
 }

 // Set close handler from builder
 if (builder.closeHandler != null) {
 this.clickHandler.setCloseHandler(builder.closeHandler);
 }

 for (SlotItem item : items) {
 ItemStack itemStack = new ItemStack(item.material(), item.quantity());
 itemStack.editMeta(meta -> meta.displayName(item.itemName()));
 menu.setItem(item.itemSlot(), itemStack);
 }

 // Register event handlers
 registerEvents(plugin);
 }

 /**
Expand DownExpand Up@@ -126,17 +147,69 @@ public HashSet<SlotItem> getItems() {
 }

 /**
 * Returns the SlotItem at the specified slot position.
 * This is useful for handling inventory click events.
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position to check (0-53 for chest inventories)
 * @return the SlotItem at the specified slot, or null if the slot is empty
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public void onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandler.setClickHandler(slot, handler);
 }

 /**
 * Removes the click handler for the specified slot.
 * 
 * @param slot the slot position to remove the handler from
 */
 public void removeClickHandler(int slot) {
 clickHandler.removeClickHandler(slot);
 }

 /**
 * Gets the click handler for the specified slot.
 * 
 * @param slot the slot position
 * @return the ClickHandler for the slot, or null if none is registered
 */
 public @Nullable ClickHandler getClickHandler(int slot) {
 return clickHandler.getClickHandler(slot);
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 */
 public void onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 clickHandler.setCloseHandler(closeHandler);
 }

 /**
 * Removes the close handler.
 */
 public void removeCloseHandler() {
 clickHandler.removeCloseHandler();
 }

 /**
 * Registers this menu's event handlers with Bukkit.
 * This method is called automatically in the constructor.
 */
 private void registerEvents(Plugin plugin) {
 Bukkit.getPluginManager().registerEvents(clickHandler, plugin);
 }

 /**
 * Unregisters this menu's event handlers.
 * This method is automatically called when the inventory is closed to prevent memory leaks.
 * You only need to call this manually if you want to unregister events before closing the menu.
 */
 public SlotItem getItemAt(int slot) {
 return this.items.stream()
 .filter(item -> item.itemSlot() == slot)
 .findFirst()
 .orElse(null);
 public void unregisterEvents() {
 clickHandler.unregister();
 }

 /**
Expand DownExpand Up@@ -171,6 +244,14 @@ public static class MenuBuilder {
 private int inventorySize;
 private Component inventoryTitle;
 private final HashSet<SlotItem> items = new HashSet<>();
 private final Map<Integer, ClickHandler> clickHandlers = new HashMap<>();
 private Consumer<InventoryCloseEvent> closeHandler;
 private Plugin plugin;

 public MenuBuilder plugin(@NotNull Plugin plugin) {
 this.plugin = plugin;
 return this;
 }

 /**
 * Sets the size of the inventory.
Expand DownExpand Up@@ -244,7 +325,38 @@ public Menu build() {
 if (inventoryTitle == null) {
 throw new IllegalArgumentException("Inventory title cannot be null");
 }
 return new Menu(this);
 if (plugin == null) {
 throw new IllegalArgumentException("Plugin cannot be null");
 }
 return new Menu(this, plugin);
 }

 /**
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public MenuBuilder onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandlers.put(slot, handler);
 return this;
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if closeHandler is null
 */
 public MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 this.closeHandler = closeHandler;
 return this;
 }
 }
}
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
Implemented click handler logic#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

Touchie771
merged 1 commit into

from

Nov 23, 2025
 Merged


Implemented click handler logic
#2
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


154 changes: 154 additions & 0 deletions
src/main/java/me/touchie771/minecraftGUI/api/ClickHandler.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
package me.touchie771.minecraftGUI.api;

import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;

import java.util.Arrays;
import java.util.EnumSet;
import java.util.function.Consumer;

/**
 * Handles click events for menu slots with filtering and cancellation options.
 * 
 * <p>This class provides a way to register callbacks for inventory clicks with
 * fine-grained control over which click types are handled and whether the event
 * should be automatically cancelled.</p>
 * 
 * <p>Example usage:
 * <pre>{@code
 * ClickHandler handler = ClickHandler.newBuilder()
 * .callback(event -> {
 * Player player = (Player) event.getWhoClicked();
 * player.sendMessage("You clicked the item!");
 * })
 * .filter(ClickType.LEFT, ClickType.RIGHT)
 * .autoCancel(true)
 * .build();
 * }</pre></p>
 */
public class ClickHandler {

 private final Consumer<InventoryClickEvent> callback;
 private final EnumSet<ClickType> allowedClickTypes;
 private final boolean autoCancel;

 /**
 * Creates a new ClickHandler with the specified configuration.
 * This constructor is package-private and should only be called by ClickHandlerBuilder.
 * 
 * @param builder the configured builder containing handler properties
 * @throws IllegalArgumentException if builder or callback is null
 */
 ClickHandler(@NotNull ClickHandlerBuilder builder) {
 if (builder.callback == null) {
 throw new IllegalArgumentException("Callback cannot be null");
 }
 this.callback = builder.callback;
 this.allowedClickTypes = builder.allowedClickTypes != null ? 
 EnumSet.copyOf(builder.allowedClickTypes) : EnumSet.allOf(ClickType.class);
 this.autoCancel = builder.autoCancel;
 }

 /**
 * Handles the given inventory click event if it matches the configured filters.
 *
 * @param event the inventory click event to handle
 */
 public void handleClick(@NotNull InventoryClickEvent event) {

 // Check if the click type is allowed
 if (!allowedClickTypes.contains(event.getClick())) {
 return;
 }

 // Auto-cancel if configured
 if (autoCancel) {
 event.setCancelled(true);
 }

 // Execute the callback
 try {
 callback.accept(event);
 } catch (Exception e) {
 // Log the exception but don't rethrow to avoid breaking other handlers
 System.err.println("Error in ClickHandler callback: " + e.getMessage());
 }

 }

 /**
 * Creates a new ClickHandlerBuilder instance for constructing click handlers.
 * This is the recommended way to create new ClickHandler instances.
 * 
 * @return a new ClickHandlerBuilder ready for configuration
 */
 @Contract(" -> new")
 public static @NotNull ClickHandlerBuilder newBuilder() {
 return new ClickHandlerBuilder();
 }

 /**
 * Builder class for creating ClickHandler instances with a fluent API.
 * 
 * <p>This builder allows you to configure all aspects of a click handler before creation:
 * the callback function, allowed click types, and auto-cancellation behavior.</p>
 */
 public static class ClickHandlerBuilder {

 private Consumer<InventoryClickEvent> callback;
 private EnumSet<ClickType> allowedClickTypes;
 private boolean autoCancel = true;

 /**
 * Sets the callback function to execute when a click event is handled.
 * 
 * @param callback the consumer that will receive the click event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if callback is null
 */
 public ClickHandlerBuilder callback(@NotNull Consumer<InventoryClickEvent> callback) {
 this.callback = callback;
 return this;
 }

 /**
 * Sets which click types should be handled.
 * If not specified, all click types will be handled.
 * 
 * @param clickTypes the click types to handle
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder filter(@NotNull ClickType... clickTypes) {
 if (clickTypes == null || clickTypes.length == 0) {
 this.allowedClickTypes = EnumSet.allOf(ClickType.class);
 } else {
 this.allowedClickTypes = EnumSet.copyOf(Arrays.asList(clickTypes));
 }
 return this;
 }

 /**
 * Sets whether the event should be automatically cancelled before executing the callback.
 * Default is true.
 * 
 * @param autoCancel true to auto-cancel events, false otherwise
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder autoCancel(boolean autoCancel) {
 this.autoCancel = autoCancel;
 return this;
 }

 /**
 * Builds and returns a new ClickHandler instance with the configured properties.
 * 
 * @return a new ClickHandler instance
 * @throws IllegalArgumentException if callback is not set
 */
 public ClickHandler build() {
 return new ClickHandler(this);
 }
 }
}

134 changes: 123 additions & 11 deletions
src/main/java/me/touchie771/minecraftGUI/api/Menu.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,14 +2,20 @@

import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;

/**
 * Represents a Minecraft GUI menu that can be displayed to players.
Expand All@@ -32,6 +38,7 @@ public class Menu {

 private final Inventory menu;
 private final HashSet<SlotItem> items;
 private final MenuClickHandler clickHandler;

 /**
 * Creates a new menu from the specified builder.
Expand All@@ -40,15 +47,29 @@ public class Menu {
 * @param builder the configured builder containing menu properties
 * @throws IllegalArgumentException if builder is null
 */
 public Menu(@NotNull MenuBuilder builder) {
 public Menu(@NotNull MenuBuilder builder, @NotNull Plugin plugin) {
 this.menu = Bukkit.createInventory(null, builder.inventorySize, builder.inventoryTitle);
 this.items = new HashSet<>(builder.items);
 this.clickHandler = new MenuClickHandler(this.menu, plugin.getLogger());

 // Copy click handlers from builder
 for (Map.Entry<Integer, ClickHandler> entry : builder.clickHandlers.entrySet()) {
 this.clickHandler.setClickHandler(entry.getKey(), entry.getValue());
 }

 // Set close handler from builder
 if (builder.closeHandler != null) {
 this.clickHandler.setCloseHandler(builder.closeHandler);
 }

 for (SlotItem item : items) {
 ItemStack itemStack = new ItemStack(item.material(), item.quantity());
 itemStack.editMeta(meta -> meta.displayName(item.itemName()));
 menu.setItem(item.itemSlot(), itemStack);
 }

 // Register event handlers
 registerEvents(plugin);
 }

 /**
Expand DownExpand Up@@ -126,17 +147,69 @@ public HashSet<SlotItem> getItems() {
 }

 /**
 * Returns the SlotItem at the specified slot position.
 * This is useful for handling inventory click events.
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position to check (0-53 for chest inventories)
 * @return the SlotItem at the specified slot, or null if the slot is empty
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public void onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandler.setClickHandler(slot, handler);
 }

 /**
 * Removes the click handler for the specified slot.
 * 
 * @param slot the slot position to remove the handler from
 */
 public void removeClickHandler(int slot) {
 clickHandler.removeClickHandler(slot);
 }

 /**
 * Gets the click handler for the specified slot.
 * 
 * @param slot the slot position
 * @return the ClickHandler for the slot, or null if none is registered
 */
 public @Nullable ClickHandler getClickHandler(int slot) {
 return clickHandler.getClickHandler(slot);
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 */
 public void onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 clickHandler.setCloseHandler(closeHandler);
 }

 /**
 * Removes the close handler.
 */
 public void removeCloseHandler() {
 clickHandler.removeCloseHandler();
 }

 /**
 * Registers this menu's event handlers with Bukkit.
 * This method is called automatically in the constructor.
 */
 private void registerEvents(Plugin plugin) {
 Bukkit.getPluginManager().registerEvents(clickHandler, plugin);
 }

 /**
 * Unregisters this menu's event handlers.
 * This method is automatically called when the inventory is closed to prevent memory leaks.
 * You only need to call this manually if you want to unregister events before closing the menu.
 */
 public SlotItem getItemAt(int slot) {
 return this.items.stream()
 .filter(item -> item.itemSlot() == slot)
 .findFirst()
 .orElse(null);
 public void unregisterEvents() {
 clickHandler.unregister();
 }

 /**
Expand DownExpand Up@@ -171,6 +244,14 @@ public static class MenuBuilder {
 private int inventorySize;
 private Component inventoryTitle;
 private final HashSet<SlotItem> items = new HashSet<>();
 private final Map<Integer, ClickHandler> clickHandlers = new HashMap<>();
 private Consumer<InventoryCloseEvent> closeHandler;
 private Plugin plugin;

 public MenuBuilder plugin(@NotNull Plugin plugin) {
 this.plugin = plugin;
 return this;
 }

 /**
 * Sets the size of the inventory.
Expand DownExpand Up@@ -244,7 +325,38 @@ public Menu build() {
 if (inventoryTitle == null) {
 throw new IllegalArgumentException("Inventory title cannot be null");
 }
 return new Menu(this);
 if (plugin == null) {
 throw new IllegalArgumentException("Plugin cannot be null");
 }
 return new Menu(this, plugin);
 }

 /**
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public MenuBuilder onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandlers.put(slot, handler);
 return this;
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if closeHandler is null
 */
 public MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 this.closeHandler = closeHandler;
 return this;
 }
 }
}
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Implemented click handler logic#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

Touchie771
merged 1 commit into

from

Nov 23, 2025
 Merged


Implemented click handler logic
#2
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


154 changes: 154 additions & 0 deletions
src/main/java/me/touchie771/minecraftGUI/api/ClickHandler.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
package me.touchie771.minecraftGUI.api;

import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;

import java.util.Arrays;
import java.util.EnumSet;
import java.util.function.Consumer;

/**
 * Handles click events for menu slots with filtering and cancellation options.
 * 
 * <p>This class provides a way to register callbacks for inventory clicks with
 * fine-grained control over which click types are handled and whether the event
 * should be automatically cancelled.</p>
 * 
 * <p>Example usage:
 * <pre>{@code
 * ClickHandler handler = ClickHandler.newBuilder()
 * .callback(event -> {
 * Player player = (Player) event.getWhoClicked();
 * player.sendMessage("You clicked the item!");
 * })
 * .filter(ClickType.LEFT, ClickType.RIGHT)
 * .autoCancel(true)
 * .build();
 * }</pre></p>
 */
public class ClickHandler {

 private final Consumer<InventoryClickEvent> callback;
 private final EnumSet<ClickType> allowedClickTypes;
 private final boolean autoCancel;

 /**
 * Creates a new ClickHandler with the specified configuration.
 * This constructor is package-private and should only be called by ClickHandlerBuilder.
 * 
 * @param builder the configured builder containing handler properties
 * @throws IllegalArgumentException if builder or callback is null
 */
 ClickHandler(@NotNull ClickHandlerBuilder builder) {
 if (builder.callback == null) {
 throw new IllegalArgumentException("Callback cannot be null");
 }
 this.callback = builder.callback;
 this.allowedClickTypes = builder.allowedClickTypes != null ? 
 EnumSet.copyOf(builder.allowedClickTypes) : EnumSet.allOf(ClickType.class);
 this.autoCancel = builder.autoCancel;
 }

 /**
 * Handles the given inventory click event if it matches the configured filters.
 *
 * @param event the inventory click event to handle
 */
 public void handleClick(@NotNull InventoryClickEvent event) {

 // Check if the click type is allowed
 if (!allowedClickTypes.contains(event.getClick())) {
 return;
 }

 // Auto-cancel if configured
 if (autoCancel) {
 event.setCancelled(true);
 }

 // Execute the callback
 try {
 callback.accept(event);
 } catch (Exception e) {
 // Log the exception but don't rethrow to avoid breaking other handlers
 System.err.println("Error in ClickHandler callback: " + e.getMessage());
 }

 }

 /**
 * Creates a new ClickHandlerBuilder instance for constructing click handlers.
 * This is the recommended way to create new ClickHandler instances.
 * 
 * @return a new ClickHandlerBuilder ready for configuration
 */
 @Contract(" -> new")
 public static @NotNull ClickHandlerBuilder newBuilder() {
 return new ClickHandlerBuilder();
 }

 /**
 * Builder class for creating ClickHandler instances with a fluent API.
 * 
 * <p>This builder allows you to configure all aspects of a click handler before creation:
 * the callback function, allowed click types, and auto-cancellation behavior.</p>
 */
 public static class ClickHandlerBuilder {

 private Consumer<InventoryClickEvent> callback;
 private EnumSet<ClickType> allowedClickTypes;
 private boolean autoCancel = true;

 /**
 * Sets the callback function to execute when a click event is handled.
 * 
 * @param callback the consumer that will receive the click event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if callback is null
 */
 public ClickHandlerBuilder callback(@NotNull Consumer<InventoryClickEvent> callback) {
 this.callback = callback;
 return this;
 }

 /**
 * Sets which click types should be handled.
 * If not specified, all click types will be handled.
 * 
 * @param clickTypes the click types to handle
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder filter(@NotNull ClickType... clickTypes) {
 if (clickTypes == null || clickTypes.length == 0) {
 this.allowedClickTypes = EnumSet.allOf(ClickType.class);
 } else {
 this.allowedClickTypes = EnumSet.copyOf(Arrays.asList(clickTypes));
 }
 return this;
 }

 /**
 * Sets whether the event should be automatically cancelled before executing the callback.
 * Default is true.
 * 
 * @param autoCancel true to auto-cancel events, false otherwise
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder autoCancel(boolean autoCancel) {
 this.autoCancel = autoCancel;
 return this;
 }

 /**
 * Builds and returns a new ClickHandler instance with the configured properties.
 * 
 * @return a new ClickHandler instance
 * @throws IllegalArgumentException if callback is not set
 */
 public ClickHandler build() {
 return new ClickHandler(this);
 }
 }
}

134 changes: 123 additions & 11 deletions
src/main/java/me/touchie771/minecraftGUI/api/Menu.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,14 +2,20 @@

import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;

/**
 * Represents a Minecraft GUI menu that can be displayed to players.
Expand All@@ -32,6 +38,7 @@ public class Menu {

 private final Inventory menu;
 private final HashSet<SlotItem> items;
 private final MenuClickHandler clickHandler;

 /**
 * Creates a new menu from the specified builder.
Expand All@@ -40,15 +47,29 @@ public class Menu {
 * @param builder the configured builder containing menu properties
 * @throws IllegalArgumentException if builder is null
 */
 public Menu(@NotNull MenuBuilder builder) {
 public Menu(@NotNull MenuBuilder builder, @NotNull Plugin plugin) {
 this.menu = Bukkit.createInventory(null, builder.inventorySize, builder.inventoryTitle);
 this.items = new HashSet<>(builder.items);
 this.clickHandler = new MenuClickHandler(this.menu, plugin.getLogger());

 // Copy click handlers from builder
 for (Map.Entry<Integer, ClickHandler> entry : builder.clickHandlers.entrySet()) {
 this.clickHandler.setClickHandler(entry.getKey(), entry.getValue());
 }

 // Set close handler from builder
 if (builder.closeHandler != null) {
 this.clickHandler.setCloseHandler(builder.closeHandler);
 }

 for (SlotItem item : items) {
 ItemStack itemStack = new ItemStack(item.material(), item.quantity());
 itemStack.editMeta(meta -> meta.displayName(item.itemName()));
 menu.setItem(item.itemSlot(), itemStack);
 }

 // Register event handlers
 registerEvents(plugin);
 }

 /**
Expand DownExpand Up@@ -126,17 +147,69 @@ public HashSet<SlotItem> getItems() {
 }

 /**
 * Returns the SlotItem at the specified slot position.
 * This is useful for handling inventory click events.
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position to check (0-53 for chest inventories)
 * @return the SlotItem at the specified slot, or null if the slot is empty
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public void onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandler.setClickHandler(slot, handler);
 }

 /**
 * Removes the click handler for the specified slot.
 * 
 * @param slot the slot position to remove the handler from
 */
 public void removeClickHandler(int slot) {
 clickHandler.removeClickHandler(slot);
 }

 /**
 * Gets the click handler for the specified slot.
 * 
 * @param slot the slot position
 * @return the ClickHandler for the slot, or null if none is registered
 */
 public @Nullable ClickHandler getClickHandler(int slot) {
 return clickHandler.getClickHandler(slot);
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 */
 public void onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 clickHandler.setCloseHandler(closeHandler);
 }

 /**
 * Removes the close handler.
 */
 public void removeCloseHandler() {
 clickHandler.removeCloseHandler();
 }

 /**
 * Registers this menu's event handlers with Bukkit.
 * This method is called automatically in the constructor.
 */
 private void registerEvents(Plugin plugin) {
 Bukkit.getPluginManager().registerEvents(clickHandler, plugin);
 }

 /**
 * Unregisters this menu's event handlers.
 * This method is automatically called when the inventory is closed to prevent memory leaks.
 * You only need to call this manually if you want to unregister events before closing the menu.
 */
 public SlotItem getItemAt(int slot) {
 return this.items.stream()
 .filter(item -> item.itemSlot() == slot)
 .findFirst()
 .orElse(null);
 public void unregisterEvents() {
 clickHandler.unregister();
 }

 /**
Expand DownExpand Up@@ -171,6 +244,14 @@ public static class MenuBuilder {
 private int inventorySize;
 private Component inventoryTitle;
 private final HashSet<SlotItem> items = new HashSet<>();
 private final Map<Integer, ClickHandler> clickHandlers = new HashMap<>();
 private Consumer<InventoryCloseEvent> closeHandler;
 private Plugin plugin;

 public MenuBuilder plugin(@NotNull Plugin plugin) {
 this.plugin = plugin;
 return this;
 }

 /**
 * Sets the size of the inventory.
Expand DownExpand Up@@ -244,7 +325,38 @@ public Menu build() {
 if (inventoryTitle == null) {
 throw new IllegalArgumentException("Inventory title cannot be null");
 }
 return new Menu(this);
 if (plugin == null) {
 throw new IllegalArgumentException("Plugin cannot be null");
 }
 return new Menu(this, plugin);
 }

 /**
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public MenuBuilder onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandlers.put(slot, handler);
 return this;
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if closeHandler is null
 */
 public MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 this.closeHandler = closeHandler;
 return this;
 }
 }
}
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Implemented click handler logic#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

Touchie771
merged 1 commit into

from

Nov 23, 2025
 Merged


Implemented click handler logic
#2
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


154 changes: 154 additions & 0 deletions
src/main/java/me/touchie771/minecraftGUI/api/ClickHandler.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
package me.touchie771.minecraftGUI.api;

import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;

import java.util.Arrays;
import java.util.EnumSet;
import java.util.function.Consumer;

/**
 * Handles click events for menu slots with filtering and cancellation options.
 * 
 * <p>This class provides a way to register callbacks for inventory clicks with
 * fine-grained control over which click types are handled and whether the event
 * should be automatically cancelled.</p>
 * 
 * <p>Example usage:
 * <pre>{@code
 * ClickHandler handler = ClickHandler.newBuilder()
 * .callback(event -> {
 * Player player = (Player) event.getWhoClicked();
 * player.sendMessage("You clicked the item!");
 * })
 * .filter(ClickType.LEFT, ClickType.RIGHT)
 * .autoCancel(true)
 * .build();
 * }</pre></p>
 */
public class ClickHandler {

 private final Consumer<InventoryClickEvent> callback;
 private final EnumSet<ClickType> allowedClickTypes;
 private final boolean autoCancel;

 /**
 * Creates a new ClickHandler with the specified configuration.
 * This constructor is package-private and should only be called by ClickHandlerBuilder.
 * 
 * @param builder the configured builder containing handler properties
 * @throws IllegalArgumentException if builder or callback is null
 */
 ClickHandler(@NotNull ClickHandlerBuilder builder) {
 if (builder.callback == null) {
 throw new IllegalArgumentException("Callback cannot be null");
 }
 this.callback = builder.callback;
 this.allowedClickTypes = builder.allowedClickTypes != null ? 
 EnumSet.copyOf(builder.allowedClickTypes) : EnumSet.allOf(ClickType.class);
 this.autoCancel = builder.autoCancel;
 }

 /**
 * Handles the given inventory click event if it matches the configured filters.
 *
 * @param event the inventory click event to handle
 */
 public void handleClick(@NotNull InventoryClickEvent event) {

 // Check if the click type is allowed
 if (!allowedClickTypes.contains(event.getClick())) {
 return;
 }

 // Auto-cancel if configured
 if (autoCancel) {
 event.setCancelled(true);
 }

 // Execute the callback
 try {
 callback.accept(event);
 } catch (Exception e) {
 // Log the exception but don't rethrow to avoid breaking other handlers
 System.err.println("Error in ClickHandler callback: " + e.getMessage());
 }

 }

 /**
 * Creates a new ClickHandlerBuilder instance for constructing click handlers.
 * This is the recommended way to create new ClickHandler instances.
 * 
 * @return a new ClickHandlerBuilder ready for configuration
 */
 @Contract(" -> new")
 public static @NotNull ClickHandlerBuilder newBuilder() {
 return new ClickHandlerBuilder();
 }

 /**
 * Builder class for creating ClickHandler instances with a fluent API.
 * 
 * <p>This builder allows you to configure all aspects of a click handler before creation:
 * the callback function, allowed click types, and auto-cancellation behavior.</p>
 */
 public static class ClickHandlerBuilder {

 private Consumer<InventoryClickEvent> callback;
 private EnumSet<ClickType> allowedClickTypes;
 private boolean autoCancel = true;

 /**
 * Sets the callback function to execute when a click event is handled.
 * 
 * @param callback the consumer that will receive the click event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if callback is null
 */
 public ClickHandlerBuilder callback(@NotNull Consumer<InventoryClickEvent> callback) {
 this.callback = callback;
 return this;
 }

 /**
 * Sets which click types should be handled.
 * If not specified, all click types will be handled.
 * 
 * @param clickTypes the click types to handle
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder filter(@NotNull ClickType... clickTypes) {
 if (clickTypes == null || clickTypes.length == 0) {
 this.allowedClickTypes = EnumSet.allOf(ClickType.class);
 } else {
 this.allowedClickTypes = EnumSet.copyOf(Arrays.asList(clickTypes));
 }
 return this;
 }

 /**
 * Sets whether the event should be automatically cancelled before executing the callback.
 * Default is true.
 * 
 * @param autoCancel true to auto-cancel events, false otherwise
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder autoCancel(boolean autoCancel) {
 this.autoCancel = autoCancel;
 return this;
 }

 /**
 * Builds and returns a new ClickHandler instance with the configured properties.
 * 
 * @return a new ClickHandler instance
 * @throws IllegalArgumentException if callback is not set
 */
 public ClickHandler build() {
 return new ClickHandler(this);
 }
 }
}

134 changes: 123 additions & 11 deletions
src/main/java/me/touchie771/minecraftGUI/api/Menu.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,14 +2,20 @@

import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;

/**
 * Represents a Minecraft GUI menu that can be displayed to players.
Expand All@@ -32,6 +38,7 @@ public class Menu {

 private final Inventory menu;
 private final HashSet<SlotItem> items;
 private final MenuClickHandler clickHandler;

 /**
 * Creates a new menu from the specified builder.
Expand All@@ -40,15 +47,29 @@ public class Menu {
 * @param builder the configured builder containing menu properties
 * @throws IllegalArgumentException if builder is null
 */
 public Menu(@NotNull MenuBuilder builder) {
 public Menu(@NotNull MenuBuilder builder, @NotNull Plugin plugin) {
 this.menu = Bukkit.createInventory(null, builder.inventorySize, builder.inventoryTitle);
 this.items = new HashSet<>(builder.items);
 this.clickHandler = new MenuClickHandler(this.menu, plugin.getLogger());

 // Copy click handlers from builder
 for (Map.Entry<Integer, ClickHandler> entry : builder.clickHandlers.entrySet()) {
 this.clickHandler.setClickHandler(entry.getKey(), entry.getValue());
 }

 // Set close handler from builder
 if (builder.closeHandler != null) {
 this.clickHandler.setCloseHandler(builder.closeHandler);
 }

 for (SlotItem item : items) {
 ItemStack itemStack = new ItemStack(item.material(), item.quantity());
 itemStack.editMeta(meta -> meta.displayName(item.itemName()));
 menu.setItem(item.itemSlot(), itemStack);
 }

 // Register event handlers
 registerEvents(plugin);
 }

 /**
Expand DownExpand Up@@ -126,17 +147,69 @@ public HashSet<SlotItem> getItems() {
 }

 /**
 * Returns the SlotItem at the specified slot position.
 * This is useful for handling inventory click events.
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position to check (0-53 for chest inventories)
 * @return the SlotItem at the specified slot, or null if the slot is empty
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public void onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandler.setClickHandler(slot, handler);
 }

 /**
 * Removes the click handler for the specified slot.
 * 
 * @param slot the slot position to remove the handler from
 */
 public void removeClickHandler(int slot) {
 clickHandler.removeClickHandler(slot);
 }

 /**
 * Gets the click handler for the specified slot.
 * 
 * @param slot the slot position
 * @return the ClickHandler for the slot, or null if none is registered
 */
 public @Nullable ClickHandler getClickHandler(int slot) {
 return clickHandler.getClickHandler(slot);
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 */
 public void onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 clickHandler.setCloseHandler(closeHandler);
 }

 /**
 * Removes the close handler.
 */
 public void removeCloseHandler() {
 clickHandler.removeCloseHandler();
 }

 /**
 * Registers this menu's event handlers with Bukkit.
 * This method is called automatically in the constructor.
 */
 private void registerEvents(Plugin plugin) {
 Bukkit.getPluginManager().registerEvents(clickHandler, plugin);
 }

 /**
 * Unregisters this menu's event handlers.
 * This method is automatically called when the inventory is closed to prevent memory leaks.
 * You only need to call this manually if you want to unregister events before closing the menu.
 */
 public SlotItem getItemAt(int slot) {
 return this.items.stream()
 .filter(item -> item.itemSlot() == slot)
 .findFirst()
 .orElse(null);
 public void unregisterEvents() {
 clickHandler.unregister();
 }

 /**
Expand DownExpand Up@@ -171,6 +244,14 @@ public static class MenuBuilder {
 private int inventorySize;
 private Component inventoryTitle;
 private final HashSet<SlotItem> items = new HashSet<>();
 private final Map<Integer, ClickHandler> clickHandlers = new HashMap<>();
 private Consumer<InventoryCloseEvent> closeHandler;
 private Plugin plugin;

 public MenuBuilder plugin(@NotNull Plugin plugin) {
 this.plugin = plugin;
 return this;
 }

 /**
 * Sets the size of the inventory.
Expand DownExpand Up@@ -244,7 +325,38 @@ public Menu build() {
 if (inventoryTitle == null) {
 throw new IllegalArgumentException("Inventory title cannot be null");
 }
 return new Menu(this);
 if (plugin == null) {
 throw new IllegalArgumentException("Plugin cannot be null");
 }
 return new Menu(this, plugin);
 }

 /**
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public MenuBuilder onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandlers.put(slot, handler);
 return this;
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if closeHandler is null
 */
 public MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 this.closeHandler = closeHandler;
 return this;
 }
 }
}
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
Implemented click handler logic#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

Touchie771
merged 1 commit into

from

Nov 23, 2025
 Merged


Implemented click handler logic
#2
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


154 changes: 154 additions & 0 deletions
src/main/java/me/touchie771/minecraftGUI/api/ClickHandler.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
package me.touchie771.minecraftGUI.api;

import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;

import java.util.Arrays;
import java.util.EnumSet;
import java.util.function.Consumer;

/**
 * Handles click events for menu slots with filtering and cancellation options.
 * 
 * <p>This class provides a way to register callbacks for inventory clicks with
 * fine-grained control over which click types are handled and whether the event
 * should be automatically cancelled.</p>
 * 
 * <p>Example usage:
 * <pre>{@code
 * ClickHandler handler = ClickHandler.newBuilder()
 * .callback(event -> {
 * Player player = (Player) event.getWhoClicked();
 * player.sendMessage("You clicked the item!");
 * })
 * .filter(ClickType.LEFT, ClickType.RIGHT)
 * .autoCancel(true)
 * .build();
 * }</pre></p>
 */
public class ClickHandler {

 private final Consumer<InventoryClickEvent> callback;
 private final EnumSet<ClickType> allowedClickTypes;
 private final boolean autoCancel;

 /**
 * Creates a new ClickHandler with the specified configuration.
 * This constructor is package-private and should only be called by ClickHandlerBuilder.
 * 
 * @param builder the configured builder containing handler properties
 * @throws IllegalArgumentException if builder or callback is null
 */
 ClickHandler(@NotNull ClickHandlerBuilder builder) {
 if (builder.callback == null) {
 throw new IllegalArgumentException("Callback cannot be null");
 }
 this.callback = builder.callback;
 this.allowedClickTypes = builder.allowedClickTypes != null ? 
 EnumSet.copyOf(builder.allowedClickTypes) : EnumSet.allOf(ClickType.class);
 this.autoCancel = builder.autoCancel;
 }

 /**
 * Handles the given inventory click event if it matches the configured filters.
 *
 * @param event the inventory click event to handle
 */
 public void handleClick(@NotNull InventoryClickEvent event) {

 // Check if the click type is allowed
 if (!allowedClickTypes.contains(event.getClick())) {
 return;
 }

 // Auto-cancel if configured
 if (autoCancel) {
 event.setCancelled(true);
 }

 // Execute the callback
 try {
 callback.accept(event);
 } catch (Exception e) {
 // Log the exception but don't rethrow to avoid breaking other handlers
 System.err.println("Error in ClickHandler callback: " + e.getMessage());
 }

 }

 /**
 * Creates a new ClickHandlerBuilder instance for constructing click handlers.
 * This is the recommended way to create new ClickHandler instances.
 * 
 * @return a new ClickHandlerBuilder ready for configuration
 */
 @Contract(" -> new")
 public static @NotNull ClickHandlerBuilder newBuilder() {
 return new ClickHandlerBuilder();
 }

 /**
 * Builder class for creating ClickHandler instances with a fluent API.
 * 
 * <p>This builder allows you to configure all aspects of a click handler before creation:
 * the callback function, allowed click types, and auto-cancellation behavior.</p>
 */
 public static class ClickHandlerBuilder {

 private Consumer<InventoryClickEvent> callback;
 private EnumSet<ClickType> allowedClickTypes;
 private boolean autoCancel = true;

 /**
 * Sets the callback function to execute when a click event is handled.
 * 
 * @param callback the consumer that will receive the click event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if callback is null
 */
 public ClickHandlerBuilder callback(@NotNull Consumer<InventoryClickEvent> callback) {
 this.callback = callback;
 return this;
 }

 /**
 * Sets which click types should be handled.
 * If not specified, all click types will be handled.
 * 
 * @param clickTypes the click types to handle
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder filter(@NotNull ClickType... clickTypes) {
 if (clickTypes == null || clickTypes.length == 0) {
 this.allowedClickTypes = EnumSet.allOf(ClickType.class);
 } else {
 this.allowedClickTypes = EnumSet.copyOf(Arrays.asList(clickTypes));
 }
 return this;
 }

 /**
 * Sets whether the event should be automatically cancelled before executing the callback.
 * Default is true.
 * 
 * @param autoCancel true to auto-cancel events, false otherwise
 * @return this builder instance for method chaining
 */
 public ClickHandlerBuilder autoCancel(boolean autoCancel) {
 this.autoCancel = autoCancel;
 return this;
 }

 /**
 * Builds and returns a new ClickHandler instance with the configured properties.
 * 
 * @return a new ClickHandler instance
 * @throws IllegalArgumentException if callback is not set
 */
 public ClickHandler build() {
 return new ClickHandler(this);
 }
 }
}

134 changes: 123 additions & 11 deletions
src/main/java/me/touchie771/minecraftGUI/api/Menu.java

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,14 +2,20 @@

import net.kyori.adventure.text.Component;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.function.Consumer;

/**
 * Represents a Minecraft GUI menu that can be displayed to players.
Expand All@@ -32,6 +38,7 @@ public class Menu {

 private final Inventory menu;
 private final HashSet<SlotItem> items;
 private final MenuClickHandler clickHandler;

 /**
 * Creates a new menu from the specified builder.
Expand All@@ -40,15 +47,29 @@ public class Menu {
 * @param builder the configured builder containing menu properties
 * @throws IllegalArgumentException if builder is null
 */
 public Menu(@NotNull MenuBuilder builder) {
 public Menu(@NotNull MenuBuilder builder, @NotNull Plugin plugin) {
 this.menu = Bukkit.createInventory(null, builder.inventorySize, builder.inventoryTitle);
 this.items = new HashSet<>(builder.items);
 this.clickHandler = new MenuClickHandler(this.menu, plugin.getLogger());

 // Copy click handlers from builder
 for (Map.Entry<Integer, ClickHandler> entry : builder.clickHandlers.entrySet()) {
 this.clickHandler.setClickHandler(entry.getKey(), entry.getValue());
 }

 // Set close handler from builder
 if (builder.closeHandler != null) {
 this.clickHandler.setCloseHandler(builder.closeHandler);
 }

 for (SlotItem item : items) {
 ItemStack itemStack = new ItemStack(item.material(), item.quantity());
 itemStack.editMeta(meta -> meta.displayName(item.itemName()));
 menu.setItem(item.itemSlot(), itemStack);
 }

 // Register event handlers
 registerEvents(plugin);
 }

 /**
Expand DownExpand Up@@ -126,17 +147,69 @@ public HashSet<SlotItem> getItems() {
 }

 /**
 * Returns the SlotItem at the specified slot position.
 * This is useful for handling inventory click events.
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position to check (0-53 for chest inventories)
 * @return the SlotItem at the specified slot, or null if the slot is empty
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public void onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandler.setClickHandler(slot, handler);
 }

 /**
 * Removes the click handler for the specified slot.
 * 
 * @param slot the slot position to remove the handler from
 */
 public void removeClickHandler(int slot) {
 clickHandler.removeClickHandler(slot);
 }

 /**
 * Gets the click handler for the specified slot.
 * 
 * @param slot the slot position
 * @return the ClickHandler for the slot, or null if none is registered
 */
 public @Nullable ClickHandler getClickHandler(int slot) {
 return clickHandler.getClickHandler(slot);
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 */
 public void onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 clickHandler.setCloseHandler(closeHandler);
 }

 /**
 * Removes the close handler.
 */
 public void removeCloseHandler() {
 clickHandler.removeCloseHandler();
 }

 /**
 * Registers this menu's event handlers with Bukkit.
 * This method is called automatically in the constructor.
 */
 private void registerEvents(Plugin plugin) {
 Bukkit.getPluginManager().registerEvents(clickHandler, plugin);
 }

 /**
 * Unregisters this menu's event handlers.
 * This method is automatically called when the inventory is closed to prevent memory leaks.
 * You only need to call this manually if you want to unregister events before closing the menu.
 */
 public SlotItem getItemAt(int slot) {
 return this.items.stream()
 .filter(item -> item.itemSlot() == slot)
 .findFirst()
 .orElse(null);
 public void unregisterEvents() {
 clickHandler.unregister();
 }

 /**
Expand DownExpand Up@@ -171,6 +244,14 @@ public static class MenuBuilder {
 private int inventorySize;
 private Component inventoryTitle;
 private final HashSet<SlotItem> items = new HashSet<>();
 private final Map<Integer, ClickHandler> clickHandlers = new HashMap<>();
 private Consumer<InventoryCloseEvent> closeHandler;
 private Plugin plugin;

 public MenuBuilder plugin(@NotNull Plugin plugin) {
 this.plugin = plugin;
 return this;
 }

 /**
 * Sets the size of the inventory.
Expand DownExpand Up@@ -244,7 +325,38 @@ public Menu build() {
 if (inventoryTitle == null) {
 throw new IllegalArgumentException("Inventory title cannot be null");
 }
 return new Menu(this);
 if (plugin == null) {
 throw new IllegalArgumentException("Plugin cannot be null");
 }
 return new Menu(this, plugin);
 }

 /**
 * Registers a click handler for the specified slot.
 * 
 * @param slot the slot position (0-53 for chest inventories)
 * @param handler the click handler to register
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if slot is invalid or handler is null
 */
 public MenuBuilder onClick(int slot, @NotNull ClickHandler handler) {
 if (slot < 0 || slot > 53) {
 throw new IllegalArgumentException("Slot must be between 0 and 53");
 }
 clickHandlers.put(slot, handler);
 return this;
 }

 /**
 * Sets a handler that will be called when the inventory is closed.
 * 
 * @param closeHandler the consumer that will receive the close event
 * @return this builder instance for method chaining
 * @throws IllegalArgumentException if closeHandler is null
 */
 public MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> closeHandler) {
 this.closeHandler = closeHandler;
 return this;
 }
 }
}
Loading