DonutShop - 甜甜圈商店插件

简介

DonutShop 是一款功能全面的商店插件，为您的 Minecraft 服务器提供丰富的商店系统。它集成了经济系统，拥有美观的交互界面，并支持高度自定义，让玩家可以轻松购买各类物品。

💡功能特色

• 多类别商店 - 包含末地、下界、装备和食物商店，每类商店提供独特的物品。
• 经济集成 - 无缝对接 Vault，支持所有交易。
• 交互式 GUI - 采用精美的 Unicode 风格商店界面。
• 高度可定制 - 可配置价格、提示信息和音效。
• 数量选择 - 玩家可在购买前调整购买数量。
• 音效反馈 - 为成功或失败的交易提供音频提示。
• 十六进制颜色支持 - 使用现代颜色代码，让消息更生动。

🎮命令与权限

命令列表

• /shop - 打开主商店 GUI。
• /donutshop - /shop 命令的别名。

权限节点

• donutshop.use - 允许使用 /shop 和 /donutshop 命令。默认所有玩家均拥有此权限。

✨前置需求

• Minecraft - 1.17+ 以获得完整功能。
• Java - 8 或更高版本。
• 服务端核心 - Spigot / Paper，版本 1.13+ 至 1.21+。
• Vault - 最新版本。
• 经济插件 - EssentialsX、CMI 或同类插件。

> 注意：运行在 1.13 至 1.16 版本的服务端，可能因缺少新版本的物品材料而导致部分功能受限。

🔧配置指南

颜色代码参考

在配置消息时，可使用 & 前缀来使用颜色代码，例如：

• &0 黑色 &1 深蓝 &2 深绿 &3 深青
• &4 深红 &5 深紫 &6 金色 &7 灰色
• &8 深灰 &9 蓝色 &a 绿色 &b 青色
• &c 红色 &d 亮紫 &e 黄色 &f 白色
• &l 粗体 &m 删除线 &n 下划线 &o 斜体

配置文件示例 (config.yml)

# GUI 标题
gui:
  main-shop-title: "ѕʜᴏᴘ"
  end-shop-title: "ѕʜᴏᴘ - ᴇɴᴅ"
  nether-shop-title: "ѕʜᴏᴘ - ɴᴇᴛʜᴇʀ"
  gear-shop-title: "ѕʜᴏᴘ - ɢᴇᴀʀ"
  food-shop-title: "ѕʜᴏᴘ - ꜰᴏᴏᴅ"

# 消息
messages:
  not-enough-money: "&cYou don't have enough money."
  inventory-full: "&cYour inventory is full."

# 音效
sounds:
  purchase-successful: "ENTITY_EXPERIENCE_ORB_PICKUP"
  purchase-successful-volume: 0.5
  purchase-unsuccessful: "ENTITY_VILLAGER_NO"
  click: "UI_BUTTON_CLICK"

# 价格示例
prices:
  enderchest: 2500
  blazerod: 150
  totemofundying: 1250
  steak: 35

商店类别与物品

• 末地商店：末影箱、末影珍珠、末地石、龙息、紫颂果、潜影壳。
• 下界商店：烈焰棒、下界疣、荧石粉、岩浆膏、恶魂之泪、石英。
• 装备商店：黑曜石、末地水晶、重生锚、不死图腾、金苹果、箭。
• 食物商店：马铃薯、甜浆果、胡萝卜、苹果、熟鸡肉、牛排、金胡萝卜。

⭐安装步骤

• 下载 DonutShop.jar 文件。
• 将其放入服务器的 plugins 文件夹。
• 确保已安装 Vault 及一款经济插件。
• 重启服务器。
• 根据需求自定义 config.yml 文件。
• 重载插件或重启服务器以使更改生效。

❓支持与故障排查

版本信息

• 当前版本：1.8
• API 版本：1.13+
• 作者：GamingHuzai

常见问题检查

如果您遇到问题，请确保

• 服务器 Minecraft 版本符合要求。
• 已正确安装 Vault 及一款经济插件。
• 配置文件 config.yml 使用了有效的 YAML 语法。
• 所有依赖插件均为最新版本。

© 2025 DonutShop Plugin - 保留所有权利

请提供您需要翻译的 Minecraft 插件文档原文，我将为您转换为清晰、结构化的简体中文版本。