# PlayerInfo

**Repository Path**: magic0610/player-info

## Basic Information

- **Project Name**: PlayerInfo
- **Description**: 玩家信息插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-13
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 玩家基础信息插件
### 目前已记录的值：
首次加入时间、上次加入时间、上次退出时间、上次（本次）在线时长、总在线时长、等级、经验、货币
### 服务器使用：
- 将插件放入plugins文件夹后重启服务器即可
- Spigot端和Bungee端都需要安装
### 开发者使用：
1. 将插件Jar作为依赖导入到你的项目
2. 获取API实例
```java
// 若是BC端插件
IApi iApi = new BungeeIApi;

// 若是Spigot插件
IApi iApi = new SpigotIApi;
```
3. 可以开始使用API操作玩家数据，所有的可用方法如下
```java
/**
 * 获取玩家的信息，自动转换为目标类型
 * 若不能确保玩家在线，则必须异步执行
 */
public <T> T get(UUID uuid, OperateKey key);
public <T> T get(String name, OperateKey key);

/**
 * 获取玩家的格式化信息
 * 若不能确保玩家在线，则必须异步执行
 */
public String getFromatted(UUID uuid, OperateKey key);
public String getFromatted(String name, OperateKey key);

/**
 * 设置玩家的数据
 * 可用：Level、Cash
 * 设置Level会重设经验至0
 * 需要操作数据库，请务必使用异步执行
 */
public void set(UUID uuid, OperateKey key, Object value);
public void set(String name, OperateKey key, Object value);

/**
 * 操作玩家的数据，在原值基础上增减
 * 可用：Level、Cash
 * 操作Level会重设经验至0
 * 需要操作数据库，请务必使用异步执行
 */
public void operate(UUID uuid, OperateKey key, Object value);
public void operate(String name, OperateKey key, Object value);

/**
 * 增加玩家的数据，在原值上增加
 * 可用：Exp
 * 会自动根据配置文件中的公式为玩家升级
 * 需要操作数据库，请务必使用异步执行
 */
public void add(UUID uuid, OperateKey key, Object value);
public void add(String name, OperateKey key, Object value);
```

### 注意：
严禁使用其他未开放到API中的方法！
插件底层复杂，涉及大量数据库操作与通信，
盲目使用未开放方法可能导致玩家数据丢失等严重后果！
若需要其他API方法请向开发者联系开放。