Update README.md
This commit is contained in:
parent
de0303d21c
commit
547c74ee23
1 changed files with 28 additions and 115 deletions
143
README.md
143
README.md
|
|
@ -18,7 +18,7 @@ Using this link supports the project at no additional cost to you. Thank you!
|
||||||
✅ Works with **Proxmox VM** or **LXC container**
|
✅ Works with **Proxmox VM** or **LXC container**
|
||||||
✅ **Performance optimizations** included (RAM allocation, CPU prioritization)
|
✅ **Performance optimizations** included (RAM allocation, CPU prioritization)
|
||||||
✅ Customizable settings (world generation, plugins, mods)
|
✅ Customizable settings (world generation, plugins, mods)
|
||||||
✅ **Minecraft-themed emojis** throughout the guide
|
✅ **Troubleshooting guide included** for common issues
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -29,7 +29,7 @@ Using this link supports the project at no additional cost to you. Thank you!
|
||||||
- **General Settings**:
|
- **General Settings**:
|
||||||
- Name: `Minecraft-Server`
|
- Name: `Minecraft-Server`
|
||||||
- **OS Selection**:
|
- **OS Selection**:
|
||||||
- Use a **Debian 11/12** or **Ubuntu 22.04** ISO image
|
- Use a **Debian 11/12** or **Ubuntu 24.04** ISO image
|
||||||
- **System Configuration**:
|
- **System Configuration**:
|
||||||
- BIOS: **OVMF (UEFI) or SeaBIOS**
|
- BIOS: **OVMF (UEFI) or SeaBIOS**
|
||||||
- Machine Type: **q35** (recommended)
|
- Machine Type: **q35** (recommended)
|
||||||
|
|
@ -43,13 +43,13 @@ Using this link supports the project at no additional cost to you. Thank you!
|
||||||
- Model: **VirtIO**
|
- Model: **VirtIO**
|
||||||
- Enable **QEMU Guest Agent** after installation
|
- Enable **QEMU Guest Agent** after installation
|
||||||
|
|
||||||
### **Install Dependencies** ⚙️
|
### **2️⃣ Install Dependencies** ⚙️
|
||||||
```bash
|
```bash
|
||||||
apt update && apt upgrade -y
|
apt update && apt upgrade -y
|
||||||
apt install -y curl wget nano screen unzip git openjdk-17-jre-headless
|
apt install -y curl wget nano screen unzip git openjdk-21-jre-headless
|
||||||
```
|
```
|
||||||
|
|
||||||
### **Run the Minecraft Server Setup Script** ⛏️
|
### **3️⃣ Run the Minecraft Server Setup Script** ⛏️
|
||||||
```bash
|
```bash
|
||||||
wget https://raw.githubusercontent.com/TimInTech/minecraft-server-Proxmox/main/setup_minecraft.sh
|
wget https://raw.githubusercontent.com/TimInTech/minecraft-server-Proxmox/main/setup_minecraft.sh
|
||||||
chmod +x setup_minecraft.sh
|
chmod +x setup_minecraft.sh
|
||||||
|
|
@ -66,7 +66,7 @@ chmod +x setup_minecraft.sh
|
||||||
- Name: `Minecraft-LXC`
|
- Name: `Minecraft-LXC`
|
||||||
- Set root user **password**
|
- Set root user **password**
|
||||||
- **Template Selection**:
|
- **Template Selection**:
|
||||||
- Choose a **Debian 11/12** or **Ubuntu 22.04** template
|
- Choose a **Debian 11/12** or **Ubuntu 24.04** template
|
||||||
- **Resources**:
|
- **Resources**:
|
||||||
- CPU: 2 vCPUs (recommended: 4)
|
- CPU: 2 vCPUs (recommended: 4)
|
||||||
- RAM: 4GB (recommended: 8GB)
|
- RAM: 4GB (recommended: 8GB)
|
||||||
|
|
@ -85,7 +85,7 @@ chmod +x setup_minecraft.sh
|
||||||
Log into the container and install:
|
Log into the container and install:
|
||||||
```bash
|
```bash
|
||||||
apt update && apt upgrade -y
|
apt update && apt upgrade -y
|
||||||
apt install -y curl wget nano screen unzip git openjdk-17-jre-headless
|
apt install -y curl wget nano screen unzip git openjdk-21-jre-headless
|
||||||
```
|
```
|
||||||
|
|
||||||
### **3️⃣ Run the LXC Setup Script** 🧰
|
### **3️⃣ Run the LXC Setup Script** 🧰
|
||||||
|
|
@ -99,59 +99,34 @@ chmod +x setup_minecraft_lxc.sh
|
||||||
|
|
||||||
## 🔍 **Troubleshooting & Solutions** 🛑
|
## 🔍 **Troubleshooting & Solutions** 🛑
|
||||||
|
|
||||||
### **1️⃣ Minecraft server did not start (No Systemd service)** 🚫
|
### **1️⃣ Java Version Error (Unsupported Class Version)** 🚫
|
||||||
**Error:** `Unit minecraft.service could not be found.`
|
**Error:** `org/bukkit/craftbukkit/Main has been compiled by a more recent version of the Java Runtime.`
|
||||||
|
#### **Solution:** Install the correct Java version
|
||||||
#### **Solution: Create the service manually** 🛠️
|
|
||||||
```bash
|
```bash
|
||||||
nano /etc/systemd/system/minecraft.service
|
apt install -y openjdk-21-jre-headless
|
||||||
```
|
|
||||||
Paste:
|
|
||||||
```ini
|
|
||||||
[Unit]
|
|
||||||
Description=Minecraft Server ⛏️
|
|
||||||
After=network.target
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
User=root
|
|
||||||
WorkingDirectory=/opt/minecraft
|
|
||||||
ExecStart=/bin/bash /opt/minecraft/start.sh
|
|
||||||
Restart=always
|
|
||||||
|
|
||||||
[Install]
|
|
||||||
WantedBy=multi-user.target
|
|
||||||
```
|
|
||||||
Enable the service:
|
|
||||||
```bash
|
|
||||||
systemctl daemon-reload
|
|
||||||
systemctl enable minecraft
|
|
||||||
systemctl start minecraft
|
|
||||||
systemctl status minecraft
|
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### **2️⃣ `server.jar` is empty** 🧨
|
|
||||||
**Error:** `ls -l /opt/minecraft/` shows the file is 0 bytes.
|
|
||||||
|
|
||||||
#### **Solution: Replace the empty `server.jar`** 💾
|
|
||||||
For **PaperMC**:
|
|
||||||
```bash
|
|
||||||
wget -O /opt/minecraft/server.jar https://api.papermc.io/v2/projects/paper/versions/1.20.4/builds/450/downloads/paper-1.20.4-450.jar
|
|
||||||
```
|
|
||||||
For **Vanilla Minecraft**:
|
|
||||||
```bash
|
|
||||||
wget -O /opt/minecraft/server.jar https://www.minecraft.net/en-us/download/server
|
|
||||||
```
|
|
||||||
Restart the server:
|
Restart the server:
|
||||||
```bash
|
```bash
|
||||||
systemctl restart minecraft
|
systemctl restart minecraft
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
### **2️⃣ Server Not Starting (`start.sh` missing)** ⚠️
|
||||||
|
```bash
|
||||||
|
cd /opt/minecraft
|
||||||
|
nano start.sh
|
||||||
|
```
|
||||||
|
Paste:
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
java -Xms2G -Xmx4G -jar server.jar nogui
|
||||||
|
```
|
||||||
|
Then:
|
||||||
|
```bash
|
||||||
|
chmod +x start.sh
|
||||||
|
./start.sh
|
||||||
|
```
|
||||||
|
|
||||||
### **3️⃣ Firewall (`ufw`) is inactive** 🔥
|
### **3️⃣ Firewall Issues (`ufw` inactive)** 🔥
|
||||||
**Solution:** Open the Minecraft port:
|
|
||||||
```bash
|
```bash
|
||||||
ufw allow 25565/tcp
|
ufw allow 25565/tcp
|
||||||
ufw allow 25565/tcp6
|
ufw allow 25565/tcp6
|
||||||
|
|
@ -160,71 +135,9 @@ ufw enable
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔧 **Manual Installation** 🗜️
|
|
||||||
|
|
||||||
### **Steps for VM & LXC**
|
|
||||||
1️⃣ **Install dependencies**:
|
|
||||||
```bash
|
|
||||||
apt update && apt upgrade -y
|
|
||||||
apt install -y curl wget nano screen unzip git openjdk-17-jre-headless
|
|
||||||
```
|
|
||||||
|
|
||||||
2️⃣ **Create server directory**:
|
|
||||||
```bash
|
|
||||||
mkdir -p /opt/minecraft && cd /opt/minecraft
|
|
||||||
```
|
|
||||||
|
|
||||||
3️⃣ **Download `server.jar`**:
|
|
||||||
```bash
|
|
||||||
wget -O server.jar https://api.papermc.io/v2/projects/paper/versions/1.20.4/builds/450/downloads/paper-1.20.4-450.jar
|
|
||||||
```
|
|
||||||
|
|
||||||
4️⃣ **Accept EULA**:
|
|
||||||
```bash
|
|
||||||
echo "eula=true" > eula.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
5️⃣ **Create a start script**:
|
|
||||||
```bash
|
|
||||||
cat <<EOF > start.sh
|
|
||||||
#!/bin/bash
|
|
||||||
java -Xms2G -Xmx4G -jar server.jar nogui
|
|
||||||
EOF
|
|
||||||
chmod +x start.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
6️⃣ **Setup Systemd Service**:
|
|
||||||
```bash
|
|
||||||
nano /etc/systemd/system/minecraft.service
|
|
||||||
```
|
|
||||||
Paste:
|
|
||||||
```ini
|
|
||||||
[Unit]
|
|
||||||
Description=Minecraft Server ⛏️
|
|
||||||
After=network.target
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
User=root
|
|
||||||
WorkingDirectory=/opt/minecraft
|
|
||||||
ExecStart=/bin/bash /opt/minecraft/start.sh
|
|
||||||
Restart=always
|
|
||||||
|
|
||||||
[Install]
|
|
||||||
WantedBy=multi-user.target
|
|
||||||
```
|
|
||||||
|
|
||||||
7️⃣ **Start the server**:
|
|
||||||
```bash
|
|
||||||
systemctl daemon-reload
|
|
||||||
systemctl enable minecraft
|
|
||||||
systemctl start minecraft
|
|
||||||
tail -f /opt/minecraft/logs/latest.log # Monitor logs 🧾
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🤝 **Contribute** 🌟
|
## 🤝 **Contribute** 🌟
|
||||||
- Found a bug? 🐛 **Open an Issue**
|
- Found a bug? 🐛 **Open an Issue**
|
||||||
- Want to improve the script? ⚙️ **Submit a Pull Request**
|
- Want to improve the script? ⚙️ **Submit a Pull Request**
|
||||||
|
|
||||||
💎 **Happy crafting!** 🎮
|
💎 **Happy crafting!** 🎮
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue