Getting Started

Create Resources on AWS with Terraform（Local）

# Clone repository
git clone git@github.com:Arata1202/MinecraftGeyserServer.git
cd MinecraftGeyserServer/.terraform

# Prepare and edit variables file
mv variables.example.tf variables.tf
vi variables.tf

# Create resources
terraform init
terraform plan
terraform apply

Set Up Minecraft Server (EC2)

# Clone repository
git clone https://github.com/Arata1202/MinecraftGeyserServer.git
cd MinecraftGeyserServer

# Prepare and edit .env file
cp .env.example .env
vi .env

# Set up Linux
./.linux/setup.sh

# Set up server
sudo make setup

# Start server
sudo make up

# Stop server
sudo make down

Configure Nginx and Obtain SSL Certificate for Bluemap（EC2）

# Start server
sudo make up

# Edit Nginx configuration files (set FQDN)
vi ./.docker/nginx/default.conf
vi ./.docker/nginx/ssl_server.conf.txt

# Switch to HTTP config temporarily for Let's Encrypt certificate issuance
mv ./.docker/nginx/default.conf ./.docker/nginx/default.conf.txt
mv ./.docker/nginx/ssl_server.conf.txt ./.docker/nginx/default.conf

# Obtain SSL certificate with Let's Encrypt
sudo docker compose run --rm certbot certonly --webroot -w /var/www/html -d <YOUR_FQDN>

# Revert back to HTTPS (SSL-enabled) Nginx configuration
mv ./.docker/nginx/default.conf ./.docker/nginx/ssl_server.conf.txt
mv ./.docker/nginx/default.conf.txt ./.docker/nginx/default.conf

# Reload Nginx
sudo docker compose exec nginx nginx -s reload

Set Up Basic Authentication for Nginx（EC2）

# Start server
sudo make up

# Create a new .htpasswd file and add a user for Basic Authentication
sudo docker compose exec nginx htpasswd -c /etc/nginx/.htpasswd <YOUR_USER_NAME>

# Reload Nginx
sudo docker compose exec nginx nginx -s reload

Manage Minecraft Server Whitelist（EC2）

# Stop server
sudo make down

# Enable whitelist in server.properties
sed -i 's/white-list=false/white-list=true/' "server.properties"

# Start server
sudo make up

# Add players to whitelist
sudo docker compose exec minecraft mcrcon -H 127.0.0.1 -P 25575 -p <RCON_PASSWORD> "whitelist add <PLAYER_NAME>"

# Remove players from whitelist
sudo docker compose exec minecraft mcrcon -H 127.0.0.1 -P 25575 -p <RCON_PASSWORD> "whitelist remove <PLAYER_NAME>"

# Show the list of whitelisted players
sudo docker compose exec minecraft mcrcon -H 127.0.0.1 -P 25575 -p <RCON_PASSWORD> "whitelist list"

Set Up Auto Shutdown Batch（EC2）

# Create batch log file
touch logs/cron.log

# Edit crontab
( sudo crontab -l 2>/dev/null; echo "*/10 * * * * /home/ubuntu/MinecraftGeyserServer/.bin/cron.sh >> /home/ubuntu/MinecraftGeyserServer/logs/cron.log 2>&1" ) | sudo crontab -

Upload Existing World（Local）

# Clone repository
git clone git@github.com:Arata1202/MinecraftGeyserServer.git
cd MinecraftGeyserServer

# Prepare and edit .env file
cp .env.example .env
vi .env

# Prepare world data
mv <path/to/your/world> uploads/
mv <path/to/your/world_nether> uploads/
mv <path/to/your/world_the_end> uploads/

# Upload data
make upload

EC2 Server Maintenance（EC2）

# Check EBS disk usage
df -h

# Remove unused Docker builder cache
sudo docker builder prune -f