# ⚔️ 竞技场战斗
### 一个简单却 *性感* 的插件,用武器和 PvP 提升你的大厅体验!
---
## 💡 为什么选择 **竞技场战斗**?
✅ **易于使用**
✅ **基于社群(权限)发放的库存**
✅ **可以使用任何物品,任何插槽、物品标志或附魔!**
✅ **免费且开源**
✅ **针对性能进行了优化**
✅ **功能丰富**
💬 它是第一个拥有本地 PlaceholderAPI 支持的 **大厅 PvP 插件**!
💡 有什么想法?在 **[Discord](https://discord.smartshub.dev/)** 或 **GitHub** 上提出建议,我们可能会在下一个版本中添加它们!
---
## ✨ 功能
- 🔧 使用 **MiniMessage** 和 **PlaceholderAPI** 完全自定义 **物品名称和 Lore**。
- 🏷️ 内置 **占位符**:剩余时间、击杀数、死亡数、命中数。
- 🚀 轻量级且注重性能。
---
## 🔐 指令 & 占位符
- `/hubcombat reload` – 重新加载配置文件和玩家统计数据。需要 `hubcombat.admin` 权限。
### 📌 占位符:
- `%hubcombat_kills%`
- `%hubcombat_deaths%`
- `%hubcombat_hits%`
- `%hubcombat_kdr%`
- `%hubcombat_time_left%`
- `%hubcombat_is_in_combat%` (返回 "true" 或 "false")
---
## ⚙️ 安装 & 使用
1. 📥 将 `.jar` 文件放入你的 `/plugins` 文件夹中。
2. 🔁 重启服务器。
3. ✅ 默认使用 H2 数据库 — **无需任何设置**。
- 你可以切换到 **MySQL** 以支持多大厅。
4. 🗣️ 通过 `lang.yml` 自定义所有消息。
🛡️ 加入时,玩家会收到武器。PvP **仅在**武器装备配置时长后启用。
👊 没有武器的实体或玩家 **无法造成伤害** — 完全掌控大厅 PvP!
---
## 配置文件:
```
# 可用驱动程序: h2, mysql
# 如果你使用 h2,则不需要指定 host、port、db-name、
# username 和 password,因为 h2 是本地数据库。
database:
driver: h2
host: 101.101.101.101
port: 3306
db-name: hubcombat
username: userNaMeForHubCombat
password: passw0rD
timing:
give-weapon: 5
remove-weapon: 5
# 插件中的所有物品
# U 可以添加任意数量的装备组合! 还可以像复制粘贴“模板”一样,在装备组合中添加任意数量的物品
loadouts:
default:
permission: hubcombat.loadout.default
items:
- slot: 4
material: DIAMOND_SWORD
name: "默认剑"
lore:
- "基本的启动剑"
enchantments:
DAMAGE_ALL: 3
DURABILITY: 2
flags:
- HIDE_ENCHANTS
- HIDE_ATTRIBUTES
vip:
permission: hubcombat.loadout.vip
items:
- slot: 4
material: NETHERITE_SWORD
name: "VIP 剑"
lore:
- "仅限 VIP"
enchantments:
DAMAGE_ALL: 5
KNOCKBACK: 2
```
## 🛣️ 路线图
- 🗡️ 通过权限添加 **多个武器**。 **-> 已添加**
- 🛡️ 通过权限添加 **多个盔甲**。 **-> 已添加**
- 🧩 更多占位符 — 提出你的建议!
! 10% OFF](https://cdn.modrinth.com/data/cached_images/4c74ad9ba6fd010e16adf4bb361f98e15bd79209_0.webp)
# [Tect.host](https://tect.host/)