插件简介 | Plugin Introduction
[中文]
ServerInfo(前身为PlayerInfo)是一款功能强大的Minecraft服务器插件,提供美观直观的网页界面用于查看玩家信息,包括物品栏、装备、状态和位置等数据。其设计理念是将后端逻辑、网页服务器和前端界面打包到单个JAR文件中,实现一体化部署架构,无需外部依赖(除Java外)。最近,我们还添加了安全的登录验证系统,进一步提升了平台的安全性。
[English]
ServerInfo (formerly PlayerInfo) is a powerful Minecraft server plugin that provides a beautiful and intuitive web interface for viewing player information, including inventory, equipment, status, and location data. Its design philosophy integrates backend logic, web server, and frontend interface into a single JAR file, creating a unified deployment architecture with no external dependencies (except Java). Recently, we've added a secure login verification system, further enhancing the platform's security.
✨ 主要特点 | Key Features
[中文]
- 双模式运行:同时支持Spigot(单服务器)和BungeeCord(代理)环境
- Minecraft风格UI:原生游戏风格的玩家信息查看界面
- 实时数据:支持物品详情、3D皮肤查看和物品栏实时更新
- 智能数据压缩:优化跨服务器通信,即使是大型数据包也能高效传输
[English]
- Dual-mode Operation: Supports both Spigot (single server) and BungeeCord (proxy) environments
- All-in-One Deployment: No external dependencies or configuration needed except Java
- Embedded Web Server: Built-in HTTP server for web interface
- Minecraft-styled UI: Native game style player information viewing interface
- Cross-server Support: View player data across multiple servers in your network
- Secure Login System: Protect your admin pages from unauthorized access
- Real-time Data: Supports item details, 3D skin viewing, and inventory real-time updates
- Smart Data Compression: Optimized cross-server communication, efficiently transmitting even large data packages
- Zero Configuration: Works out of the box with sensible defaults
安装与配置 | Installation & Configuration
[中文]
安装步骤
- 下载最新版本的插件JAR文件
- 将JAR文件放入服务器的plugins文件夹中
- 重启服务器或使用插件管理器加载插件
- 初次启动时,插件将自动创建必要的配置文件
- 访问http://你的服务器IP:25581(默认端口)查看网页界面
配置文件
- bungee_config.yml:BungeeCord代理端配置
[English]
Installation Steps
- Download the latest version of the plugin JAR file
- Place the JAR file in your server's plugins folder
- Restart the server or use a plugin manager to load the plugin
- On first startup, the plugin will automatically create necessary configuration files
- Access http://your-server-ip:25581 (default port) to view the web interface
Configuration Files
- config.yml: Spigot server configuration
- bungee_config.yml: BungeeCord proxy configuration
- passwd.yml: User authentication configuration (auto-generated)
️ 使用方法 | Usage
[中文]
网页界面
- 在浏览器中访问http://你的服务器IP:25581
- 使用在passwd.yml中配置的用户名和密码登录
- 登录后,您将看到服务器选择界面(如果在BungeeCord模式下)或直接看到玩家列表
- 点击玩家名称查看详细信息,包括:
服务器命令
- /serverinfo reload - 重新加载配置
- /serverinfo status - 显示插件状态信息
- /serverinfo web - 显示网页服务器信息和URL
[English]
Web Interface
- Access http://your-server-ip:25581 in your browser
- Log in using the username and password configured in passwd.yml
- After logging in, you'll see the server selection interface (if in BungeeCord mode) or directly view the player list
- Click on a player's name to view detailed information, including:
- Player health and location
Server Commands
- /serverinfo reload - Reload configuration
- /serverinfo status - Display plugin status information
- /serverinfo web - Show web server information and URL
在Bungee 端启动后会自动识别所有子服
⚙️ 配置详解 | Configuration Details
Bungee Config
Code (YAML):
# 调试模式
debug
: false
# 网页服务器设置
web-server:
port
: 25581
allow-external-access
: true
# 消息设置
messaging:
channel
:
"playerinfo:channel"
Bukkit/Spigot Config
Code (YAML):
# 网页服务器设置
web-server:
port
: 25581
allow-external-access
: true
# BungeeCord集成
bungeecord:
enabled
: true
server:
name
:
""
# 如果为空则自动检测
# 独立设置
standalone:
web-server
: false
# 即使在BungeeCord模式下也运行本地网页服务器
# 消息设置
messaging:
channel
:
"playerinfo:channel"
data-send-interval
: 30
# 调试模式
debug
: false
Passwd Config
Code (YAML):
# 认证设置
authentication:
enabled
: true
# 是否启用认证
session-timeout
: 1440
# 会话有效期(分钟)
max-login-attempts
: 5
# 最大尝试次数
lockout-duration
: 30
# 锁定时间(分钟)
# 用户账号
users:
- username
: admin
# 管理员用户名
password
:
"hashed_password"
# 密码(存储为哈希值)
permission
: admin
# 权限级别
- username
: viewer
# 普通查看用户
password
:
"hashed_password"
# 密码(存储为哈希值)
permission
: view
# 权限级别
技术架构 | Technical Architecture
ServerInfo插件使用多层架构设计:
ServerInfo插件
├── 核心系统
│ ├── 环境检测
│ ├── 双模式初始化
│ ├── 配置管理
│ └── 资源处理
├── 后端组件
│ ├── 数据收集(玩家状态、物品栏等)
│ ├── 事件监听器
│ ├── 跨服务器消息传递
│ └── 命令系统
├── 网页服务
│ ├── 嵌入式HTTP服务器
│ ├── API控制器
│ ├── 资源服务
│ └── 安全控制
└── 前端界面
├── HTML/CSS结构
├── JavaScript逻辑
├── 3D皮肤查看器
└── 物品详情系统
主要技术特点
- 高效数据压缩:使用GZIP压缩算法处理大数据包,实现65-80%的压缩率
- 智能数据同步:通过事件触发和周期性更新的结合实现高效数据同步
- Minecraft风格UI:专为MC玩家设计的直观界面
ServerInfo plugin uses a multi-layered architecture design:
ServerInfo Plugin
├── Core System
│ ├── Environment Detection
│ ├── Dual-mode Initialization
│ ├── Configuration Management
│ └── Resource Handling
├── Backend Components
│ ├── Data Collection (player status, inventory, etc.)
│ ├── Event Listeners
│ ├── Cross-server Messaging
│ └── Command System
├── Web Services
│ ├── Embedded HTTP Server
│ ├── API Controllers
│ ├── Resource Serving
│ └── Security Controls
└── Frontend Interface
├── HTML/CSS Structure
├── JavaScript Logic
├── 3D Skin Viewer
└── Item Detail System
Key Technical Features
- Efficient Data Compression: Using GZIP compression algorithm for large data packages, achieving 65-80% compression rates
- Asynchronous Operations: Leveraging async processing to avoid blocking the main server thread
- Smart Data Synchronization: Combining event-triggered and periodic updates for efficient data sync
- Minecraft-styled UI: Intuitive interface designed specifically for MC players
版本支持 | Version Support
- Minecraft: 1.12.2 - 1.19+
- Spigot/Paper/Purpur: 支持所有主流分支
- BungeeCord/Waterfall: 完全支持
- Minecraft: 1.12.2 - 1.19+
- Spigot/Paper/Purpur: All major forks supported
- BungeeCord/Waterfall: Fully supported
未来计划 | Future Plans
- Enhanced permission control system
- Advanced player search and filtering
- Mobile device interface optimization
- Additional data visualization options
- Support for more server platforms (such as Velocity)
1.1.0 Major updates
1.0.5 Update PlaceholderAPI + DragonCore
1.0.4 Update UI
