菜单
Use when proving MCC behavior on a real local Minecraft server, validating runtime or protocol changes end-to-end, exercising movement, physics, inventory, entity, chat, or terrain behavior, or running a single-version or cross-version regression sweep.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/MCCTeam/Minecraft-Console-Client --skill mcc-integration-testing命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | mcc-integration-testing |
| description | Use when proving MCC behavior on a real local Minecraft server, validating runtime or protocol changes end-to-end, exercising movement, physics, inventory, entity, chat, or terrain behavior, or running a single-version or cross-version regression sweep. |
| metadata | {"category":"discipline","triggers":["integration test","real server","local server","regression sweep","rcon","tmux","offline mode","online mode","movement","physics","inventory","entity","terrain","chat"]} |
Use this skill when the task is "prove it on a real server", not just "reason about whether it should work."
Read references/online-mode.md when the user asks for Microsoft login, device-code auth, or an online-mode server run. Use references/command-matrix.md for stable MCC-side and RCON-side commands.
Only say MCC was integration tested when MCC ran against a real local server and the claim is backed by real MCC output plus real server logs.
Calling build-only, reasoning-only, or join-only work "integration tested" is a rules violation, not shorthand.
These do not count as end-to-end proof:
If the environment cannot run a real server, say so and report the result as unexecuted or inferred, not integration tested.
1.21.11-Vanilla unless the user asks for a different version or a version matrix.MCC_SERVERS if it is set. Otherwise the default server root is MinecraftOfficial/downloads.localhost:<server-port> target for repeatable local tests.MinecraftClient.ini account defaults.BasicIO-NoColor so the device code is easy to read and relay to the user.ScriptScheduler or DiscordRpc settings can pollute the session and send unintended chat right after login.Done as startup progress, not RCON readiness. Retry the first RCON command before assuming the setup is broken.stdin.pipe, or pre-join Connection refused errors are usually environment problems until proven otherwise.Use this when one supported version is enough and you want broad coverage:
.skills/mcc-integration-testing/scripts/run_full_spectrum_test.sh 1.21.11-Vanilla
This covers join, chat, slash commands, internal MCC commands, creative inventory, entity handling, sounds, particles, TNT, kill/respawn, and log assertions.
Use this when the user asks for a regression sweep in a strict scenario order such as:
Broad validation should usually cover connect-test, item-test, entity-test, terrain-test, and chat-test.
Command:
MCC_SERVERS=/home/anon/Minecraft/Servers bash tools/run-creative-e2e.sh 1.21.11-Vanilla 1.21.11 modern
For legacy targets such as 1.8 or 1.8.9, switch the final argument to legacy and pass the pinned MC version.
Use this for TPS, movement-cadence, or packet-cadence work:
MinecraftClient/config/sample-script-tick-counter.csMinecraftClient/config/sample-script-packet-capture.csRun them against a real server with a temp config and summarize counts from the captured logs.
Use this after touching any StructuredComponents code (registries, component
parsers, subcomponents, codec helpers) to prove every component type in a
version parses on the wire without error:
bash tools/run-structured-components-test.sh 1.21.11
Run a single version (fast, ~2 min) or a matrix:
for v in 1.20.6 1.21 1.21.2 1.21.5 1.21.11 26.1; do
bash tools/run-structured-components-test.sh "$v"
done
The script gives items with every registered component via RCON /give, reads
them back with inventory player list, and asserts no parse errors in the MCC
log. Version-gated components (v1212+, v1215+, v12111+, v261) are tested only
on the versions that support them. See SC_Integration_Test_Report.md for a
reference run across all 6 version groups.
Use this after touching any dialog system code (packet handling, NBT parsing,
models, TUI, command dispatch, the state machine in DialogManager, or the
codec in DialogNbtParser). Tests all 5 dialog types, button actions (close,
run_command, show_dialog), cancel/dismiss, click-label, and body content:
tools/run-dialog-test.sh 26.1
The script starts the server if needed, generates a temp MCC config, launches
MCC with file-input mode (requires both MCC_FILE_INPUT=1 and
MCC_INPUT_FILE=<path> env vars), sends inline SNBT dialogs via RCON, and
asserts 29 checks against the MCC log.
Key requirements that differ from other test modes:
MCC_FILE_INPUT=1 is set in the
environment. The [ChatBot.FileInput] config section is ignored at load
time.MCC_INPUT_FILE, not by the config
File setting.ResourceOrIdArgument, e.g.:
dialog show <player> {type:"minecraft:notice", title:{text:"Hello"}}ActionButton.CODEC flattens CommonButtonData fields (label,
tooltip, width) into the same object as action — no button wrapper.Use this when touching inventory snapshots, player/container slot sync, creative inventory, item-slot serialization, packet palettes, game-mode updates, or block-use paths that open containers:
tools/run-inventory-full-sweep.sh --versions "1.21.10 1.21.11"
Default coverage includes:
useblockThe script writes summary.tsv under RUN_ROOT and per-version logs under /tmp/mcc-debug/inventory-full-<version>/mcc-debug.log.
When a matrix has existing PASS rows, do not rerun them unless a later code change affects that row or the user asks for a full rerun. Derive remaining rows from summaries:
awk 'FNR>1 && $2=="PASS" {print $1}' /tmp/mcc-inventory-full-sweep/*/summary.tsv | sort -V | uniq
Before running any scenario:
eula=truePreflight and reset helpers:
.skills/mcc-integration-testing/scripts/preflight_test_env.sh 1.21.11-Vanilla
.skills/mcc-integration-testing/scripts/reset_shared_test_state.sh 1.21.11-Vanilla
Offline configuration helper:
.skills/mcc-integration-testing/scripts/ensure_offline_server.sh 1.21.11-Vanilla
By default, the config helper prepares offline auth. To opt into another auth mode for a specific run, set:
MCC_TEST_ACCOUNT_TYPE=microsoft
MCC_TEST_PASSWORD=
Optionally override the login name with the fourth argument to the config helper.
.skills/mcc-integration-testing/scripts/ensure_offline_server.sh
.skills/mcc-integration-testing/scripts/preflight_test_env.sh
.skills/mcc-integration-testing/scripts/reset_shared_test_state.sh
stdin.pipe files before a rerun.skills/mcc-integration-testing/scripts/prepare_offline_mcc_config.sh
.skills/mcc-integration-testing/scripts/get_server_port.sh
server.properties or the latest server log.skills/mcc-integration-testing/scripts/run_full_spectrum_test.sh
.skills/mcc-integration-testing/scripts/summarize_test_run.sh
tools/run-creative-e2e.sh
tools/run-inventory-full-sweep.sh
tools/run-structured-components-test.sh
/give across versions 1.20.6-26.1tools/run-dialog-test.sh
In every report, separate:
Executed: exact scripts, commands, versions, auth mode, and whether the run was sequential or single-versionObserved: exact MCC output, exact server-log evidence, and the saved log directoryInferred: conclusions not directly shown by that run's runtime evidenceHarness issues: setup or runner problems such as missing Java on PATH, stale tmux sessions, stale stdin.pipe, missing log artifacts, or failed config generationNever upgrade inferred claims to observed facts. Absence of errors is supporting evidence only; pair it with a positive assertion for the feature under test.
Stop and fix the test plan if you are about to:
MinecraftClient.ini or another user-local stateful configAlways summarize:
preflight_test_env.sh. This resolves common Homebrew Java paths on macOS.MCC_TEST_ACCOUNT_TYPE=microsoft before launching the harness.BasicIO-NoColor in a real TTY, relay the device code from the TUI, and avoid pressing empty Enter at any auth prompt.ChatBot.ScriptScheduler tasks and ChatBot.DiscordRpc are common sources of test noise in user-local configs.dotnet run cannot see an existing Microsoft session, check whether SessionCache.db and ProfileKeyCache.ini need to be synced from MinecraftClient/bin/Release/net10.0/ to the repo root.Account.Login matches the cached username exactly.Connection refused, verify the launched target matches the server's actual server-port.Connection refused immediately after a server start, also check for stale shared state: old tmux sessions, a stale stdin.pipe, or a server that never actually reached Done (.use-native-transport=false in server.properties.mcc.log or a command transcript, treat it as a harness failure, fix the environment, and rerun that row before drawing product conclusions.3.Queue empty or Failed to process incoming packet, inspect packet palette routing before changing inventory code. A single shifted packet ID can make a healthy inventory feature look broken.useblock.Done log line does not prove RCON is ready. Retry setup commands and verify the actual RCON port from server.properties.tools/run-dialog-test.sh fails with "FileInput Watching: .../mcc_input.txt" pointing to the wrong directory, the MCC_INPUT_FILE env var was not set in the tmux command. FileInputBot ignores the config File setting entirely.Failed to parse structure: No key ...), check whether ActionButton.CODEC fields are flat (no button wrapper) and whether the dialog type fields match the 26.1 server (label not text in CommonButtonData).