screepers/screeps-launcher

Screeps私有服务器增强启动器

镜像概述和主要用途

Screeps是一款多人在线编程游戏，玩家可通过编写代码控制游戏单位。官方Steam私有服务器存在非workshop mod安装困难等限制，而npm版本虽功能更完善但需手动正确配置所有依赖。本镜像作为Screeps私有服务器的增强启动器，旨在简化整个搭建过程，自动处理依赖安装，无需手动执行npm install命令，大幅降低私有服务器的部署和维护门槛。

核心功能和特性

• 简化部署流程：自动处理所有依赖项安装，用户无需手动执行npm install
• Mod管理自动化：通过配置文件指定mod名称，自动下载并集成mods
• Bots支持：支持通过配置文件定义bots，可指定bots名称或文件系统路径
• 配置集中化：核心参数通过config.yml统一管理，简化服务器配置

使用场景和适用范围

适用于需要搭建Screeps私有服务器的玩家或开发团队，尤其适合以下场景：

• 希望避免手动配置npm依赖的用户
• 需要便捷管理mods的私有服务器管理员
• 希望快速部署包含自定义bots的Screeps服务器

详细使用方法和配置说明

快速启动指南

1. 在空目录中创建配置文件（示例使用/srv/screeps作为目录）
2. 执行以下Docker命令启动服务器：

   bash
   docker run --restart=unless-stopped --name MyScreepsServer -v /srv/screeps:/screeps -p 21025:21025 docker.xuanyuan.run/screepers/screeps-launcher
   

3. 服务器启动完成，可通过http://localhost:21025访问

注：更详细和最新的操作说明，请参考https://github.com/screepers/screeps-launcher

Mod配置

通过修改config.yml文件添加mods，启动器会自动下载并安装指定mods。可在https://github.com/ScreepsMods%E6%9F%A5%E6%89%BE%E5%8F%AF%E7%94%A8mods%E3%80%82

常用推荐mods：

• screepsmod-mongo：提供Mongo+Redis数据库支持（核心功能必需）
• screepsmod-auth：密码管理模块，可通过http://localhost:21025/authmod/password修改密码
• screepsmod-admin-utils：管理员工具集，增强服务器管理功能
• screepsmod-map-tool：地图管理工具，支持地图生成和修改
• screepsmod-history：游戏历史记录模块，记录服务器事件
• screepsmod-market：市场系统支持模块

各mod详细使用方法请参考其在https://github.com/ScreepsMods%E7%9A%84%E6%96%87%E6%A1%A3%E3%80%82

Bots配置

可通过config.yml文件配置bots生成规则，支持指定bots名称或文件系统中的代码路径。具体配置示例可参考config.sample.yml文件。

Docker部署示例

基础部署命令

bash
docker run --restart=unless-stopped --name MyScreepsServer -v /srv/screeps:/screeps -p 21025:21025 docker.xuanyuan.run/screepers/screeps-launcher

参数说明：

• --restart=unless-stopped：容器退出时自动重启（手动停止除外）
• --name MyScreepsServer：指定容器名称为"MyScreepsServer"
• -v /srv/screeps:/screeps：挂载宿主机目录用于持久化存储配置和数据
• -p 21025:21025：映射服务器端口，允许外部访问Screeps服务