nonebot-plugin-mcserver-status-check 0.1.2__py3-none-any.whl

nonebot_plugin_mcserver_status_check/__init__.py

@@ -0,0 +1,102 @@
+from __future__ import annotations
+
+import asyncio
+import io
+from typing import Annotated, Set
+
+from nonebot import get_plugin_config, on_command
+from nonebot.adapters.onebot.v11 import Message, MessageSegment
+from nonebot.exception import FinishedException
+from nonebot.params import CommandArg
+from nonebot.plugin import PluginMetadata
+from nonebot.matcher import Matcher
+
+from .config import Config
+from .checker import generate_mcmotd_image, generate_single_server_image
+
+__plugin_meta__ = PluginMetadata(
+    name="Minecraft Server Status",
+    description="一款原版风格、美观高效的 Minecraft 服务器状态查询插件",
+    usage="\n".join([
+        "指令:",
+        "查服",
+        "查服 [IP/别名]",
+    ]),
+    type="application",
+    homepage="https://github.com/leiuary/nonebot-plugin-mcserver-status-check",
+    supported_adapters={"nonebot.adapters.onebot.v11"},
+    config=Config,
+)
+
+# Load configuration
+plugin_config = get_plugin_config(Config)
+
+# Determine command name and aliases
+triggers = plugin_config.msc_command_triggers
+cmd_name = triggers[0] if triggers else "查服"
+cmd_aliases: Set[str | tuple[str, ...]] = set(triggers[1:]) if len(triggers) > 1 else set()
+
+# Define command
+mcmotd: Matcher = on_command(cmd_name, aliases=cmd_aliases, priority=5, block=True)
+
+@mcmotd.handle()
+async def handle_mcmotd(args: Annotated[Message, CommandArg()]):
+    arg_text = args.extract_plain_text().strip()
+    
+    if arg_text:
+        # Single server query
+        target_address = arg_text
+        # Check if it matches an alias
+        for server in plugin_config.msc_server_list:
+            if server.alias == arg_text:
+                target_address = server.address
+                break
+        
+        await mcmotd.send(f"正在查询服务器 {target_address}，请稍候...")
+        
+        try:
+            image = await asyncio.to_thread(generate_single_server_image, target_address, plugin_config)
+            
+            if image:
+                img_byte_arr = io.BytesIO()
+                image.save(img_byte_arr, format='PNG')
+                img_bytes = img_byte_arr.getvalue()
+                await mcmotd.finish(MessageSegment.image(img_bytes))
+            else:
+                await mcmotd.finish("查询失败，未能生成状态图片。")
+                
+        except FinishedException:
+            raise
+        except Exception as e:
+            await mcmotd.finish(f"发生错误: {str(e)}")
+            
+    else:
+        # All servers query
+        await mcmotd.send("正在查询服务器状态，请稍候...")
+        
+        try:
+            image = await asyncio.to_thread(generate_mcmotd_image, plugin_config)
+            
+            if image:
+                img_byte_arr = io.BytesIO()
+                image.save(img_byte_arr, format='PNG')
+                img_bytes = img_byte_arr.getvalue()
+                await mcmotd.finish(MessageSegment.image(img_bytes))
+            else:
+                await mcmotd.finish("查询失败，未能生成状态图片。")
+                
+        except FinishedException:
+            raise
+        except Exception as e:
+            await mcmotd.finish(f"发生错误: {str(e)}")
+
+# List command
+cmd_list = on_command("查服列表", priority=5, block=True)
+
+@cmd_list.handle()
+async def handle_list():
+    msg = "已保存的服务器列表：\n"
+    for server in plugin_config.msc_server_list:
+        alias_str = f" (别名: {server.alias})" if server.alias else ""
+        msg += f"- {server.address}{alias_str}\n"
+    await cmd_list.finish(msg.strip())

nonebot_plugin_mcserver_status_check/checker.py

@@ -0,0 +1,536 @@
+from __future__ import annotations
+
+import concurrent.futures
+import json
+import socket
+import struct
+import time
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Optional
+
+from PIL import Image, ImageDraw, ImageFont
+from mcstatus import JavaServer
+
+from .config import Config
+from .mc_renderer import calculate_required_width, generate_server_card, parse_inner_legacy
+
+# Image Settings
+TITLE_TEXT = "Minecraft Server Status"
+FOOTER_TEXT_TEMPLATE = "{time} | Made by leiuary"
+BG_COLOR = (30, 30, 30)
+TEXT_COLOR = (255, 255, 255)
+FOOTER_COLOR = (150, 150, 150)
+ROW_GAP = 10
+
+# --- 辅助函数 ---
+
+def get_font_path(config: Config) -> str:
+    """解析字体路径，如果未找到则检查本地目录。"""
+    path = Path(config.msc_font_path)
+    if path.exists():
+        return str(path)
+    
+    # 尝试在与此文件相同的目录中查找
+    local_path = Path(__file__).parent / config.msc_font_path
+    if local_path.exists():
+        return str(local_path)
+        
+    return config.msc_font_path
+
+def pack_varint(d):
+    """将整数打包为 VarInt (Minecraft 协议)。"""
+    o = b''
+    while True:
+        b = d & 0x7F
+        d >>= 7
+        o += struct.pack("B", b | (0x80 if d > 0 else 0))
+        if d == 0: break
+    return o
+
+def unpack_varint(sock):
+    """从 socket 解包 VarInt。"""
+    d = 0
+    for i in range(5):
+        b = sock.recv(1)
+        if not b: return 0
+        b = ord(b)
+        d |= (b & 0x7F) << 7 * i
+        if not b & 0x80: return d
+    return 0
+
+def get_rgb_json(hostname, port):
+    """
+    使用原始协议连接到 Minecraft 服务器以检索完整的 JSON 状态。
+    这样做是因为 mcstatus 有时会简化 JSON 结构。
+    """
+    sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    sock.settimeout(5)
+    try:
+        sock.connect((hostname, port))
+        protocol = 763 # MC 1.20.4 协议版本 (近似值)
+        host_bytes = hostname.encode('utf-8')
+        
+        # 握手包
+        data = (b'\x00' + pack_varint(protocol) + pack_varint(len(host_bytes)) + 
+                host_bytes + struct.pack('!H', port) + pack_varint(1))
+        sock.send(pack_varint(len(data)) + data)
+        
+        # 请求包
+        sock.send(b'\x01\x00')
+        time.sleep(0.1) 
+        sock.send(b'\x01\x00') # 发送两次以确保在某些情况下能收到响应
+        
+        _ = unpack_varint(sock) # 包长度
+        packet_id = unpack_varint(sock)
+        
+        if packet_id != 0: 
+            raise Exception("Packet ID mismatch")
+            
+        json_len = unpack_varint(sock)
+        buffer = b''
+        while len(buffer) < json_len:
+            chunk = sock.recv(min(4096, json_len - len(buffer)))
+            if not chunk: break
+            buffer += chunk
+            
+        return json.loads(buffer)
+    finally:
+        sock.close()
+
+class MixedStatus:
+    """
+    结合了原始 JSON 数据和 mcstatus 延迟的混合状态对象。
+    模仿渲染器预期的结构。
+    """
+    @dataclass
+    class Players:
+        online: int
+        max: int
+        sample: list[dict[str, Any]]
+
+    def __init__(self, raw_json: dict[str, Any], mcstatus_latency: float, fail_count: int = 0):
+        self.raw = raw_json
+        self.latency = mcstatus_latency
+        self.fail_count = fail_count
+        self.favicon = raw_json.get("favicon")
+        p = raw_json.get("players", {})
+        self.players = self.Players(
+            online=p.get("online", 0),
+            max=p.get("max", 0),
+            sample=p.get("sample", []),
+        )
+
+class OfflineStatus:
+    """
+    表示服务器连接失败。
+    """
+    def __init__(self, error_msg: str):
+        self.raw = {
+            "description": {"text": f"§c无法连接到服务器\n§7{error_msg}"},
+            "players": {"online": 0, "max": 0},
+            "favicon": None, "version": {"name": "Unknown"}
+        }
+        self.latency = -1
+        self.players = MixedStatus.Players(online=0, max=0, sample=[])
+
+
+# --- 核心逻辑 ---
+
+def query_one_server(index, address, config: Config):
+    """
+    查询单个服务器的状态。
+    执行预热 Ping，多次测试 Ping，并计算平均延迟。
+    """
+    print(f"⏳ [{index+1}] 查询: {address}")
+    t_start = time.time()
+    detailed_logs = []
+    
+    try:
+        # --- 延迟测试 ---
+        latencies = []
+        last_std_status = None
+        
+        t_warmup_start = time.time()
+        
+        # 1. 预热
+        if config.msc_latency_warmup > 0:
+            for w_i in range(config.msc_latency_warmup):
+                try:
+                    t0 = time.time()
+                    temp_server = JavaServer.lookup(address, timeout=5)
+                    t1 = time.time()
+                    temp_server.status()
+                    t2 = time.time()
+                    detailed_logs.append(f"预热#{w_i+1}: DNS={(t1-t0)*1000:.1f}ms, Query={(t2-t1)*1000:.1f}ms")
+                    time.sleep(config.msc_latency_interval)
+                except Exception:
+                    detailed_logs.append(f"预热#{w_i+1}: 失败")
+        t_warmup_end = time.time()
+
+        # 2. 实际测试
+        target_count = config.msc_latency_count + (2 if config.msc_latency_trim else 0)
+        t_test_start = time.time()
+        
+        fail_count = 0
+        for i in range(target_count):
+            try:
+                t0 = time.time()
+                # 每次都重新 lookup 以避免连接复用问题
+                server = JavaServer.lookup(address, timeout=5)
+                t1 = time.time()
+                st = server.status()
+                t2 = time.time()
+                
+                dns_ms = (t1 - t0) * 1000
+                query_ms = (t2 - t1) * 1000
+                ping_ms = st.latency
+                
+                latencies.append(ping_ms)
+                last_std_status = st
+                detailed_logs.append(f"测试#{i+1}: DNS={dns_ms:.1f}ms, Query={query_ms:.1f}ms, Ping={ping_ms:.1f}ms")
+            except Exception:
+                fail_count += 1
+                detailed_logs.append(f"测试#{i+1}: 失败")
+            
+            if i < target_count - 1:
+                time.sleep(config.msc_latency_interval)
+        t_test_end = time.time()
+        
+        if not latencies:
+            raise Exception("无法连接到服务器 (所有尝试均失败)")
+
+        # 3. 计算统计数据
+        is_trimmed = False
+        raw_latencies = list(latencies)
+        
+        # 方差始终基于原始数据计算
+        raw_avg = sum(latencies) / len(latencies)
+        variance = sum((x - raw_avg) ** 2 for x in latencies) / len(latencies)
+
+        if config.msc_latency_trim and len(latencies) >= 3:
+            sorted_latencies = sorted(latencies)
+            valid_latencies = sorted_latencies[1:-1]
+            avg_latency = sum(valid_latencies) / len(valid_latencies)
+            is_trimmed = True
+        else:
+            avg_latency = raw_avg
+
+        # 记录结果
+        latency_str = ", ".join([f"{l:.2f}" for l in raw_latencies])
+        avg_note = " (已去极值)" if is_trimmed else ""
+        
+        t_total = time.time() - t_start
+        t_warmup = t_warmup_end - t_warmup_start
+        t_test = t_test_end - t_test_start
+        
+        print(f"✅ [{index+1}] {address} -> 延迟: [{latency_str}] -> 平均: {avg_latency:.2f} ms{avg_note}, 方差: {variance:.2f}, 丢包: {fail_count}")
+        
+        if config.msc_show_timing_details:
+            print(f"   🕒 耗时详情: 总计 {t_total:.2f}s (预热: {t_warmup:.2f}s, 测试: {t_test:.2f}s)")
+            for log in detailed_logs:
+                print(f"      -> {log}")
+
+        # 4. 获取完整 JSON 数据
+        # 我们需要真实的 host/port (已解析) 来获取原始 JSON
+        final_server = JavaServer.lookup(address, timeout=5) 
+        real_host = final_server.address.host
+        real_port = final_server.address.port
+        
+        rgb_json = get_rgb_json(real_host, real_port)
+        status_obj = MixedStatus(rgb_json, avg_latency, fail_count)
+        
+        return {
+            "index": index, 
+            "address": address, 
+            "success": True, 
+            "json": rgb_json, 
+            "status_obj": status_obj
+        }
+        
+    except Exception as e:
+        err_str = str(e)
+        if "Expecting value" in err_str: err_str = "服务器返回无效数据"
+        elif "timed out" in err_str or "lifetime expired" in err_str: err_str = "连接超时"
+        elif "getaddrinfo" in err_str: err_str = "域名解析失败"
+        
+        print(f"⚠️ [{index+1}] {address} 失败: {err_str}")
+        
+        offline_obj = OfflineStatus(err_str)
+        return {
+            "index": index, 
+            "address": address, 
+            "success": False, 
+            "json": {"error": err_str}, 
+            "status_obj": offline_obj
+        }
+
+def create_summary_image(combined_rows, config: Config) -> Optional[Image.Image]:
+    """
+    将单独的服务器行合并为带有标题和页脚的单个汇总图像。
+    """
+    if not combined_rows:
+        return None
+
+    # 加载字体
+    font_path = get_font_path(config)
+    try:
+        font_title = ImageFont.truetype(font_path, 48)
+        font_footer = ImageFont.truetype(font_path, 24)
+    except:
+        font_title = ImageFont.load_default()
+        font_footer = ImageFont.load_default()
+
+    # 计算尺寸
+    dummy_draw = ImageDraw.Draw(Image.new("RGB", (1, 1)))
+    title_w = dummy_draw.textlength(TITLE_TEXT, font=font_title)
+    title_h = 100 
+    
+    footer_text = FOOTER_TEXT_TEMPLATE.format(time=time.strftime('%Y-%m-%d %H:%M:%S'))
+    footer_w = dummy_draw.textlength(footer_text, font=font_footer)
+    footer_h = 40 
+
+    content_w = combined_rows[0].width
+    total_w = max(content_w, int(title_w + 60), int(footer_w + 60))
+    
+    list_h = sum(img.height for img in combined_rows) + (len(combined_rows)-1) * ROW_GAP
+    total_h = title_h + list_h + footer_h
+    
+    # 绘制
+    summary_img = Image.new('RGB', (total_w, total_h), BG_COLOR)
+    draw = ImageDraw.Draw(summary_img)
+    
+    # 标题
+    draw.text(((total_w - title_w) // 2, (title_h - 48) // 2), TITLE_TEXT, fill=TEXT_COLOR, font=font_title)
+    
+    # 服务器行
+    curr_y = title_h
+    for img in combined_rows:
+        x_offset = (total_w - img.width) // 2
+        summary_img.paste(img, (x_offset, curr_y))
+        curr_y += img.height + ROW_GAP
+        
+    # 页脚
+    draw.text((total_w - footer_w - 20, total_h - footer_h + 10), footer_text, fill=FOOTER_COLOR, font=font_footer)
+    
+    return summary_img
+
+def generate_mcmotd_image(config: Config) -> Optional[Image.Image]:
+    print(f"🚀 开始并行查询 {len(config.msc_server_list)} 个服务器...")
+    
+    font_path = get_font_path(config)
+
+    # 并行查询
+    query_results = []
+    with concurrent.futures.ThreadPoolExecutor(max_workers=10) as executor:
+        future_map = {executor.submit(query_one_server, i, server.address, config): i for i, server in enumerate(config.msc_server_list)}
+        for future in concurrent.futures.as_completed(future_map):
+            query_results.append(future.result())
+    
+    query_results.sort(key=lambda x: x["index"])
+
+    # 1. 计算全局宽度以进行对齐
+    max_width = 0
+    for res in query_results:
+        idx = res["index"]
+        alias = config.msc_server_list[idx].alias
+        w = calculate_required_width(res["address"], res["status_obj"], font_path=font_path, alias=alias)
+        if w > max_width: max_width = w
+    
+    max_width = max(max_width, 800) # 最小宽度
+
+    # 2. 生成单独的行
+    combined_rows = []
+    for res in query_results:
+        idx = res["index"]
+        alias = config.msc_server_list[idx].alias
+        icon, info = generate_server_card(res["address"], res["status_obj"], fixed_width=max_width, font_path=font_path, alias=alias)
+        
+        # 合并图标 + 信息
+        row_width = icon.width + info.width
+        row_height = 128
+        
+        # 检查玩家列表
+        player_img = None
+        if config.msc_show_player_list and hasattr(res["status_obj"].players, 'sample') and res["status_obj"].players.sample:
+             player_img = render_player_list(res["status_obj"].players.sample, row_width, font_path)
+        
+        if player_img:
+            row_height += player_img.height
+
+        row_img = Image.new('RGB', (row_width, row_height), (30, 30, 30))
+        row_img.paste(icon, (0, 0))
+        row_img.paste(info, (icon.width, 0))
+        
+        if player_img:
+            row_img.paste(player_img, (0, 128))
+        
+        combined_rows.append(row_img)
+
+    # 3. 生成汇总图片
+    if combined_rows:
+        return create_summary_image(combined_rows, config)
+    return None
+
+def render_player_list(players, width, font_path):
+    if not players: return None
+    
+    try:
+        font = ImageFont.truetype(font_path, 20)
+    except:
+        font = ImageFont.load_default()
+        
+    dummy = ImageDraw.Draw(Image.new("RGB", (1,1)))
+    
+    # 展平名称并处理颜色
+    # 某些服务器在玩家列表中使用 '&' 表示颜色
+    names = []
+    for p in players:
+        raw_name = p.get("name", "Unknown")
+        # 将 & 替换为 § 以进行颜色解析，但仅当它看起来像颜色代码时
+        # 目前进行简单替换
+        names.append(raw_name.replace("&", "§"))
+    
+    # 检测这是否可能是消息列表（自定义信息）或真实的玩家列表
+    # 标准：包含颜色代码、空格或非 ASCII 字符
+    is_message_list = False
+    for n in names:
+        if "§" in n or " " in n:
+            is_message_list = True
+            break
+        # 检查非 ascii (例如中文)
+        if any(ord(c) > 127 for c in n):
+            is_message_list = True
+            break
+
+    lines = []
+    current_line = []
+    current_width = 0
+    max_width = width - 40 # 填充
+    
+    if is_message_list:
+        # 每行一个条目
+        for name in names:
+            lines.append([name])
+    else:
+        # 紧凑模式（逗号分隔）
+        for name in names:
+            # 去除代码以计算宽度
+            clean_name = name
+            for i in range(10): clean_name = clean_name.replace(f"§{i}", "")
+            for c in "abcdefklmnor": clean_name = clean_name.replace(f"§{c}", "")
+            
+            name_w = dummy.textlength(clean_name + ", ", font=font)
+            
+            if current_width + name_w > max_width and current_line:
+                lines.append(current_line)
+                current_line = [name]
+                current_width = name_w
+            else:
+                current_line.append(name)
+                current_width += name_w
+                
+        if current_line: lines.append(current_line)
+    
+    line_height = 24
+    h = len(lines) * line_height + 20
+    
+    img = Image.new("RGB", (width, h), BG_COLOR)
+    draw = ImageDraw.Draw(img)
+    
+    y = 10
+    default_color = (200, 200, 200)
+    
+    for line in lines:
+        x = 20
+        for i, name in enumerate(line):
+            # 如果不是最后一个且不在消息模式下，则添加分隔符
+            separator = ", " if (not is_message_list and i < len(line) - 1) else ""
+            full_text = name + separator
+            
+            # 解析并绘制段
+            segments = parse_inner_legacy(full_text, default_color)
+            for text, color in segments:
+                draw.text((x, y), text, fill=color, font=font)
+                x += dummy.textlength(text, font=font)
+                
+        y += line_height
+        
+    return img
+
+def generate_single_server_image(address: str, config: Config) -> Optional[Image.Image]:
+    font_path = get_font_path(config)
+    
+    # 查找别名
+    alias = None
+    for s in config.msc_server_list:
+        if s.address == address:
+            alias = s.alias
+            break
+
+    # 查询
+    res = query_one_server(0, address, config)
+    status = res["status_obj"]
+    
+    # 生成卡片
+    w = calculate_required_width(address, status, font_path=font_path, alias=alias)
+    w = max(w, 800)
+    
+    icon, info = generate_server_card(address, status, fixed_width=w, font_path=font_path, alias=alias)
+    
+    # 合并图标 + 信息
+    row_width = icon.width + info.width
+    row_height = 128
+    row_img = Image.new('RGB', (row_width, row_height), BG_COLOR)
+    row_img.paste(icon, (0, 0))
+    row_img.paste(info, (icon.width, 0))
+    
+    # 玩家列表
+    player_img = None
+    if hasattr(status.players, 'sample') and status.players.sample:
+        player_img = render_player_list(status.players.sample, row_width, font_path)
+        
+    # 标题和页脚
+    try:
+        font_title = ImageFont.truetype(font_path, 48)
+        font_footer = ImageFont.truetype(font_path, 24)
+    except:
+        font_title = ImageFont.load_default()
+        font_footer = ImageFont.load_default()
+        
+    dummy = ImageDraw.Draw(Image.new("RGB", (1, 1)))
+    
+    title_w = dummy.textlength(TITLE_TEXT, font=font_title)
+    title_h = 100
+    
+    footer_text = FOOTER_TEXT_TEMPLATE.format(time=time.strftime('%Y-%m-%d %H:%M:%S'))
+    footer_w = dummy.textlength(footer_text, font=font_footer)
+    footer_h = 40
+    
+    # 计算总高度
+    total_h = title_h + row_height + (player_img.height if player_img else 0) + footer_h + ROW_GAP
+    total_w = max(row_width, int(title_w + 60), int(footer_w + 40))
+    
+    # 创建最终图像
+    final_img = Image.new("RGB", (total_w, total_h), BG_COLOR)
+    draw = ImageDraw.Draw(final_img)
+    
+    # 绘制标题
+    draw.text(((total_w - title_w) // 2, (title_h - 48) // 2), TITLE_TEXT, fill=TEXT_COLOR, font=font_title)
+    
+    # 粘贴行
+
+    x_offset = (total_w - row_width) // 2
+    final_img.paste(row_img, (x_offset, title_h))
+    
+    curr_y = title_h + row_height
+    
+    # Paste Player List
+    if player_img:
+        final_img.paste(player_img, (x_offset, curr_y))
+        curr_y += player_img.height
+        
+    # Draw Footer
+    draw.text((total_w - footer_w - 20, total_h - footer_h + 10), footer_text, fill=FOOTER_COLOR, font=font_footer)
+    
+    return final_img

nonebot_plugin_mcserver_status_check/config.py

@@ -0,0 +1,17 @@
+from pydantic import BaseModel
+from typing import List, Optional
+
+class Server(BaseModel):
+    address: str
+    alias: Optional[str] = None
+
+class Config(BaseModel):
+    msc_server_list: List[Server] = []
+    msc_latency_interval: float = 0.1
+    msc_latency_warmup: int = 5
+    msc_latency_count: int = 5
+    msc_latency_trim: bool = True
+    msc_show_timing_details: bool = False
+    msc_font_path: str = "minecraft.ttf"
+    msc_command_triggers: List[str] = ["查服"]
+    msc_show_player_list: bool = False

nonebot_plugin_mcserver_status_check/mc_renderer.py

@@ -0,0 +1,318 @@
+"""
+Minecraft 服务器状态渲染器
+==========================
+
+此模块负责将 Minecraft 服务器状态数据（JSON）渲染为图像。
+它处理颜色代码解析、MOTD 格式化、图标处理和布局计算。
+
+主要功能：
+- 解析 Minecraft 颜色代码 (§a, §b 等) 和 JSON 颜色格式。
+- 将 MOTD 渲染为带有正确颜色的文本。
+- 生成包含服务器图标、名称、MOTD、玩家数量、版本和延迟的卡片图像。
+- 支持自动计算宽度以对齐多个服务器卡片。
+"""
+
+import base64
+from io import BytesIO
+from PIL import Image, ImageDraw, ImageFont
+
+# --- 颜色常量 ---
+BG_COLOR = (30, 30, 30)
+MC_COLORS = {
+    'black': (0, 0, 0),        'dark_blue': (0, 0, 170),
+    'dark_green': (0, 170, 0), 'dark_aqua': (0, 170, 170),
+    'dark_red': (170, 0, 0),   'dark_purple': (170, 0, 170),
+    'gold': (255, 170, 0),     'gray': (170, 170, 170),
+    'dark_gray': (85, 85, 85), 'blue': (85, 85, 255),
+    'green': (85, 255, 85),    'aqua': (85, 255, 255),
+    'red': (255, 85, 85),      'light_purple': (255, 85, 255),
+    'yellow': (255, 255, 85),  'white': (255, 255, 255),
+    '0': (0, 0, 0),       '1': (0, 0, 170),     '2': (0, 170, 0),     '3': (0, 170, 170),
+    '4': (170, 0, 0),     '5': (170, 0, 170),   '6': (255, 170, 0),   '7': (170, 170, 170),
+    '8': (85, 85, 85),    '9': (85, 85, 255),   'a': (85, 255, 85),   'b': (85, 255, 255),
+    'c': (255, 85, 85),   'd': (255, 85, 255),  'e': (255, 255, 85),  'f': (255, 255, 255),
+}
+
+
+# --- 辅助函数 ---
+
+def resolve_color(color_obj):
+    """将颜色名称或十六进制代码解析为 RGB 元组。"""
+    if not color_obj: return (170, 170, 170)
+    if isinstance(color_obj, str):
+        c = color_obj.lower()
+        if c in MC_COLORS: return MC_COLORS[c]
+        if c.startswith('#') and len(c) == 7:
+            try: return tuple(int(c[i:i+2], 16) for i in (1, 3, 5))
+            except: pass
+    return (170, 170, 170)
+
+def parse_inner_legacy(text, start_color):
+    """解析字符串中的旧版 Minecraft 颜色代码 (§a)。"""
+    if not text: return []
+    if '§' not in text: return [(text, start_color)]
+    result = []
+    buffer = ""
+    current_color = start_color
+    i = 0
+    while i < len(text):
+        if text[i] == '§' and i + 1 < len(text):
+            if buffer:
+                result.append((buffer, current_color))
+                buffer = ""
+            code = text[i+1].lower()
+            if code in MC_COLORS: current_color = MC_COLORS[code]
+            elif code == 'r': current_color = (170, 170, 170)
+            i += 2
+        else:
+            buffer += text[i]
+            i += 1
+    if buffer: result.append((buffer, current_color))
+    return result
+
+def strip_mc_codes(text):
+    """从文本中移除所有 Minecraft 颜色代码 (§a)。"""
+    if not text: return ""
+    if '§' not in text: return text
+    result = ""
+    i = 0
+    while i < len(text):
+        if text[i] == '§' and i + 1 < len(text):
+            i += 2
+        else:
+            result += text[i]
+            i += 1
+    return result
+
+def flatten_json_motd(data, inherited_color='gray'):
+    """将分层的 JSON MOTD 结构展平为 (文本, 颜色) 段列表。"""
+    result = []
+    text = ""
+    if isinstance(data, dict):
+        text = data.get('text', "")
+        color_name = data.get('color', inherited_color)
+    elif isinstance(data, str):
+        text = data
+        color_name = inherited_color
+    else:
+        return []
+    base_rgb = resolve_color(color_name)
+    if text: result.extend(parse_inner_legacy(text, base_rgb))
+    if isinstance(data, dict) and 'extra' in data:
+        for item in data['extra']:
+            result.extend(flatten_json_motd(item, color_name))
+    return result
+
+def draw_text_with_shadow(draw, pos, text, color, font):
+    """绘制带有阴影效果的文本。"""
+    x, y = pos
+    r, g, b = color
+    shadow_color = (r // 5, g // 5, b // 5)
+    draw.text((x + 2, y + 2), text, fill=shadow_color, font=font)
+    draw.text((x, y), text, fill=color, font=font)
+    return draw.textlength(text, font=font)
+
+def measure_segments_width(segments, draw, font):
+    """测量一系列文本段的总宽度。"""
+    return sum(draw.textlength(text, font=font) for text, _ in segments)
+
+
+def extract_render_data(server_addr, status, alias=None):
+    """
+    从状态对象中提取并预处理渲染所需的数据。
+    
+    参数:
+        server_addr (str): 服务器地址字符串。
+        status (MixedStatus): 包含原始 JSON 响应和延迟数据的状态对象。
+        alias (str, optional): 服务器别名。
+        
+    返回:
+        dict: 包含结构化渲染数据的字典，包括左侧文本、右侧统计信息和图标数据。
+    """
+    raw = status.raw
+    
+    # --- 提取右侧统计数据 (在线人数, 版本, 延迟) ---
+    players = raw.get("players", {})
+    online, max_p = players.get('online', 0), players.get('max', 0)
+    txt_players = f"{online}/{max_p}"
+    # 在线且有延迟数据时显示绿色，否则显示灰色
+    color_players = (85, 255, 85) if (online > 0 and status.latency >= 0) else (170, 170, 170)
+    
+    txt_version = "Unknown"
+    if "version" in raw:
+        v = raw["version"]
+        if isinstance(v, dict): txt_version = v.get("name", "Unknown")
+        elif isinstance(v, str): txt_version = v
+    elif hasattr(status, 'version') and status.version:
+        txt_version = status.version.name
+    
+    # 移除版本字符串中的颜色代码以保持整洁
+    txt_version = strip_mc_codes(txt_version)
+    
+    lat = status.latency if hasattr(status, 'latency') else -1
+    fail_count = getattr(status, 'fail_count', 0)
+    
+    txt_ping = f"{int(lat)}ms"
+    if fail_count > 0:
+        txt_ping = f"Loss:{fail_count} {txt_ping}"
+
+    if lat < 0: color_ping = (170, 170, 170)      # 离线/未知
+    elif lat < 150: color_ping = (85, 255, 85)    # 良好 (绿色)
+    elif lat < 300: color_ping = (255, 170, 0)    # 一般 (金色)
+    else: color_ping = (170, 0, 0)                # 较差 (红色)
+
+    # --- 提取左侧文本数据 (服务器标题, MOTD) ---
+    desc_data = raw.get("description", "")
+    motd_parts = flatten_json_motd(desc_data)
+    motd_lines = [[]]
+    for text, color in motd_parts:
+        if not text: continue
+        segs = text.split('\n')
+        for i, seg in enumerate(segs):
+            if i > 0: motd_lines.append([])
+            if seg: motd_lines[-1].append((seg, color))
+    
+    # 仅保留前两行 MOTD
+    line1 = motd_lines[0] if len(motd_lines) > 0 else []
+    line2 = motd_lines[1] if len(motd_lines) > 1 else []
+    
+    title_text = server_addr
+    if alias:
+        title_text = f"{alias} ({server_addr})"
+
+    return {
+        "right": {
+            "p_txt": txt_players, "p_col": color_players,
+            "v_txt": txt_version, "v_col": (170, 170, 170),
+            "ping_txt": txt_ping, "ping_col": color_ping
+        },
+        "left": {
+            "title": title_text,
+            "line1": line1,
+            "line2": line2
+        },
+        "favicon": raw.get("favicon")
+    }
+
+def calculate_required_width(server_addr, status, font_path="minecraft.ttf", alias=None):
+    """
+    计算渲染该服务器卡片所需的最小宽度。
+    此函数用于在批量渲染前确定全局统一的宽度，以确保对齐。
+    """
+    data = extract_render_data(server_addr, status, alias)
+    
+    # 创建临时画布用于测量文本宽度
+    temp_draw = ImageDraw.Draw(Image.new('RGB', (1, 1)))
+    try:
+        font_title = ImageFont.truetype(font_path, 30) 
+        font_desc = ImageFont.truetype(font_path, 26)  
+        font_info = ImageFont.truetype(font_path, 26)  
+    except:
+        font_title = ImageFont.load_default()
+        font_desc = ImageFont.load_default()
+        font_info = ImageFont.load_default()
+
+    # 计算右侧统计信息区域宽度 (取最大值)
+    r = data["right"]
+    w_p = temp_draw.textlength(r["p_txt"], font=font_info)
+    w_v = temp_draw.textlength(r["v_txt"], font=font_info)
+    w_ping = temp_draw.textlength(r["ping_txt"], font=font_info)
+    max_stats_w = max(w_p, w_v, w_ping) + 10
+
+    # 计算左侧文本区域宽度 (标题和 MOTD)
+    l = data["left"]
+    w_title = temp_draw.textlength(l["title"], font=font_title)
+    w_m1 = measure_segments_width(l["line1"], temp_draw, font_desc)
+    w_m2 = measure_segments_width(l["line2"], temp_draw, font_desc)
+    max_text_w = max(w_title, w_m1, w_m2)
+    
+    GAP = 40     # 左右内容区域之间的间隙
+    PADDING = 40 # 左右两侧的总边距
+    
+    return int(max_text_w + GAP + max_stats_w + PADDING)
+
+def generate_server_card(server_addr, status, fixed_width=None, font_path="minecraft.ttf", alias=None):
+    """
+    生成单个服务器的状态卡片图像。
+    
+    参数:
+        server_addr (str): 服务器地址。
+        status (MixedStatus): 状态对象。
+        fixed_width (int, optional): 指定图像宽度。若为 None，则自动计算最小宽度。
+        font_path (str, optional): 字体文件路径。
+        alias (str, optional): 服务器别名。
+        
+    返回:
+        tuple: (icon_image, info_image) - 返回包含图标和信息卡片的元组。
+    """
+    # 1. 基础配置与数据提取
+    FIXED_HEIGHT = 128
+    data = extract_render_data(server_addr, status, alias)
+    
+    # 2. 生成服务器图标
+    ICON_SIZE = 128
+    icon_img = Image.new('RGB', (ICON_SIZE, ICON_SIZE), (50, 50, 50))
+    if data["favicon"] and "," in data["favicon"]:
+        try:
+            b64 = data["favicon"].split(",", 1)[1]
+            real_icon = Image.open(BytesIO(base64.b64decode(b64))).resize((ICON_SIZE, ICON_SIZE), Image.Resampling.NEAREST)
+            if real_icon.mode != 'RGB': real_icon = real_icon.convert('RGB')
+            icon_img.paste(real_icon, (0, 0))
+        except: pass
+
+    # 3. 确定图像宽度
+    # 若未指定固定宽度，则自动计算所需的最小宽度，并确保不小于 800px
+    if fixed_width:
+        TOTAL_WIDTH = fixed_width
+    else:
+        TOTAL_WIDTH = calculate_required_width(server_addr, status, font_path, alias)
+        TOTAL_WIDTH = max(TOTAL_WIDTH, 800)
+
+    # 4. 创建信息卡片画布
+    info_img = Image.new('RGB', (TOTAL_WIDTH, FIXED_HEIGHT), BG_COLOR)
+    draw = ImageDraw.Draw(info_img)
+    
+    try:
+        font_title = ImageFont.truetype(font_path, 30) 
+        font_desc = ImageFont.truetype(font_path, 26)  
+        font_info = ImageFont.truetype(font_path, 26)  
+    except:
+        font_title = ImageFont.load_default()
+        font_desc = ImageFont.load_default()
+        font_info = ImageFont.load_default()
+
+    LINE_HEIGHT = 36
+    START_Y = (FIXED_HEIGHT - (LINE_HEIGHT * 3)) // 2
+    Y1, Y2, Y3 = START_Y - 2, START_Y + LINE_HEIGHT, START_Y + LINE_HEIGHT * 2
+    
+    PADDING_LEFT = 20
+    PADDING_RIGHT = 20
+    
+    # 5. 绘制右侧统计信息 (始终右对齐)
+    ALIGN_X = TOTAL_WIDTH - PADDING_RIGHT
+    r = data["right"]
+    
+    w_p = draw.textlength(r["p_txt"], font=font_info)
+    draw_text_with_shadow(draw, (ALIGN_X - w_p, Y1), r["p_txt"], r["p_col"], font_info)
+    
+    w_v = draw.textlength(r["v_txt"], font=font_info)
+    draw_text_with_shadow(draw, (ALIGN_X - w_v, Y2), r["v_txt"], r["v_col"], font_info)
+    
+    w_ping = draw.textlength(r["ping_txt"], font=font_info)
+    draw_text_with_shadow(draw, (ALIGN_X - w_ping, Y3), r["ping_txt"], r["ping_col"], font_info)
+    
+    # 6. 绘制左侧文本信息 (标题和 MOTD)
+    l = data["left"]
+    TEXT_X = PADDING_LEFT
+    
+    draw_text_with_shadow(draw, (TEXT_X, Y1), l["title"], (255, 255, 255), font_title)
+    
+    curr_x = TEXT_X
+    for t, c in l["line1"]:
+        curr_x += draw_text_with_shadow(draw, (curr_x, Y2), t, c, font_desc)
+        
+    curr_x = TEXT_X
+    for t, c in l["line2"]:
+        curr_x += draw_text_with_shadow(draw, (curr_x, Y3), t, c, font_desc)
+
+    return icon_img, info_img

nonebot_plugin_mcserver_status_check-0.1.2.dist-info/METADATA

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-mcserver-status-check
+Version: 0.1.2
+Summary: A vanilla-style, beautiful and efficient Minecraft server status query plugin
+License: MIT
+License-File: LICENSE
+Author: leiuary
+Author-email: leiuary@qq.com
+Requires-Python: >=3.9,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: Pillow (>=9.1.0)
+Requires-Dist: mcstatus (>=11.0.0)
+Requires-Dist: nonebot-adapter-onebot (>=2.0.0,<3.0.0)
+Requires-Dist: nonebot2 (>=2.0.0,<3.0.0)
+Project-URL: Homepage, https://github.com/leiuary/nonebot-plugin-mcserver-status-check
+Project-URL: Repository, https://github.com/leiuary/nonebot-plugin-mcserver-status-check
+Description-Content-Type: text/markdown
+
+<div align="center">
+    <a href="https://v2.nonebot.dev/store">
+    <img src="https://raw.githubusercontent.com/fllesser/nonebot-plugin-template/refs/heads/resource/.docs/NoneBotPlugin.svg" width="310" alt="logo"></a>
+
+## ✨ nonebot-plugin-mcserver-status-check ✨
+[![LICENSE](https://img.shields.io/github/license/leiuary/nonebot-plugin-mcserver-status-check.svg)](./LICENSE)
+[![pypi](https://img.shields.io/pypi/v/nonebot-plugin-mcserver-status-check.svg)](https://pypi.python.org/pypi/nonebot-plugin-mcserver-status-check)
+[![python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org)
+
+</div>
+
+## 📖 介绍
+
+- 支持同时查询多个服务器。
+- 生成美观的状态卡片图片。
+- 显示服务器图标 (Favicon)。
+- 解析并渲染 Minecraft 颜色代码 (MOTD)。
+- 详细的延迟测试（预热、多次测试取平均值、去极值）。
+- 可配置的字体和显示选项。
+
+## 💿 安装
+
+<details open>
+<summary>使用 nb-cli 安装</summary>
+在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
+
+    nb plugin install nonebot-plugin-mcserver-status-check --upgrade
+使用 **pypi** 源安装
+
+    nb plugin install nonebot-plugin-mcserver-status-check --upgrade -i "https://pypi.org/simple"
+使用**清华源**安装
+
+    nb plugin install nonebot-plugin-mcserver-status-check --upgrade -i "https://pypi.tuna.tsinghua.edu.cn/simple"
+
+
+</details>
+
+<details>
+<summary>使用包管理器安装</summary>
+在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
+
+<details open>
+<summary>uv</summary>
+
+    uv add nonebot-plugin-mcserver-status-check
+安装仓库 master 分支
+
+    uv add git+https://github.com/leiuary/nonebot-plugin-mcserver-status-check@master
+</details>
+
+<details>
+<summary>pdm</summary>
+
+    pdm add nonebot-plugin-mcserver-status-check
+安装仓库 master 分支
+
+    pdm add git+https://github.com/leiuary/nonebot-plugin-mcserver-status-check@master
+</details>
+<details>
+<summary>poetry</summary>
+
+    poetry add nonebot-plugin-mcserver-status-check
+安装仓库 master 分支
+
+    poetry add git+https://github.com/leiuary/nonebot-plugin-mcserver-status-check@master
+</details>
+
+打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入
+
+    plugins = ["nonebot_plugin_mcserver_status_check"]
+
+</details>
+
+<details>
+<summary>使用 nbr 安装(使用 uv 管理依赖可用)</summary>
+
+[nbr](https://github.com/fllesser/nbr) 是一个基于 uv 的 nb-cli，可以方便地管理 nonebot2
+
+    nbr plugin install nonebot-plugin-mcserver-status-check
+使用 **pypi** 源安装
+
+    nbr plugin install nonebot-plugin-mcserver-status-check -i "https://pypi.org/simple"
+使用**清华源**安装
+
+    nbr plugin install nonebot-plugin-mcserver-status-check -i "https://pypi.tuna.tsinghua.edu.cn/simple"
+
+</details>
+
+
+## ⚙️ 配置
+
+在 nonebot2 项目的`.env`文件中添加下表中的配置
+
+```dotenv
+# 服务器列表
+MSC_SERVER_LIST='[]'
+
+# 延迟测试间隔(秒)
+MSC_LATENCY_INTERVAL=0.1
+
+# 延迟测试预热次数
+MSC_LATENCY_WARMUP=1
+
+# 延迟测试次数
+MSC_LATENCY_COUNT=3
+
+# 是否去极值(去掉最大最小)
+MSC_LATENCY_TRIM=true
+
+# 是否在控制台显示详细耗时
+MSC_SHOW_TIMING_DETAILS=false
+
+# 字体文件
+MSC_FONT_PATH="minecraft.ttf"
+
+# 触发指令列表
+MSC_COMMAND_TRIGGERS=["查服"]
+
+# 是否在列表模式显示玩家名单
+MSC_SHOW_PLAYER_LIST=false
+```
+
+### 服务器列表配置示例
+
+```dotenv
+MSC_SERVER_LIST='[
+  {"address": "mc.hypixel.net", "alias": "Hypixel"},
+  {"address": "play.example.com", "alias": "示例服"}
+]'
+```
+
+## 🎉 使用
+### 指令列表
+
+- **查服**
+  - 查询所有配置的服务器状态，生成汇总图片。
+- **查服 [IP/别名]**
+  - 单独查询指定服务器的状态。
+- **查服列表**
+  - 查看当前配置的服务器列表及别名。
+
+### 🎨 效果图
+如果有效果图的话
+
+## 💡 特性
+
+- 🎨 **原版风格**：完美还原 Minecraft 游戏内的服务器列表显示效果。
+- ⚡ **高效并发**：支持多服务器并行查询，速度飞快。
+- 📊 **精准延迟**：内置预热和去极值算法，提供最真实的延迟数据。
+- 📝 **颜色支持**：完整支持 Minecraft 样式代码 (§) 和 JSON 格式 MOTD。
+- 🖼️ **图标显示**：自动获取并显示服务器 Favicon。
+- 👥 **玩家列表**：支持显示在线玩家列表（需服务器开启相关功能）。
+

nonebot_plugin_mcserver_status_check-0.1.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+nonebot_plugin_mcserver_status_check/__init__.py,sha256=OCZPP48pT6bTZ8ctqJrn3Z_RGgzhO0zHNaLePG9CG-8,3584
+nonebot_plugin_mcserver_status_check/checker.py,sha256=oRyfVxv3AWaCQx3yYrZbQTZcD9mHQ8L9V18UVVjVA3Y,18203
+nonebot_plugin_mcserver_status_check/config.py,sha256=PxjnZlmNZHlh0i1JS7YXhJtYg0mRdpkCf_OZ2vwfWw4,511
+nonebot_plugin_mcserver_status_check/mc_renderer.py,sha256=CIX6rcHXfCnrwpZrqE7Jq2h3BIintbOi-GK58oWcMho,11931
+nonebot_plugin_mcserver_status_check/minecraft.ttf,sha256=Dg7zi9mTTGQQZ2lrImlvJ2OVAEO6pi8b0M2rqtCypyk,16162252
+nonebot_plugin_mcserver_status_check-0.1.2.dist-info/licenses/LICENSE,sha256=CxDbpUkgH8TO7CcjMlxywwLud1mUW9m9lxpH_-aROC0,1085
+nonebot_plugin_mcserver_status_check-0.1.2.dist-info/METADATA,sha256=Tmhro3_9t0yNQMZ7l0YeqHux8x_kWCfqKoO99sSIxHw,5565
+nonebot_plugin_mcserver_status_check-0.1.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+nonebot_plugin_mcserver_status_check-0.1.2.dist-info/RECORD,,

nonebot_plugin_mcserver_status_check-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.2.1
+Root-Is-Purelib: true
+Tag: py3-none-any

nonebot_plugin_mcserver_status_check-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 leiuary
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.