Aurora GUIs v1.1.0

import dev.aurora.Manager.GuiManager;

public class YourPlugin extends JavaPlugin {
    private GuiManager guiManager;

    @Override
    public void onEnable() {
        // Initialize the GUI manager
        guiManager = new GuiManager(this);

        getLogger().info("GuiManager initialized!");
    }

    public GuiManager getGuiManager() {
        return guiManager;
    }
}

import dev.aurora.GUI.AuroraGui;
import dev.aurora.Utilities.Items.ItemBuilder;
import org.bukkit.Material;
import org.bukkit.entity.Player;

public void createMenuGui() {
    AuroraGui menu = new AuroraGui("main-menu")
        .title("&6&lMain Menu")
        .rows(3);

    // Add a clickable item
    menu.addItem(13,
        new ItemBuilder(Material.DIAMOND)
            .name("&b&lClick Me!")
            .lore("&7This is a clickable item")
            .build(),
        event -> {
            Player player = (Player) event.getWhoClicked();
            player.sendMessage("§aYou clicked the diamond!");
        }
    );

    // Register the GUI
    menu.register(guiManager);
}

// Get and open the GUI
AuroraGui menu = guiManager.getGui("main-menu");
if (menu != null) {
    menu.open(player);
}

<repositories>
    <repository>
        <id>github</id>
        <url>https://maven.pkg.github.com/Unforgoten1/AuroraGuis</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>dev.aurora</groupId>
        <artifactId>AuroraGuis</artifactId>
        <version>1.1.0</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

repositories {
    maven {
        url = uri("https://maven.pkg.github.com/Unforgoten1/AuroraGuis")
    }
}

dependencies {
    implementation 'dev.aurora:AuroraGuis:1.1.0'
}

AuroraGui menu = new AuroraGui("main-menu")
    .title("&6&lMain Menu")
    .rows(3);  // 1-6 rows (9-54 slots)

// Add a border
menu.setBorder(BorderType.FULL,
    new ItemBuilder(Material.GRAY_STAINED_GLASS_PANE)
        .name("&7")
        .build()
);

// Add items to specific slots
menu.addItem(11, homeButton, this::handleHomeClick);
menu.addItem(13, shopButton, this::handleShopClick);
menu.addItem(15, settingsButton, this::handleSettingsClick);

// Register and open
menu.register(guiManager);
menu.open(player);

// Simple click handler
menu.addItem(13, item, event -> {
    Player player = (Player) event.getWhoClicked();
    player.sendMessage("§aClicked!");
});

// Advanced click handler
menu.addItem(14, item, event -> {
    event.setCancelled(true);  // Prevent item pickup
    Player player = (Player) event.getWhoClicked();

    // Handle different click types
    if (event.isLeftClick()) {
        // Left click action
    } else if (event.isRightClick()) {
        // Right click action
    } else if (event.isShiftClick()) {
        // Shift click action
    }
});

List<ItemStack> allItems = new ArrayList<>();
// Add 100 items...

// System automatically splits across pages
gui.addPaginatedItems(allItems, event -> {
    ItemStack clicked = event.getCurrentItem();
    Player player = (Player) event.getWhoClicked();
    player.sendMessage("§aClicked: " + clicked.getItemMeta().getDisplayName());
});

// Add navigation buttons
ItemStack prev = new ItemBuilder(Material.ARROW)
    .name("&ePrevious Page")
    .build();

ItemStack next = new ItemBuilder(Material.ARROW)
    .name("&eNext Page")
    .build();

gui.addItem(45, prev, e -> gui.prevPage());
gui.addItem(53, next, e -> gui.nextPage());

// Step 1: Enable packet support (once in onEnable)
guiManager.enablePacketSupport();

// Step 2: Create a PacketGui
PacketGui shop = new PacketGui("secure-shop")
    .title("&6Secure Shop")
    .rows(6)
    .validationLevel(ValidationLevel.PACKET)
    .addItem(13, createDiamondItem(), event -> {
        Player player = (Player) event.getWhoClicked();

        // This transaction is protected from duplication
        economy.withdraw(player, 1000);
        player.getInventory().addItem(new ItemStack(Material.DIAMOND, 64));
        player.sendMessage("§aPurchased 64 diamonds!");
    })
    .register(guiManager);

shop.open(player);

// Lenient - For trusted players
PacketGui gui = new PacketGui("shop")
    .config(PacketGuiConfig.lenient())
    .register(manager);

// Normal - Recommended default
PacketGui gui = new PacketGui("shop")
    .config(PacketGuiConfig.normal())
    .register(manager);

// Strict - Maximum security
PacketGui gui = new PacketGui("bank")
    .config(PacketGuiConfig.strict())
    .register(manager);

PacketGui shop = new PacketGui("shop")
    .validationLevel(ValidationLevel.ADVANCED)
    .onViolation((player, exploitType) -> {
        // Log violation
        plugin.getLogger().warning(
            player.getName() + " attempted " + exploitType
        );

        // Alert admins
        Bukkit.getOnlinePlayers().stream()
            .filter(p -> p.hasPermission("aurora.admin"))
            .forEach(admin -> admin.sendMessage(
                "§c" + player.getName() + " attempted " + exploitType
            ));

        // Take action based on severity
        int severity = exploitType.getSeverity();
        if (severity >= 5) {
            player.kickPlayer("§cExploit attempt detected.");
        } else if (severity >= 4) {
            player.sendMessage("§cWarning: Suspicious activity detected.");
        }
    })
    .register(manager);

import dev.aurora.Builder.VirtualGuiBuilder;
import dev.aurora.GUI.VirtualGui;

VirtualGui storage = new VirtualGuiBuilder(manager)
    .name("mega-storage")
    .title("&6&lMega Storage")
    .virtualRows(15)  // 135 total slots!
    .build();

// Add items using virtual slot numbers (0-134)
for (int i = 0; i < 100; i++) {
    storage.setItem(i, items.get(i), event -> {
        // Handle click
    });
}

// Open for player
storage.open(player);

Virtual Rows: 15
Total Virtual Slots: 135 (15 × 9)

Content Slots Per Page: 45 (rows 0-4, bottom row reserved for navigation)
Total Pages: 3 (⌈135 ÷ 45⌉)

Virtual Slot 0-44   → Page 1, Slots 0-44
Virtual Slot 45-89  → Page 2, Slots 0-44
Virtual Slot 90-134 → Page 3, Slots 0-44

ItemStack prevButton = new ItemBuilder(Material.ARROW)
    .name("&e« Previous")
    .build();

ItemStack nextButton = new ItemBuilder(Material.ARROW)
    .name("&eNext »")
    .build();

ItemStack indicator = new ItemBuilder(Material.PAPER)
    .name("&6Page {current}/{total}")
    .build();

VirtualGui gui = new VirtualGuiBuilder(manager)
    .virtualRows(12)
    .navigationButtons(prevButton, nextButton, indicator)
    .build();

// Open at first page
gui.open(player);

// Navigate to specific page
gui.navigateToPage(player, 2);  // Go to page 3 (0-indexed)

// Next/previous page
gui.nextPage(player);
gui.prevPage(player);

// Get current page
int currentPage = gui.getCurrentPage(player);

AuroraGui menu = new AuroraGui("animated-menu")
    .title("&6Animated Menu")
    .rows(3);

// Create pulsing animation
Animation pulsing = new PulsingBorder(3, 1);

// Add to slot 13 (center)
menu.addAnimation(13, pulsing);

menu.register(manager);
menu.open(player);

AuroraGui menu = new AuroraGui("multi-animated")
    .title("&6Multi-Animated Menu")
    .rows(5);

// Border pulse
menu.addAnimation(4, new PulsingBorder(3, 1));

// Rotating compass
menu.addAnimation(13, new RotatingCompass());

// Loading bar
menu.addAnimation(22, new LoadingBar(Direction.HORIZONTAL, 10));

menu.register(manager);
menu.open(player);

models:
  ruby:
    base-material: EMERALD
    custom-model-data: 1001
    name: "&cRuby"
    lore:
      - "&7A rare gemstone"
      - "&7Value: $1000"

  gold_coin:
    base-material: GOLD_NUGGET
    custom-model-data: 2001
    name: "&6Gold Coin"

  diamond_sword_custom:
    base-material: DIAMOND_SWORD
    custom-model-data: 3001
    name: "&b&lLegendary Sword"
    lore:
      - "&7Damage: +50"
      - "&7Durability: Infinite"

import dev.aurora.ResourcePack.ModelRegistry;

@Override
public void onEnable() {
    // Load models from configuration
    File modelsFile = new File(getDataFolder(), "models.yml");
    int loaded = ModelRegistry.loadFromConfig(modelsFile);

    getLogger().info("Loaded " + loaded + " custom models");
}

// Method 1: ItemBuilder.customModel()
ItemStack ruby = new ItemBuilder(Material.EMERALD)
    .customModel("ruby")  // Looks up from ModelRegistry
    .lore("&7Click to sell")
    .build();

// Method 2: Direct CustomModelData
ItemStack item = new ItemBuilder(Material.EMERALD)
    .customModelData(1001)
    .name("&cRuby")
    .build();

// Method 3: ModelRegistry.createItem()
ItemStack ruby = ModelRegistry.createItem("ruby");

import dev.aurora.ResourcePack.TitleBuilder;
import dev.aurora.ResourcePack.FontCharacters;

String title = new TitleBuilder()
    .icon(FontCharacters.STAR)
    .space(4)
    .text("&6&lPremium Shop")
    .space(4)
    .icon(FontCharacters.STAR)
    .center()
    .build();

AuroraGui gui = new AuroraGui("shop")
    .title(title)
    .rows(6)
    .register(manager);

import dev.aurora.Config.GuiConfigManager;

@Override
public void onEnable() {
    GuiManager guiManager = new GuiManager(this);

    // Initialize config-based GUI system
    GuiConfigManager configManager = new GuiConfigManager(this, guiManager);

    // Load all GUIs from guis/ folder
    int loaded = configManager.loadAllGuis();
    getLogger().info("Loaded " + loaded + " GUI(s) from configuration");

    // Auto-register commands
    int registered = configManager.registerCommands();
    getLogger().info("Registered " + registered + " command(s)");
}

gui:
  name: "shop"
  title: "&6&lItem Shop"
  rows: 6

  command: "shop"
  aliases: ["store", "market"]
  permission: "myplugin.shop"
  auto-register: true

  border:
    material: "GRAY_STAINED_GLASS_PANE"
    name: " "

  items:
    - slot: 13
      material: "DIAMOND"
      name: "&b&lDiamond"
      lore:
        - "&7Price: $100"
        - "&7Click to purchase"
      action: "close"

    - slot: 20
      material: "GOLD_INGOT"
      name: "&6&lGold"
      lore:
        - "&7Price: $50"
      actions:
        - type: "sound"
          sound: "ENTITY_PLAYER_LEVELUP"
          volume: 1.0
          pitch: 1.5
        - type: "message"
          message: "&aPurchase successful!"
        - type: "close"

import dev.aurora.Struct.Condition.ClickCondition;

gui.addItem(10, premiumItem, handler,
    ClickCondition.requirePermission("shop.premium")
        .and(ClickCondition.requireLeftClick())
        .and(ClickCondition.custom(p -> p.getLevel() >= 20))
);

// Built-in conditions:
ClickCondition.requirePermission("shop.vip")
ClickCondition.requireLeftClick()
ClickCondition.requireRightClick()
ClickCondition.requireShiftClick()
ClickCondition.requireItem()
ClickCondition.custom(player -> player.getLevel() >= 10)

import dev.aurora.Struct.Cooldown.ClickCooldown;

ClickCooldown cooldown = new ClickCooldown();
cooldown.setDefaultCooldown(1000); // 1 second

gui.addItem(13, rewardItem, event -> {
    Player player = (Player) event.getWhoClicked();

    if (cooldown.canClick(player)) {
        giveReward(player);
        cooldown.recordClick(player);
    } else {
        long remaining = cooldown.getRemainingCooldown(player);
        player.sendMessage("§cCooldown: " + (remaining / 1000) + "s");
    }
});