bartixxx32/kissmpbase

KissMP Beam.NG多人游戏服务器Docker镜像

KissMP官方网站

镜像概述

本镜像为KissMP Beam.NG多人游戏服务器提供Docker化部署方案，旨在简化服务器搭建流程，方便用户快速部署和管理Beam.NG多人游戏服务器。推荐使用docker-compose.yml而非docker run命令进行部署，以获得更便捷的配置管理和服务控制能力。

核心功能和特性

• 支持自定义服务器配置（名称、描述、地图、最大玩家数等）
• 支持mod和addons的挂载与管理
• 基于Docker容器化部署，环境隔离性好，部署简单
• 支持自动重启（通过docker-compose配置）
• 可通过卷挂载持久化配置和数据

使用场景

适用于希望快速搭建Beam.NG多人游戏服务器的个人用户、游戏社区或小型服务器管理员，尤其适合需要便捷管理服务器配置和扩展功能的场景。

使用方法和配置说明

前置要求

• 已安装Docker和docker-compose

部署步骤

1. 在服务器目录中准备config.json和docker-compose.yml文件
2. 如需添加mod或addons，在同一目录下创建mods和/或addons文件夹
3. 编辑config.json和docker-compose.yml以满足自定义需求
4. 执行docker-compose up -d启动服务器
5. 测试连接服务器，验证功能是否正常
6. 如需停止或重启服务器，使用docker-compose down或docker-compose restart命令

可使用Portainer.io通过浏览器管理服务器

配置文件说明

config.json

服务器核心配置文件，需自行生成或使用以下示例（请务必修改server_identifier为唯一值）：

json
{
  "server_name": "我的KissMP服务器",
  "description": "服务器描述",
  "map": "/levels/smallgrid/info.json",
  "max_players": 15,
  "tickrate": 60,
  "port": 3698,
  "max_vehicles_per_client": 5,
  "show_in_server_list": true,
  "server_identifier": "zYd\\3n#'JA"  // 请修改为唯一值
}

配置参数说明：

• server_name: 服务器名称，将显示在服务器列表中
• description: 服务器描述信息
• map: 初始地图路径，默认为/levels/smallgrid/info.json
• max_players: 最大玩家数量限制
• tickrate: 服务器tick率（建议60）
• port: 服务器UDP端口（默认为3698）
• max_vehicles_per_client: 每个客户端允许的最大载具数量
• show_in_server_list: 是否在服务器列表中显示
• server_identifier: 服务器唯一标识符（必须修改为唯一值）

docker-compose.yml

推荐的docker-compose配置文件：

yaml
---
version: "3"
services:
  kissmp:
    image: bartixxx32/kissmpbase:latest
    ports:
      - "3698:3698/udp"  // 端口映射（主机端口:容器端口）
    restart: unless-stopped  // 除非手动停止，否则自动重启
    volumes:
      - ./config.json:/server/config.json  // 挂载配置文件
      - ./mods/:/server/mods/  // 挂载mod文件夹（可选）
      - ./addons/:/server/addons/  // 挂载addons文件夹（可选）
---

服务器管理

• 启动服务器：docker-compose up -d
• 停止服务器：docker-compose down
• 重启服务器：docker-compose restart
• 查看日志：docker-compose logs -f