🦀 CrabPvPStats

轻量级 Paper 1.21 PvP 统计插件
Lightweight Paper 1.21 PvP Statistics Plugin

中文 · 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

📖 文档导航

文档	说明
📕 完整介绍	功能详解、指令、权限、构建方式
🔧 配置参考	config.yml 配置项说明
🔣 占位符列表	PlaceholderAPI 占位符完整列表
🧩 开发者 API	API 接入指南、接口方法、事件监听

⬇️ 下载

或将 JAR 放入 plugins/ 目录后重启服务器。

🚀 快速开始

# 构建插件
./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	Features, commands, permissions, building
🔧 Configuration	config.yml reference
🔣 Placeholders	Complete PAPI placeholder list
🧩 Developer API	Integration guide & API reference

⬇️ Download

Or place the JAR in plugins/ and restart the server.

🚀 Quick Start

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

---