diff --git a/UI_IMPROVEMENTS.md b/UI_IMPROVEMENTS.md
new file mode 100644
index 0000000..c47c3c0
--- /dev/null
+++ b/UI_IMPROVEMENTS.md
@@ -0,0 +1,304 @@
+# 🎨 UI/UX Improvements Applied
+
+## ✅ Completed Changes
+
+### 1. **3D Map Enhancements**
+
+#### Turtle Model
+- ✅ Replaced spinning cube with **proper turtle model**
+  - Shell, head, legs, tail, eyes with yellow glow
+  - Bobbing animation when selected
+  - Faces correct direction based on `facing` value
+  - Color-coded by mode (exploring=blue, returning=orange, idle=gray)
+
+#### World Block Visualization
+- ✅ **Blocks are now detected and displayed**
+  - Turtle scans forward, up, and down blocks
+  - Blocks stored in server's `worldBlocks` Map
+  - Rendered as semi-transparent colored cubes
+  - Color-coded by block type:
+    - 💎 Diamond = Cyan
+    - 💚 Emerald = Green
+    - 🟡 Gold = Gold
+    - ⚪ Iron = Light gray
+    - ⚫ Coal = Black
+    - 🔴 Redstone = Red
+    - 🔵 Lapis = Blue
+    - 🟠 Copper = Orange
+    - 🪨 Stone/Dirt/etc = Gray/Brown
+
+#### Persistence
+- ✅ **Blocks stored long-term in server**
+  - `worldBlocks` Map persists during server runtime
+  - Each block includes: position, name, metadata, discoveredBy, timestamp
+  - Sent to new clients on connection
+  - Updated as turtles discover new blocks
+
+### 2. **Server Enhancements**
+
+```javascript
+// Added world block storage
+const worldBlocks = new Map(); // "x,y,z" -> block data
+
+// Helper functions
+- storeBlock(x, y, z, blockData, turtleID)
+- getBlockPosition(turtlePos, facing, direction)
+
+// New endpoint
+GET /api/world/blocks - Returns all discovered blocks
+
+// Enhanced turtle updates
+- Processes surroundings data from turtles
+- Calculates absolute block positions
+- Stores in worldBlocks Map
+```
+
+### 3. **Turtle Script Enhancements**
+
+```lua
+-- broadcastStatus() now includes:
+surroundings = {
+    forward = {name = "minecraft:stone", metadata = 0},
+    up = {name = "minecraft:dirt", metadata = 0},
+    down = {name = "minecraft:bedrock", metadata = 0}
+}
+```
+
+### 4. **Client Store Updates**
+
+```javascript
+// New state
+worldBlocks: []
+
+// New function
+updateBlocksFromSurroundings(turtle)
+  - Calculates block positions from turtle data
+  - Adds to worldBlocks array
+  - Prevents duplicates
+```
+
+## 📋 Remaining UI Improvements
+
+### Priority 1: Responsive Layout
+
+```css
+/* Add to ControlPanel.css */
+@media (max-width: 1024px) {
+  .app-container {
+    flex-direction: column;
+  }
+  
+  .map-view {
+    height: 50vh;
+  }
+  
+  .control-panel {
+    height: 50vh;
+  }
+}
+
+@media (max-width: 768px) {
+  .turtle-grid {
+    grid-template-columns: 1fr;
+  }
+  
+  .command-grid {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+```
+
+### Priority 2: Item Icons in Inventory
+
+Create `client/src/components/InventoryItem.jsx`:
+
+```jsx
+import React from 'react';
+
+const ITEM_ICONS = {
+  'minecraft:diamond': '💎',
+  'minecraft:emerald': '💚',
+  'minecraft:gold_ore': '🟡',
+  'minecraft:iron_ore': '⚪',
+  'minecraft:coal': '⚫',
+  'minecraft:redstone': '🔴',
+  'minecraft:dirt': '🟤',
+  'minecraft:stone': '🪨',
+  'minecraft:cobblestone': '⬜',
+  // Add more...
+};
+
+export function InventoryItem({ item }) {
+  const icon = ITEM_ICONS[item.name] || '📦';
+  const shortName = item.name.replace('minecraft:', '').replace('_', ' ');
+  
+  return (
+    <div className="inventory-item">
+      <span className="item-icon">{icon}</span>
+      <span className="item-name">{shortName}</span>
+      <span className="item-count">×{item.count}</span>
+    </div>
+  );
+}
+```
+
+### Priority 3: Better Inventory Display
+
+Update `ControlPanel.jsx`:
+
+```jsx
+import { InventoryItem } from './InventoryItem';
+
+// In TurtleDetails component:
+<div className="detail-section">
+  <h3>Inventory ({turtle.inventoryCount}/16)</h3>
+  <div className="inventory-grid">
+    {turtle.inventory && turtle.inventory.map((item, idx) => (
+      <InventoryItem key={idx} item={item} />
+    ))}
+  </div>
+</div>
+```
+
+```css
+/* Add to ControlPanel.css */
+.inventory-grid {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 0.5rem;
+}
+
+.inventory-item {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  padding: 0.75rem;
+  background: #1e293b;
+  border: 2px solid #334155;
+  border-radius: 0.5rem;
+  transition: all 0.2s;
+}
+
+.inventory-item:hover {
+  border-color: #60a5fa;
+  transform: translateY(-2px);
+}
+
+.item-icon {
+  font-size: 2rem;
+  margin-bottom: 0.25rem;
+}
+
+.item-name {
+  font-size: 0.75rem;
+  color: #94a3b8;
+  text-align: center;
+  text-transform: capitalize;
+}
+
+.item-count {
+  font-size: 0.875rem;
+  color: #f1f5f9;
+  font-weight: 600;
+  margin-top: 0.25rem;
+}
+```
+
+### Priority 4: Intuitive Controls
+
+```jsx
+// Add tooltips to buttons
+<button 
+  title="Start autonomous exploration - turtle will mine valuable ores"
+  onClick={() => handleCommand('explore')}
+>
+  🔍 Explore
+</button>
+
+// Add keyboard shortcuts
+useEffect(() => {
+  const handleKeyPress = (e) => {
+    if (!turtle) return;
+    
+    switch(e.key) {
+      case 'w': handleCommand('forward'); break;
+      case 's': handleCommand('back'); break;
+      case 'a': handleCommand('turnLeft'); break;
+      case 'd': handleCommand('turnRight'); break;
+      case ' ': handleCommand('up'); break;
+      case 'Shift': handleCommand('down'); break;
+    }
+  };
+  
+  window.addEventListener('keydown', handleKeyPress);
+  return () => window.removeEventListener('keydown', handleKeyPress);
+}, [turtle]);
+```
+
+### Priority 5: Map Controls UI
+
+```jsx
+// Add map control panel
+<div className="map-controls">
+  <button onClick={() => resetCamera()}>🎯 Center</button>
+  <button onClick={() => toggleGrid()}>📏 Grid</button>
+  <button onClick={() => toggleBlocks()}>🧱 Blocks</button>
+  <label>
+    Opacity: 
+    <input 
+      type="range" 
+      min="0" 
+      max="100" 
+      value={blockOpacity} 
+      onChange={(e) => setBlockOpacity(e.target.value)}
+    />
+  </label>
+</div>
+```
+
+## 🚀 How to Apply
+
+1. **Server changes** - Already applied ✅
+2. **Turtle changes** - Already applied ✅
+3. **Client Map3D** - Already applied ✅
+4. **Client Store** - Already applied ✅
+
+### To activate:
+```bash
+# Restart server
+cd server && npm start
+
+# Rebuild client
+cd client && npm run build
+
+# Or for development
+npm run dev
+
+# In Minecraft
+# Upload updated turtle.lua and restart
+# Restart webbridge
+```
+
+## 🎯 Expected Results
+
+1. **Map shows actual discovered blocks** with colors
+2. **Turtle looks like a turtle** with proper facing direction
+3. **Blocks persist** across page refreshes (while server runs)
+4. **Real-time block discovery** as turtle explores
+5. **Performance optimized** - blocks grouped by color for efficient rendering
+
+## 📊 Performance Notes
+
+- Blocks are grouped by color in Map3D for efficient rendering
+- Semi-transparent (60% opacity) to see through
+- No textures needed - uses colored cubes
+- Could add thousands of blocks without performance issues
+
+## 🔮 Future Enhancements
+
+1. **Block textures** - Load Minecraft texture atlas
+2. **Persistent storage** - Save to database
+3. **Export/Import** - Download/upload world data
+4. **Minimap** - 2D top-down view
+5. **Block filtering** - Show only certain block types
+6. **Heatmap** - Visualize ore density