PF-player_ip_logger

Player IP Logger for MCDReforged

Player IP Logger 是一款为 MCDReforged (MCDR) 开发的插件，主要功能是记录玩家的 IP 地址。该插件通过监控玩家的登录和断开连接事件，记录玩家对应的 IP 地址，并提供便捷的 API 供服务器管理员进行查询、封禁或解禁操作。

配置: 插件会自动生成一个 config.json 配置文件，存储用户和 IP 记录。文件格式如下：

{
    "users": {
        "玩家名称": [
            "玩家的IP1",
            "玩家的IP2"
        ]
    },
    "banned_player": [],
    "banned_ips": []
}

该插件支持以下日志格式的解析：

插件会自动运行并自动监听玩家的登录与断开事件，并记录 IP 地址，不需要任何配置。管理员可以快速对玩家或 IP 进行封禁或解禁操作，或者查看封禁列表。

is_player(name: str) -> bool
- 描述: 检查某个玩家是否存在于 IP 记录中。
- 参数:
  - name：玩家名称。
- 返回: 如果玩家存在记录返回 True，否则返回 False。
示例:
```
if is_player("Shusao"):
    print("Shusao 的 IP 已被记录。")
```
get_player_ips(name: str) -> list
- 描述: 获取指定玩家的所有 IP 地址。
- 参数:
  - name：玩家名称。
- 返回: 包含玩家所有历史 IP 地址的列表。如果玩家没有记录，返回空列表。
示例:
```
ips = get_player_ips("Shusao")
print(f"Shusao 的 IP 历史: {ips}")
```
get_player_names(ip: str) -> list
- 描述: 获取使用该 IP 地址的所有玩家名称。
- 参数:
  - ip：IP地址。
- 返回: 包含玩家名称的列表。
ban(src, ctx)
- 描述: 封禁指定玩家或 IP 地址。
- 参数:
  - 玩家ID 或 IP 地址。
pardon(src, ctx)
- 描述: 解禁指定玩家或 IP 地址。
- 参数:
  - 玩家ID 或 IP 地址。

用于区分真实玩家

如果发现问题，或希望贡献代码，欢迎在 GitHub 提交 Issue 或 Pull Request。

欢迎提建议！