需手动配置Node.js环境、安装mc.js依赖并启动服务:一、安装Node.js v18/v20并验证;二、克隆源码或下载预编译包;三、npm install并npm run build生成dist/;四、复制修改config.json;五、npm start或node dist/main.js启动。

如果您希望运行一个基于 mc.js 的 Minecraft 服务器,但缺乏现成的部署环境,则需要手动配置 Node.js 运行时、安装 mc.js 核心依赖并启动服务实例。以下是搭建 mc.js 自建服务器的详细步骤:
一、准备 Node.js 运行环境
mc.js 是基于 JavaScript 编写的 Minecraft 服务器实现,必须依赖 Node.js 运行时才能执行。需确保系统中已安装兼容版本(推荐 v18.x 或 v20.x),否则后续安装与启动将失败。
1、访问 https://nodejs.org/ 官网,下载 LTS 版本安装包。
2、运行安装程序,勾选“Add to PATH”选项以自动配置环境变量。
3、打开终端或命令提示符,输入 node -v && npm -v 验证是否输出版本号。
二、获取 mc.js 源码或预编译包
mc.js 提供 GitHub 仓库源码及部分发布版本的可执行包。直接使用源码可灵活调整配置,而预编译包适合快速启动。
1、在终端中执行 git clone https://github.com/mc-js/mc.js.git 克隆官方仓库。
2、进入项目目录:cd mc.js。
3、若不使用 Git,可前往 https://github.com/mc-js/mc.js/releases 下载最新 .tar.gz 或 .zip 包并解压。
三、安装依赖并构建项目
mc.js 使用 TypeScript 编写,需通过 npm 安装开发依赖并编译为可运行的 JavaScript 文件。跳过构建将导致无法启动服务。
1、在项目根目录下执行 npm install 安装所有依赖项。
2、执行 npm run build 触发 TypeScript 编译流程。
3、确认 dist/ 目录生成成功,其中包含 main.js 等核心运行文件。
四、配置服务器参数
mc.js 通过 config.json 文件控制端口、最大玩家数、世界路径等关键行为。未配置将使用默认值,可能导致端口冲突或世界加载失败。
1、复制 config.example.json 并重命名为 config.json。
2、用文本编辑器打开 config.json,修改 "port": 25565 为可用端口号。
3、设置 "maxPlayers": 20 和 "world": "./world" 路径确保可读写。
五、启动 mc.js 服务器
启动方式有多种,可根据调试需求选择直接运行、后台守护或使用 PM2 管理进程。任一方式均需确保 config.json 存在且权限正确。
1、执行 npm start 启动开发模式服务器(监听文件变更)。
2、执行 node dist/main.js 直接运行编译后主程序。
3、若需后台持续运行,先全局安装 PM2:npm install -g pm2,再执行 pm2 start dist/main.js --name "mcjs-server"。











