Crab PvPStats

# ? CrabPvPStats > **轻量级 Paper 1.21 PvP 统计插件** > *Lightweight Paper 1.21 PvP Statistics Plugin*

**中文** · [English](#english) ## ?? 中文 ### ? 简介 CrabPvPStats 是一款为 **Paper 1.21** 服务器打造的轻量级 PvP 统计插件。 使用 **SQLite** 存储数据，支持 **PlaceholderAPI**，自带 **开发者 API** 和 **多语言**。

⚡ 零依赖 仅需 sqlite-jdbc（已内置）

? 双语言 中文 + English 自动切换

? GUI /stats 图形界面

? PAPI 8 个占位符

? API 开发者集成接口

### ✨ 功能特性 | 功能 | 说明 | | -------------------- | ------------------------------------------------------------ | | ? **PvP 追踪** | `EntityDamageByEntityEvent` → `PlayerDeathEvent` 自动记录击杀/死亡 | | ? **KDR 排行** | 死亡为 0 时显示击杀数，SQL 排序确保 0 死亡排在前列 | | ?️ **图形界面** | 27 格 ChestInventory，击杀/死亡/KDR/连杀/最佳连杀一目了然 | | ? **PlaceholderAPI** | 4 种个人占位符 + 4 种排行榜占位符，30 秒缓存 | | ? **国际化** | 自动检测玩家客户端语言，内置中文和英文 | | ? **开发者 API** | `CrabPvPStatsAPI` 接口 + `StatsUpdateEvent` 事件 | | ?️ **SQLite 存储** | 无需外部数据库，`plugins/CrabPvPStats/data.db` | ### ? 文档导航 | 文档 | 说明 | | ------------------------------------------------------------ | -------------------------------- | | ? [**完整介绍**](https://github.com/ItzLittleCrab/PvPStats/blob/master/docs/README.md) | 功能详解、指令、权限、构建方式 | | ? [**配置参考**](https://github.com/ItzLittleCrab/PvPStats/blob/master/docs/config.md) | `config.yml` 配置项说明 | | ? [**占位符列表**](https://github.com/ItzLittleCrab/PvPStats/blob/master/docs/placeholders.md) | PlaceholderAPI 占位符完整列表 | | ? [**开发者 API**](https://github.com/ItzLittleCrab/PvPStats/blob/master/docs/API.md) | API 接入指南、接口方法、事件监听 | ### ⬇️ 下载 或将 JAR 放入 `plugins/` 目录后重启服务器。 ### ? 快速开始 ```bash # 构建插件 ./mvnw clean package # 输出文件 target/crabpvpstats-1.0.0.jar → 放入 plugins/ 目录 ``` 首次启动后编辑 `plugins/CrabPvPStats/config.yml` 配置语言和权限。 --- ## ?? English ### ? Overview CrabPvPStats is a lightweight **Paper 1.21** PvP statistics plugin. It uses **SQLite** for storage, supports **PlaceholderAPI**, and ships with a **developer API** and **built-in i18n**.

⚡ Zero Deps sqlite-jdbc shaded

? Bilingual 中文 + English

? GUI /stats inventory

? PAPI 8 placeholders

? API Developer interface

### ✨ Features | Feature | Description | | -------------------- | ------------------------------------------------------------ | | ? **PvP Tracking** | Auto-records kills/deaths via entity damage → death chain | | ? **KDR Ranking** | Deaths=0 displays kills count; SQL sort ensures fair ranking | | ?️ **GUI** | 27-slot ChestInventory with kills, deaths, KDR, killstreaks | | ? **PlaceholderAPI** | 4 personal + 4 leaderboard placeholders with 30s cache | | ? **i18n** | Auto-detects player locale; Chinese and English built-in | | ? **Developer API** | `CrabPvPStatsAPI` interface + `StatsUpdateEvent` | | ?️ **SQLite** | Zero external databases — stores in `plugins/CrabPvPStats/data.db` | ### ? Documentation | Doc | Description | | ------------------------------------------------------------ | ----------------------------------------- | | ? [**Full Guide**](https://github.com/ItzLittleCrab/PvPStats/blob/master/docs/README.md) | Features, commands, permissions, building | | ? [**Configuration**](https://github.com/ItzLittleCrab/PvPStats/blob/master/docs/config.md) | `config.yml` reference | | ? [**Placeholders**](https://github.com/ItzLittleCrab/PvPStats/blob/master/docs/placeholders.md) | Complete PAPI placeholder list | | ? [**Developer API**](https://github.com/ItzLittleCrab/PvPStats/blob/master/docs/API.md) | Integration guide & API reference | ### ⬇️ Download Or place the JAR in `plugins/` and restart the server. ### ? Quick Start ```bash # Build ./mvnw clean package # Output target/crabpvpstats-1.0.0.jar → place in plugins/ ``` Edit `plugins/CrabPvPStats/config.yml` after first run to configure language and permissions. ---