@minecraft-docker/mcctl 1.6.13 → 1.6.15

package/scripts/delete-server.sh

@@ -0,0 +1,266 @@
+#!/bin/bash
+# =============================================================================
+# delete-server.sh - Delete a Minecraft server
+# =============================================================================
+# Usage: ./scripts/delete-server.sh <server-name> [options]
+#
+# This script removes a server created by create-server.sh:
+#   - Stops and removes the Docker container
+#   - Removes server from servers/compose.yml
+#   - Removes hostname from avahi-daemon
+#   - Deletes server directory (servers/<server-name>/)
+#
+# IMPORTANT: World data in worlds/ directory is PRESERVED.
+#
+# Options:
+#   -f, --force    Skip confirmation prompt
+#   -y, --yes      Same as --force
+#   --keep-avahi   Don't remove avahi hostname entry
+#
+# Examples:
+#   ./scripts/delete-server.sh myserver
+#   ./scripts/delete-server.sh myserver --force
+# =============================================================================
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Get script/platform directories
+# Support both direct execution and npm package execution (mcctl CLI)
+if [[ -n "${MCCTL_ROOT:-}" ]]; then
+    # Running via npm package
+    PLATFORM_DIR="$MCCTL_ROOT"
+    SCRIPT_DIR="${MCCTL_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)}"
+else
+    # Running directly (development mode)
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    PLATFORM_DIR="$(dirname "$SCRIPT_DIR")"
+fi
+
+# Source common functions
+source "$SCRIPT_DIR/lib/common.sh"
+
+SERVERS_DIR="$PLATFORM_DIR/servers"
+SERVERS_COMPOSE="$SERVERS_DIR/compose.yml"
+MAIN_COMPOSE="$PLATFORM_DIR/docker-compose.yml"
+AVAHI_HOSTS="/etc/avahi/hosts"
+
+# Default values
+FORCE_DELETE="false"
+KEEP_AVAHI="false"
+
+# Show usage
+show_usage() {
+    echo "Usage: $0 <server-name> [options]"
+    echo ""
+    echo "Delete a Minecraft server (worlds are preserved)."
+    echo ""
+    echo "Options:"
+    echo "  -f, --force    Skip confirmation prompt"
+    echo "  -y, --yes      Same as --force"
+    echo "  --keep-avahi   Don't remove avahi hostname entry"
+    echo ""
+    echo "Examples:"
+    echo "  $0 myserver"
+    echo "  $0 myserver --force"
+}
+
+# Check if first argument exists
+if [ -z "$1" ]; then
+    echo -e "${RED}Error: Server name is required${NC}"
+    echo ""
+    show_usage
+    exit 1
+fi
+
+# Check for help flag first
+if [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
+    show_usage
+    exit 0
+fi
+
+# First argument is server name
+SERVER_NAME="$1"
+shift
+
+# Parse remaining arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -f|--force|-y|--yes)
+            FORCE_DELETE="true"
+            shift
+            ;;
+        --keep-avahi)
+            KEEP_AVAHI="true"
+            shift
+            ;;
+        -h|--help)
+            show_usage
+            exit 0
+            ;;
+        *)
+            echo -e "${RED}Error: Unknown option: $1${NC}"
+            echo ""
+            show_usage
+            exit 1
+            ;;
+    esac
+done
+
+# Validate server name
+SERVER_DIR="$SERVERS_DIR/$SERVER_NAME"
+if [ ! -d "$SERVER_DIR" ]; then
+    echo -e "${RED}Error: Server '$SERVER_NAME' not found at $SERVER_DIR${NC}"
+    exit 1
+fi
+
+# Confirmation prompt
+if [ "$FORCE_DELETE" != "true" ]; then
+    echo -e "${YELLOW}WARNING: This will delete server '$SERVER_NAME'${NC}"
+    echo ""
+    echo "The following will be removed:"
+    echo "  - Docker container: mc-$SERVER_NAME"
+    echo "  - Server directory: servers/$SERVER_NAME/"
+    echo "  - servers/compose.yml entry"
+    if [ "$KEEP_AVAHI" != "true" ]; then
+        echo "  - avahi hostname: $SERVER_NAME.local"
+    fi
+    echo ""
+    echo -e "${GREEN}World data in worlds/ will be PRESERVED.${NC}"
+    echo ""
+    read -p "Are you sure? (y/N): " confirm
+    if [[ ! "$confirm" =~ ^[Yy]$ ]]; then
+        echo "Cancelled."
+        exit 0
+    fi
+fi
+
+echo ""
+echo -e "${RED}Deleting server: $SERVER_NAME${NC}"
+echo ""
+
+# =============================================================================
+# Step 1: Stop Docker container
+# =============================================================================
+echo -e "${BLUE}[1/4]${NC} Stopping Docker container..."
+cd "$PLATFORM_DIR"
+if docker compose ps "mc-$SERVER_NAME" 2>/dev/null | grep -q "mc-$SERVER_NAME"; then
+    docker compose stop "mc-$SERVER_NAME" 2>/dev/null || true
+    docker compose rm -f "mc-$SERVER_NAME" 2>/dev/null || true
+    echo "   Container mc-$SERVER_NAME stopped and removed"
+else
+    # Check if container exists but not managed by compose (exited state)
+    if docker ps -a --format '{{.Names}}' | grep -q "^mc-$SERVER_NAME$"; then
+        docker rm -f "mc-$SERVER_NAME" 2>/dev/null || true
+        echo "   Container mc-$SERVER_NAME removed"
+    else
+        echo "   Container mc-$SERVER_NAME not found"
+    fi
+fi
+
+# =============================================================================
+# Step 2: Update servers/compose.yml
+# =============================================================================
+echo -e "${BLUE}[2/4]${NC} Updating servers/compose.yml..."
+
+if [ -f "$SERVERS_COMPOSE" ]; then
+    # Backup original
+    cp "$SERVERS_COMPOSE" "$SERVERS_COMPOSE.bak"
+
+    # Remove include entry
+    if grep -q "$SERVER_NAME/docker-compose.yml" "$SERVERS_COMPOSE"; then
+        sed -i "\|$SERVER_NAME/docker-compose.yml|d" "$SERVERS_COMPOSE"
+        echo "   Removed from include section"
+
+        # If no more includes, remove the include: line
+        if ! grep -q "^  - " "$SERVERS_COMPOSE"; then
+            sed -i '/^include:/d' "$SERVERS_COMPOSE"
+            echo "   Removed empty include section"
+        fi
+    else
+        echo "   Server not found in compose.yml"
+    fi
+
+    # Verify the changes
+    if docker compose -f "$MAIN_COMPOSE" config --quiet 2>/dev/null; then
+        echo -e "   ${GREEN}Configuration validated successfully${NC}"
+        rm -f "$SERVERS_COMPOSE.bak"
+    else
+        echo -e "${RED}   Error: Configuration validation failed!${NC}"
+        echo "   Restoring backup..."
+        mv "$SERVERS_COMPOSE.bak" "$SERVERS_COMPOSE"
+        echo "   Please check the configuration manually."
+        exit 1
+    fi
+else
+    echo "   servers/compose.yml not found (nothing to update)"
+fi
+
+# =============================================================================
+# Step 3: Remove from avahi-daemon
+# =============================================================================
+echo -e "${BLUE}[3/4]${NC} Removing mDNS hostname..."
+if [ "$KEEP_AVAHI" = "true" ]; then
+    echo "   Skipped (--keep-avahi specified)"
+elif [ -f "$AVAHI_HOSTS" ]; then
+    if grep -q "$SERVER_NAME.local" "$AVAHI_HOSTS" 2>/dev/null; then
+        if run_with_sudo sed -i "/$SERVER_NAME\.local/d" "$AVAHI_HOSTS" 2>/dev/null; then
+            run_with_sudo systemctl restart avahi-daemon 2>/dev/null || true
+            echo -e "   ${GREEN}Removed $SERVER_NAME.local from avahi${NC}"
+        else
+            echo -e "${YELLOW}   Warning: Failed to update avahi (sudo required)${NC}"
+            if has_sudo_password; then
+                echo "   Check if MCCTL_SUDO_PASSWORD is correct"
+            else
+                echo "   Set MCCTL_SUDO_PASSWORD env var or remove manually: sudo sed -i '/$SERVER_NAME.local/d' $AVAHI_HOSTS"
+            fi
+        fi
+    else
+        echo "   Hostname not found in avahi"
+    fi
+else
+    echo "   avahi not configured"
+fi
+
+# =============================================================================
+# Step 4: Delete server directory
+# =============================================================================
+echo -e "${BLUE}[4/4]${NC} Deleting server directory..."
+
+# Check for symlinked worlds and warn
+if [ -d "$SERVER_DIR/data" ]; then
+    for link in "$SERVER_DIR/data"/*; do
+        if [ -L "$link" ]; then
+            target=$(readlink "$link")
+            echo "   Note: Symlink found: $(basename "$link") -> $target (preserved in worlds/)"
+        fi
+    done
+fi
+
+rm -rf "$SERVER_DIR"
+echo -e "   ${GREEN}Deleted servers/$SERVER_NAME/${NC}"
+
+# =============================================================================
+# Summary
+# =============================================================================
+echo ""
+echo -e "${GREEN}========================================${NC}"
+echo -e "${GREEN}Server '$SERVER_NAME' deleted successfully!${NC}"
+echo -e "${GREEN}========================================${NC}"
+echo ""
+echo "Removed:"
+echo "  - Container: mc-$SERVER_NAME"
+echo "  - Directory: servers/$SERVER_NAME/"
+echo "  - servers/compose.yml entry"
+if [ "$KEEP_AVAHI" != "true" ]; then
+    echo "  - avahi hostname: $SERVER_NAME.local"
+fi
+echo ""
+echo -e "${GREEN}World data in worlds/ has been preserved.${NC}"
+echo ""

package/scripts/init.sh

@@ -0,0 +1,390 @@
+#!/bin/bash
+# =============================================================================
+# init.sh - Initialize Minecraft Platform for First Run
+# =============================================================================
+# This script prepares the platform for initial operation:
+#   1. Validates Docker and Docker Compose installation
+#   2. Validates avahi-daemon for mDNS support
+#   3. Creates/validates .env configuration
+#   4. Creates required directories
+#   5. Creates Docker network and volumes
+#   6. Performs initial docker-compose config validation
+#
+# Usage:
+#   ./scripts/init.sh [options]
+#
+# Options:
+#   --create-server NAME [TYPE]  Create initial server after setup
+#   --skip-validation            Skip Docker/Compose validation
+#   --skip-avahi                 Skip avahi-daemon validation
+#   --skip-compose-up            Only initialize, don't start services
+#   -h, --help                   Show this help
+#
+# Example:
+#   ./scripts/init.sh
+#   ./scripts/init.sh --create-server myserver PAPER
+# =============================================================================
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+MAGENTA='\033[0;35m'
+NC='\033[0m' # No Color
+
+# Get script/platform directories
+# Support both direct execution and npm package execution (mcctl CLI)
+if [[ -n "${MCCTL_ROOT:-}" ]]; then
+    # Running via npm package
+    PLATFORM_DIR="$MCCTL_ROOT"
+    SCRIPT_DIR="${MCCTL_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)}"
+    TEMPLATE_DIR="${MCCTL_TEMPLATES:-$PLATFORM_DIR/servers/_template}/servers/_template"
+else
+    # Running directly (development mode)
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    PLATFORM_DIR="$(dirname "$SCRIPT_DIR")"
+    TEMPLATE_DIR="$PLATFORM_DIR/servers/_template"
+fi
+
+ENV_FILE="$PLATFORM_DIR/.env"
+ENV_EXAMPLE="$PLATFORM_DIR/.env.example"
+
+# Default options
+VALIDATE_DOCKER=true
+VALIDATE_AVAHI=true
+START_SERVICES=true
+CREATE_SERVER_NAME=""
+CREATE_SERVER_TYPE="PAPER"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --create-server)
+            CREATE_SERVER_NAME="$2"
+            CREATE_SERVER_TYPE="${3:-PAPER}"
+            shift 3
+            ;;
+        --skip-validation)
+            VALIDATE_DOCKER=false
+            shift
+            ;;
+        --skip-avahi)
+            VALIDATE_AVAHI=false
+            shift
+            ;;
+        --skip-compose-up)
+            START_SERVICES=false
+            shift
+            ;;
+        -h|--help)
+            sed -n '/^# Usage:/,/^$/p' "$0" | sed 's/^# *//'
+            exit 0
+            ;;
+        *)
+            echo -e "${RED}Error: Unknown option $1${NC}"
+            exit 1
+            ;;
+    esac
+done
+
+# =============================================================================
+# Helper Functions
+# =============================================================================
+
+print_header() {
+    echo ""
+    echo -e "${MAGENTA}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${MAGENTA}  $1${NC}"
+    echo -e "${MAGENTA}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
+print_step() {
+    echo -e "${BLUE}▶ $1${NC}"
+}
+
+print_success() {
+    echo -e "${GREEN}✓ $1${NC}"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠ $1${NC}"
+}
+
+print_error() {
+    echo -e "${RED}✗ $1${NC}"
+}
+
+# =============================================================================
+# 1. Validate Docker and Docker Compose
+# =============================================================================
+
+if [ "$VALIDATE_DOCKER" = true ]; then
+    print_header "Step 1: Validating Docker and Docker Compose"
+
+    print_step "Checking Docker installation..."
+    if ! command -v docker &> /dev/null; then
+        print_error "Docker not found. Please install Docker Engine 20.10+"
+        exit 1
+    fi
+    DOCKER_VERSION=$(docker --version | grep -oP '\d+\.\d+' | head -1)
+    print_success "Docker $DOCKER_VERSION found"
+
+    print_step "Checking Docker Compose installation..."
+    if ! command -v docker compose &> /dev/null && ! command -v docker-compose &> /dev/null; then
+        print_error "Docker Compose not found. Please install Docker Compose v2.0+"
+        exit 1
+    fi
+    if command -v docker compose &> /dev/null; then
+        COMPOSE_VERSION=$(docker compose version 2>&1 | grep -oP '\d+\.\d+' | head -1 || echo "unknown")
+        DOCKER_COMPOSE_CMD="docker compose"
+    else
+        COMPOSE_VERSION=$(docker-compose --version 2>&1 | grep -oP '\d+\.\d+' | head -1 || echo "unknown")
+        DOCKER_COMPOSE_CMD="docker-compose"
+    fi
+    print_success "Docker Compose $COMPOSE_VERSION found"
+
+    print_step "Checking Docker daemon..."
+    if ! docker info &> /dev/null; then
+        print_error "Cannot connect to Docker daemon. Please ensure Docker is running"
+        exit 1
+    fi
+    print_success "Docker daemon is running"
+fi
+
+# =============================================================================
+# 2. Validate avahi-daemon (mDNS support)
+# =============================================================================
+
+if [ "$VALIDATE_AVAHI" = true ]; then
+    print_header "Step 2: Validating avahi-daemon (mDNS)"
+
+    print_step "Checking avahi-daemon installation..."
+    if command -v avahi-daemon &> /dev/null; then
+        print_success "avahi-daemon found"
+    else
+        print_warning "avahi-daemon not found"
+        echo ""
+        echo -e "${YELLOW}To install avahi-daemon:${NC}"
+        echo "  Debian/Ubuntu: sudo apt install avahi-daemon"
+        echo "  CentOS/RHEL:   sudo dnf install avahi"
+        echo "  Arch Linux:    sudo pacman -S avahi nss-mdns"
+        echo "  Alpine Linux:  apk add avahi"
+        echo ""
+    fi
+
+    print_step "Checking avahi-daemon status..."
+    if systemctl is-active --quiet avahi-daemon 2>/dev/null; then
+        print_success "avahi-daemon is running"
+    elif rc-service avahi-daemon status &>/dev/null; then
+        print_success "avahi-daemon is running (OpenRC)"
+    else
+        print_warning "avahi-daemon is not running"
+        echo ""
+        echo -e "${YELLOW}To start avahi-daemon:${NC}"
+        echo "  Systemd:  sudo systemctl enable --now avahi-daemon"
+        echo "  OpenRC:   rc-update add avahi-daemon default && rc-service avahi-daemon start"
+        echo ""
+    fi
+
+    print_step "Checking /etc/avahi/hosts write permission..."
+    if [ -w /etc/avahi/hosts ] || sudo test -w /etc/avahi/hosts 2>/dev/null; then
+        print_success "/etc/avahi/hosts is writable"
+    else
+        print_warning "/etc/avahi/hosts may require sudo for hostname registration"
+    fi
+fi
+
+# =============================================================================
+# 3. Setup Environment File
+# =============================================================================
+
+print_header "Step 3: Setting up environment configuration"
+
+if [ ! -f "$ENV_FILE" ]; then
+    print_step "Creating .env from template..."
+    if [ -f "$ENV_EXAMPLE" ]; then
+        cp "$ENV_EXAMPLE" "$ENV_FILE"
+        print_success ".env created from .env.example"
+    else
+        print_warning ".env.example not found, creating minimal .env"
+        cat > "$ENV_FILE" << 'EOF'
+# Multi-Server Minecraft Management
+MINECRAFT_NETWORK=minecraft-net
+MINECRAFT_SUBNET=172.28.0.0/16
+DEFAULT_MEMORY=4G
+DEFAULT_VERSION=1.20.4
+TZ=Asia/Seoul
+RCON_PASSWORD=changeme
+COMPOSE_PROJECT_NAME=minecraft
+EOF
+        print_success "Minimal .env created"
+    fi
+    print_warning "Please review and update .env with your settings"
+else
+    print_success ".env already exists"
+fi
+
+# =============================================================================
+# 4. Create Required Directories
+# =============================================================================
+
+print_header "Step 4: Creating required directories"
+
+DIRS=(
+    "$PLATFORM_DIR/servers"
+    "$PLATFORM_DIR/shared/plugins"
+    "$PLATFORM_DIR/shared/mods"
+    "$PLATFORM_DIR/worlds"
+    "$PLATFORM_DIR/worlds/.locks"
+    "$PLATFORM_DIR/backups/servers"
+    "$PLATFORM_DIR/backups/worlds"
+)
+
+for dir in "${DIRS[@]}"; do
+    if [ ! -d "$dir" ]; then
+        mkdir -p "$dir"
+        print_step "Created: $dir"
+    fi
+done
+
+print_success "All directories validated/created"
+
+# =============================================================================
+# 5. Validate docker-compose.yml
+# =============================================================================
+
+print_header "Step 5: Validating Docker Compose configuration"
+
+print_step "Validating $PLATFORM_DIR/docker-compose.yml..."
+cd "$PLATFORM_DIR"
+if ! $DOCKER_COMPOSE_CMD config > /dev/null 2>&1; then
+    print_error "Docker Compose configuration is invalid"
+    $DOCKER_COMPOSE_CMD config
+    exit 1
+fi
+print_success "Docker Compose configuration is valid"
+
+# =============================================================================
+# 6. Create/Verify Docker Network
+# =============================================================================
+
+print_header "Step 6: Setting up Docker network"
+
+# Source .env to get network settings
+set -a
+source <(grep -v '^\s*#' "$ENV_FILE" | grep -v '^\s*$') 2>/dev/null || true
+set +a
+
+NETWORK_NAME="${MINECRAFT_NETWORK:-minecraft-net}"
+print_step "Checking network: $NETWORK_NAME"
+
+if ! docker network ls | grep -q "^[^ ]*${NETWORK_NAME}"; then
+    print_step "Creating network: $NETWORK_NAME"
+    docker network create \
+        --driver bridge \
+        --subnet "${MINECRAFT_SUBNET:-172.28.0.0/16}" \
+        "$NETWORK_NAME" 2>/dev/null || true
+    print_success "Network created/verified"
+else
+    print_success "Network already exists"
+fi
+
+# =============================================================================
+# 7. Create Initial Server (Optional)
+# =============================================================================
+
+if [ -n "$CREATE_SERVER_NAME" ]; then
+    print_header "Step 7: Creating initial server"
+    print_step "Creating server: $CREATE_SERVER_NAME ($CREATE_SERVER_TYPE)"
+    
+    if [ -x "$SCRIPT_DIR/create-server.sh" ]; then
+        "$SCRIPT_DIR/create-server.sh" "$CREATE_SERVER_NAME" -t "$CREATE_SERVER_TYPE" --no-start
+        print_success "Server created: $CREATE_SERVER_NAME"
+    else
+        print_error "create-server.sh not found or not executable"
+        exit 1
+    fi
+else
+    print_header "Step 7: Initial server creation"
+    print_warning "No initial server requested (use --create-server NAME [TYPE] to create one)"
+fi
+
+# =============================================================================
+# 8. Start Services (Optional)
+# =============================================================================
+
+if [ "$START_SERVICES" = true ]; then
+    print_header "Step 8: Starting platform services"
+
+    print_step "Starting Docker Compose services..."
+    cd "$PLATFORM_DIR"
+    $DOCKER_COMPOSE_CMD up -d router 2>&1 | grep -E '(Creating|Created|Starting|Started)' || true
+
+    print_success "mc-router started"
+
+    # Wait for router to be ready
+    print_step "Waiting for router to be ready..."
+    for i in {1..30}; do
+        if docker exec mc-router nc -zv localhost 25565 &> /dev/null; then
+            print_success "Router is ready"
+            break
+        fi
+        if [ $i -eq 30 ]; then
+            print_warning "Router startup timeout (may still be initializing)"
+        fi
+        sleep 1
+    done
+else
+    print_header "Step 8: Services not started"
+    print_warning "Use 'docker compose up -d' to start services manually"
+fi
+
+# =============================================================================
+# 9. Summary
+# =============================================================================
+
+print_header "Initialization Complete ✓"
+
+cat << EOF
+
+${GREEN}Platform Status:${NC}
+
+  📁 Configuration:  $ENV_FILE
+  🐳 Network:        $NETWORK_NAME
+  📂 Directories:    Created
+  🌐 mDNS:           avahi-daemon (system service)
+
+${GREEN}Next Steps:${NC}
+
+  1. Create your first server:
+     cd $PLATFORM_DIR
+     ./scripts/create-server.sh myserver -t PAPER
+
+  2. Connect to server (mDNS):
+     Open Minecraft and connect to: myserver.local:25565
+
+  3. View server status:
+     docker compose ps
+
+  4. View logs:
+     docker logs -f mc-myserver
+
+${YELLOW}Environment Reminder:${NC}
+
+  ⚠️  Default RCON_PASSWORD is 'changeme' - change in .env for production!
+  ⚠️  Ensure avahi-daemon is running for mDNS auto-discovery
+
+${BLUE}Documentation:${NC}
+
+  📖 Getting Started: Read README.md
+  📖 mDNS Setup:      See README.md#mdns-setup-guide
+  📖 Full Docs:       See docs/doc-list.md
+
+EOF
+
+print_success "Platform ready to use!"
+exit 0