node-GameDig命令行教程：无需编程也能查询游戏服务器状态的实用技巧

【免费下载链接】node-gamedigQuery game servers and not only! Node.JS/Deno/Bun or Bash (via the CLI).项目地址: https://gitcode.com/gh_mirrors/no/node-gamedig

node-GameDig是一款强大的游戏服务器查询工具，无需编程基础，通过简单的命令行操作就能快速获取各类游戏服务器的实时状态信息，包括在线人数、服务器名称、地图等关键数据。无论是游戏玩家还是服务器管理员，都能轻松掌握服务器动态。

📋 快速安装：3步完成配置

前提条件

确保系统已安装Node.js环境（建议v14.0.0及以上版本），可通过node -v命令检查版本。

安装步骤

1. 克隆项目仓库

   git clone https://gitcode.com/gh_mirrors/no/node-gamedig cd node-gamedig

2. 安装依赖

   npm install

3. 验证安装
   执行以下命令查看帮助信息，确认安装成功：

   node bin/gamedig.js --help

💻 基础查询：3个必学命令

1. 快速查询服务器状态

命令格式：

node bin/gamedig.js <游戏类型>://<服务器IP>:<端口>

示例（查询Minecraft服务器）：

node bin/gamedig.js minecraft://mc.hypixel.net:25565

输出说明：
返回JSON格式结果，包含服务器名称、在线人数、最大容量、当前地图等信息。添加--pretty参数可美化输出：

node bin/gamedig.js minecraft://mc.hypixel.net:25565 --pretty

2. 仅显示玩家列表

使用--requestPlayers参数过滤结果，专注查看在线玩家：

node bin/gamedig.js csgo://192.168.1.100:27015 --requestPlayers

3. 调试模式排查问题

遇到连接失败时，添加--debug参数获取详细日志：

node bin/gamedig.js rust://server.example.com:28015 --debug

🎮 支持的游戏类型与参数

热门游戏类型示例

• Minecraft:minecraft://<IP>:<端口>
• CS:GO:csgo://<IP>:<端口>
• ARK: Survival Evolved:asa://<IP>:<端口>
• Rust:rust://<IP>:<端口>

完整游戏列表可查看项目根目录下的GAMES_LIST.md文件。

常用参数表

🚀 进阶技巧：提升查询效率

1. 使用配置文件批量查询

创建servers.json文件定义多个服务器：

[ { "type": "minecraft", "host": "mc.hypixel.net", "port": 25565 }, { "type": "csgo", "host": "192.168.1.100", "port": 27015 } ]

通过脚本循环读取并查询（需简单JavaScript知识）。

2. 集成到监控工具

结合cron任务定期执行查询，将结果输出到日志文件：

*/5 * * * * node /path/to/node-gamedig/bin/gamedig.js minecraft://mc.example.com >> /var/log/server-status.log

❓ 常见问题解决

Q: 提示“无法连接服务器”怎么办？

A: 检查服务器IP和端口是否正确，添加--debug参数查看具体错误信息，确认服务器是否开启查询功能。

Q: 支持自定义游戏类型吗？

A: 可以！参考protocols/目录下的协议实现，添加自定义游戏的查询逻辑。

📚 更多资源

• 官方文档：项目根目录README.md
• 协议源码：protocols/
• 贡献指南：CONTRIBUTING.md

通过本教程，你已掌握node-GameDig命令行工具的核心用法。无论是快速查询朋友的服务器状态，还是监控自己管理的游戏服务，这款工具都能为你提供高效便捷的解决方案。立即尝试，开启你的游戏服务器监控之旅吧！

【免费下载链接】node-gamedigQuery game servers and not only! Node.JS/Deno/Bun or Bash (via the CLI).项目地址: https://gitcode.com/gh_mirrors/no/node-gamedig