#!/bin/bash # MCC (Minecraft Console Client) Development Utilities # Source this file to get helper functions: source $MCC_REPO/tools/mcc-env.sh # Or add to ~/.bashrc: source "$HOME/Minecraft/Minecraft-Console-Client/tools/mcc-env.sh" if [[ -n "${BASH_SOURCE[0]:-}" ]]; then _mcc_env_source="${BASH_SOURCE[0]}" elif [[ -n "${ZSH_VERSION:-}" ]]; then _mcc_env_source="${(%):-%N}" else _mcc_env_source="$0" fi TOOLS_DIR="$(cd "$(dirname "$_mcc_env_source")" && pwd)" MCC_REPO_ROOT="$(cd "$TOOLS_DIR/.." && pwd)" unset _mcc_env_source export MCC_REPO="$MCC_REPO_ROOT" export MCC_SERVERS="${MCC_SERVERS:-$MCC_REPO_ROOT/MinecraftOfficial/downloads}" _mcc_repo_root() { printf '%s\n' "$MCC_REPO_ROOT" } _mcc_servers_root() { printf '%s\n' "${MCC_SERVERS:-$MCC_REPO_ROOT/MinecraftOfficial/downloads}" } _mcc_current_worktree_name() { local worktree_root if ! worktree_root="$(git -C "$MCC_REPO_ROOT" rev-parse --show-toplevel 2>/dev/null)"; then return 0 fi if [[ -z "$worktree_root" ]]; then return 0 fi basename "$worktree_root" } _mcc_resolve_session() { local explicit="${1:-}" if [[ -n "$explicit" ]]; then printf '%s\n' "$explicit" return 0 fi local worktree worktree="$(_mcc_current_worktree_name)" if [[ -n "$worktree" ]]; then printf '%s\n' "$worktree" return 0 fi basename "$MCC_REPO_ROOT" } _mcc_sha1_short() { if command -v sha1sum >/dev/null 2>&1; then printf '%s' "$1" | sha1sum | awk '{print substr($1, 1, 4)}' else printf '%s' "$1" | shasum -a 1 | awk '{print substr($1, 1, 4)}' fi } _mcc_resolve_username() { local session="$1" local normalized normalized="$(printf '%s' "$session" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9_]/_/g')" local candidate="mcc_${normalized}" if (( ${#candidate} <= 16 )); then printf '%s\n' "$candidate" return 0 fi local hash hash="$(_mcc_sha1_short "$normalized")" printf '%s_%s\n' "${candidate:0:11}" "$hash" } _mcc_session_root() { printf '%s/mcc-debug/%s\n' "${TMPDIR:-/tmp}" "$1" } _mcc_session_log_file() { printf '%s/mcc-debug.log\n' "$(_mcc_session_root "$1")" } _mcc_session_input_file() { printf '%s/mcc_input.txt\n' "$(_mcc_session_root "$1")" } _mcc_session_pid_file() { printf '%s/mcc.pid\n' "$(_mcc_session_root "$1")" } _mcc_session_meta_file() { printf '%s/session.meta\n' "$(_mcc_session_root "$1")" } _mcc_tmux_session_name() { printf 'mcc-%s\n' "$1" } _mcc_build_root() { local worktree worktree="$(_mcc_current_worktree_name)" if [[ -z "$worktree" ]]; then worktree="$(basename "$MCC_REPO_ROOT")" fi if [[ "${MCC_BUILD_MODE:-local}" == "tmpfs" ]]; then if [[ -d /dev/shm && -w /dev/shm ]]; then printf '/dev/shm/mcc-build/%s\n' "$worktree" else printf '%s/mcc-build/%s\n' "${TMPDIR:-/tmp}" "$worktree" fi return 0 fi printf '%s\n' "$MCC_REPO_ROOT" } # Helper: convert version to tmux session name (dots -> underscores) _mc-session() { echo "mc-${1//\./_}"; } # --- Minecraft Server Management --- mc-start() { bash "$MCC_REPO/tools/start-server.sh" "${1:-1.20.6}"; } mc-stop() { local v="${1:-1.20.6}"; echo "stop" > "$MCC_SERVERS/$v/stdin.pipe"; } mc-cmd() { local v="${2:-1.20.6}"; echo "$1" > "$MCC_SERVERS/$v/stdin.pipe"; } mc-log() { local s; s=$(_mc-session "${1:-1.20.6}"); tmux capture-pane -t "$s" -p -S "-${2:-50}"; } mc-kill() { local v="${1:-1.20.6}" s; s=$(_mc-session "$v"); tmux kill-session -t "$s" 2>/dev/null; rm -f "$MCC_SERVERS/$v/stdin.pipe"; echo "Killed $s"; } mc-list() { tmux list-sessions 2>/dev/null | grep "^mc-" || echo "No running MC servers"; } mc-wait-ready() { bash "$MCC_REPO/.skills/mcc-integration-testing/scripts/preflight_test_env.sh" "${1:-1.20.6}" >/dev/null && source "$MCC_REPO/.skills/mcc-integration-testing/scripts/common.sh" && wait_for_server_ready "${1:-1.20.6}" "${2:-60}"; } mc-wait-stop() { source "$MCC_REPO/.skills/mcc-integration-testing/scripts/common.sh" && wait_for_server_stop "${1:-1.20.6}" "${2:-60}"; } mc-reset-test-env() { bash "$MCC_REPO/.skills/mcc-integration-testing/scripts/reset_shared_test_state.sh" "$@"; } # --- RCON --- mc-rcon() { bash "$MCC_REPO/tools/mc-rcon.sh" "$@"; } # --- MCC Build/Run --- mcc-build() { local repo_root repo_root="$(_mcc_repo_root)" if [[ "${MCC_BUILD_MODE:-local}" == "tmpfs" ]]; then local build_root build_root="$(_mcc_build_root)" mkdir -p "$build_root" MCC_BUILD_ROOT="$build_root" dotnet build "$repo_root/MinecraftClient.sln" -c Release else dotnet build "$repo_root/MinecraftClient.sln" -c Release fi } mcc-run() { local port="${1:-25565}" shift || true cd "$MCC_REPO" && MCC_FILE_INPUT=1 dotnet run --project MinecraftClient -c Release -- CursorBot - "localhost:${port}" "$@" 2>&1 } mcc-cmd() { local session="" local command="" while [[ $# -gt 0 ]]; do case "$1" in --session) session="$2"; shift 2 ;; *) command="$1"; shift ;; esac done [[ -n "$command" ]] || { echo "Usage: mcc-cmd [--session NAME] " >&2; return 1; } session="$(_mcc_resolve_session "$session")" local input_file input_file="$(_mcc_session_input_file "$session")" mkdir -p "$(dirname "$input_file")" printf '%s\n' "$command" >> "$input_file" } mcc-kill() { pkill -f "MinecraftClient" 2>/dev/null && echo "MCC killed" || echo "No MCC process found"; tmux kill-session -t mcc-debug 2>/dev/null || true; } mcc-reload() { mcc-kill sleep 1 mcc-build && mcc-run } # --- TUI Mode --- mcc-tui() { local port="${1:-25565}" shift || true tmux new-session -d -s mcc-debug -x 160 -y 50 \ "cd '$MCC_REPO' && dotnet run --project MinecraftClient -c Release -- CursorBot - localhost:${port} $* 2>&1; echo '=== MCC EXITED ==='; sleep 600" echo "TUI mode launched in tmux session 'mcc-debug'" echo "Attach: tmux attach -t mcc-debug" } _mcc_session_log_tail() { local session="$1" local log_file log_file="$(_mcc_session_log_file "$session")" tail -f "$log_file" 2>/dev/null || echo "No MCC log found" } # --- Debug helpers --- mcc-debug() { bash "$MCC_REPO/tools/mcc-debug.sh" "$@"; } mcc-log-mcc() { local session="${1:-}" if [[ "$session" == "--session" ]]; then session="${2:-}" fi session="$(_mcc_resolve_session "$session")" _mcc_session_log_tail "$session" } mcc-state() { echo "debug state" >> "$MCC_REPO/mcc_input.txt"; sleep 1; tail -30 "${TMPDIR:-/tmp}/mcc-debug/mcc-debug.log" 2>/dev/null; } mcc-preflight() { bash "$MCC_REPO/.skills/mcc-integration-testing/scripts/preflight_test_env.sh" "$@"; } mcc-reset-session() { local session="" while [[ $# -gt 0 ]]; do case "$1" in --session) session="$2"; shift 2 ;; *) echo "Unknown option: $1" >&2; return 1 ;; esac done session="$(_mcc_resolve_session "$session")" tmux kill-session -t "$(_mcc_tmux_session_name "$session")" 2>/dev/null || true rm -rf "$(_mcc_session_root "$session")" }