IPDynamic
适用于 Minecraft 服务器的先进 IP 追踪与小号检测系统
概述
IPDynamic 是一款强大的安全插件,帮助服务器管理员精准追踪玩家连接、检测小号账号,并管理基于 IP 的封禁。
IPDynamic 采用现代技术从头构建,提供 零 TPS 影响、用于可靠数据存储的 SQLite 数据库,以及一个 细粒度的权限系统,让你完全掌控工作人员的访问权限。
功能
? IP 追踪
记录每一次玩家连接的完整详情:
- IP 地址和国家/地区(GeoIP)
- 首次和上次连接的时间戳
- 总连接次数
- 每个玩家的完整 IP 历史记录
? 小号检测
通过分析共享 IP 智能检测小号账号:
- 交叉比对所有玩家的 IP 历史记录
- UUID + 用户名验证以确保准确性
- 支持在线模式和离线模式服务器
- 查看与任何 IP 关联的所有账号
? IP 段封禁
两种灵活且易于理解的封禁模式:
| 模式 | 规则示例 | 封禁 IP 数量 |
|---|---|---|
| OP1 | 192.168.1.* |
~256 个 IP |
| OP2 | 192.168.*.* |
~65,536 个 IP |
- 临时或永久封禁
- 自定义封禁理由
- 自动清理过期的封禁
- 为被封禁玩家提供美观的断开连接界面
✅ 白名单系统
允许受信任的玩家绕过 IP 封禁:
- Mojang API UUID 验证
- 即使玩家更改用户名也能正常工作
- 添加白名单时可填写可选理由
? GeoIP 集成
使用免费的 GeoIP 服务自动检测每次连接的国家/地区。
⚡ 性能优化
- SQLite 数据库 启用 WAL 模式
- 通过 Kotlin Coroutines 实现 异步操作
- 内存缓存 实现即时查找
- 零 TPS 影响 - 保证无性能损耗
? 完全可定制
messages.yml 中的每条消息均可自定义:
- 封禁界面
- 命令响应
- 所有插件消息
- 完整支持颜色代码
? 细粒度权限
为你的工作人员提供所需的精确访问权限:
- 10+ 项独立权限
- 按命令控制访问权限
- Tab 补全尊重权限设置
命令
基础命令: /ipdynamic (别名: /ipdy, /ipd)
信息查询
| 命令 | 描述 |
|---|---|
/ipdy check <player> |
查看玩家完整档案 |
/ipdy history <player> |
查看连接历史 |
/ipdy alts <player> |
列出检测到的小号账号 |
/ipdy ip <address> |
根据 IP 查找账号 |
/ipdy stats |
查看插件统计信息 |
封禁管理
| 命令 | 描述 |
|---|---|
/ipdy ban <op1|op2> <ip> [reason] [duration] |
封禁 IP 段 |
/ipdy unban <pattern> |
移除封禁 |
/ipdy banlist |
查看活跃封禁列表 |
持续时间示例: 30m(30分钟), 12h(12小时), 7d(7天), 4w(4周)(无持续时间 = 永久)
白名单
| 命令 | 描述 |
|---|---|
/ipdy whitelist add <player> [reason] |
添加到白名单 |
/ipdy whitelist remove <player> |
从白名单移除 |
/ipdy whitelist list |
查看白名单玩家 |
管理
| 命令 | 描述 |
|---|---|
/ipdy reload |
重新加载配置 |
/ipdy help |
显示帮助菜单 |
权限
ipdynamic.* # 完全访问权限(默认:op)
# 信息查询(适用于 Moderators)
ipdynamic.check # /ipdy check
ipdynamic.history # /ipdy history
ipdynamic.alts # /ipdy alts
ipdynamic.ip # /ipdy ip
# 封禁管理(适用于 Admins)
ipdynamic.ban # /ipdy ban
ipdynamic.unban # /ipdy unban
ipdynamic.banlist # /ipdy banlist
# 白名单管理
ipdynamic.whitelist # /ipdy whitelist (add/remove/list)
# 系统
ipdynamic.stats # /ipdy stats
ipdynamic.reload # /ipdy reload
示例设置 (LuckPerms)
Moderators - 仅查询访问:
/lp group mod permission set ipdynamic.check true
/lp group mod permission set ipdynamic.history true
/lp group mod permission set ipdynamic.alts true
/lp group mod permission set ipdynamic.ip true
Admins - 完全访问:
/lp group admin permission set ipdynamic.* true
安装
- 下载
IPDynamic.jar - 放入服务器的
/plugins文件夹 - 重启服务器
- 如需自定义,请配置
messages.yml - 为工作人员设置权限
就这么简单! 数据库会自动创建。
配置
messages.yml
所有插件消息均可自定义:
prefix: "&b&lIPDynamic &8|- "
ban-screen:
lines:
- "&c&lIPDynamic &8|- &fIP Range Ban"
- ""
- "&7Your IP has been banned from this server."
- "&7IP Address: &f{ip}"
- "&7Banned Range: &c{pattern}"
- "&7Reason: &f{reason}"
- "&7Duration: &f{duration}"
commands:
no-permission: "&cYou don't have permission."
player-not-found: "&cPlayer not found in database."
# ... 完全可自定义
可用占位符
| 占位符 | 描述 |
|---|---|
{player} |
玩家名称 |
{ip} |
IP 地址 |
{pattern} |
封禁规则 |
{reason} |
封禁理由 |
{banned_by} |
谁执行的封禁 |
{banned_date} |
封禁日期 |
{duration} |
封禁时长 |
{expires} |
过期日期 |
{country} |
国家/地区 |
{count} |
数量(封禁数、小号数等) |
要求
| 要求 | 版本 |
|---|---|
| Minecraft | 1.17.x - 1.21.x |
| 服务端 | Paper 或 Spigot |
| Java | 17 或更高 |
技术细节
- 语言: Kotlin 1.9
- 数据库: 启用 WAL 模式的 SQLite
- 异步处理: 使用 MCCoroutine for Bukkit
- 架构: 清晰、易维护的代码
数据库
IPDynamic 使用 SQLite 进行可靠的数据存储:
- 自动创建数据库结构
- 自适应更新(无需手动迁移)
- 启用 WAL 模式以获得更好的性能
- 所有数据存储在
plugins/IPDynamic/ipdynamic.db中
支持
- 问题反馈: 在 GitHub 上报告 Bug
- 提问: 留下评论或发起讨论
路线图
- 支持 1.13.x - 1.16.x
- Discord Webhook 通知
- Web 管理面板
- 从其他插件导入数据
使用 IPDynamic 保护你的服务器。
如果你觉得这个插件有用,请考虑留下评论!
IPDynamic
Advanced IP Tracking & Alt Detection System for Minecraft Servers
Overview
IPDynamic is a powerful security plugin that helps server administrators track player connections, detect alt accounts, and manage IP-based bans with precision.
Built from the ground up with modern technologies, IPDynamic offers zero TPS impact, a SQLite database for reliable data storage, and a granular permission system that gives you full control over staff access.
Features
? IP Tracking
Every player connection is recorded with complete details:
- IP address and country (GeoIP)
- First and last connection timestamps
- Total connection count
- Complete IP history per player
? Alt Detection
Intelligently detect alt accounts by analyzing shared IPs:
- Cross-references all player IP histories
- UUID + Username verification for accuracy
- Works on both online and offline mode servers
- View all accounts associated with any IP
? IP Range Banning
Two flexible and easy-to-understand ban modes:
| Mode | Pattern | IPs Blocked |
|---|---|---|
| OP1 | 192.168.1.* |
~256 IPs |
| OP2 | 192.168.*.* |
~65,536 IPs |
- Temporary or permanent bans
- Custom ban reasons
- Automatic expired ban cleanup
- Beautiful disconnect screen for banned players
✅ Whitelist System
Allow trusted players to bypass IP bans:
- Mojang API UUID verification
- Works even if players change usernames
- Add optional reasons when whitelisting
? GeoIP Integration
Automatic country detection for every connection using free GeoIP services.
⚡ Performance Optimized
- SQLite database with WAL mode
- Async operations via Kotlin Coroutines
- In-memory caching for instant lookups
- Zero TPS impact - guaranteed
? Fully Customizable
Every message can be customized in messages.yml:
- Ban screens
- Command responses
- All plugin messages
- Full color code support
? Granular Permissions
Give your staff exactly the access they need:
- 10+ individual permissions
- Per-command access control
- Tab completion respects permissions
Commands
Base command: /ipdynamic (aliases: /ipdy, /ipd)
Information
| Command | Description |
|---|---|
/ipdy check <player> |
View complete player profile |
/ipdy history <player> |
View connection history |
/ipdy alts <player> |
List detected alt accounts |
/ipdy ip <address> |
Find accounts by IP |
/ipdy stats |
View plugin statistics |
Ban Management
| Command | Description |
|---|---|
/ipdy ban <op1|op2> <ip> [reason] [duration] |
Ban an IP range |
/ipdy unban <pattern> |
Remove a ban |
/ipdy banlist |
View active bans |
Duration examples: 30m, 12h, 7d, 4w (no duration = permanent)
Whitelist
| Command | Description |
|---|---|
/ipdy whitelist add <player> [reason] |
Add to whitelist |
/ipdy whitelist remove <player> |
Remove from whitelist |
/ipdy whitelist list |
View whitelisted players |
Administration
| Command | Description |
|---|---|
/ipdy reload |
Reload configuration |
/ipdy help |
Display help menu |
Permissions
ipdynamic.* # Full access (default: op)
# Information (for Moderators)
ipdynamic.check # /ipdy check
ipdynamic.history # /ipdy history
ipdynamic.alts # /ipdy alts
ipdynamic.ip # /ipdy ip
# Ban Management (for Admins)
ipdynamic.ban # /ipdy ban
ipdynamic.unban # /ipdy unban
ipdynamic.banlist # /ipdy banlist
# Whitelist Management
ipdynamic.whitelist # /ipdy whitelist (add/remove/list)
# System
ipdynamic.stats # /ipdy stats
ipdynamic.reload # /ipdy reload
Example Setup (LuckPerms)
Moderators - Query access only:
/lp group mod permission set ipdynamic.check true
/lp group mod permission set ipdynamic.history true
/lp group mod permission set ipdynamic.alts true
/lp group mod permission set ipdynamic.ip true
Admins - Full access:
/lp group admin permission set ipdynamic.* true
Installation
- Download
IPDynamic.jar - Place in your server's
/pluginsfolder - Restart your server
- Configure
messages.ymlif desired - Set up permissions for your staff
That's it! The database is created automatically.
Configuration
messages.yml
All plugin messages are customizable:
prefix: "&b&lIPDynamic &8|- "
ban-screen:
lines:
- "&c&lIPDynamic &8|- &fIP Range Ban"
- ""
- "&7Your IP has been banned from this server."
- "&7IP Address: &f{ip}"
- "&7Banned Range: &c{pattern}"
- "&7Reason: &f{reason}"
- "&7Duration: &f{duration}"
commands:
no-permission: "&cYou don't have permission."
player-not-found: "&cPlayer not found in database."
# ... fully customizable
Available Placeholders
| Placeholder | Description |
|---|---|
{player} |
Player name |
{ip} |
IP address |
{pattern} |
Ban pattern |
{reason} |
Ban reason |
{banned_by} |
Who banned |
{banned_date} |
Ban date |
{duration} |
Ban duration |
{expires} |
Expiration date |
{country} |
Country |
{count} |
Count (bans, alts, etc.) |
Requirements
| Requirement | Version |
|---|---|
| Minecraft | 1.17.x - 1.21.x |
| Server | Paper or Spigot |
| Java | 17 or higher |
Technical Details
- Language: Kotlin 1.9
- Database: SQLite with WAL mode
- Async: MCCoroutine for Bukkit
- Architecture: Clean, maintainable code
Database
IPDynamic uses SQLite for reliable data storage:
- Automatic schema creation
- Auto-adaptive updates (no manual migration)
- WAL mode for better performance
- All data in
plugins/IPDynamic/ipdynamic.db
Support
- Issues: Report bugs on GitHub
- Questions: Leave a comment or open a discussion
Roadmap
- Support for 1.13.x - 1.16.x
- Discord webhook notifications
- Web management panel
- Data import from other plugins
Protect your server with IPDynamic.
If you find this plugin useful, please consider leaving a review!
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IPDynamic
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
范围封禁虽然威力强大,但单个 192.168.*.* 这样的地址段可能会悄无声息地误伤数十名合法玩家。此版本让你能够在执行范围封禁之前,确切地查看该范围会波及哪些人。/ipdy ip 命令现在支持通配符,并会按国家分组显示范围内的所有账号。
⭐ 新功能:通配符范围查询
/ipdy ip <ip> 现在接受末尾的通配符,用于检查整个地址段而非单个 IP 地址:
/ipdy ip 190.1.2.3 — 单个 IP → 精确查询(GeoIP + VPN + 账号),保持不变
/ipdy ip 190.1.2.* — /24 范围(256 个 IP)→ 该块内的每个账号
/ipdy ip 190.1.*.* — /16 范围(65,536 个 IP)→ 该块内的所有跨区账号
/ipdy ip 190.*.*.* — /8 范围(1670 万个 IP)→ 该块内的所有跨区账号
每次范围查询都会报告以下内容:
? 它覆盖的确切范围(例如 190.1.2.0 – 190.1.2.255)
? 将受影响的账号数量,以及涉及的不同 IP 数量
? 国家分布情况 — 例如 美国: 8, 德国: 4, 智利: 2 — 以便你发现当范围跨越地区时是否会捕获无关的玩家
?️ 一个可点击的分页账号列表 — 点击名字可查看其精确查询结果
为何重要:先运行范围查询作为预览(/ipdy ip 127.0.0.*),阅读它会触及的人和事物,然后再决定是否执行 /ipdy ban。不再有无视后果的范围封禁导致误伤真实玩家。
提示:添加页码以浏览长结果 → /ipdy ip 190.1.*.* 2
? 安全性与可靠性
HTTPS 上的 GeoIP 服务 — 玩家 IP 地址(个人身份信息)不再以明文形式发送给地理位置提供商。默认开启,可配置。
防注入的范围查询 — 严格的白名单模式验证,完全参数化的 SQL 配合 LIKE ... ESCAPE,精确的数值范围重新检查,以及可配置的结果上限,以防止宽泛的模式……
每玩家命令冷却时间 — /ipdy ip 和 /ipdy check 针对每个用户进行速率限制(控制台豁免)。
用户名清理 — 在离线模式或 Bedrock 服务器上,攻击者控制的名称无法再向工作人员输出中注入颜色或格式代码。
更安全的导入 — /ipdy import 会在插入之前验证每个封禁范围或 CIDR。
优雅关闭 — 协程拆卸具有时间限制,因此卡住的 GeoIP 请求永远不会冻结 /reload 或服务器停止。
? 集成现已上线 公共 API(通过 Bukkit ServicesManager 的 IPDynamicAPI)和 PlaceholderAPI 扩展(9 个占位符)现在已注册并正常工作。占位符由异步预热缓存提供服务 — 主线程上零阻塞 I/O。
? 幕后优化 统一的分页机制、去重的 IP 工具、死代码清理以及共享的协程错误处理器(命令不再静默失败)。范围查询已涵盖单元测试。
✅ 兼容性 Minecraft / Paper: 1.17.x – 26.2.x (支持 Spigot) Folia: 支持 Bedrock (Floodgate / Geyser): 支持 Java: 17 或更高版本 PlaceholderAPI: 可选 IPDynamic 通过 Paper 的前向兼容性在新版 26.x 服务器线上加载(26.1.x / 26.2.x)— 同一个 jar 文件从 1.17 到最新版本均可正常工作。
? 安装
下载下方的 IPDynamic.jar。
将其放入服务器的 plugins/ 文件夹。
重启服务器。现有数据库会自动升级 — 无需数据迁移。
在游戏中运行 /ipdy help 以获取完整的命令参考。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧