Skip to content

Commit b349371

Browse files
author
InvolveX
committed
fix setup
1 parent 700f802 commit b349371

6 files changed

Lines changed: 437 additions & 120 deletions

File tree

‎README-WEBUI.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,14 +31,16 @@ A modern, feature-rich web interface for managing your Minecraft server with RCO
3131
### 🚀 One-Command Setup (Windows)
3232

3333
**PowerShell (Recommended):**
34+
3435
```powershell
3536
# Download and run setup automatically
3637
iwr -useb https://raw.githubusercontent.com/involvex/docker-minecraft-server/master/setup.ps1 | iex
3738
```
3839

3940
**Command Prompt:**
41+
4042
```cmd
41-
# Download and run setup automatically
43+
# Download and run setup automatically
4244
curl -o setup.bat https://raw.githubusercontent.com/involvex/docker-minecraft-server/master/setup.bat && setup.bat && manage.bat start
4345
```
4446

‎README.md‎

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,15 +9,15 @@
99
### 🐛 **Critical Fixes in v2.1.0**
1010

1111
- ✅ **FIXED**: WebUI constant restarting issue (containers now run stably)
12-
- ✅ **FIXED**: PowerShell encoding problems with Unicode characters
12+
- ✅ **FIXED**: PowerShell encoding problems with Unicode characters
1313
- ✅ **FIXED**: manage.bat script output suppression
1414
- ✅ **CLEANED**: Removed 5 duplicate management scripts
1515
- ✅ **UPDATED**: All documentation to reflect current file structure
1616

1717
### 🚀 **What's New**
1818

1919
- **Simplified Management**: Streamlined batch scripts with clean ASCII output
20-
- **Better Documentation**: Updated all setup guides with correct file references
20+
- **Better Documentation**: Updated all setup guides with correct file references
2121
- **Enhanced Stability**: Improved health checks and service dependencies
2222
- **Cross-Platform**: Works reliably in both PowerShell and Command Prompt
2323

@@ -96,20 +96,23 @@ manage.bat update
9696
### 🚀 One-Command Setup (Windows)
9797

9898
**PowerShell (Recommended):**
99+
99100
```powershell
100101
# Download and run setup automatically
101102
iwr -useb https://raw.githubusercontent.com/involvex/docker-minecraft-server/master/setup.ps1 | iex
102103
```
103104

104105
**Command Prompt:**
106+
105107
```cmd
106-
# Download and run setup automatically
108+
# Download and run setup automatically
107109
curl -o setup.bat https://raw.githubusercontent.com/involvex/docker-minecraft-server/master/setup.bat && setup.bat && manage.bat start
108110
```
109111

110112
### 📦 Manual Setup
111113

112114
**PowerShell:**
115+
113116
```powershell
114117
# Clone and setup the repository
115118
git clone https://github.com/involvex/docker-minecraft-server.git
@@ -118,6 +121,7 @@ cd docker-minecraft-server
118121
```
119122

120123
**Command Prompt:**
124+
121125
```cmd
122126
REM Clone the repository
123127
git clone https://github.com/involvex/docker-minecraft-server.git
@@ -166,7 +170,10 @@ cd docker-minecraft-server
166170
./setup.sh
167171

168172
# Manage the server
169-
./manage.sh start
173+
docker-compose up -d # Start the server
174+
docker-compose logs -f # View logs
175+
docker-compose down # Stop the server
176+
docker-compose ps # Check status
170177
```
171178

172179
## 📊 Service Architecture

‎RELEASE_NOTES.md‎

Lines changed: 122 additions & 110 deletions
Original file line numberDiff line numberDiff line change
@@ -1,110 +1,122 @@
1-
# Release 2.1.0 - Critical Bug Fixes & Stability Improvements
2-
3-
## 🎯 Release Summary
4-
5-
This release addresses critical stability issues and improves the overall user experience. The WebUI no longer restarts constantly, management scripts work reliably across all Windows environments, and documentation is now consistent with the actual file structure.
6-
7-
## 🔧 Major Fixes
8-
9-
### 🐛 WebUI Constant Restarting Issue - RESOLVED
10-
- **Root Cause**: Missing `CMD ["python3", "app.py"]` instruction in webui Dockerfile
11-
- **Solution**: Added proper CMD instruction and improved service dependencies
12-
- **Impact**: WebUI now runs stably without restart loops
13-
14-
### 🖥️ PowerShell Compatibility Issues - RESOLVED
15-
- **Root Cause**: Unicode emoji characters causing display corruption
16-
- **Solution**: Replaced all Unicode with ASCII-compatible symbols
17-
- **Impact**: Clean output in both PowerShell and Command Prompt
18-
19-
### 📜 Management Script Output Issues - RESOLVED
20-
- **Root Cause**: Complex batch logic suppressing docker-compose output
21-
- **Solution**: Simplified to direct commands with proper output display
22-
- **Impact**: Status commands now show actual container information
23-
24-
### 🧹 File Structure Cleanup - COMPLETED
25-
- **Action**: Removed 5 duplicate management scripts
26-
- **Removed**: `setup.bat`, `setup.ps1`, `setup-and-manage.bat`, `setup-and-manage.ps1`, `rebuild-webui.bat`
27-
- **Impact**: Cleaner project structure, less confusion
28-
29-
### 📚 Documentation Consistency - UPDATED
30-
- **Updated**: README.md, README-WEBUI.md, docs/index.html
31-
- **Fixed**: All references to removed scripts
32-
- **Impact**: Setup instructions now point to existing files
33-
34-
## 🆕 New Features
35-
36-
- **Enhanced MANAGEMENT.md**: Comprehensive management commands documentation
37-
- **Simplified Commands**: Streamlined batch scripts with better error handling
38-
- **Cross-Platform Support**: Consistent behavior across all Windows environments
39-
40-
## 🧪 Testing
41-
42-
✅ **Container Status**: Both minecraft-server and minecraft-webui run stably
43-
✅ **Management Commands**: All commands (start, stop, status, logs) work correctly
44-
✅ **PowerShell Compatibility**: No encoding issues in any environment
45-
✅ **Documentation**: All setup guides tested and verified
46-
47-
## 🔄 Breaking Changes
48-
49-
⚠️ **Management Script Changes**: Some batch script commands have been simplified
50-
- `manage.bat rebuild` → Use `docker-compose build --no-cache` instead
51-
- References to removed scripts in documentation updated
52-
53-
## 📦 Installation
54-
55-
### Windows PowerShell
56-
```powershell
57-
git clone https://github.com/involvex/docker-minecraft-server.git
58-
cd docker-minecraft-server
59-
.\setup.ps1
60-
```
61-
62-
### Windows Command Prompt
63-
```cmd
64-
git clone https://github.com/involvex/docker-minecraft-server.git
65-
cd docker-minecraft-server
66-
setup.bat
67-
manage.bat start
68-
```
69-
70-
### Linux/macOS
71-
```bash
72-
git clone https://github.com/involvex/docker-minecraft-server.git
73-
cd docker-minecraft-server
74-
./setup.sh
75-
```
76-
77-
## 🎮 Quick Start
78-
79-
1. **Setup**: Run the appropriate setup script for your platform
80-
2. **Start**: `manage.bat start` (Windows) or `./setup.sh start` (Linux)
81-
3. **Access**: Web UI at http://localhost:8080, Minecraft at localhost:25565
82-
83-
## 🙏 Acknowledgments
84-
85-
Thanks to the community for reporting these issues and helping improve the project stability.
86-
87-
## 📋 Full Changelog
88-
89-
### Fixed
90-
- WebUI constant restarting due to missing Dockerfile CMD instruction
91-
- PowerShell display issues with Unicode characters in batch scripts
92-
- manage.bat status command not showing container output
93-
- Documentation references to non-existent setup scripts
94-
- Duplicate management scripts causing user confusion
95-
96-
### Improved
97-
- Simplified and optimized management scripts
98-
- Enhanced documentation with consistent file references
99-
- Better error handling and user feedback
100-
- Cross-platform compatibility for Windows environments
101-
102-
### Removed
103-
- Duplicate management scripts (setup.bat, setup.ps1, setup-and-manage.bat, etc.)
104-
- References to non-existent files in documentation
105-
106-
---
107-
108-
**Release Date**: November 22, 2025
109-
**Download**: https://github.com/involvex/docker-minecraft-server/releases/tag/v2.1.0
110-
**Documentation**: https://github.com/involvex/docker-minecraft-server/blob/master/README.md
1+
# Release 2.1.0 - Critical Bug Fixes & Stability Improvements
2+
3+
## 🎯 Release Summary
4+
5+
This release addresses critical stability issues and improves the overall user experience. The WebUI no longer restarts constantly, management scripts work reliably across all Windows environments, and documentation is now consistent with the actual file structure.
6+
7+
## 🔧 Major Fixes
8+
9+
### 🐛 WebUI Constant Restarting Issue - RESOLVED
10+
11+
- **Root Cause**: Missing `CMD ["python3", "app.py"]` instruction in webui Dockerfile
12+
- **Solution**: Added proper CMD instruction and improved service dependencies
13+
- **Impact**: WebUI now runs stably without restart loops
14+
15+
### 🖥️ PowerShell Compatibility Issues - RESOLVED
16+
17+
- **Root Cause**: Unicode emoji characters causing display corruption
18+
- **Solution**: Replaced all Unicode with ASCII-compatible symbols
19+
- **Impact**: Clean output in both PowerShell and Command Prompt
20+
21+
### 📜 Management Script Output Issues - RESOLVED
22+
23+
- **Root Cause**: Complex batch logic suppressing docker-compose output
24+
- **Solution**: Simplified to direct commands with proper output display
25+
- **Impact**: Status commands now show actual container information
26+
27+
### 🧹 File Structure Cleanup - COMPLETED
28+
29+
- **Action**: Removed 5 duplicate management scripts
30+
- **Removed**: `setup.bat`, `setup.ps1`, `setup-and-manage.bat`, `setup-and-manage.ps1`, `rebuild-webui.bat`
31+
- **Impact**: Cleaner project structure, less confusion
32+
33+
### 📚 Documentation Consistency - UPDATED
34+
35+
- **Updated**: README.md, README-WEBUI.md, docs/index.html
36+
- **Fixed**: All references to removed scripts
37+
- **Impact**: Setup instructions now point to existing files
38+
39+
## 🆕 New Features
40+
41+
- **Enhanced MANAGEMENT.md**: Comprehensive management commands documentation
42+
- **Simplified Commands**: Streamlined batch scripts with better error handling
43+
- **Cross-Platform Support**: Consistent behavior across all Windows environments
44+
45+
## 🧪 Testing
46+
47+
✅ **Container Status**: Both minecraft-server and minecraft-webui run stably
48+
✅ **Management Commands**: All commands (start, stop, status, logs) work correctly
49+
✅ **PowerShell Compatibility**: No encoding issues in any environment
50+
✅ **Documentation**: All setup guides tested and verified
51+
52+
## 🔄 Breaking Changes
53+
54+
⚠️ **Management Script Changes**: Some batch script commands have been simplified
55+
56+
- `manage.bat rebuild` → Use `docker-compose build --no-cache` instead
57+
- References to removed scripts in documentation updated
58+
59+
## 📦 Installation
60+
61+
### Windows PowerShell
62+
63+
```powershell
64+
git clone https://github.com/involvex/docker-minecraft-server.git
65+
cd docker-minecraft-server
66+
.\setup.ps1
67+
```
68+
69+
### Windows Command Prompt
70+
71+
```cmd
72+
git clone https://github.com/involvex/docker-minecraft-server.git
73+
cd docker-minecraft-server
74+
setup.bat
75+
manage.bat start
76+
```
77+
78+
### Linux/macOS
79+
80+
```bash
81+
git clone https://github.com/involvex/docker-minecraft-server.git
82+
cd docker-minecraft-server
83+
./setup.sh
84+
```
85+
86+
## 🎮 Quick Start
87+
88+
1. **Setup**: Run the appropriate setup script for your platform
89+
2. **Start**: `manage.bat start` (Windows) or `./setup.sh start` (Linux)
90+
3. **Access**: Web UI at http://localhost:8080, Minecraft at localhost:25565
91+
92+
## 🙏 Acknowledgments
93+
94+
Thanks to the community for reporting these issues and helping improve the project stability.
95+
96+
## 📋 Full Changelog
97+
98+
### Fixed
99+
100+
- WebUI constant restarting due to missing Dockerfile CMD instruction
101+
- PowerShell display issues with Unicode characters in batch scripts
102+
- manage.bat status command not showing container output
103+
- Documentation references to non-existent setup scripts
104+
- Duplicate management scripts causing user confusion
105+
106+
### Improved
107+
108+
- Simplified and optimized management scripts
109+
- Enhanced documentation with consistent file references
110+
- Better error handling and user feedback
111+
- Cross-platform compatibility for Windows environments
112+
113+
### Removed
114+
115+
- Duplicate management scripts (setup.bat, setup.ps1, setup-and-manage.bat, etc.)
116+
- References to non-existent files in documentation
117+
118+
---
119+
120+
**Release Date**: November 22, 2025
121+
**Download**: https://github.com/involvex/docker-minecraft-server/releases/tag/v2.1.0
122+
**Documentation**: https://github.com/involvex/docker-minecraft-server/blob/master/README.md

‎SETUP_GUIDE.md‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -287,12 +287,15 @@ REM PowerShell usage
287287

288288
```bash
289289
# Make scripts executable
290-
chmod +x setup.sh manage.sh
290+
chmod +x setup.sh
291291
./setup.sh
292-
./manage.sh start
293-
./manage.sh logs
294-
./manage.sh backup
295-
./manage.sh rcon "list players"
292+
293+
# Manage the server using docker-compose commands
294+
docker-compose up -d # Start the server
295+
docker-compose logs -f # View logs
296+
docker-compose exec minecraft rcon-cli "list players" # Execute RCON commands
297+
docker-compose exec minecraft tar -czf /backups/backup-$(date +%Y%m%d).tar.gz /data # Create backup
298+
docker-compose down # Stop the server
296299
```
297300

298301
## 🔒 Security

0 commit comments

Comments
 (0)