Minecraft JSON-RPC API文档
  1. 服务器控制
Minecraft JSON-RPC API文档
  • JSON-RPC API说明
  • 白名单管理
    • 获取白名单
    • 设置白名单
    • 添加玩家到白名单
    • 从白名单移除玩家
    • 清空白名单
  • 封禁管理
    • 获取封禁列表
    • 设置封禁列表
    • 添加玩家到封禁列表
    • 从封禁列表移除玩家
    • 清空封禁列表
    • 获取IP封禁列表
    • 设置IP封禁列表
    • 添加IP到封禁列表
    • 从封禁列表移除IP
    • 清空IP封禁列表
  • 玩家管理
    • 获取在线玩家
    • 踢出玩家
  • 管理员权限
    • 获取管理员列表
    • 设置管理员列表
    • 添加管理员权限
    • 移除管理员权限
    • 清空管理员列表
  • 服务器控制
    • 获取服务器状态
      POST
    • 保存服务器世界
      POST
    • 停止服务器
      POST
    • 发送系统消息
      POST
    • 获取自动保存设置
      POST
    • 设置自动保存
      POST
    • 获取服务器难度
      POST
    • 设置服务器难度
      POST
    • 获取强制白名单设置
      POST
    • 设置强制白名单
      POST
    • 获取白名单启用状态
      POST
    • 设置白名单启用状态
      POST
    • 获取最大玩家数
      POST
    • 设置最大玩家数
      POST
    • 获取空服暂停时间
      POST
    • 设置空服暂停时间
      POST
    • 获取玩家挂机超时时间
      POST
    • 设置玩家挂机超时时间
      POST
    • 获取飞行权限设置
      POST
    • 设置飞行权限
      POST
    • 获取服务器欢迎信息
      POST
    • 设置服务器欢迎信息
      POST
    • 获取出生点保护半径
      POST
    • 设置出生点保护半径
      POST
    • 获取强制游戏模式设置
      POST
    • 设置强制游戏模式
      POST
    • 获取默认游戏模式
      POST
    • 设置默认游戏模式
      POST
    • 获取视距设置
      POST
    • 设置视距
      POST
    • 获取模拟距离设置
      POST
    • 设置模拟距离
      POST
    • 获取服务器传送设置
      POST
    • 设置服务器传送
      POST
    • 获取状态心跳间隔
      POST
    • 设置状态心跳间隔
      POST
    • 获取管理员权限等级
      POST
    • 设置管理员权限等级
      POST
    • 获取隐藏在线玩家设置
      POST
    • 设置隐藏在线玩家
      POST
    • 获取状态回复设置
      POST
    • 设置状态回复
      POST
    • 获取实体广播范围
      POST
    • 设置实体广播范围
      POST
  • 游戏规则
    • 获取游戏规则
    • 更新游戏规则
  • 数据模型
    • Schemas
      • untyped_game_rule
      • incoming_ip_ban
      • system_message
      • kick_player
      • ip_ban
      • typed_game_rule
      • user_ban
      • message
      • version
      • server_state
      • operator
      • player
      • JsonRpcRequest
      • JsonRpcResponse
      • JsonRpcError
      • WebSocketNotification
  1. 服务器控制

设置最大玩家数

POST
minecraft:serversettings/max_players/set
服务器控制

设置max_players#

Set the maximum number of players allowed to connect to the server

参数说明：#

max (integer) - 必需

使用方法：#

通过WebSocket连接发送JSON-RPC请求到您的Minecraft服务器

请求示例：#

{"jsonrpc": "2.0", "method": "minecraft:serversettings/max_players/set", "id": 1}

服务器配置：#

确保在 server.properties 中已启用管理API

请求参数

Body 参数application/json

示例
{
    "jsonrpc": "2.0",
    "method": "minecraft:serversettings/max_players/set",
    "id": 1,
    "params": {
        "max": 1
    }
}

返回响应

🟢200成功
application/json
成功响应
Body

示例
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": 0
}
🟠400请求有误
修改于 2025-08-26 17:42:15
上一页
获取最大玩家数
下一页
获取空服暂停时间
Built with