awamenu

AWAmenu - Minecraft Paper Multi-Functional Menu Plugin

中文版本

English Summary

AWAmenu is a powerful multi-functional menu plugin for Minecraft Paper servers that provides intuitive GUI interfaces for players to easily execute various commands and operations. It offers a comprehensive menu system with extensive customization options, sound effects, permission controls, and full version compatibility.

Description

AWAmenu is designed to enhance the player experience on Minecraft Paper servers by providing a sophisticated menu system that allows server administrators to create custom GUI menus for players. This plugin eliminates the need for players to remember complex commands and provides a user-friendly interface for accessing server features.

Key Features

- 🎯 Developer Friendly - Supports main menus, sub-menus, and complex menu hierarchies - 🎨 Developer Friendly - Customize menu content, items, commands, and layouts through YAML configuration - 🔊 Developer Friendly - Configurable open/close sound effects for better user experience - 🔄 Developer Friendly - Hot-reload configuration without server restart - 👥 Developer Friendly - Complete permission system with granular access controls - 🎮 Developer Friendly - Supports Paper 1.13+ and all modern Minecraft versions - ⚡ Developer Friendly - Lightweight and efficient with minimal server impact - 🔧 Developer Friendly - Easy to extend and integrate with other plugins

What Does This Plugin Add?

AWAmenu adds a comprehensive GUI menu system to your Minecraft server that allows: - Cross-version Support: Players can execute commands through intuitive GUI interfaces - Cross-version Support: Server administrators can create unlimited custom menus - Cross-version Support: Different menus can be restricted to specific permission groups - Cross-version Support: Menus can display dynamic information and conditional items - Cross-version Support: Works seamlessly across multiple Minecraft versions

Why Should Users Download It?

- Active Development: Makes server features accessible to all players regardless of technical knowledge - Active Development: Reduces the need for players to memorize complex commands - Active Development: Highly adaptable to fit any server theme or purpose - Active Development: Stable and well-tested with minimal performance impact - Active Development: Regular updates and community support

---

中文版本

AWAmenu - Minecraft Paper 多功能菜单插件

AWAmenu 是一个适用于 Minecraft Paper 服务器的多功能菜单插件，提供直观的GUI界面让玩家可以方便地执行各种命令和操作。

Installation

Installing to Server

1. Download the `AWAmenu-1.0.0.jar` file 2. Copy the JAR file to your server's `plugins` directory 3. Restart the server 4. The plugin will automatically generate default configuration files

---

安装方法

安装到服务器

1. 下载 `AWAmenu-1.0.0.jar` 文件 2. 将 JAR 文件复制到服务器的 `plugins` 目录 3. 重启服务器 4. 插件会自动生成默认配置文件

Usage

Basic Commands

- `/awamenu` or `/menu` - Open the default menu - `/awamenu <menu-name>` - Open a specific menu - `/awamenu open <menu-name>` - Open a specific menu - `/awamenu reload` - Reload configuration (requires permission) - `/awamenu list` - View available menu list (requires permission)

Permission Nodes

- `awamenu.use` - Basic permission to use menus (default for all players) - `awamenu.admin` - Administrator permissions (default for OPs) - `awamenu.*` - All permissions

---

使用方法

基本命令

- `/awamenu` 或 `/menu` - 打开默认菜单 - `/awamenu <菜单名称>` - 打开指定菜单 - `/awamenu open <菜单名称>` - 打开指定菜单 - `/awamenu reload` - 重载配置（需要权限） - `/awamenu list` - 查看可用菜单列表（需要权限）

权限节点

- `awamenu.use` - 使用菜单的基本权限（默认所有玩家拥有） - `awamenu.admin` - 管理员权限（默认OP拥有） - `awamenu.*` - 所有权限

Configuration

Configuration file is located at `plugins/AWAmenu/config.yml`

Main Configuration Options

```yaml

Plugin Settings

settings: default-menu: "main" # Default menu name enable-animations: true # Enable animations open-sound: "BLOCK_NOTE_BLOCK_PLING" # Open sound effect close-sound: "BLOCK_NOTE_BLOCK_BASS" # Close sound effect

Menu Configuration

menus:

Menu Name

main: title: "&6&lMain Menu" # Menu title size: 27 # Menu size (must be multiple of 9) items:

Slot number (0-53)

10: material: "ENDER_PEARL" # Item material name: "&b&lTeleport Menu" # Item name lore: # Item description - "&7Click to open teleport menu" commands: # Commands to execute - "awamenu teleport"

Message Configuration

messages: no-permission: "&cYou don't have permission to use this feature!" menu-not-found: "&cMenu not found!" menu-opened: "&aMenu opened successfully!" reload-success: "&aConfiguration reloaded successfully!" ```

Command Types

- Player Variables: `awamenu <menu-name>` - Open other menus - Player Variables: Execute commands as player - Player Variables: `console:<command>` - Execute commands as console - Player Variables: `{player}` - Will be replaced with player name

---

配置文件说明

配置文件位于 `plugins/AWAmenu/config.yml`

主要配置项

```yaml

插件设置

settings: default-menu: "main" # 默认菜单名称 enable-animations: true # 是否启用动画 open-sound: "BLOCK_NOTE_BLOCK_PLING" # 打开音效 close-sound: "BLOCK_NOTE_BLOCK_BASS" # 关闭音效

菜单配置

menus:

菜单名称

main: title: "&6&l主菜单" # 菜单标题 size: 27 # 菜单大小（必须是9的倍数） items:

槽位编号（0-53）

10: material: "ENDER_PEARL" # 物品材质 name: "&b&l传送菜单" # 物品名称 lore: # 物品描述 - "&7点击打开传送菜单" commands: # 执行的命令 - "awamenu teleport"

消息配置

messages: no-permission: "&c你没有权限使用此功能!" menu-not-found: "&c菜单不存在!" menu-opened: "&a菜单已打开!" reload-success: "&a配置重载成功!" ```

命令类型

- 玩家变量: `awamenu <菜单名称>` - 打开其他菜单 - 玩家变量: 直接执行玩家命令 - 玩家变量: `console:<命令>` - 以控制台身份执行命令 - 玩家变量: `{player}` - 会被替换为玩家名称

Default Menus

The plugin includes the following default menus:

1. Settings Menu (`main`) - Primary feature entry point 2. Settings Menu (`teleport`) - Quick teleportation features 3. Settings Menu (`tools`) - Get tools and items 4. Settings Menu (`info`) - View server information 5. Settings Menu (`settings`) - Time and weather settings

Custom Menus

To create custom menus, simply add new menu configurations in the `menus` section of the configuration file:

```yaml menus: my-custom-menu: title: "&d&lMy Custom Menu" size: 27 items: 10: material: "DIAMOND" name: "&b&lGive Me Diamonds" commands: - "give {player} diamond 64" 16: material: "EMERALD" name: "&a&lGive Me Emeralds" commands: - "give {player} emerald 64" ```

---

默认菜单

插件包含以下默认菜单：

1. 设置菜单 (`main`) - 主要功能入口 2. 设置菜单 (`teleport`) - 快速传送功能 3. 设置菜单 (`tools`) - 获取工具和物品 4. 设置菜单 (`info`) - 查看服务器信息 5. 设置菜单 (`settings`) - 时间和天气设置

自定义菜单

要创建自定义菜单，只需在配置文件的 `menus` 部分添加新的菜单配置：

```yaml menus: my-custom-menu: title: "&d&l我的自定义菜单" size: 27 items: 10: material: "DIAMOND" name: "&b&l给我钻石" commands: - "give {player} diamond 64" 16: material: "EMERALD" name: "&a&l给我绿宝石" commands: - "give {player} emerald 64" ```