转载 闭源 工具 游戏菜单 1.1.4

[MD]
# 游戏菜单

GameMenu 是一款简洁的 Minecraft 服务端菜单插件，类似 Hypixel SkyBlock 的“SkyBlock Menu”。

插件支持高度自定义，可通过编辑 `config.yml` 进行配置。

## 目录

- [Introduction](#introduction)
- [Features](#features)
- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
- [Commands](#commands)
- [Permissions](#permissions)
- [Contributing](#contributing)
- [License](#license)
- [Thankyou](#thankyoudonations)

## 简介

`GameMenu` 是一款轻量、易用的 Minecraft 服务端插件。它为玩家提供可自定义的菜单界面，方便玩家快速访问服务器功能与执行命令。

## 功能

- 安装和配置简单。
- 可自定义菜单物品及其执行的命令。
- **暂未提供**：高级版多页菜单支持。
- 界面直观，易于使用。
- 轻量高效，对服务器性能影响较小。

## 安装

按照以下步骤安装 `GameMenu` 插件：

1. **下载插件**
从 [here]([https://hangar.papermc.io/ItzLoghotXD/GameMenu](https://hangar.papermc.io/ItzLoghotXD/GameMenu) )、[here]([https://modrinth.com/plugin/game-menu](https://modrinth.com/plugin/game-menu) )、[here]([https://www.spigotmc.org/resources/...//www.spigotmc.org/resources/gamemenu.122426) ) 或 [here]([https://github.com/ItzLoghotXD/GameMenu/releases](https://github.com/ItzLoghotXD/GameMenu/releases) ) 下载最新版本的 `GameMenu` 插件。

2. **将插件加入服务器**
将下载的 JAR 文件放入 Minecraft 服务端的 `plugins` 目录中。

> 该插件可在 Spigot 和 Paper 服务端上运行，也可能兼容其他服务端核心。

3. **启动服务器**
启动 Minecraft 服务端以加载插件。

4. **验证安装**
服务端启动后，在控制台或游戏内执行 `/plugins`。如果已加载成功，已加载插件列表中应显示 `GameMenu`。

## 配置

`GameMenu` 插件自带默认配置文件，可根据服务器需求进行调整。

1. 打开 `plugins/GameMenu` 目录。
2. 使用文本编辑器打开 `config.yml` 文件。
3. 按需修改配置选项。默认配置如下：

```yaml
#
# AUTHOR: Loghot (ItzLoghotXD)
# WIKI:[https://github.com/ItzLoghotXD/GameMenu/wiki](https://github.com/ItzLoghotXD/GameMenu/wiki)
# Copyright (c) ItzLoghotXD 2024-2024. All rights reserved.
#--------
# SERVER MENU ITEM
# The custom item which is used for
# server menu which is present in
# player's hotbar
#--------
# SERVER MENU/GUI
# The default gui which is opens when
# player execute 'gm menu' command
#--------
# BUILT IN PLUGIN PLACEHOLDERS
# %player% - Returns player name
# %online% - Returns number of players online
# %online_max% - Returns number of max player slots
# *** USE PLACEHOLDERAPI TO GET MORE ***
# ([https://hangar.papermc.io/HelpChat/...://hangar.papermc.io/HelpChat/PlaceholderAPI) )
#--------
# BUILT-IN FEATURES
# You can use minecraft color codes
# like '&a' for green you can find all
# code here[https://www.digminecraft.com/lists/...www.digminecraft.com/lists/color_list_pc.php)
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# | SERVER MENU ITEM SETTINGS |
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
server_menu_item:
material: NETHER_STAR # The material which is use for this custom item. (you can find all item names here
#[https://raw.githubusercontent.com/I....com/ItzLoghotXD/GameMenu/main/Materials.txt) )
display_name: '&aServer Menu &7(Right Click)' # The display name of this item
lore: # Lore(s) of this item
- '&7This will open a GUI.'
- '&7You can see items there'
- '&7and interact with them!'
- '&7edit this in config.yml'
- ''
- '&eClick to open'
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# | SERVER MENU/GUI SETTINGS |
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
menu:
slots: 9 # Total number of slots in the gui (if you enter any number which is not divisible by 9
# it will auto adjust it. minimum valid number is 9 and maximum is 54)
title: '&6Server Menu' # The title of this menu
items: # You can set items here which will be in the menu
# Some example items
Report_Island_Name:
material: DIAMOND_BLOCK # The material which will be displayed in the menu for this item
slot: 0 # The number of slot in which the item will be (starts from index 0)
amount: 1 # The Amount of items in a slot
glow: false # Whether the item glow or not
display_name: '&aDIAMONDS' # The display name of this item
lore: # Lore(s) of this item
- '&7Give you some Diamonds!'
- '&7This is just for example'
- '&7change this in config'
- ''
- '&eClick to get!'
commands: # The list of commands which will be executed when the player will right/left click on it
# (It has a built-in command 'CLOSE' which will close the menu and if you put 'CONSOLE: ' in before
# any command it will execute it as console else player)
- 'CONSOLE: give %player% diamond'
Crafting_Table:
material: CRAFTING_TABLE
slot: 4
amount: 1
glow: true
display_name: '&aCrafting Table'
lore:
- '&7Opens the Crafting Grid.'
- ''
- '&7(Will not actually open a'
- '&7crafting grid, just for'
- '&7example) edit in config'
- ''
- '&eClick to open!'
commands:
- 'CONSOLE: say edit the config.yml file in the plugin/GameMenu folder'
- 'CONSOLE: say Visit me at paper hangar:[https://hangar.papermc.io/ItzLoghotXD/GameMenu](https://hangar.papermc.io/ItzLoghotXD/GameMenu) '
- 'CONSOLE: say Visit me at modrinth:[https://modrinth.com/plugin/game-menu](https://modrinth.com/plugin/game-menu) '
- 'CONSOLE: say Visit me at spigot:[https://www.spigotmc.org/resources/...//www.spigotmc.org/resources/gamemenu.122426) '
- 'CONSOLE: say or found any issue then report it here:[https://github.com/ItzLoghotXD/GameMenu/issues](https://github.com/ItzLoghotXD/GameMenu/issues) '
CLOSE:
material: BARRIER
slot: 8
display_name: '&4Close'
commands:
- 'CLOSE'
```

保存修改后，在控制台执行 `/gamemenu reload` 重载插件，使新配置生效。

## 使用方法

安装并配置 `GameMenu` 后，所有玩家均可在游戏内执行 `/gamemenu menu` 打开菜单。

玩家也可以手持自定义的 `server_menu_item` 并右键使用，以打开包含已配置物品的服务器菜单。

## 命令

`GameMenu` 插件提供以下命令：

- `/gamemenu`：默认命令。
- 别名：`/gm`
- 用法：`/gamemenu <subcommand>`
- `/gamemenu help`：显示所有命令的用法说明。
- `gamemenu menu`：打开 `Main menu`。
- `gamemenu reload`：重载插件。

## 权限

`GameMenu` 插件使用以下权限节点：

- `gamemenu.command.gm`：允许玩家使用默认命令。
- `gamemenu.command.help`：允许玩家使用帮助子命令。
- `gamemenu.command.menu`：允许玩家打开 `Main menu`。
- `gamemenu.command.reload`：允许玩家重载插件。

## 参与开发

欢迎为 `GameMenu` 插件贡献代码。参与开发可按以下流程进行：

1. Fork 项目仓库。
2. 为新功能或 Bug 修复创建分支。
3. 完成修改，并使用清晰的提交信息进行提交。
4. 将分支推送至自己的 Fork 仓库。
5. 向主仓库创建 Pull Request。

请确保代码符合项目的编码规范，并包含必要的测试。

## 许可证

本项目采用 MIT License 许可证，详情请参阅 [LICENSE](LICENSE) 文件。
[/MD]