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
/plugins folder
- Restart your server
- Configure
messages.yml if 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!
评论 0
登录后参与评分
还没有评论,来抢沙发吧