安装指南 | Minecraft插件生成器

我的世界交易网大约 3 分钟

安装指南

本指南将帮助您在本地环境或服务器上安装和配置Minecraft插件生成器。根据您的需求和技术背景，我们提供了多种安装方法。

环境准备

Java环境配置

必要条件

Minecraft插件生成器需要Java环境来编译生成的插件代码。推荐使用JDK 8或更高版本。

Windows系统

下载JDK安装包：
- Oracle JDK
- Eclipse Adoptium OpenJDK
运行安装程序，按照向导完成安装
配置环境变量：
- 右键点击"此电脑"→"属性"→"高级系统设置"→"环境变量"
- 在系统变量中新建JAVA_HOME，值为JDK安装路径（例如：C:\Program Files\Java\jdk1.8.0_301）
- 编辑Path变量，添加%JAVA_HOME%\bin
验证安装：
- 打开命令提示符
- 输入java -version和javac -version
- 应显示已安装的Java版本信息

macOS系统

使用Homebrew安装OpenJDK：
```
brew install openjdk@8
```

配置环境变量：

echo 'export JAVA_HOME=/usr/local/opt/openjdk@8' >> ~/.zshrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

验证安装：
```
java -version
javac -version
```

Linux系统

使用包管理器安装OpenJDK：

Ubuntu/Debian：

sudo apt update
sudo apt install openjdk-8-jdk

CentOS/RHEL：

sudo yum install java-1.8.0-openjdk-devel

配置环境变量：

echo 'export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

验证安装：
```
java -version
javac -version
```

Maven安装

提示

Maven是一个Java项目管理和构建工具，用于编译生成的插件代码。

Windows系统

下载Maven二进制压缩包
解压到合适的目录（例如：C:\Program Files\Apache\maven）
配置环境变量：
- 新建系统变量MAVEN_HOME，值为Maven解压路径
- 编辑Path变量，添加%MAVEN_HOME%\bin
验证安装：
```
mvn -version
```

macOS系统

使用Homebrew安装：
```
brew install maven
```
验证安装：
```
mvn -version
```

Linux系统

使用包管理器安装：

Ubuntu/Debian：
```
sudo apt update
sudo apt install maven
```
CentOS/RHEL：
```
sudo yum install maven
```

验证安装：
```
mvn -version
```

安装方法

方法：本地直接运行

创建.env文件，添加以下内容：

DEEPSEEK_API_KEY=您的DeepSeek API密钥
PORT=3000

安装Node.js依赖：
```
npm install
```
启动服务器：
```
node server.js
```
打开浏览器访问：http://localhost:3000

配置选项

环境变量

在.env文件中可以配置以下环境变量：

变量名	描述	默认值
`PORT`	服务器监听端口	3000
`DEEPSEEK_API_KEY`	DeepSeek API密钥	无（必填）
`MAX_CONCURRENT_GENERATIONS`	最大并发生成数量	5
`GENERATION_TIMEOUT`	生成超时时间（毫秒）	300000
`CLEANUP_INTERVAL`	临时文件清理间隔（毫秒）	3600000

自定义配置

如需更高级的自定义配置，可以修改以下文件：

server.js：调整服务器设置和生成逻辑
public/css/style.css：自定义UI样式
public/js/main.js和public/js/generate-result.js：修改前端交互逻辑

故障排除

常见问题

无法启动服务器
- 检查Node.js是否正确安装：node -v
- 确保所有依赖已安装：npm install
- 检查端口是否被占用，尝试更改端口号
插件生成失败
- 确保Java和Maven正确安装并配置环境变量
- 检查DeepSeek API密钥是否有效
- 查看服务器日志获取详细错误信息
Docker相关问题
- 确保Docker服务正在运行
- 检查Docker权限：在Linux上可能需要使用sudo
- 尝试重新构建镜像：docker build --no-cache -t minecraft-plugin-generator .

日志文件

服务器日志可以帮助诊断问题：

控制台输出：运行node server.js时的终端输出
Docker日志：docker logs <container_id>

更新指南

本地部署更新

安装新依赖：
```
npm install
```
重启服务器：
```
node server.js
```

支持

如果您在安装过程中遇到任何问题，请查阅常见问题解答或联系我们的技术支持团队。