# BOBSHOP
[](https://github.com/bilolib/BOBSHOP)
[](https://github.com/bilolib/BOBSHOP/blob/main/LICENSE.md)
[](https://modrinth.com/plugin/bobcase)
# Required Plugins
- 💰 [Vault](https://modrinth.com/plugin/vault) (required)
- Any Vault-compatible economy plugin (e.g. EssentialsX Economy, CMI, XConomy, iConomy, etc.)
## Notes
- External hologram plugins are no longer required.
- BOBShop now includes its **own built-in hologram system** for item and shop displays.
# Features
- 🛒 创建玩家商店，使用箱子或桶
- 📜 自动创建和更新告示牌（买/卖模式、价格、店主姓名、库存数量）
- 💰 完美集成 Vault 经济系统（支持所有 Vault 兼容的经济插件）
- 🪧 可定制的商店上方的全息图（物品预览 + 描述文本）
- 🏦 无限库存和特殊定价的管理员商店
- ⚙️ 可配置的设置（商店限制、创建成本、税率、货币格式等）
- 💾 带有自动备份的 SQLite 数据库
- 🔄 配置和语言文件重载支持
- 🌍 通过 `lang` 文件夹支持多种语言（例如，英语、土耳其语）
- 🪙 基于权限的税收折扣（例如，VIP 玩家支付更少的税）
- 🚫 保护：商店不能在没有适当权限的情况下被破坏或修改
- ✨ 内置的全息图系统（无需任何外部全息图插件）
# 如何安装
1. 从 [Modrinth 页面](https://modrinth.com/plugin/bobshop#download) 下载 **BOBShop** 的最新版本。
2. 将 `.jar` 文件放入服务器的 `plugins` 文件夹中。
3. 确保已安装所需的依赖项：
- 💰 [Vault](https://modrinth.com/plugin/vault)
- 一个 Vault 兼容的经济插件（例如 EssentialsX Economy, CMI Economy 等）
4. 重新启动你的服务器。
5. (可选) 编辑 `config.yml` 和 `plugins/BOBShop` 文件夹中的语言文件，以自定义商店限制、创建成本、税收、消息等。
6. 使用 `/bobshop reload` 应用配置或语言更改，无需重新启动服务器。
### ⚠️ 重要提示
**仅使用最新版本 (v3.0+)。**
- 此版本包含一个 **内置的看板全息图系统**—— **不再需要外部的全息图插件**了。
- 旧版本可能 **需要外部全息图插件**，它们的全息图可能在新的服务器上 **无法正常工作**。
- 为了获得最佳的稳定性和性能，**请勿使用旧版本**。
# 命令 & 权限
| 命令 / 节点 | 描述 | 权限 |
|:---------------------:|:---------------------------------------------|:------------------------|
| `/bobshop` | 打开插件设置菜单 | `bobshop.admin` |
| `/bobshop reload` | 重新加载插件配置和语言 | `bobshop.admin` |
| *(无命令)* | 授予 **20% 商店税收折扣** | `bobshop.tax.discount.20` |
| *(无命令)* | 授予 **完全免税 (0% 税)** | `bobshop.tax.free` |
📊 基于权限的税收乘数
`multipliers.tax_by_permission` 部分允许您 **调整或覆盖玩家的商店税收**，从而为具有特定权限的玩家提供服务。
### 示例 (`config.yml`)
```yaml
multipliers:
tax_by_permission:
"bobshop.tax.discount.20": 0.8
"bobshop.tax.free": 0.0
```
- 每个键是权限节点.
- 每个值是应用于税率百分比的乘数。
## 如何工作
- 如果玩家具有 bobshop.tax.discount.20 权限，他们的税收将乘以 0.8 → 他们支付 20% 少的税。
- 如果玩家具有 bobshop.tax.free 权限，他们的税收将乘以 0.0 → 他们不支付任何税款。
- 没有这些权限的玩家使用 config.yml 中定义的默认税值。
这让您可以通过简单地分配正确的权限来创建 VIP 等级、赞助者福利或工作人员豁免。
### 使用 LuckPerms 的示例
```
# 给玩家授予 20% 的税收折扣
/lp user Steve permission set bobshop.tax.discount.20 true
# 使玩家完全免税
/lp user Alex permission set bobshop.tax.free true
```
注意：目前仅提供基本的权限。
在未来的更新中将添加更详细和可定制的权限节点。
# 如何使用
## /bobshop
|
BOBShop 设置菜单
- 商店创建价格 – 设置玩家创建新市场所必须支付的成本。
- 全息图切换 – 启用或禁用商店物品的全息图显示。
- 描述切换 – 显示或隐藏商店上方的商品描述。
- 商店限制 – 设置玩家可以创建的最大商店数量。
|
## 如果您右键单击您自己的市场的告示牌
|
Market 菜单
- 更改价格 – 调整商店中物品的价格。
- 更改物品 – 更改目前正在商店销售的物品。
- 更改模式 – 切换市场之间买和卖模式。
- 描述 – ✨ 在商店全息图上方显示自定义浮动文本，以便为玩家提供有关您物品的更多信息。
|
## 如果您 **Shift + 右键单击** 任何市场的告示牌
|
Admin 菜单
Shift + 右键单击任何市场以打开 admin 菜单并管理其设置。
- "设置为 Admin 商店 – 使商店的物品无限量，所有进出金都归服务器所有。"
|
## 如何出售 & 购买 🛒💰
右键单击市场的告示牌 🪧，然后在聊天 💬 中输入您想要 **购买** 或 **出售** 的数量。
确认前请务必检查价格 💵！ ✅✨
## 注意
受 **快速商店 (QuickShop)** 启发创建此插件，添加了我自己的想法和功能。 由于我独自开发它，可能无法彻底测试所有内容，因此可能存在一些错误。
如果您遇到任何问题，我非常感谢您的反馈 — 请告诉我，我将尽力修复它们。 感谢您使用 **BobShop**!
## 其他插件
### [BOBCASE](https://modrinth.com/plugin/bobcase)
🎁 **BobCase** 是一款针对 Minecraft 的简单且可定制的箱子插件。
- 支持不同的箱子类型
- 完全可配置的奖励和机会
- 玩家和管理员都易于使用
