diff --git a/build/docs-manifest.ts b/build/docs-manifest.ts
index bfa7ead..a608af5 100644
--- a/build/docs-manifest.ts
+++ b/build/docs-manifest.ts
@@ -4,6 +4,7 @@ import type { ToolSpec, PromptSpec, ResourceSpec } from "../lib/factories";
 // Tool docs imports — each file exports schemas at module level with zero Blockbench deps
 import { cameraToolDocs } from "../server/tools/camera";
 import { cubeToolDocs } from "../server/tools/cubes";
+import { displayToolDocs } from "../server/tools/display";
 import { elementToolDocs } from "../server/tools/element";
 import { importToolDocs } from "../server/tools/import";
 import { meshToolDocs } from "../server/tools/mesh";
@@ -29,6 +30,7 @@ export const toolManifest: CategoryGroup[] = [
   { category: "Camera & Screenshots", tools: cameraToolDocs },
   { category: "Animation", tools: animationToolDocs },
   { category: "Armature", tools: armatureToolDocs },
+  { category: "Display Settings", tools: displayToolDocs },
   { category: "Elements", tools: elementToolDocs },
   { category: "Export", tools: exportToolDocs },
   { category: "History", tools: historyToolDocs },
diff --git a/docs/api.json b/docs/api.json
index c8ebf9c..5e05e2f 100644
--- a/docs/api.json
+++ b/docs/api.json
@@ -1,6 +1,6 @@
 {
-  "version": "1.6.0",
-  "generatedAt": "2026-05-22T14:18:59.107Z",
+  "version": "1.7.0",
+  "generatedAt": "2026-07-03T17:35:32.369Z",
   "tools": [
     {
       "name": "place_cube",
@@ -1983,6 +1983,201 @@
         "$schema": "http://json-schema.org/draft-07/schema#"
       }
     },
+    {
+      "name": "get_display_transform",
+      "title": "Get Display Transform",
+      "description": "Reads Java Edition display settings (Project.display_settings). Returns translation, rotation, scale, mirror and pivots for a single slot, or a summary of every populated slot when no slot is given. Never modifies state.",
+      "status": "experimental",
+      "category": "Display Settings",
+      "annotations": {
+        "readOnlyHint": true
+      },
+      "parameters": {
+        "$ref": "#/definitions/get_display_transform",
+        "definitions": {
+          "get_display_transform": {
+            "type": "object",
+            "properties": {
+              "slot": {
+                "type": "string",
+                "enum": [
+                  "thirdperson_righthand",
+                  "thirdperson_lefthand",
+                  "firstperson_righthand",
+                  "firstperson_lefthand",
+                  "ground",
+                  "gui",
+                  "head",
+                  "embedded",
+                  "fixed",
+                  "on_shelf"
+                ],
+                "description": "Display slot to read. If omitted, returns every populated slot in the project.",
+                "markdownDescription": "Display slot to read. If omitted, returns every populated slot in the project."
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
+    {
+      "name": "set_display_transform",
+      "title": "Set Display Transform",
+      "description": "Writes a Java Edition display slot's transform (translation, rotation, scale, mirror, pivots). Creates the slot if it does not exist yet and wraps the change in an undo step. This edits data that ships in the exported model JSON — it changes the deliverable, not just the preview. Requires a format that supports display mode (e.g. Java Block/Item).",
+      "status": "experimental",
+      "category": "Display Settings",
+      "annotations": {
+        "destructiveHint": true
+      },
+      "parameters": {
+        "$ref": "#/definitions/set_display_transform",
+        "definitions": {
+          "set_display_transform": {
+            "type": "object",
+            "properties": {
+              "slot": {
+                "type": "string",
+                "enum": [
+                  "thirdperson_righthand",
+                  "thirdperson_lefthand",
+                  "firstperson_righthand",
+                  "firstperson_lefthand",
+                  "ground",
+                  "gui",
+                  "head",
+                  "embedded",
+                  "fixed",
+                  "on_shelf"
+                ],
+                "description": "Display slot to modify.",
+                "markdownDescription": "Display slot to modify."
+              },
+              "translation": {
+                "type": "array",
+                "items": {
+                  "type": "number"
+                },
+                "minItems": 3,
+                "maxItems": 3,
+                "description": "Translation offset as [x, y, z] (Minecraft display units).",
+                "markdownDescription": "Translation offset as [x, y, z] (Minecraft display units)."
+              },
+              "rotation": {
+                "type": "array",
+                "items": {
+                  "type": "number"
+                },
+                "minItems": 3,
+                "maxItems": 3,
+                "description": "Rotation in degrees as [x, y, z].",
+                "markdownDescription": "Rotation in degrees as [x, y, z]."
+              },
+              "scale": {
+                "type": "array",
+                "items": {
+                  "type": "number"
+                },
+                "minItems": 3,
+                "maxItems": 3,
+                "description": "Scale factor as [x, y, z].",
+                "markdownDescription": "Scale factor as [x, y, z]."
+              },
+              "rotation_pivot": {
+                "type": "array",
+                "items": {
+                  "type": "number"
+                },
+                "minItems": 3,
+                "maxItems": 3,
+                "description": "Rotation pivot point as [x, y, z].",
+                "markdownDescription": "Rotation pivot point as [x, y, z]."
+              },
+              "scale_pivot": {
+                "type": "array",
+                "items": {
+                  "type": "number"
+                },
+                "minItems": 3,
+                "maxItems": 3,
+                "description": "Scale pivot point as [x, y, z].",
+                "markdownDescription": "Scale pivot point as [x, y, z]."
+              },
+              "mirror": {
+                "type": "array",
+                "items": {
+                  "type": "boolean"
+                },
+                "minItems": 3,
+                "maxItems": 3,
+                "description": "Per-axis mirror flags as [x, y, z].",
+                "markdownDescription": "Per-axis mirror flags as [x, y, z]."
+              },
+              "reset": {
+                "type": "boolean",
+                "default": false,
+                "description": "Reset the slot to its default (identity) transform before applying any of the other values.",
+                "markdownDescription": "Reset the slot to its default (identity) transform before applying any of the other values."
+              }
+            },
+            "required": [
+              "slot"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
+    {
+      "name": "enter_display_mode",
+      "title": "Enter Display Mode",
+      "description": "Switches Blockbench into Display mode, activates the given slot and optionally loads a reference model (player, zombie, armor stand, …), then returns a screenshot. Pair with set_camera_angle / capture_screenshot for multi-angle fit checks of cosmetics and handheld items. Requires a format that supports display mode.",
+      "status": "experimental",
+      "category": "Display Settings",
+      "annotations": {
+        "destructiveHint": true,
+        "openWorldHint": true
+      },
+      "parameters": {
+        "$ref": "#/definitions/enter_display_mode",
+        "definitions": {
+          "enter_display_mode": {
+            "type": "object",
+            "properties": {
+              "slot": {
+                "type": "string",
+                "enum": [
+                  "thirdperson_righthand",
+                  "thirdperson_lefthand",
+                  "firstperson_righthand",
+                  "firstperson_lefthand",
+                  "ground",
+                  "gui",
+                  "head",
+                  "embedded",
+                  "fixed",
+                  "on_shelf"
+                ],
+                "description": "Display slot to switch to and activate.",
+                "markdownDescription": "Display slot to switch to and activate."
+              },
+              "reference": {
+                "type": "string",
+                "description": "Optional reference model to load for a fit check (e.g. 'player', 'zombie', 'armor_stand', 'baby_zombie', 'block'). Validated against the live reference model list; an unknown value returns the available names.",
+                "markdownDescription": "Optional reference model to load for a fit check (e.g. 'player', 'zombie', 'armor_stand', 'baby_zombie', 'block'). Validated against the live reference model list; an unknown value returns the available names."
+              }
+            },
+            "required": [
+              "slot"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
     {
       "name": "remove_element",
       "title": "Remove Element",
@@ -2038,8 +2233,13 @@
                 },
                 "minItems": 3,
                 "maxItems": 3,
-                "description": "3D vector [x, y, z].",
-                "markdownDescription": "3D vector [x, y, z]."
+                "description": "Pivot point of the group as [x, y, z].",
+                "markdownDescription": "Pivot point of the group as [x, y, z].",
+                "default": [
+                  0,
+                  0,
+                  0
+                ]
               },
               "rotation": {
                 "type": "array",
@@ -2048,8 +2248,13 @@
                 },
                 "minItems": 3,
                 "maxItems": 3,
-                "description": "3D vector [x, y, z].",
-                "markdownDescription": "3D vector [x, y, z]."
+                "description": "Rotation of the group in degrees as [x, y, z].",
+                "markdownDescription": "Rotation of the group in degrees as [x, y, z].",
+                "default": [
+                  0,
+                  0,
+                  0
+                ]
               },
               "parent": {
                 "type": "string",
@@ -2080,9 +2285,7 @@
               }
             },
             "required": [
-              "name",
-              "origin",
-              "rotation"
+              "name"
             ],
             "additionalProperties": false
           }
diff --git a/docs/index.html b/docs/index.html
index eeff5eb..44ab84e 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -11,14 +11,14 @@
     <nav class="sidebar">
       <div class="sidebar-brand">
         <h1>Blockbench MCP</h1>
-        <p>v1.6.0 — API Reference</p>
+        <p>v1.7.0 — API Reference</p>
       </div>
 
       <input id="search" type="text" placeholder="Search tools..." class="search-input" />
 
       <div class="nav-group">
         <p class="nav-heading">Overview</p>
-        <a href="#tools" class="nav-link">Tools <span class="count">(106)</span></a>
+        <a href="#tools" class="nav-link">Tools <span class="count">(109)</span></a>
         <a href="#prompts" class="nav-link">Prompts <span class="count">(6)</span></a>
         <a href="#resources" class="nav-link">Resources <span class="count">(12)</span></a>
       </div>
@@ -29,6 +29,7 @@ <h1>Blockbench MCP</h1>
         <a href="#cat-camera-screenshots" class="nav-link">Camera &amp; Screenshots <span class="count">(3)</span></a>
         <a href="#cat-animation" class="nav-link">Animation <span class="count">(7)</span></a>
         <a href="#cat-armature" class="nav-link">Armature <span class="count">(16)</span></a>
+        <a href="#cat-display-settings" class="nav-link">Display Settings <span class="count">(3)</span></a>
         <a href="#cat-elements" class="nav-link">Elements <span class="count">(9)</span></a>
         <a href="#cat-export" class="nav-link">Export <span class="count">(2)</span></a>
         <a href="#cat-history" class="nav-link">History <span class="count">(4)</span></a>
@@ -47,9 +48,9 @@ <h1>Blockbench MCP</h1>
     <main class="main">
       <header class="page-header">
         <h1>Blockbench MCP Plugin</h1>
-        <p class="subtitle">API Reference — v1.6.0</p>
+        <p class="subtitle">API Reference — v1.7.0</p>
         <nav class="stats">
-          <a href="#tools"><strong>106</strong> tools (39 stable, 67 experimental)</a>
+          <a href="#tools"><strong>109</strong> tools (39 stable, 70 experimental)</a>
           <a href="#prompts"><strong>6</strong> prompts</a>
           <a href="#resources"><strong>12</strong> resources</a>
         </nav>
@@ -1275,6 +1276,136 @@ <h3 class="card-name">clear_vertex_weights</h3>
       </div>
     </div>
         </section>
+<section id="cat-display-settings" class="category-section">
+          <h3 class="category-title">Display Settings</h3>
+          <div id="tool-get_display_transform" class="card tool-card">
+      <div class="card-header">
+        <h3 class="card-name">get_display_transform</h3>
+        <div class="card-badges">
+          <span class="badge badge-experimental">experimental</span>
+          <span class="badge badge-readonly">read-only</span>
+        </div>
+      </div>
+      <p class="card-title">Get Display Transform</p>
+      <p class="card-desc">Reads Java Edition display settings (Project.display_settings). Returns translation, rotation, scale, mirror and pivots for a single slot, or a summary of every populated slot when no slot is given. Never modifies state.</p>
+      <div class="overflow-x">
+        <table class="param-table">
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Required</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody><tr>
+      <td class="col-name">slot</td>
+      <td class="col-type">&quot;thirdperson_righthand&quot; | &quot;thirdperson_lefthand&quot; | &quot;firstperson_righthand&quot; | &quot;firstperson_lefthand&quot; | &quot;ground&quot; | &quot;gui&quot; | &quot;head&quot; | &quot;embedded&quot; | &quot;fixed&quot; | &quot;on_shelf&quot;</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Display slot to read. If omitted, returns every populated slot in the project.</td>
+    </tr></tbody>
+    </table>
+      </div>
+    </div>
+<div id="tool-set_display_transform" class="card tool-card">
+      <div class="card-header">
+        <h3 class="card-name">set_display_transform</h3>
+        <div class="card-badges">
+          <span class="badge badge-experimental">experimental</span>
+          <span class="badge badge-destructive">destructive</span>
+        </div>
+      </div>
+      <p class="card-title">Set Display Transform</p>
+      <p class="card-desc">Writes a Java Edition display slot's transform (translation, rotation, scale, mirror, pivots). Creates the slot if it does not exist yet and wraps the change in an undo step. This edits data that ships in the exported model JSON — it changes the deliverable, not just the preview. Requires a format that supports display mode (e.g. Java Block/Item).</p>
+      <div class="overflow-x">
+        <table class="param-table">
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Required</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody><tr>
+      <td class="col-name">slot</td>
+      <td class="col-type">&quot;thirdperson_righthand&quot; | &quot;thirdperson_lefthand&quot; | &quot;firstperson_righthand&quot; | &quot;firstperson_lefthand&quot; | &quot;ground&quot; | &quot;gui&quot; | &quot;head&quot; | &quot;embedded&quot; | &quot;fixed&quot; | &quot;on_shelf&quot;</td>
+      <td><span class="param-required">required</span></td>
+      <td class="col-desc">Display slot to modify.</td>
+    </tr><tr>
+      <td class="col-name">translation</td>
+      <td class="col-type">number[]</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Translation offset as [x, y, z] (Minecraft display units). <span class="param-meta">[minItems: 3, maxItems: 3]</span></td>
+    </tr><tr>
+      <td class="col-name">rotation</td>
+      <td class="col-type">number[]</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Rotation in degrees as [x, y, z]. <span class="param-meta">[minItems: 3, maxItems: 3]</span></td>
+    </tr><tr>
+      <td class="col-name">scale</td>
+      <td class="col-type">number[]</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Scale factor as [x, y, z]. <span class="param-meta">[minItems: 3, maxItems: 3]</span></td>
+    </tr><tr>
+      <td class="col-name">rotation_pivot</td>
+      <td class="col-type">number[]</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Rotation pivot point as [x, y, z]. <span class="param-meta">[minItems: 3, maxItems: 3]</span></td>
+    </tr><tr>
+      <td class="col-name">scale_pivot</td>
+      <td class="col-type">number[]</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Scale pivot point as [x, y, z]. <span class="param-meta">[minItems: 3, maxItems: 3]</span></td>
+    </tr><tr>
+      <td class="col-name">mirror</td>
+      <td class="col-type">boolean[]</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Per-axis mirror flags as [x, y, z]. <span class="param-meta">[minItems: 3, maxItems: 3]</span></td>
+    </tr><tr>
+      <td class="col-name">reset</td>
+      <td class="col-type">boolean</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Reset the slot to its default (identity) transform before applying any of the other values. <span class="param-meta">(default: <code>false</code>)</span></td>
+    </tr></tbody>
+    </table>
+      </div>
+    </div>
+<div id="tool-enter_display_mode" class="card tool-card">
+      <div class="card-header">
+        <h3 class="card-name">enter_display_mode</h3>
+        <div class="card-badges">
+          <span class="badge badge-experimental">experimental</span>
+          <span class="badge badge-destructive">destructive</span><span class="badge badge-openworld">open-world</span>
+        </div>
+      </div>
+      <p class="card-title">Enter Display Mode</p>
+      <p class="card-desc">Switches Blockbench into Display mode, activates the given slot and optionally loads a reference model (player, zombie, armor stand, …), then returns a screenshot. Pair with set_camera_angle / capture_screenshot for multi-angle fit checks of cosmetics and handheld items. Requires a format that supports display mode.</p>
+      <div class="overflow-x">
+        <table class="param-table">
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Required</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody><tr>
+      <td class="col-name">slot</td>
+      <td class="col-type">&quot;thirdperson_righthand&quot; | &quot;thirdperson_lefthand&quot; | &quot;firstperson_righthand&quot; | &quot;firstperson_lefthand&quot; | &quot;ground&quot; | &quot;gui&quot; | &quot;head&quot; | &quot;embedded&quot; | &quot;fixed&quot; | &quot;on_shelf&quot;</td>
+      <td><span class="param-required">required</span></td>
+      <td class="col-desc">Display slot to switch to and activate.</td>
+    </tr><tr>
+      <td class="col-name">reference</td>
+      <td class="col-type">string</td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Optional reference model to load for a fit check (e.g. 'player', 'zombie', 'armor_stand', 'baby_zombie', 'block'). Validated against the live reference model list; an unknown value returns the available names.</td>
+    </tr></tbody>
+    </table>
+      </div>
+    </div>
+        </section>
 <section id="cat-elements" class="category-section">
           <h3 class="category-title">Elements</h3>
           <div id="tool-remove_element" class="card tool-card">
@@ -1334,13 +1465,13 @@ <h3 class="card-name">add_group</h3>
     </tr><tr>
       <td class="col-name">origin</td>
       <td class="col-type">number[]</td>
-      <td><span class="param-required">required</span></td>
-      <td class="col-desc">3D vector [x, y, z]. <span class="param-meta">[minItems: 3, maxItems: 3]</span></td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Pivot point of the group as [x, y, z]. <span class="param-meta">(default: <code>[0,0,0]</code>) [minItems: 3, maxItems: 3]</span></td>
     </tr><tr>
       <td class="col-name">rotation</td>
       <td class="col-type">number[]</td>
-      <td><span class="param-required">required</span></td>
-      <td class="col-desc">3D vector [x, y, z]. <span class="param-meta">[minItems: 3, maxItems: 3]</span></td>
+      <td><span class="param-optional">optional</span></td>
+      <td class="col-desc">Rotation of the group in degrees as [x, y, z]. <span class="param-meta">(default: <code>[0,0,0]</code>) [minItems: 3, maxItems: 3]</span></td>
     </tr><tr>
       <td class="col-name">parent</td>
       <td class="col-type">string</td>
@@ -4484,7 +4615,7 @@ <h3 class="card-name">hytale-cubes</h3>
       </section>
 
       <footer class="page-footer">
-        Generated 2026-05-22T14:18:59.107Z from Zod schemas
+        Generated 2026-07-03T17:35:32.369Z from Zod schemas
       </footer>
     </main>
   </div>
diff --git a/lib/zodObjects.ts b/lib/zodObjects.ts
index e863ec7..e1920b4 100644
--- a/lib/zodObjects.ts
+++ b/lib/zodObjects.ts
@@ -16,6 +16,28 @@ export const vector3Schema = z
   .length(3)
   .describe("3D vector [x, y, z].");
 
+/**
+ * Returns a *fresh* 3D vector schema instance on every call.
+ *
+ * Prefer this over sharing the module-level {@link vector3Schema} instance
+ * across multiple fields of the same `z.object`. The MCP SDK converts input
+ * schemas with `zod-to-json-schema` using `$refStrategy: "root"`, which
+ * deduplicates repeated schema instances *by object identity*: the second
+ * occurrence of a shared instance is emitted as a bare `{ "$ref": "#/…" }`
+ * with no `type`/`items`/`description`. Clients that don't resolve local
+ * `$ref`s (Claude Code among them) then see an untyped property and send it
+ * as a string, which server-side validation rejects — making the tool
+ * uncallable. Giving each field its own instance keeps the advertised schema
+ * fully inlined and typed. See issue #44.
+ *
+ * @param description - Optional field description surfaced in the JSON schema.
+ * @returns A new `z.array(z.number()).length(3)` schema.
+ */
+export const vec3 = (description?: string) => {
+  const schema = z.array(z.number()).length(3);
+  return description ? schema.describe(description) : schema;
+};
+
 // ============================================================================
 // Enum Schemas
 // ============================================================================
@@ -113,6 +135,20 @@ export const renderSidesEnum = z.enum(["auto", "front", "double"]);
 /** Loop modes for animation */
 export const loopModeEnum = z.enum(["once", "loop", "hold"]);
 
+/** Java Edition display slots (keys of `Project.display_settings`) */
+export const displaySlotEnum = z.enum([
+  "thirdperson_righthand",
+  "thirdperson_lefthand",
+  "firstperson_righthand",
+  "firstperson_lefthand",
+  "ground",
+  "gui",
+  "head",
+  "embedded",
+  "fixed",
+  "on_shelf",
+]);
+
 // ============================================================================
 // Color Schemas
 // ============================================================================
diff --git a/package.json b/package.json
index 8d33e2a..b3f0c1e 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "blockbench-mcp",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "description": "Blockbench MCP server plugin",
   "keywords": [
     "Blockbench",
diff --git a/prompts/manifest.json b/prompts/manifest.json
index d8dfc24..acbdb8f 100644
--- a/prompts/manifest.json
+++ b/prompts/manifest.json
@@ -1,6 +1,6 @@
 {
-  "version": "1.6.0",
-  "generatedAt": "2026-06-12T00:46:38.387Z",
+  "version": "1.7.0",
+  "generatedAt": "2026-07-03T17:35:20.842Z",
   "prompts": {
     "bedrock_block": "Create a new block model for Minecraft: Bedrock Edition.\n- Size total size of a block is limited to 30 pixels in all dimensions. The limit can be off-centered in all directions by 7 pixels from the block center.\n",
     "blockbench_code_eval_safety": "# Blockbench Code Evaluation Safety Guide\n\n**FOR AGENTS USING CODE EVALUATION TOOLS (e.g., `risky_eval`, code execution, REPL tools)**\n\n## Critical Security Changes in Blockbench v5.0+\n\n### ⚠️ BREAKING: Global Node.js APIs Removed\n\n```javascript\n// ❌ THESE NO LONGER WORK IN v5.0+\nfs.readFileSync()         // undefined\nos.platform()             // undefined  \nchild_process.spawn()     // undefined\n\n// ✅ USE THESE INSTEAD\nconst fs = requireNativeModule('fs');\nSystemInfo.platform\nPathModule.join()         // Still global\n```\n\n## Quick Reference for Code Generation\n\n### File System Operations\n```javascript\n// Always wrap in permission check\nconst fs = requireNativeModule('fs', {\n    message: 'Describe why you need file system access'\n});\n\nif (!fs) {\n    // User denied - handle gracefully\n    return { error: 'File system access denied' };\n}\n\n// Now safe to use\nfs.writeFileSync(path, data);\n```\n\n### System Information\n```javascript\n// No permission needed - USE THIS\nconst platform = SystemInfo.platform;        // 'win32' | 'darwin' | 'linux'\nconst home = SystemInfo.home_directory;\nconst arch = SystemInfo.arch;                // 'x64' | 'arm64'\nconst appdata = SystemInfo.appdata_directory;\nconst version = SystemInfo.os_version;\n```\n\n### Path Operations\n```javascript\n// No permission needed - USE THIS\nconst joined = PathModule.join('path', 'to', 'file');\nconst dirname = PathModule.dirname(path);\nconst basename = PathModule.basename(path);\n```\n\n### Child Process (Requires Permission)\n```javascript\nconst child_process = requireNativeModule('child_process', {\n    message: 'Execute external commands (e.g., FFmpeg for video encoding)'\n});\n\nif (!child_process) {\n    return { error: 'Process execution denied' };\n}\n\nchild_process.spawn('command', ['args']);\n```\n\n## Module Permission Matrix\n\n| Module | Permission | Alternative |\n|--------|-----------|-------------|\n| `path` | ✅ None | Use `PathModule` |\n| `crypto` | ✅ None | Direct require |\n| `fs` | ⚠️ User prompt | `requireNativeModule('fs')` |\n| `os` | ⚠️ User prompt | Use `SystemInfo` instead |\n| `child_process` | ⚠️ User prompt | `requireNativeModule('child_process')` |\n| `http/https` | ⚠️ User prompt | `requireNativeModule('https')` |\n\n## Code Generation Template\n\nWhen generating Blockbench plugin code, use this pattern:\n\n```javascript\n// ✅ SAFE PATTERN FOR v5.0+\nfunction myFeature() {\n    // 1. Check if we need native modules\n    const needsFileSystem = true; // or false\n    \n    if (needsFileSystem) {\n        // 2. Request permission with clear message\n        const fs = requireNativeModule('fs', {\n            message: 'Save configuration to disk'\n        });\n        \n        // 3. Handle denial gracefully\n        if (!fs) {\n            Blockbench.showQuickMessage('Feature requires file system access', 2000);\n            return false;\n        }\n        \n        // 4. Use the module\n        try {\n            fs.writeFileSync(path, data);\n            return true;\n        } catch (error) {\n            console.error('Failed:', error);\n            return false;\n        }\n    }\n    \n    // 5. Use SystemInfo for basic system checks\n    if (SystemInfo.platform === 'win32') {\n        // Windows-specific code\n    }\n}\n```\n\n## Common Mistakes to Avoid\n\n### ❌ Don't Do This\n```javascript\n// Requesting at plugin load\nBBPlugin.register('my_plugin', {\n    onload() {\n        const fs = requireNativeModule('fs');\n        const os = requireNativeModule('os');\n        const cp = requireNativeModule('child_process');\n        // Bombards user with 3 permission prompts!\n    }\n});\n\n// Using without checking\nconst fs = requireNativeModule('fs');\nfs.readFileSync(path); // Crashes if user denied!\n\n// Using old globals\nif (process.platform === 'win32') { // undefined in v5.0!\n```\n\n### ✅ Do This\n```javascript\n// Request on-demand\nBBPlugin.register('my_plugin', {\n    onload() {\n        // Just setup, no permissions yet\n        new Action('my_action', {\n            click: () => this.doWork()\n        });\n    },\n    \n    doWork() {\n        // Request only when needed\n        const fs = requireNativeModule('fs', {\n            message: 'Save your work'\n        });\n        \n        if (!fs) {\n            return; // Handle gracefully\n        }\n        \n        // Use safely\n        fs.writeFileSync(path, data);\n    }\n});\n\n// Use SystemInfo instead of process/os\nif (SystemInfo.platform === 'win32') {\n    // Windows-specific\n}\n```\n\n## Scoped File System (Enhanced Security)\n\nFor directory-specific access:\n\n```javascript\nconst project_fs = requireNativeModule('fs', {\n    scope: '/path/to/project',\n    message: 'Access project files in /path/to/project'\n});\n\nif (project_fs) {\n    // ✅ Works - inside scope\n    project_fs.writeFileSync('/path/to/project/file.json', data);\n    \n    // ❌ Throws - outside scope  \n    project_fs.writeFileSync('/etc/passwd', data);\n}\n```\n\n## Evaluation Safety Checklist\n\nBefore running ANY generated code in Blockbench v5.0+:\n\n- [ ] Uses `requireNativeModule()` instead of `require()` for native modules\n- [ ] Checks if module is defined before use (`if (!module) return`)\n- [ ] Uses `SystemInfo` for platform/arch/home instead of `os`/`process`\n- [ ] Uses `PathModule` for path operations\n- [ ] Requests permissions on-demand, not at plugin load\n- [ ] Includes clear permission messages\n- [ ] Handles user denial gracefully\n- [ ] Avoids direct use of `fs`, `os`, `child_process` globals\n\n## Migration Quick-Fixes\n\n| Old Code | New Code |\n|----------|----------|\n| `fs.readFileSync()` | `const fs = requireNativeModule('fs'); if (fs) fs.readFileSync()` |\n| `os.platform()` | `SystemInfo.platform` |\n| `os.homedir()` | `SystemInfo.home_directory` |\n| `process.platform` | `SystemInfo.platform` |\n| `require('path')` | `PathModule` |\n| At plugin load | On-demand in action handlers |\n\n---\n\n**Remember**: Code that works in Blockbench 4.x WILL BREAK in 5.0+ if it uses native modules. Always use the new patterns above.\n",
diff --git a/server/tools.ts b/server/tools.ts
index 3849159..28a4028 100644
--- a/server/tools.ts
+++ b/server/tools.ts
@@ -7,6 +7,7 @@ import { tools, prompts } from "@/lib/factories";
 import { registerCameraTools } from "./tools/camera";
 import { registerAnimationTools } from "./tools/animation";
 import { registerCubesTools } from "./tools/cubes";
+import { registerDisplayTools } from "./tools/display";
 import { registerElementTools } from "./tools/element";
 import { registerImportTools } from "./tools/import";
 import { registerMeshTools } from "./tools/mesh";
@@ -34,6 +35,7 @@ const registrationFunctions = [
   registerArmatureTools,
   registerCameraTools,
   registerCubesTools,
+  registerDisplayTools,
   registerElementTools,
   registerExportTools,
   registerHistoryTools,
diff --git a/server/tools/animation.ts b/server/tools/animation.ts
index 0b3832d..724a8d9 100644
--- a/server/tools/animation.ts
+++ b/server/tools/animation.ts
@@ -324,6 +324,34 @@ export const animationToolDocs: ToolSpec[] = [
   },
 ];
 
+/**
+ * Applies a keyframe's data-point values through Blockbench's real per-axis
+ * `Keyframe.set()` API. A bare number (uniform scale) is expanded to all three
+ * axes; a `[x, y, z]` array is written component-wise.
+ *
+ * `Keyframe.extend()` only merges registered properties, so a `values` key is
+ * silently dropped and `set("values", …)` writes a stray, unread property —
+ * which is why `manage_keyframes` used to leave every data point at its channel
+ * default. Scale keyframes also default to `uniform: true`, where `set()`
+ * mirrors one value to all axes, so the flag is cleared before writing
+ * genuinely non-uniform components; otherwise x/y/z collapse to the last write.
+ *
+ * @param keyframe - The keyframe to write to.
+ * @param values - `[x, y, z]` for position/rotation, or a number for uniform scale.
+ */
+function applyKeyframeValues(
+  keyframe: _Keyframe,
+  values: number[] | number
+): void {
+  const vals = Array.isArray(values) ? values : [values, values, values];
+  if (keyframe.uniform && new Set(vals).size > 1) {
+    keyframe.uniform = false;
+  }
+  keyframe.set("x", vals[0]);
+  keyframe.set("y", vals[1]);
+  keyframe.set("z", vals[2]);
+}
+
 export function registerAnimationTools() {
 createTool(
   animationToolDocs[0].name,
@@ -413,11 +441,12 @@ createTool(
       switch (action) {
         case "create":
           keyframes.forEach((kf) => {
+            // `values` is intentionally omitted here: Keyframe.extend() ignores
+            // it. Values are applied below through the real per-axis set() API.
             const keyframe = animator.createKeyframe(
               {
                 time: kf.time,
                 channel,
-                values: kf.values,
                 interpolation: kf.interpolation,
               },
               kf.time,
@@ -425,6 +454,10 @@ createTool(
               false
             );
 
+            if (kf.values !== undefined) {
+              applyKeyframeValues(keyframe, kf.values);
+            }
+
             if (kf.interpolation === "bezier" && kf.bezier_handles) {
               // @ts-ignore
               if (kf.bezier_handles.left_time !== undefined)
@@ -459,8 +492,8 @@ createTool(
               (k) => Math.abs(k.time - kf.time) < 0.001
             );
             if (keyframe) {
-              if (kf.values) {
-                keyframe.set("values", kf.values);
+              if (kf.values !== undefined) {
+                applyKeyframeValues(keyframe, kf.values);
               }
               if (kf.interpolation) {
                 keyframe.interpolation = kf.interpolation;
diff --git a/server/tools/display.ts b/server/tools/display.ts
new file mode 100644
index 0000000..a08f620
--- /dev/null
+++ b/server/tools/display.ts
@@ -0,0 +1,353 @@
+/// <reference types="three" />
+/// <reference types="blockbench-types" />
+import { z } from "zod";
+import { createTool, type ToolSpec } from "@/lib/factories";
+import { captureScreenshot } from "@/lib/util";
+import { STATUS_EXPERIMENTAL } from "@/lib/constants";
+import { displaySlotEnum, vec3 } from "@/lib/zodObjects";
+
+// ============================================================================
+// Display Settings Tool Parameter Schemas
+// ============================================================================
+
+export const getDisplayTransformParameters = z.object({
+  slot: displaySlotEnum
+    .optional()
+    .describe(
+      "Display slot to read. If omitted, returns every populated slot in the project."
+    ),
+});
+
+export const setDisplayTransformParameters = z.object({
+  slot: displaySlotEnum.describe("Display slot to modify."),
+  // Each vector uses a fresh schema instance (via vec3) so the advertised JSON
+  // schema stays fully inlined rather than collapsing repeated instances into a
+  // bare, unresolved `$ref`. See issue #44.
+  translation: vec3(
+    "Translation offset as [x, y, z] (Minecraft display units)."
+  ).optional(),
+  rotation: vec3("Rotation in degrees as [x, y, z].").optional(),
+  scale: vec3("Scale factor as [x, y, z].").optional(),
+  rotation_pivot: vec3("Rotation pivot point as [x, y, z].").optional(),
+  scale_pivot: vec3("Scale pivot point as [x, y, z].").optional(),
+  mirror: z
+    .array(z.boolean())
+    .length(3)
+    .optional()
+    .describe("Per-axis mirror flags as [x, y, z]."),
+  reset: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe(
+      "Reset the slot to its default (identity) transform before applying any of the other values."
+    ),
+});
+
+export const enterDisplayModeParameters = z.object({
+  slot: displaySlotEnum.describe("Display slot to switch to and activate."),
+  reference: z
+    .string()
+    .optional()
+    .describe(
+      "Optional reference model to load for a fit check (e.g. 'player', 'zombie', 'armor_stand', 'baby_zombie', 'block'). Validated against the live reference model list; an unknown value returns the available names."
+    ),
+});
+
+// ============================================================================
+// Display Settings Tool Docs
+// ============================================================================
+
+export const displayToolDocs: ToolSpec[] = [
+  {
+    name: "get_display_transform",
+    description:
+      "Reads Java Edition display settings (Project.display_settings). Returns translation, rotation, scale, mirror and pivots for a single slot, or a summary of every populated slot when no slot is given. Never modifies state.",
+    annotations: {
+      title: "Get Display Transform",
+      readOnlyHint: true,
+    },
+    parameters: getDisplayTransformParameters,
+    status: STATUS_EXPERIMENTAL,
+  },
+  {
+    name: "set_display_transform",
+    description:
+      "Writes a Java Edition display slot's transform (translation, rotation, scale, mirror, pivots). Creates the slot if it does not exist yet and wraps the change in an undo step. This edits data that ships in the exported model JSON — it changes the deliverable, not just the preview. Requires a format that supports display mode (e.g. Java Block/Item).",
+    annotations: {
+      title: "Set Display Transform",
+      destructiveHint: true,
+    },
+    parameters: setDisplayTransformParameters,
+    status: STATUS_EXPERIMENTAL,
+  },
+  {
+    name: "enter_display_mode",
+    description:
+      "Switches Blockbench into Display mode, activates the given slot and optionally loads a reference model (player, zombie, armor stand, …), then returns a screenshot. Pair with set_camera_angle / capture_screenshot for multi-angle fit checks of cosmetics and handheld items. Requires a format that supports display mode.",
+    annotations: {
+      title: "Enter Display Mode",
+      destructiveHint: true,
+      openWorldHint: true,
+    },
+    parameters: enterDisplayModeParameters,
+    status: STATUS_EXPERIMENTAL,
+  },
+];
+
+// ============================================================================
+// Runtime shims for Blockbench globals not covered by blockbench-types
+// ============================================================================
+
+/** Subset of the runtime DisplayMode global used here (types only cover `slots`). */
+interface IDisplayModeRuntime {
+  load?: (slot: string) => void;
+  display_slot?: string;
+}
+
+/** Subset of the runtime displayReferenceObjects global (not in blockbench-types). */
+interface IDisplayReferenceObjects {
+  refmodels?: Record<string, { load?: (index?: number) => void }>;
+}
+
+/**
+ * Serializes a DisplaySlot into a plain, JSON-friendly transform object.
+ *
+ * @param slot - The DisplaySlot instance to read.
+ * @returns The slot's translation, rotation, scale, mirror and pivot values.
+ */
+function serializeSlot(slot: DisplaySlot) {
+  return {
+    translation: slot.translation,
+    rotation: slot.rotation,
+    scale: slot.scale,
+    mirror: slot.mirror,
+    rotation_pivot: slot.rotation_pivot,
+    scale_pivot: slot.scale_pivot,
+  };
+}
+
+/**
+ * Ensures a project is open, throwing an actionable error otherwise.
+ *
+ * @returns The live `Project.display_settings` map, typed as DisplaySlot values.
+ * @throws When no project is open.
+ */
+function getDisplaySettingsOrThrow(): Record<string, DisplaySlot> {
+  if (!Project) {
+    throw new Error(
+      "No project is open. Create or open a project before working with display settings."
+    );
+  }
+  return Project.display_settings as unknown as Record<string, DisplaySlot>;
+}
+
+/**
+ * Guards that the active format supports Java Edition display settings.
+ *
+ * @throws When the current format has no display mode.
+ */
+function assertDisplayModeSupported(): void {
+  if (!Format?.display_mode) {
+    throw new Error(
+      "The current format does not support Java Edition display settings. Display transforms only apply to formats with a display mode, such as Java Block/Item."
+    );
+  }
+}
+
+// ============================================================================
+// Tool Registration
+// ============================================================================
+
+export function registerDisplayTools() {
+  createTool(
+    displayToolDocs[0].name,
+    {
+      ...displayToolDocs[0],
+      async execute({ slot }) {
+        const settings = getDisplaySettingsOrThrow();
+
+        if (slot) {
+          const displaySlot = settings[slot];
+          return JSON.stringify(
+            {
+              slot,
+              present: Boolean(displaySlot),
+              transform: displaySlot
+                ? serializeSlot(displaySlot)
+                : null,
+              note: displaySlot
+                ? undefined
+                : "Slot is not set; it exports at the default identity transform.",
+            },
+            null,
+            2
+          );
+        }
+
+        const slots = Object.entries(settings).map(([id, displaySlot]) => ({
+          slot: id,
+          ...serializeSlot(displaySlot),
+        }));
+
+        return JSON.stringify(
+          {
+            format_supports_display: Boolean(Format?.display_mode),
+            populated_count: slots.length,
+            slots,
+          },
+          null,
+          2
+        );
+      },
+    },
+    displayToolDocs[0].status
+  );
+
+  createTool(
+    displayToolDocs[1].name,
+    {
+      ...displayToolDocs[1],
+      async execute({
+        slot,
+        translation,
+        rotation,
+        scale,
+        rotation_pivot,
+        scale_pivot,
+        mirror,
+        reset,
+      }) {
+        const settings = getDisplaySettingsOrThrow();
+        assertDisplayModeSupported();
+
+        Undo.initEdit({ display_slots: [slot] });
+
+        // Create the slot on demand, mirroring Blockbench's own loadDisp().
+        let displaySlot = settings[slot];
+        if (!displaySlot) {
+          displaySlot = new DisplaySlot(slot, {});
+          settings[slot] = displaySlot;
+        }
+
+        if (reset) {
+          displaySlot.default();
+        }
+
+        // Only forward the fields the caller actually supplied so unspecified
+        // components keep their current values.
+        const data: DisplaySlotOptions = {
+          ...(translation && { translation: translation as ArrayVector3 }),
+          ...(rotation && { rotation: rotation as ArrayVector3 }),
+          ...(scale && { scale: scale as ArrayVector3 }),
+          ...(rotation_pivot && {
+            rotation_pivot: rotation_pivot as ArrayVector3,
+          }),
+          ...(scale_pivot && { scale_pivot: scale_pivot as ArrayVector3 }),
+          ...(mirror && { mirror: mirror as [boolean, boolean, boolean] }),
+        };
+        displaySlot.extend(data);
+        displaySlot.update();
+
+        Undo.finishEdit("Agent set display transform");
+        Canvas.updateAll();
+
+        return JSON.stringify(
+          {
+            slot,
+            reset: Boolean(reset),
+            transform: serializeSlot(displaySlot),
+          },
+          null,
+          2
+        );
+      },
+    },
+    displayToolDocs[1].status
+  );
+
+  createTool(
+    displayToolDocs[2].name,
+    {
+      ...displayToolDocs[2],
+      async execute({ slot, reference }) {
+        if (!Project) {
+          throw new Error(
+            "No project is open. Create or open a project before entering display mode."
+          );
+        }
+        assertDisplayModeSupported();
+
+        const notes: string[] = [];
+
+        // 1. Enter display mode if not already active. Selecting the mode runs
+        //    enterDisplaySettings() synchronously (sets up the display preview).
+        const alreadyDisplay = Boolean(Modes.display);
+        if (!alreadyDisplay) {
+          const displayMode = Modes.options.display;
+          if (!displayMode) {
+            throw new Error(
+              "Display mode is unavailable in this Blockbench build."
+            );
+          }
+          displayMode.select();
+        }
+        notes.push(
+          alreadyDisplay ? "Already in display mode." : "Entered display mode."
+        );
+
+        // 2. Activate the requested slot. Slot-activation internals differ
+        //    across Blockbench versions, so try the canonical entry point first
+        //    and fall back to older/global variants, reporting which worked.
+        const displayModeRuntime = DisplayMode as unknown as IDisplayModeRuntime;
+        const loadDisp = (
+          globalThis as unknown as { loadDisp?: (slot: string) => void }
+        ).loadDisp;
+
+        const activateSlot = (): string => {
+          if (typeof displayModeRuntime.load === "function") {
+            displayModeRuntime.load(slot);
+            return "DisplayMode.load";
+          }
+          if (typeof loadDisp === "function") {
+            loadDisp(slot);
+            return "loadDisp";
+          }
+          displayModeRuntime.display_slot = slot;
+          return "DisplayMode.display_slot";
+        };
+        notes.push(`Activated slot "${slot}" via ${activateSlot()}.`);
+
+        // 3. Load the reference model, if requested.
+        if (reference) {
+          const refObjects = (
+            globalThis as unknown as {
+              displayReferenceObjects?: IDisplayReferenceObjects;
+            }
+          ).displayReferenceObjects;
+          const refModel = refObjects?.refmodels?.[reference];
+          if (!refModel) {
+            const available = refObjects?.refmodels
+              ? Object.keys(refObjects.refmodels).join(", ")
+              : "none available";
+            throw new Error(
+              `Reference model "${reference}" not found. Available references: ${available}.`
+            );
+          }
+          refModel.load?.();
+          notes.push(`Loaded reference model "${reference}".`);
+        }
+
+        // 4. Return a screenshot of the display preview alongside the notes.
+        const shot = captureScreenshot();
+        return {
+          content: [
+            { type: "text" as const, text: notes.join(" ") },
+            ...shot.content,
+          ],
+        };
+      },
+    },
+    displayToolDocs[2].status
+  );
+}
diff --git a/server/tools/element.ts b/server/tools/element.ts
index 7692106..f9d7018 100644
--- a/server/tools/element.ts
+++ b/server/tools/element.ts
@@ -7,6 +7,7 @@ import { STATUS_EXPERIMENTAL, STATUS_STABLE } from "@/lib/constants";
 import {
   elementIdSchema,
   vector3Schema,
+  vec3,
   autoUvEnum,
 } from "@/lib/zodObjects";
 
@@ -37,12 +38,12 @@ export const findElementsByCriteriaParameters = z.object({
     .describe(
       "UUID or name of a parent group. Only descendants of this group are returned."
     ),
-  min_size: vector3Schema
-    .optional()
-    .describe("Minimum [x,y,z] size for cubes. Cubes smaller on any axis are excluded."),
-  max_size: vector3Schema
-    .optional()
-    .describe("Maximum [x,y,z] size for cubes. Cubes larger on any axis are excluded."),
+  min_size: vec3(
+    "Minimum [x,y,z] size for cubes. Cubes smaller on any axis are excluded."
+  ).optional(),
+  max_size: vec3(
+    "Maximum [x,y,z] size for cubes. Cubes larger on any axis are excluded."
+  ).optional(),
   selected_only: z
     .boolean()
     .optional()
@@ -92,8 +93,12 @@ export const getSelectionParameters = z.object({});
 
 export const addGroupParameters = z.object({
   name: z.string(),
-  origin: vector3Schema,
-  rotation: vector3Schema,
+  origin: vec3("Pivot point of the group as [x, y, z].")
+    .optional()
+    .default([0, 0, 0]),
+  rotation: vec3("Rotation of the group in degrees as [x, y, z].")
+    .optional()
+    .default([0, 0, 0]),
   parent: z.string().optional().default("root"),
   visibility: z.boolean().optional().default(true),
   autouv: autoUvEnum
diff --git a/server/tools/texture.ts b/server/tools/texture.ts
index 14db378..356b7df 100644
--- a/server/tools/texture.ts
+++ b/server/tools/texture.ts
@@ -395,6 +395,8 @@ export function registerTextureTools() {
       fill_color,
       group,
       layer_name,
+      render_mode,
+      render_sides,
     }) {
       Undo.initEdit({
         textures: [],
@@ -407,6 +409,8 @@ export function registerTextureTools() {
         height,
         group,
         pbr_channel,
+        render_mode,
+        render_sides,
         internal: true,
       });
 
@@ -452,6 +456,15 @@ export function registerTextureTools() {
 
       texture.add();
 
+      // The file/data-URL import path reassigns `texture` (via fromFile) and
+      // neither path guarantees the constructor's render settings survived, so
+      // re-apply them on the final instance and rebuild the three.js material
+      // so emissive/additive/layered modes take effect in the viewport
+      // immediately (constructing alone does not rebuild the material).
+      if (render_mode) texture.render_mode = render_mode;
+      if (render_sides) texture.render_sides = render_sides;
+      texture.updateMaterial();
+
       Undo.finishEdit("Agent created texture");
       Canvas.updateAll();