chore: housekeeping (#590)

* fix: `door-breaking-difficulty` values, fix missing defaults

* chore: bump dependencies

* chore: turn off TOCs for configuration pages, add missing descriptions

* fix: linking to config keys with special characters, config diagram border

* chore: add Experimental badges to experimental API pages

* fix: change sidebar badges

Author: zlataovce

astro.config.ts

@@ -138,6 +138,10 @@ export default defineConfig({
                         {
                           label: "Command API",
                           collapsed: true,
+                          badge: {
+                            text: "Experimental",
+                            variant: "danger",
+                          },
                           items: [
                             {
                               label: "Basics",

package.json

@@ -13,11 +13,11 @@
   },
   "dependencies": {
     "@astrojs/markdown-remark": "^6.3.1",
-    "@astrojs/starlight": "^0.34.2",
+    "@astrojs/starlight": "^0.34.3",
     "@astrojs/svelte": "^7.0.13",
     "@fontsource/jetbrains-mono": "^5.2.5",
     "@fontsource/poppins": "^5.2.6",
-    "astro": "^5.7.10",
+    "astro": "^5.7.11",
     "astro-d2": "^0.7.0",
     "sharp": "^0.34.1",
     "starlight-contributor-list": "^0.3.0",
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@types/mdast": "^4.0.4",
-    "@types/node": "^22.15.3",
+    "@types/node": "^22.15.16",
     "prettier": "3.5.3",
     "prettier-plugin-astro": "0.14.1",
     "prettier-plugin-organize-imports": "^4.1.0",

patches/@astrojs__starlight@0.34.2.patch patches/@astrojs__starlight@0.34.3.patchpatches/@astrojs__starlight@0.34.2.patch renamed to patches/@astrojs__starlight@0.34.3.patch

@@ -1,2 +1,2 @@
 patchedDependencies:
-  '@astrojs/starlight@0.34.2': patches/@astrojs__starlight@0.34.2.patch
+  '@astrojs/starlight@0.34.3': patches/@astrojs__starlight@0.34.3.patch

pnpm-lock.yaml

@@ -50,7 +50,7 @@ const formatDefault = (value?: string): Default => {
         displayKey = `"${displayKey}"`;
       }
 
-      const childPath = [...path, key.replace(/-/g, "_")];
+      const childPath = [...path, key.replace(/[-<> ]/g, "_")];
       const hasComma = json && i !== (entries.length - 1);
 
       const { value, inline } = formatDefault(rawValue.default);
@@ -101,6 +101,7 @@ const formatDefault = (value?: string): Default => {
 
   .node-root {
     padding: 1rem;
+    border: 1px solid var(--sl-color-gray-5);
     background-color: var(--sl-color-gray-6);
   }
 

pnpm-workspace.yaml

@@ -199,10 +199,16 @@ entities:
         Whether spiders should be able to climb on the world border, as if it
         were a regular wall.
     door-breaking-difficulty:
-      default: "[HARD, NORMAL, EASY, PEACEFUL]"
-      description: >-
-        Takes a list of difficulties at which each entity will attempt to break
-        doors
+      vindicator:
+        default: "[NORMAL, HARD]"
+        description: >-
+          A list of difficulties (PEACEFUL, EASY, NORMAL, HARD) at which vindicators will attempt to break doors.
+      <entity-type>:
+        default: "[HARD]"
+        description: >-
+          A list of difficulties (PEACEFUL, EASY, NORMAL, HARD) at which zombie-like entities
+          (husks, zombies, zombie villagers and zombified piglins) will attempt to break doors.
+          Defaults to *HARD*.
     ender-dragons-death-always-places-dragon-egg:
       default: "false"
       description: Controls whether ender dragons should always drop dragon eggs on death
@@ -797,6 +803,7 @@ feature-seeds:
       already set a seed to. Using this in a controlled environment is also a
       good way of receiving a full list of features you can set seeds for
   <feature-namespace>:
+    default: -1
     description: >-
       Sets the population seed for the specified feature. If set to -1, the
       Vanilla population seed stays unchanged and will not be overridden by the
@@ -1047,6 +1054,7 @@ tick-rates:
           entities
     <entity-type>:
       <behavior-name>:
+        default: -1
         description: >-
           Sets the behavior tick rate of an entity. -1 uses Vanilla. See timings
           for the names. Might change between updates!
@@ -1088,6 +1096,7 @@ tick-rates:
           entities
     <entity-type>:
       <sensor-name>:
+        default: -1
         description: >-
           Sets the sensor tick rate of an entity. -1 uses Vanilla. See timings
           for the names. Might change between updates!

src/components/ConfigNode.astro

@@ -1,6 +1,8 @@
 ---
 title: commands.yml
+description: An explanation of Bukkit's commands.yml file.
 slug: paper/reference/bukkit-commands-configuration
+tableOfContents: false
 ---
 
 import ConfigNode from "/src/components/ConfigNode.astro";

src/config/paper/paper-world-defaults.yml

@@ -2,6 +2,7 @@
 title: bukkit.yml
 description: An explanation of Bukkit's configuration file.
 slug: paper/reference/bukkit-configuration
+tableOfContents: false
 ---
 
 import ConfigNode from "/src/components/ConfigNode.astro";

src/content/docs/paper/admin/reference/configuration/bukkit-commands-configuration.mdx

@@ -1,6 +1,8 @@
 ---
 title: help.yml
+description: An explanation of Bukkit's help.yml file.
 slug: paper/reference/bukkit-help-configuration
+tableOfContents: false
 ---
 
 import ConfigNode from "/src/components/ConfigNode.astro";