# 🦀 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. ---

🦀 **CrabPvPStats** — Made with ♥ for Minecraft Paper servers

Crab PvPStats

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

Stats GUI

CPSBanner