# 遊戲菜單
一個類似 Hypixel Skyblock 的 "Skyblock Menu" 的簡單 Minecraft 伺服器菜單插件。
完全可定制，您可以通過編輯 `config.yml` 檔案來定制此插件
## 目錄
- [介紹](#introduction)
- [功能](#features)
- [安裝](#installation)
- [配置](#configuration)
- [用法](#usage)
- [指令](#commands)
- [權限](#permissions)
- [貢獻](#contributing)
- [授權](#license)
- [感謝/捐贈](#thankyoudonations)
## 介紹
`GameMenu` 是一個為 Minecraft 伺服器設計的輕量級且用戶友好的插件。 它提供了一個可定制的菜單界面，供伺服器玩家使用，可以輕鬆導航和訪問伺服器的功能和指令。
## 功能
- 易於安裝和配置。
- 可定制的菜單項目和指令。
- [PREMIUM] 支援多個菜單頁面。
- 用戶友好的界面。
- 輕量級且高效。
## 安裝
要安裝 `GameMenu` 插件，請按照以下步驟操作：
1. **下載插件**: 從 [這裡](https://hangar.papermc.io/ItzLoghotXD/GameMenu) 下載 `GameMenu` 插件的最新版本。
2. **將插件添加到您的伺服器**:
- 將下載的 JAR 檔案放入您的 Minecraft 伺服器的 `plugins` 目錄中。
[注意 - 此插件可在 spigot 和 paper 伺服器上使用 (可能也適用於其他伺服器)]
3. **啟動伺服器**: 僅僅啟動您的 Minecraft 伺服器以加載插件。
4. **驗證安裝**: 伺服器啟動後，運行指令 `/plugins` 在伺服器控制台或遊戲中驗證插件是否加載。 您應該在已加載的插件列表中看到 `GameMenu`。
## 配置
`GameMenu` 插件附帶一個默認的配置檔案，您可以根據自己的喜好進行定制。 要配置插件：
1. 導航到 `plugins/GameMenu` 目錄。
2. 在文字編輯器中打開 `config.yml` 檔案。
3. 修改配置選項以滿足您的需求。 以下是默認配置：
```yaml
#
# 作者: Loghot (ItzLoghotXD)
# Wiki: https://github.com/ItzLoghotXD/GameMenu/wiki
# 版權所有 © ItzLoghotXD 2024-2024. 保留所有權利。
#--------
# 伺服器菜單項目
# 用於伺服器菜單的自定義項目，該菜單
# 存在於
# 玩家的熱條
#--------
# 伺服器菜單/GUI
# 當
# 玩家執行 'gm menu' 指令時打開的默認 gui
#--------
# 內置插件佔位符
# %player% - 返回玩家姓名
# %online% - 返回線上玩家數量
# %online_max% - 返回最大玩家槽數
# *** 使用 PLACEHOLDERAPI 獲取更多 ***
# (https://hangar.papermc.io/HelpChat/PlaceholderAPI)
#--------
# 內置特性
# 您可以使用 minecraft 顏色代碼
# 如 '&a' 代表綠色，您可以在此處找到所有
# 代碼 https://www.digminecraft.com/lists/color_list_pc.php
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# | 伺服器菜單項目設置 |
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
server_menu_item:
material: NETHER_STAR # 用於此自定義項目的材質。(您可以在此處找到所有物品名稱
# https://raw.githubusercontent.com/ItzLoghotXD/GameMenu/main/Materials.txt)
display_name: '&aServer Menu &7(Right Click)' # 此物品的顯示名稱
lore: # 此物品的 Lore(s)
- '&7檢視所有您的伺服器'
- '&7進度，包括你的技能,'
- '&7收藏、食譜等等！'
- ''
- '&e點擊打開'
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# | 伺服器菜單/GUI 設置 |
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
menu:
slots: 54 # gui 中的總槽數 (如果您輸入任何不能被 9 整除的數字
# 它會自動調整。最小有效數字是 9，最大是 54)
title: '&aServer Menu' # 此菜單的標題
items: # 您可以在這裡設置將在菜單中顯示的物品
# 一些示例物品
Report_Island_Name:
material: ANVIL # 用於此物品的顯示材質
slot: 8 # 物品將顯示的槽號
amount: 1 # 每個槽中的物品數量
glow: false # 物品是否發光
display_name: '&aReport Island Name' # 此物品的顯示名稱
lore: # 此物品的 Lore(s)
- '&7您可以報告這個島嶼'
- '&7如果您認為它有'
- '&7不適當的名稱.'
- ''
- '&e點擊報告它！'
commands: # 玩家右鍵/左鍵點擊時將執行的指令列表
# (它有一個內置的指令 'CLOSE'，如果之前在任何指令前放入 'CONSOLE: '
# 它可以作為控制台執行，否則作為玩家)
- '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'
- 'CONSOLE: say Visit me at modrinth: https://modrinth.com/plugin/game-menu'
- 'CONSOLE: say Visit me at spigot: https://www.spigotmc.org/resources/gamemenu.122426'
- 'CONSOLE: say or found any issue then report it here: https://github.com/ItzLoghotXD/GameMenu/issues'
Crafting_Table:
material: CRAFTING_TABLE
slot: 31
amount: 1
glow: false
display_name: '&aCrafting Table'
lore:
- '&7打開製作網格.'
- ''
- '&e點擊打開！'
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'
- 'CONSOLE: say Visit me at modrinth: https://modrinth.com/plugin/game-menu'
- 'CONSOLE: say Visit me at spigot: https://www.spigotmc.org/resources/gamemenu.122426'
- 'CONSOLE: say or found any issue then report it here: https://github.com/ItzLoghotXD/GameMenu/issues'
CLOSE:
material: BARRIER
slot: 49
display_name: '&4Close'
commands:
- 'CLOSE'
```
保存更改，然後通過在控制台或遊戲中鍵入 `/gamemenu reload` 指令來重新加載插件以應用新的配置。
## 用法
安裝和配置 `GameMenu` 插件後，所有玩家都可以通過在遊戲中執行 `/gamemenu menu` 指令或右鍵點擊時手持自定義 `server_menu_item` 來使用菜單。 這將打開帶有配置項目的伺服器菜單。
## 指令
`GameMenu` 插件提供以下指令：
* `/gamemenu` - 默認指令。
* 代替詞 - `/gm`
* 用法 - `/gamemenu <子指令>`
* `/gamemenu help` - 顯示每個指令的用法。
* `gamemenu menu` - 打開 `主菜單`。
* `gamemenu reload` - 重新加載插件
## 權限
`GameMenu` 插件使用以下權限：
* `gamemenu.command.gm` - 允許玩家使用默認指令。
* `gamemenu.command.help` - 允許玩家使用幫助子指令。
* `gamemenu.command.menu` - 允許玩家打開 `主菜單`
* `gamemenu.command.reload` - 允許玩家重新加載插件。
## 貢獻
歡迎貢獻 `GameMenu` 插件！ 如果您希望做出貢獻，請按照以下步驟操作：
1. 叉分該存儲庫。
2. 為您的功能或錯誤修復創建一個新的分支。
3. 進行更改並使用描述性消息提交它們。
4. 將您的更改推送到您的叉分庫。
5. 創建一個拉取請求到主存儲庫。
請確保您的代碼遵循項目的編碼標準，並且包含適當的測試。
## 授權
此項目使用 MIT 許可證授權。 請參閱 [授權](LICENSE) 檔案以了解更多信息。
# 感謝/捐贈
感謝您使用 `GameMenu`！ 如果您有任何問題或需要支持，請在 [GitHub 存儲庫](https://github.com/ItzLoghotXD/GameMenu/issues) 上提出問題。
我利用空閒時間來開發這個項目。 如果您願意，請通過加密貨幣以您想要的任何金額進行捐贈，以表示您的支持，並幫助我保持積極性以繼續進行此項目。 感謝您!
* 比特幣 (BTC) 地址: bc1qgarxwpp4rn3y5h8hwmhc6a5cpwzqqu3p5pun07
* 萊特幣 (LTC) 地址: LaHYbGK3ysnGQyC8PNmrFkZu3xvDfFQg14
* 以太幣 (ETH) 地址: 0xE842deFED402339F77637e95cD09d7b3820630ac
* 幣安智能鏈 (BSC) 地址: 0x5A425Abe60bd8B60D2ca1EE359C0461e6Cc92369
* 錢包 (SOL) 地址: HcXwLbebt7mvjc69we8jnQtBGSAcB9U5rnbAMQeRAdSD
* 狗狗幣 (DOGE) 地址: DKgToq8vnBHTgik3iQnm3r3r4mnqvXy4Um
