Merge pull request #2957 from milutinke/ai-dev-workflow-docs

docs/.vuepress/styles/index.scss

@@ -0,0 +1,84 @@
+.custom-container {
+  --custom-container-accent: var(--vp-c-accent-bg);
+  --custom-container-title: var(--vp-c-accent-text);
+  --custom-container-soft: var(--vp-c-accent-soft);
+
+  margin: 0.75rem 0;
+  padding: 0.85rem 1rem;
+  border-inline-start: 0.35rem solid var(--custom-container-accent);
+  border-radius: 0.75rem;
+  background: var(--custom-container-soft);
+  color: inherit;
+  font-size: var(--hint-font-size, 0.92rem);
+  transition:
+    background var(--vp-t-color),
+    color var(--vp-t-color),
+    border-color var(--vp-t-color);
+}
+
+.custom-container > .custom-container-title {
+  margin: 0 0 0.45rem;
+  color: var(--custom-container-title);
+  font-weight: 700;
+  line-height: 1.25;
+}
+
+.custom-container > :last-child {
+  margin-bottom: 0;
+}
+
+.custom-container > :not(.custom-container-title):first-child {
+  margin-top: 0;
+}
+
+.custom-container a {
+  color: var(--vp-c-accent);
+}
+
+.custom-container :not(pre) > code {
+  background: var(--vp-c-control);
+}
+
+.custom-container.tip {
+  --custom-container-accent: var(--tip-c-accent, var(--vp-c-green-bg));
+  --custom-container-title: var(--tip-c-text, var(--vp-c-green-text));
+  --custom-container-soft: var(--tip-c-soft, var(--vp-c-green-soft));
+}
+
+.custom-container.info {
+  --custom-container-accent: var(--info-c-accent, var(--vp-c-blue-bg));
+  --custom-container-title: var(--info-c-text, var(--vp-c-blue-text));
+  --custom-container-soft: var(--info-c-soft, var(--vp-c-blue-soft));
+}
+
+.custom-container.note {
+  --custom-container-accent: var(--note-c-accent, var(--vp-c-grey-bg));
+  --custom-container-title: var(--note-c-text, var(--vp-c-grey-text));
+  --custom-container-soft: var(--note-c-soft, var(--vp-c-grey-soft));
+}
+
+.custom-container.important {
+  --custom-container-accent: var(--important-c-accent, var(--vp-c-purple-bg));
+  --custom-container-title: var(--important-c-text, var(--vp-c-purple-text));
+  --custom-container-soft: var(--important-c-soft, var(--vp-c-purple-soft));
+}
+
+.custom-container.warning {
+  --custom-container-accent: var(--warning-c-accent, var(--vp-c-yellow-bg));
+  --custom-container-title: var(--warning-c-text, var(--vp-c-yellow-text));
+  --custom-container-soft: var(--warning-c-soft, var(--vp-c-yellow-soft));
+}
+
+.custom-container.danger,
+.custom-container.caution {
+  --custom-container-accent: var(--caution-c-accent, var(--vp-c-red-bg));
+  --custom-container-title: var(--caution-c-text, var(--vp-c-red-text));
+  --custom-container-soft: var(--caution-c-soft, var(--vp-c-red-soft));
+}
+
+@media (max-width: 719px) {
+  .custom-container {
+    margin-inline: -0.75rem;
+    border-radius: 0.5rem;
+  }
+}

docs/README.md

@@ -18,6 +18,6 @@ features:
     - title: Automation
       details: Create bots to do automated tasks
     - title: Supported Versions
-      details: 1.4.6 - 1.21.11
+      details: 1.4.6 - 26.1
 footer: Made by MCC Team with ❤️
 ---

docs/guide/README.md

@@ -122,7 +122,7 @@ If you want the repeatable agent workflow used by maintainers, start with [AI-As
 
 ### Inventory, Terrain and Entity Handling
 
-MCC currently supports Minecraft versions `1.4.6` through `1.21.11`.
+MCC currently supports Minecraft versions `1.4.6` through `26.1`.
 
 Feature support still depends on protocol version:
 
@@ -136,16 +136,22 @@ If there was a major game update, and the MCC hasn't been updated to support the
 
 ### Path-Finding and Physics
 
-Currently the path-finding and physics have some limitations, those are:
-- Path finding under slabs is not supported
-- Swimming is not supported yet
-- Jumping is not supported yet
-- Knockback is not supported yet
+MCC now uses A* path-finding together with a physics-based movement system for movement and collision handling.
 
 What is supported and works:
-- Terrain navigation (path-finding with A* algorithm and walking)
-- Climbing up and down the ladders and all types of vines
-- Gravity
+- Terrain navigation with A* path-finding and physics-driven movement
+- Collision-aware movement using real block shapes
+- Automatic jumping when the path requires moving up
+- Step-up movement for slabs and similar low obstacles
+- Sneaking and sprinting
+- Movement physics in water and lava
+- Climbing up and down ladders and all types of vines
+- Gravity, friction, and block speed modifiers such as ice, soul sand, soul soil, and honey blocks
+
+Current limitations:
+- Path-finding is still block-based, so very complex terrain can still fail
+- Automatic route planning still avoids underwater routes by default, so this is not a full swimming path-finder yet
+- Knockback and other external velocity effects are not simulated yet
 
 ## Credits
 

docs/guide/ai-assisted-development.md

@@ -681,7 +681,7 @@ Use skills:
 Typical flow:
 
 ```bash
-tools/decompile.sh --version 1.21.11
+tools/decompile.sh --version 26.1
 ```
 
 Generate server reports:
@@ -689,14 +689,14 @@ Generate server reports:
 ```bash
 cd /tmp
 java -DbundlerMainClass=net.minecraft.data.Main \
-  -jar "$MCC_SERVERS/1.21.11/server.jar" \
+  -jar "$MCC_SERVERS/26.1/server.jar" \
   --reports --output /tmp/mc_reports
 ```
 
 Run the registry diff:
 
 ```bash
-python3 tools/diff_registries.py 1.21.10 1.21.11 --registry /tmp/mc_reports/reports/registries.json
+python3 tools/diff_registries.py 1.21.10 26.1 --registry /tmp/mc_reports/reports/registries.json
 ```
 
 Then regenerate the palettes that changed, update routing, build MCC, start a local server for the target version, and run live validation before calling the work done.

docs/guide/configuration.md

@@ -267,7 +267,7 @@ Coordinate = { x = 145, y = 64, z = 2045 }
 
     <div class="custom-container tip"><p class="custom-container-title">Tip</p>
 
-    **Current code support is `1.4.6` through `1.21.11`.**
+    **Current code support is `1.4.6` through `26.1`.**
 
     </div>
 

docs/guide/installation.md

@@ -35,11 +35,9 @@ Requirements:
 -   [Git](https://www.git-scm.com/)
 -   [.NET 10 SDK](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development
 
-<div class="custom-container tip"><p class="custom-container-title">Tip</p>
-
-    **If you want to modify the code, and you are new to C# or in programming in general, you might want to watch some C# tutorials, we recommend the ones listed in [Creating Bots](creating-bots.md#requirements) section.**
-
-</div>
+::: tip
+If you want to modify the code and you are new to C# or programming in general, the tutorials listed in [Creating Bots](creating-bots.md#requirements) are a good starting point.
+:::
 
 #### Cloning using Git
 

tools/README.md

@@ -120,7 +120,7 @@ Downloads block collision shapes from PrismarineJS `minecraft-data` and compacts
 
 ```bash
 # Auto-download for a specific MC version
-python3 tools/gen_block_shapes.py 1.21.11
+python3 tools/gen_block_shapes.py 26.1
 # → MinecraftClient/Physics/BlockShapeData.json
 
 # From a local file (if network is slow)