@minecraft-docker/mcctl 1.6.13 → 1.6.15

package/scripts/migrate-nip-io.sh

@@ -0,0 +1,258 @@
+#!/bin/bash
+# =============================================================================
+# migrate-nip-io.sh - Add nip.io domains to existing servers
+# =============================================================================
+# Usage: ./scripts/migrate-nip-io.sh [options]
+#
+# This script updates all existing server docker-compose.yml files to include
+# nip.io magic DNS hostnames alongside the existing .local hostnames.
+#
+# Options:
+#   --dry-run    Show what would be changed without making changes
+#   -h, --help   Show this help message
+#
+# Requirements:
+#   - HOST_IP must be set in platform/.env
+#
+# Example:
+#   ./scripts/migrate-nip-io.sh           # Apply changes
+#   ./scripts/migrate-nip-io.sh --dry-run # Preview changes only
+# =============================================================================
+
+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
+
+# Track current backup for cleanup on error
+CURRENT_BACKUP=""
+
+# Cleanup function for trap
+cleanup_on_error() {
+    if [ -n "$CURRENT_BACKUP" ] && [ -f "$CURRENT_BACKUP" ]; then
+        echo -e "${RED}Error occurred. Restoring backup...${NC}"
+        local original_file="${CURRENT_BACKUP%.bak}"
+        mv "$CURRENT_BACKUP" "$original_file"
+        echo -e "${YELLOW}Restored: $original_file${NC}"
+    fi
+}
+
+# Set trap for cleanup on error
+trap cleanup_on_error ERR
+
+# Get script/platform directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLATFORM_DIR="$(dirname "$SCRIPT_DIR")"
+SERVERS_DIR="$PLATFORM_DIR/servers"
+ENV_FILE="$PLATFORM_DIR/.env"
+
+# Options
+DRY_RUN=false
+
+# =============================================================================
+# Helper Functions
+# =============================================================================
+
+show_usage() {
+    echo "Usage: $0 [options]"
+    echo ""
+    echo "Add nip.io magic DNS hostnames to existing server configurations."
+    echo ""
+    echo "Options:"
+    echo "  --dry-run    Show what would be changed without making changes"
+    echo "  -h, --help   Show this help message"
+    echo ""
+    echo "Requirements:"
+    echo "  HOST_IP must be set in platform/.env"
+}
+
+# Get host IP from .env file or auto-detect
+get_host_ip() {
+    # Try .env file first
+    if [ -f "$ENV_FILE" ]; then
+        local env_ip
+        env_ip=$(grep "^HOST_IP=" "$ENV_FILE" 2>/dev/null | cut -d'=' -f2 | tr -d '"' | tr -d "'")
+        if [ -n "$env_ip" ]; then
+            echo "$env_ip"
+            return
+        fi
+    fi
+
+    # Auto-detect: Try ip route
+    local detected_ip
+    detected_ip=$(ip route get 1 2>/dev/null | grep -oP 'src \K\S+' | head -1)
+    if [ -n "$detected_ip" ]; then
+        echo "$detected_ip"
+        return
+    fi
+
+    # Auto-detect: Try hostname -I
+    detected_ip=$(hostname -I 2>/dev/null | awk '{print $1}')
+    if [ -n "$detected_ip" ]; then
+        echo "$detected_ip"
+        return
+    fi
+
+    echo ""
+}
+
+# Extract server name from docker-compose.yml
+get_server_name() {
+    local compose_file="$1"
+    # Look for mc-router.host label and extract the .local hostname
+    local hostname
+    hostname=$(grep -E "mc-router\.host.*\.local" "$compose_file" 2>/dev/null | head -1 | grep -oP '[a-z0-9-]+(?=\.local)' | head -1)
+    echo "$hostname"
+}
+
+# Check if nip.io is already configured
+has_nip_io() {
+    local compose_file="$1"
+    grep -q "nip\.io" "$compose_file" 2>/dev/null
+}
+
+# =============================================================================
+# Parse Arguments
+# =============================================================================
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        -h|--help)
+            show_usage
+            exit 0
+            ;;
+        *)
+            echo -e "${RED}Error: Unknown option: $1${NC}"
+            show_usage
+            exit 1
+            ;;
+    esac
+done
+
+# =============================================================================
+# Main Script
+# =============================================================================
+
+echo -e "${GREEN}========================================${NC}"
+echo -e "${GREEN}nip.io Migration Script${NC}"
+echo -e "${GREEN}========================================${NC}"
+echo ""
+
+# Check HOST_IP
+HOST_IP=$(get_host_ip)
+if [ -z "$HOST_IP" ]; then
+    echo -e "${RED}Error: HOST_IP not set in $ENV_FILE${NC}"
+    echo "Please set HOST_IP to your server's local IP address."
+    echo "Example: HOST_IP=192.168.20.37"
+    exit 1
+fi
+
+echo "HOST_IP: $HOST_IP"
+echo "Servers directory: $SERVERS_DIR"
+if [ "$DRY_RUN" = true ]; then
+    echo -e "${YELLOW}DRY RUN MODE - No changes will be made${NC}"
+fi
+echo ""
+
+# Find all server directories (excluding _template)
+SERVERS_FOUND=0
+SERVERS_UPDATED=0
+SERVERS_SKIPPED=0
+
+for server_dir in "$SERVERS_DIR"/*/; do
+    # Skip _template directory
+    if [[ "$(basename "$server_dir")" == "_template" ]]; then
+        continue
+    fi
+
+    compose_file="$server_dir/docker-compose.yml"
+
+    # Check if docker-compose.yml exists
+    if [ ! -f "$compose_file" ]; then
+        continue
+    fi
+
+    SERVERS_FOUND=$((SERVERS_FOUND + 1))
+    server_name=$(basename "$server_dir")
+
+    echo -e "${BLUE}Processing:${NC} $server_name"
+
+    # Check if already has nip.io
+    if has_nip_io "$compose_file"; then
+        echo -e "  ${YELLOW}Skipped${NC} - nip.io already configured"
+        SERVERS_SKIPPED=$((SERVERS_SKIPPED + 1))
+        continue
+    fi
+
+    # Get the current hostname from the file
+    current_hostname=$(get_server_name "$compose_file")
+    if [ -z "$current_hostname" ]; then
+        echo -e "  ${YELLOW}Skipped${NC} - Could not find mc-router.host label"
+        SERVERS_SKIPPED=$((SERVERS_SKIPPED + 1))
+        continue
+    fi
+
+    # Construct new hostname value
+    new_hostname="$current_hostname.local,$current_hostname.$HOST_IP.nip.io"
+
+    echo "  Current: $current_hostname.local"
+    echo "  New: $new_hostname"
+
+    if [ "$DRY_RUN" = true ]; then
+        echo -e "  ${YELLOW}Would update${NC} (dry run)"
+        SERVERS_UPDATED=$((SERVERS_UPDATED + 1))
+    else
+        # Create backup (tracked for cleanup on error)
+        CURRENT_BACKUP="$compose_file.bak"
+        cp "$compose_file" "$CURRENT_BACKUP"
+
+        # Update the mc-router.host label
+        # Handle both YAML format (mc-router.host: "value") and array format (- "mc-router.host=value")
+        if grep -q "mc-router\.host:" "$compose_file"; then
+            # YAML format
+            sed -i "s/mc-router\.host:.*\"$current_hostname\.local\"/mc-router.host: \"$new_hostname\"/" "$compose_file"
+        else
+            # Array format
+            sed -i "s/mc-router\.host=$current_hostname\.local/mc-router.host=$new_hostname/" "$compose_file"
+        fi
+
+        echo -e "  ${GREEN}Updated${NC}"
+
+        # Remove backup on success and clear tracking
+        rm -f "$CURRENT_BACKUP"
+        CURRENT_BACKUP=""
+        SERVERS_UPDATED=$((SERVERS_UPDATED + 1))
+    fi
+done
+
+echo ""
+echo -e "${GREEN}========================================${NC}"
+echo -e "${GREEN}Migration Summary${NC}"
+echo -e "${GREEN}========================================${NC}"
+echo "Servers found: $SERVERS_FOUND"
+echo "Servers updated: $SERVERS_UPDATED"
+echo "Servers skipped: $SERVERS_SKIPPED"
+echo ""
+
+if [ "$DRY_RUN" = true ]; then
+    echo -e "${YELLOW}This was a dry run. Run without --dry-run to apply changes.${NC}"
+elif [ "$SERVERS_UPDATED" -gt 0 ]; then
+    echo -e "${GREEN}Migration complete!${NC}"
+    echo ""
+    echo "Next steps:"
+    echo "  1. Validate configuration: docker compose -f $PLATFORM_DIR/docker-compose.yml config"
+    echo "  2. Restart servers: docker compose down && docker compose up -d"
+    echo ""
+    echo "Clients can now connect via:"
+    echo "  <server>.$HOST_IP.nip.io:25565"
+else
+    echo "No servers needed migration."
+fi

package/scripts/player.sh

@@ -0,0 +1,329 @@
+#!/bin/bash
+# =============================================================================
+# player.sh - Player UUID lookup using PlayerDB API
+# =============================================================================
+# Look up Minecraft player information including UUID.
+#
+# Usage:
+#   ./scripts/player.sh lookup <playerName>           # Full player info
+#   ./scripts/player.sh lookup <playerName> --json    # JSON output
+#   ./scripts/player.sh uuid <playerName>             # Online UUID only
+#   ./scripts/player.sh uuid <playerName> --offline   # Offline UUID only
+#
+# Exit codes:
+#   0 - Success
+#   1 - Error (API error, player not found, etc.)
+#   2 - Warning
+# =============================================================================
+
+set -e
+
+# Get script directory and source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/lib/common.sh"
+
+# =============================================================================
+# Configuration
+# =============================================================================
+
+PLAYERDB_API="https://playerdb.co/api/player/minecraft"
+AVATAR_BASE="https://crafthead.net/avatar"
+
+# =============================================================================
+# Usage
+# =============================================================================
+
+usage() {
+    cat <<EOF
+Usage: $(basename "$0") <command> <playerName> [options]
+
+Look up Minecraft player information using PlayerDB API.
+
+Commands:
+  lookup <playerName>           Show full player information
+  uuid <playerName>             Get player's online UUID
+
+Options:
+  --json                        Output in JSON format
+  --offline                     Get offline UUID (for uuid command)
+  -h, --help                    Show this help message
+
+Examples:
+  $(basename "$0") lookup Notch
+  $(basename "$0") lookup Notch --json
+  $(basename "$0") uuid Notch
+  $(basename "$0") uuid Notch --offline
+
+Notes:
+  - Online UUID is fetched from Mojang API via PlayerDB
+  - Offline UUID is calculated from player name (UUID v3)
+  - Requires: curl and jq
+EOF
+}
+
+# =============================================================================
+# Helper Functions
+# =============================================================================
+
+# Check required commands
+check_requirements() {
+    local missing=()
+
+    if ! command -v curl &> /dev/null; then
+        missing+=("curl")
+    fi
+
+    if ! command -v jq &> /dev/null; then
+        missing+=("jq")
+    fi
+
+    if [[ ${#missing[@]} -gt 0 ]]; then
+        error "Missing required commands: ${missing[*]}"
+        error "Please install them and try again"
+        return 1
+    fi
+}
+
+# Calculate offline UUID from player name
+# Offline UUID = UUID v3 based on "OfflinePlayer:<name>"
+calculate_offline_uuid() {
+    local player_name="$1"
+    local input="OfflinePlayer:$player_name"
+
+    # Calculate MD5 hash and format as UUID v3
+    local md5_hash
+    md5_hash=$(echo -n "$input" | md5sum | cut -d' ' -f1)
+
+    # Format as UUID with version 3 marker
+    # UUID format: xxxxxxxx-xxxx-3xxx-yxxx-xxxxxxxxxxxx
+    # where 3 is the version and y is 8, 9, a, or b (variant)
+    local uuid
+    uuid=$(echo "$md5_hash" | sed 's/\(........\)\(....\)\(....\)\(....\)\(............\)/\1-\2-\3-\4-\5/')
+
+    # Set version to 3 (third section starts with 3)
+    uuid=$(echo "$uuid" | sed 's/\(........-....\)-\(.\)/\1-3/')
+
+    # Set variant (first char of fourth section should be 8, 9, a, or b)
+    # We'll use 8 for simplicity
+    local fourth_section
+    fourth_section=$(echo "$uuid" | cut -d'-' -f4)
+    local first_char=${fourth_section:0:1}
+    local rest=${fourth_section:1}
+
+    # Convert first char to variant (8-b range)
+    case $first_char in
+        0|1|2|3) first_char="8" ;;
+        4|5|6|7) first_char="9" ;;
+        8|9) ;; # Already valid
+        a|b) ;; # Already valid
+        c|d|e|f) first_char="a" ;;
+    esac
+
+    # Reconstruct UUID
+    uuid=$(echo "$uuid" | sed "s/\(........-....-....-\).\(...-............\)/\1${first_char}\2/")
+
+    echo "$uuid"
+}
+
+# Fetch player info from PlayerDB API
+fetch_player_info() {
+    local player_name="$1"
+    local response
+    local http_code
+
+    # Make API request with error handling
+    response=$(curl -s -w "\n%{http_code}" "${PLAYERDB_API}/${player_name}" 2>/dev/null) || {
+        error "Failed to connect to PlayerDB API"
+        return 1
+    }
+
+    # Extract HTTP code and body
+    http_code=$(echo "$response" | tail -n1)
+    local body
+    body=$(echo "$response" | sed '$d')
+
+    # Check HTTP status
+    if [[ "$http_code" != "200" ]]; then
+        error "API request failed with HTTP $http_code"
+        return 1
+    fi
+
+    # Check API success
+    local success
+    success=$(echo "$body" | jq -r '.success' 2>/dev/null)
+
+    if [[ "$success" != "true" ]]; then
+        local code
+        code=$(echo "$body" | jq -r '.code' 2>/dev/null)
+        if [[ "$code" == "minecraft.invalid_username" ]]; then
+            error "Invalid username format: $player_name"
+        elif [[ "$code" == "minecraft.api_failure" ]]; then
+            error "Player not found: $player_name"
+        else
+            error "API error: $(echo "$body" | jq -r '.message' 2>/dev/null)"
+        fi
+        return 1
+    fi
+
+    echo "$body"
+}
+
+# =============================================================================
+# Commands
+# =============================================================================
+
+# Lookup command - show full player info
+cmd_lookup() {
+    local player_name=""
+    local json_output=false
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --json)
+                json_output=true
+                JSON_OUTPUT=true
+                setup_colors
+                shift
+                ;;
+            -*)
+                error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$player_name" ]]; then
+                    player_name="$1"
+                else
+                    error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$player_name" ]]; then
+        error "Player name is required"
+        return 1
+    fi
+
+    check_requirements || return 1
+
+    local response
+    response=$(fetch_player_info "$player_name") || return 1
+
+    # Extract player data
+    local username
+    local online_uuid
+    local raw_id
+    local avatar
+    local skin_texture
+
+    username=$(echo "$response" | jq -r '.data.player.username')
+    online_uuid=$(echo "$response" | jq -r '.data.player.id')
+    raw_id=$(echo "$response" | jq -r '.data.player.raw_id')
+    avatar=$(echo "$response" | jq -r '.data.player.avatar')
+    skin_texture=$(echo "$response" | jq -r '.data.player.meta.name_history[0].name // empty' 2>/dev/null || echo "")
+
+    # Calculate offline UUID
+    local offline_uuid
+    offline_uuid=$(calculate_offline_uuid "$username")
+
+    if $json_output; then
+        cat <<EOF
+{
+  "username": "$username",
+  "online_uuid": "$online_uuid",
+  "offline_uuid": "$offline_uuid",
+  "raw_id": "$raw_id",
+  "avatar": "$avatar"
+}
+EOF
+    else
+        echo -e "${BOLD}Player: ${CYAN}$username${NC}"
+        echo -e "Online UUID:  ${GREEN}$online_uuid${NC}"
+        echo -e "Offline UUID: ${YELLOW}$offline_uuid${NC}"
+        echo -e "Avatar: $avatar"
+    fi
+}
+
+# UUID command - get specific UUID
+cmd_uuid() {
+    local player_name=""
+    local offline_mode=false
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --offline)
+                offline_mode=true
+                shift
+                ;;
+            -*)
+                error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$player_name" ]]; then
+                    player_name="$1"
+                else
+                    error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$player_name" ]]; then
+        error "Player name is required"
+        return 1
+    fi
+
+    if $offline_mode; then
+        # Just calculate offline UUID (no API call needed)
+        calculate_offline_uuid "$player_name"
+    else
+        check_requirements || return 1
+
+        local response
+        response=$(fetch_player_info "$player_name") || return 1
+
+        echo "$response" | jq -r '.data.player.id'
+    fi
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+main() {
+    local command="${1:-}"
+    shift || true
+
+    case "$command" in
+        lookup)
+            cmd_lookup "$@"
+            ;;
+        uuid)
+            cmd_uuid "$@"
+            ;;
+        -h|--help|help)
+            usage
+            exit 0
+            ;;
+        "")
+            error "No command specified"
+            usage
+            exit 1
+            ;;
+        *)
+            error "Unknown command: $command"
+            usage
+            exit 1
+            ;;
+    esac
+}
+
+# Run main if script is executed directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi