mirror of
https://github.com/MCCTeam/Minecraft-Console-Client
synced 2026-08-15 13:04:36 +00:00
296 lines
9.2 KiB
Bash
296 lines
9.2 KiB
Bash
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
|
REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
|
|
# shellcheck source=tools/mcc-env.sh
|
|
source "$REPO_ROOT/tools/mcc-env.sh"
|
|
|
|
usage() {
|
|
cat <<'EOF'
|
|
Usage: tools/mcc-debug.sh [options]
|
|
|
|
One-step build, server start, and MCC launch for debugging.
|
|
|
|
Options:
|
|
-v, --version VER Server directory name (default: 1.21.11-Vanilla)
|
|
-m, --mode MODE Console mode: classic or tui (default: classic)
|
|
-p, --port PORT Server port (default: 25565)
|
|
--session NAME Session name for scoped runtime artifacts
|
|
--username NAME MCC username (default: resolved from session)
|
|
--no-build Skip dotnet build
|
|
--debug-on Enable debug messages from the start
|
|
--file-input Use FileInput mode (classic only; enables mcc-cmd)
|
|
-h, --help Show this help
|
|
|
|
Examples:
|
|
tools/mcc-debug.sh # Classic mode, default server
|
|
tools/mcc-debug.sh -m tui # TUI mode
|
|
tools/mcc-debug.sh -v 1.21.11-Vanilla --debug-on
|
|
tools/mcc-debug.sh --session smoke-a --username SmokeA
|
|
tools/mcc-debug.sh --file-input # FileInput for script-driven testing
|
|
EOF
|
|
}
|
|
|
|
VERSION="1.21.11-Vanilla"
|
|
MODE="classic"
|
|
PORT="25565"
|
|
PORT_SET_BY_USER=false
|
|
SESSION=""
|
|
USERNAME=""
|
|
DO_BUILD=true
|
|
DEBUG_ON=false
|
|
FILE_INPUT=false
|
|
|
|
while [[ $# -gt 0 ]]; do
|
|
case "$1" in
|
|
-v|--version)
|
|
if [[ $# -lt 2 ]]; then
|
|
echo "$1 requires a value" >&2
|
|
exit 1
|
|
fi
|
|
VERSION="$2"
|
|
shift 2
|
|
;;
|
|
-m|--mode)
|
|
if [[ $# -lt 2 ]]; then
|
|
echo "$1 requires a value" >&2
|
|
exit 1
|
|
fi
|
|
MODE="$2"
|
|
shift 2
|
|
;;
|
|
-p|--port)
|
|
if [[ $# -lt 2 ]]; then
|
|
echo "$1 requires a value" >&2
|
|
exit 1
|
|
fi
|
|
PORT="$2"
|
|
PORT_SET_BY_USER=true
|
|
shift 2
|
|
;;
|
|
--session)
|
|
if [[ $# -lt 2 ]]; then
|
|
echo "--session requires a value" >&2
|
|
exit 1
|
|
fi
|
|
SESSION="$2"
|
|
shift 2
|
|
;;
|
|
--username)
|
|
if [[ $# -lt 2 ]]; then
|
|
echo "--username requires a value" >&2
|
|
exit 1
|
|
fi
|
|
USERNAME="$2"
|
|
shift 2
|
|
;;
|
|
--no-build) DO_BUILD=false; shift ;;
|
|
--debug-on) DEBUG_ON=true; shift ;;
|
|
--file-input) FILE_INPUT=true; shift ;;
|
|
-h|--help) usage; exit 0 ;;
|
|
*) echo "Unknown option: $1" >&2; usage >&2; exit 1 ;;
|
|
esac
|
|
done
|
|
|
|
SESSION="$(_mcc_resolve_session "$SESSION")"
|
|
if [[ -z "$USERNAME" ]]; then
|
|
USERNAME="$(_mcc_resolve_username "$SESSION")"
|
|
fi
|
|
|
|
SESSION_ROOT="$(_mcc_session_root "$SESSION")"
|
|
CFG="$SESSION_ROOT/MinecraftClient.debug.ini"
|
|
MCC_LOG="$(_mcc_session_log_file "$SESSION")"
|
|
INPUT_FILE="$(_mcc_session_input_file "$SESSION")"
|
|
PID_FILE="$(_mcc_session_pid_file "$SESSION")"
|
|
META_FILE="$(_mcc_session_meta_file "$SESSION")"
|
|
MCC_TMUX_SESSION="$(_mcc_tmux_session_name "$SESSION")"
|
|
SESSION_NAME="mc-${VERSION//\./_}"
|
|
PREPARE_CFG_SCRIPT="$REPO_ROOT/.skills/mcc-integration-testing/scripts/prepare_offline_mcc_config.sh"
|
|
ENSURE_SERVER_SCRIPT="$REPO_ROOT/.skills/mcc-integration-testing/scripts/ensure_offline_server.sh"
|
|
PREFLIGHT_SCRIPT="$REPO_ROOT/.skills/mcc-integration-testing/scripts/preflight_test_env.sh"
|
|
GET_PORT_SCRIPT="$REPO_ROOT/.skills/mcc-integration-testing/scripts/get_server_port.sh"
|
|
|
|
mkdir -p "$SESSION_ROOT"
|
|
|
|
echo "=== MCC Debug Session ==="
|
|
echo " Server: $VERSION (port $PORT)"
|
|
echo " Session: $SESSION"
|
|
echo " User: $USERNAME"
|
|
echo " Mode: $MODE"
|
|
echo " Root: $SESSION_ROOT"
|
|
echo " Config: $CFG"
|
|
echo " Log: $MCC_LOG"
|
|
echo " Input: $INPUT_FILE"
|
|
echo " PID: $PID_FILE"
|
|
echo " Meta: $META_FILE"
|
|
echo " Tmux: $MCC_TMUX_SESSION"
|
|
echo ""
|
|
|
|
bash "$PREFLIGHT_SCRIPT" "$VERSION" >/dev/null
|
|
|
|
# --- Build ---
|
|
if $DO_BUILD; then
|
|
echo "[1/4] Building MCC..."
|
|
dotnet build "$REPO_ROOT/MinecraftClient.sln" -c Release -v quiet --nologo
|
|
echo " Build OK"
|
|
else
|
|
echo "[1/4] Build skipped (--no-build)"
|
|
fi
|
|
|
|
# --- Prepare config ---
|
|
echo "[2/4] Preparing config..."
|
|
bash "$PREPARE_CFG_SCRIPT" "$CFG" "${VERSION%-Vanilla}" "$USERNAME" >/dev/null
|
|
|
|
if [[ "$MODE" == "tui" ]]; then
|
|
if [[ "$(uname)" == "Darwin" ]]; then
|
|
sed -i '' 's/ConsoleMode = "classic"/ConsoleMode = "tui"/' "$CFG"
|
|
else
|
|
sed -i 's/ConsoleMode = "classic"/ConsoleMode = "tui"/' "$CFG"
|
|
fi
|
|
fi
|
|
|
|
if $DEBUG_ON; then
|
|
if [[ "$(uname)" == "Darwin" ]]; then
|
|
sed -i '' 's/DebugMessages = false/DebugMessages = true/' "$CFG"
|
|
else
|
|
sed -i 's/DebugMessages = false/DebugMessages = true/' "$CFG"
|
|
fi
|
|
fi
|
|
|
|
echo " Config ready"
|
|
|
|
# --- Start server ---
|
|
echo "[3/4] Starting server $VERSION..."
|
|
if tmux has-session -t "$SESSION_NAME" 2>/dev/null; then
|
|
echo " Server already running"
|
|
else
|
|
bash "$ENSURE_SERVER_SCRIPT" "$VERSION" >/dev/null
|
|
mc-start "$VERSION" >/dev/null
|
|
|
|
echo -n " Waiting for server..."
|
|
for i in $(seq 1 60); do
|
|
if mc-log "$VERSION" 250 2>/dev/null | grep -Fq "Done ("; then
|
|
echo " ready (${i}s)"
|
|
break
|
|
fi
|
|
echo -n "."
|
|
sleep 1
|
|
if [[ $i -eq 60 ]]; then
|
|
echo " TIMEOUT"
|
|
echo "Server failed to start. Check: tmux attach -t $SESSION_NAME"
|
|
exit 1
|
|
fi
|
|
done
|
|
fi
|
|
|
|
if ! $PORT_SET_BY_USER; then
|
|
PORT="$(bash "$GET_PORT_SCRIPT" "$VERSION")"
|
|
fi
|
|
|
|
RUNTIME_MODE="$MODE"
|
|
if $FILE_INPUT; then
|
|
RUNTIME_MODE="${MODE}-file-input"
|
|
fi
|
|
|
|
cat > "$META_FILE" <<EOF
|
|
session=$SESSION
|
|
user=$USERNAME
|
|
mode=$RUNTIME_MODE
|
|
config=$CFG
|
|
log=$MCC_LOG
|
|
input=$INPUT_FILE
|
|
pid=$PID_FILE
|
|
tmux=$MCC_TMUX_SESSION
|
|
server_version=$VERSION
|
|
server_port=$PORT
|
|
EOF
|
|
|
|
# --- Launch MCC ---
|
|
echo "[4/4] Launching MCC in $MODE mode..."
|
|
: > "$INPUT_FILE"
|
|
rm -f "$MCC_LOG"
|
|
rm -f "$PID_FILE"
|
|
|
|
MCC_ARGS=("$CFG" "$USERNAME" "-" "localhost:$PORT")
|
|
MCC_ARGS_CMD="$(printf '%q ' "${MCC_ARGS[@]}")"
|
|
|
|
if [[ "$MODE" == "tui" ]]; then
|
|
# TUI mode: needs a real tty - no pipes or redirects allowed
|
|
tmux kill-session -t "$MCC_TMUX_SESSION" 2>/dev/null || true
|
|
tmux new-session -d -s "$MCC_TMUX_SESSION" -x 160 -y 50 \
|
|
"cd '$REPO_ROOT' && dotnet run --project MinecraftClient -c Release --no-build -- $MCC_ARGS_CMD; echo '=== MCC EXITED ==='; sleep 600"
|
|
echo ""
|
|
echo " TUI mode started in tmux session '$MCC_TMUX_SESSION'"
|
|
echo " (TUI mode uses a real terminal; log file is not available, use MCC's /debug command)"
|
|
echo ""
|
|
echo " Attach: tmux attach -t $MCC_TMUX_SESSION"
|
|
echo " Detach: Ctrl+B, D"
|
|
echo " Kill MCC: tmux kill-session -t $MCC_TMUX_SESSION"
|
|
echo ""
|
|
elif $FILE_INPUT; then
|
|
# FileInput mode: run in detached tmux, drive via session-specific input file
|
|
tmux kill-session -t "$MCC_TMUX_SESSION" 2>/dev/null || true
|
|
tmux new-session -d -s "$MCC_TMUX_SESSION" -x 160 -y 50 \
|
|
"cd '$REPO_ROOT' && printf '%s\n' \"\$\$\" > '$PID_FILE' && exec env MCC_FILE_INPUT=1 MCC_INPUT_FILE='$INPUT_FILE' dotnet run --project MinecraftClient -c Release --no-build -- $MCC_ARGS_CMD > '$MCC_LOG' 2>&1"
|
|
|
|
for _ in $(seq 1 25); do
|
|
if [[ -s "$PID_FILE" ]]; then
|
|
break
|
|
fi
|
|
sleep 0.2
|
|
done
|
|
if [[ ! -s "$PID_FILE" ]]; then
|
|
echo " Failed to capture MCC PID in $PID_FILE"
|
|
exit 1
|
|
fi
|
|
|
|
MCC_PID="$(tr -cd '0-9' < "$PID_FILE")"
|
|
if [[ -z "$MCC_PID" ]]; then
|
|
echo " Invalid PID content in $PID_FILE"
|
|
exit 1
|
|
fi
|
|
|
|
echo " MCC PID: $MCC_PID"
|
|
echo " MCC PID file: $PID_FILE"
|
|
echo ""
|
|
|
|
sleep 5
|
|
if kill -0 "$MCC_PID" 2>/dev/null; then
|
|
if grep -Fq "Server was successfully joined" "$MCC_LOG" 2>/dev/null; then
|
|
echo " MCC connected successfully!"
|
|
else
|
|
echo " MCC started (check $MCC_LOG for status)"
|
|
fi
|
|
else
|
|
echo " MCC exited unexpectedly. Check $MCC_LOG"
|
|
exit 1
|
|
fi
|
|
|
|
echo ""
|
|
echo " Send commands: echo 'debug state' >> $INPUT_FILE"
|
|
echo " Tail log: tail -f $MCC_LOG"
|
|
echo " Metadata: cat $META_FILE"
|
|
echo " Attach (optional): tmux attach -t $MCC_TMUX_SESSION"
|
|
echo " Stop MCC: echo 'quit' >> $INPUT_FILE"
|
|
echo " Stop server: mc-stop $VERSION"
|
|
echo ""
|
|
else
|
|
# Interactive classic mode: run in tmux (no pipe - ConsoleInteractive also needs tty)
|
|
tmux kill-session -t "$MCC_TMUX_SESSION" 2>/dev/null || true
|
|
tmux new-session -d -s "$MCC_TMUX_SESSION" -x 160 -y 50 \
|
|
"cd '$REPO_ROOT' && dotnet run --project MinecraftClient -c Release --no-build -- $MCC_ARGS_CMD; echo '=== MCC EXITED ==='; sleep 600"
|
|
echo ""
|
|
echo " Classic mode started in tmux session '$MCC_TMUX_SESSION'"
|
|
echo ""
|
|
echo " Attach: tmux attach -t $MCC_TMUX_SESSION"
|
|
echo " Detach: Ctrl+B, D"
|
|
echo " Kill MCC: tmux kill-session -t $MCC_TMUX_SESSION"
|
|
echo " Note: Use MCC's built-in /debug command or enable LogToFile for log output"
|
|
echo ""
|
|
fi
|
|
|
|
echo "Quick commands:"
|
|
echo " mc-rcon 'op $USERNAME' # Give operator"
|
|
echo " mc-rcon 'gamemode creative' # Creative mode"
|
|
echo " mc-stop $VERSION # Stop server"
|