ARSALAN OFFICL

PROJECT: ROXMENU – ADVANCED GUI MENU PLUGIN

Develop a complete, professional and production-ready Minecraft Paper plugin inspired by the functionality and quality of DeluxeMenus and RoxMenu.

  1. DEVELOPMENT ENVIRONMENT
  • Language: Java 25
  • Build System: Maven
  • Server API: Latest compatible Paper API
  • Package: in.roxdevelopment.roxmenu
  • Plugin Name: RoxMenu
  • Author: RoxCreation
  • Version: 3.0.0
  • No unnecessary dependencies.
  • Use clean, modular and optimized code.
  1. GUI MENU SYSTEM
  • Unlimited custom GUI menus.
  • Create, delete, edit and open menus.
  • Configurable inventory sizes: 9, 18, 27, 36, 45 and 54.
  • Custom GUI titles.
  • Custom item icons.
  • Support all Minecraft materials and blocks.
  • Custom item names and lore.
  • HEX colors and MiniMessage support.
  • Enchantments and item flags.
  • Custom player heads.
  • Custom model data where supported.
  • Animated menu titles where practical.
  • Fill GUI with customizable materials.
  • Border GUI functionality.
  • Configurable empty slots.
  1. ITEM CLICK ACTIONS

Support:

  • Player commands.
  • Console commands.
  • Multiple commands per item.
  • Open another menu.
  • Close menu.
  • Play custom sounds.
  • Send messages.
  • Give items.
  • Permission checks.
  • Economy actions.
  • Conditional actions.
  1. COMMANDS

Implement fully working commands:

/rm help /rm version /rm about /rm reload /rm create /rm delete /rm list /rm open /rm edit /rm settitle /rm setsize /rm setitem /rm removeitem /rm setcommand /rm itemcmd /rm lore /rm setsound /rm fill /rm clear /rm sethanditem

Also support individual menu commands such as: /shopmenu /rankmenu /warpmenu

Menu commands must be configurable and automatically registered where supported.

  1. TAB COMPLETION
  • Complete every command.
  • Suggest online player names.
  • Suggest menu names.
  • Suggest valid Minecraft materials.
  • Suggest inventory sizes.
  • Suggest available sounds.
  • Suggest subcommands.
  • Provide intelligent context-based suggestions.
  1. PERMISSIONS AND SECURITY
  • Admin commands must require OP or roxmenu.admin.
  • Players can only open menus they are permitted to access.
  • Prevent unauthorized GUI manipulation.
  • Prevent menu item duplication exploits.
  • Validate all user inputs.
  1. CONFIGURATION FILES

Create:

  • config.yml
  • messages.yml
  • plugin.yml
  • menus/

Each menu must have its own YAML configuration file.

All messages, prefixes, sounds and GUI settings must be configurable.

  1. MESSAGE DESIGN
  • Prefix should display RoxMenu in purple.
  • No unnecessary square brackets.
  • No bold prefix.
  • Support HEX colors.
  • Clean, professional messages.
  • Detailed error messages.
  • Fully customizable messages.yml.
  1. PERFORMANCE
  • Optimize inventory click listeners.
  • Avoid unnecessary repeating tasks.
  • Avoid blocking the main server thread.
  • Properly unregister listeners and clean up resources.
  • Handle invalid configurations safely.
  • Support server restarts without losing menu data.
  1. PROJECT STRUCTURE

Use separate packages:

  • commands
  • managers
  • listeners
  • menus
  • items
  • actions
  • utils
  • config

Use separate classes for each major responsibility.

  1. QUALITY REQUIREMENTS
  • No dummy commands.
  • No placeholder implementations.
  • No fake features.
  • No missing event handlers.
  • No compilation errors.
  • No deprecated API unless absolutely necessary.
  • Handle exceptions properly.
  • Maintain compatibility with the target Paper API.
  1. BUILD AND DELIVERY
  • Generate the complete Maven project.
  • Include every Java source file.
  • Include all configuration files.
  • Include plugin.yml.
  • Build the final JAR.
  • Fix all Maven compilation errors.
  • Provide exact installation instructions.
  • Provide command documentation.
  • Explain how to configure custom menus.

IMPORTANT:

Do not stop after generating the project structure. Implement every requested feature completely. Build the project and verify that the JAR compiles successfully before declaring the project complete.

The final result must be a professional, stable and fully functional plugin developed by RoxCreation.

Kodari AI
KodariNov 11 at 8:16 am 3
RoxMenu
RoxMenu is a comprehensive GUI menu management plugin for Paper servers, offering unlimited custom menus with full configuration via YAML files. It supports dynamic inventory sizes, custom items with HEX colors and MiniMessage formatting, player heads, enchantments, and animated titles. The plugin includes a robust action system for player/console commands, menu navigation, sounds, messages, economy integration, and conditional permissions. Features complete command management with tab completion, configurable menu commands, and a secure permission system. All menus persist across restarts, with optimized performance and comprehensive admin tools for creating, editing, and managing menus in-game.
  • Set up the Maven/Paper project and configurable messages/default menu.

  • Implement menu loading, rendering, safe click handling, editing, and item actions.

  • Add the complete /rm command suite, permissions, tab completion, and configured menu commands.

Created the RoxMenu 3.0.0 Java 25 Maven project with Paper API support, configurable YAML menus, click actions, Vault economy actions, permission checks, admin commands, tab completion, and a sample menu at src/main/resources/menus/welcome.yml.

Commands: /rm help, /rm version, /rm about, /rm reload, /rm create, /rm delete, /rm list, /rm open, /rm edit, /rm settitle, /rm setsize, /rm setitem, /rm removeitem, /rm setcommand, /rm itemcmd, /rm lore, /rm setsound, /rm fill, /rm clear, and /rm sethanditem. Admin operations require OP or roxmenu.admin; players can open permitted menus.

To configure a menu command, set command: shopmenu in its YAML file. Menu commands are handled for players and included in tab suggestions. /rm edit <menu> opens the editor: left-click while holding an item to copy it into a slot; right-click to remove the slot. Menu titles are configurable, but animated titles are omitted because changing an inventory title requires reopening the menu.

Item actions support player:, console:, menu:, message:, sound:, give:, economy:withdraw:, economy:deposit:, if-permission:, and if-not-permission:. Economy actions require Vault and a registered economy provider.

Build and install: In Kodari, click Compile in the top bar (on phone: ⋮ → Compile Project), then click Compile in the window. Download the JAR when the build succeeds, place it in the server’s plugins folder, and restart the server.

ARSALAN OFFICL

Start

Kodari AI
KodariNov 11 at 8:24 am 1

Compile RoxMenu from Kodari: click Compile in the top bar, then click Compile in the window. When it succeeds, click Download and place the JAR in your server’s plugins folder, then restart the server.

Kodari can make mistakes. Review important code before using.
Files
src
pom.xml
Code
15 1,228
src/main/java/in/roxdevelopment/roxmenu/RoxMenuPlugin.java
package in.roxdevelopment.roxmenu;

import in.roxdevelopment.roxmenu.actions.ActionExecutor;
import in.roxdevelopment.roxmenu.commands.RoxMenuCommand;
import in.roxdevelopment.roxmenu.config.MessageService;
import in.roxdevelopment.roxmenu.listeners.MenuCommandListener;
import in.roxdevelopment.roxmenu.listeners.MenuListener;
import in.roxdevelopment.roxmenu.menus.MenuManager;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;

public final class RoxMenuPlugin extends JavaPlugin {
    private MessageService messages;
    private MenuManager menuManager;
    private ActionExecutor actionExecutor;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        if (!getDataFolder().exists() && !getDataFolder().mkdirs()) getLogger().severe("Unable to create plugin data folder.");
        saveResource("messages.yml", false);
        new java.io.File(getDataFolder(), "menus").mkdirs();
        messages = new MessageService(this);
        menuManager = new MenuManager(this);
        actionExecutor = new ActionExecutor(this);
        RoxMenuCommand command = new RoxMenuCommand(this);
        if (getCommand("rm") == null) {
            getLogger().severe("Command 'rm' is missing from plugin.yml; disabling.");
            getServer().getPluginManager().disablePlugin(this);
            return;
        }
        getCommand("rm").setExecutor(command);
        getCommand("rm").setTabCompleter(command);
        getServer().getPluginManager().registerEvents(new MenuListener(this), this);
        getServer().getPluginManager().registerEvents(new MenuCommandListener(this), this);
        getLogger().info("RoxMenu 3.0.0 enabled with " + menuManager.names().size() + " menu(s).");
    }

    @Override
    public void onDisable() {
        if (menuManager != null) menuManager.shutdown();
    }

    public MessageService messages() {
        return messages;
    }

    public MenuManager menuManager() {
        return menuManager;
    }

    public ActionExecutor actionExecutor() {
        return actionExecutor;
    }

    public boolean isAdmin(CommandSender sender) {
        return sender.isOp() || sender.hasPermission("roxmenu.admin");
    }

    public boolean isAdmin(Player player) {
        return isAdmin((CommandSender) player);
    }
}