minecraft-inventory 0.1.0 → 0.1.2

package/src/components/Tooltip/Tooltip.module.css

@@ -1,25 +1,25 @@
 .tooltip {
   background: #100010;
   border: 1px solid #100010;
-  border-radius: 5px;
+  border-radius: 3px;
   display: flex;
   flex-direction: column;
   font-family: 'Minecraftia', 'Minecraft', monospace;
   image-rendering: pixelated;
   line-height: 1.2;
-  /* MC tooltip: 2-layer purple gradient inner glow */
+  /* Gray inner border instead of classic purple */
   box-shadow:
-    inset 0 1px 0 0 #5000a0,
-    inset 1px 0 0 0 #5000a0,
-    inset -1px 0 0 0 #5000a0,
-    inset 0 -1px 0 0 #28007f,
+    inset 0 1px 0 0 #555555,
+    inset 1px 0 0 0 #555555,
+    inset -1px 0 0 0 #555555,
+    inset 0 -1px 0 0 #444444,
     0 0 0 1px #100010;
 }
 
 .name {
   font-weight: bold;
   white-space: nowrap;
-  margin-bottom: 2px;
+  margin-bottom: 1px;
 }
 
 .section {
@@ -37,20 +37,20 @@
   flex-direction: column;
   color: #6b29a4;
   font-style: italic;
-  border-top: 1px solid #2d0069;
-  margin-top: 3px;
-  padding-top: 3px;
+  border-top: 1px solid #333333;
+  margin-top: 2px;
+  padding-top: 2px;
 }
 
 .durability {
   color: #dddddd;
-  border-top: 1px solid #2d0069;
-  margin-top: 3px;
-  padding-top: 3px;
+  border-top: 1px solid #333333;
+  margin-top: 2px;
+  padding-top: 2px;
 }
 
 .typeId {
   color: #444455;
   font-size: 0.8em;
-  margin-top: 2px;
+  margin-top: 1px;
 }

package/src/components/Tooltip/Tooltip.tsx

@@ -1,14 +1,13 @@
-import React, { useRef, useState, useEffect, useLayoutEffect } from 'react'
+import React, { useRef, useEffect } from 'react'
 import { createPortal } from 'react-dom'
 import type { ItemStack } from '../../types'
 import { useScale } from '../../context/ScaleContext'
 import { MessageFormattedString } from '../Text/MessageFormattedString'
+import { globalMouse } from '../../utils/globalMouse'
 import styles from './Tooltip.module.css'
 
 interface TooltipProps {
   item: ItemStack
-  mouseX: number
-  mouseY: number
   visible: boolean
 }
 
@@ -22,16 +21,15 @@ function formatEnchantment(e: { name: string; level: number }): string {
   return e.level <= 10 ? `${e.name} ${roman[e.level]}` : `${e.name} ${e.level}`
 }
 
-export function Tooltip({ item, mouseX, mouseY, visible }: TooltipProps) {
+export function Tooltip({ item, visible }: TooltipProps) {
   const { scale } = useScale()
   const ref = useRef<HTMLDivElement>(null)
-  const [pos, setPos] = useState({ x: -9999, y: -9999 })
-  const [ready, setReady] = useState(false)
 
-  // Recompute position every time mouse moves or item changes
-  useLayoutEffect(() => {
-    if (!visible || !ref.current) return
+  // Position the tooltip directly via DOM, bypassing React state updates.
+  // Called on every mousemove and whenever visible/item/scale changes.
+  const applyPosition = () => {
     const el = ref.current
+    if (!el) return
     const tw = el.offsetWidth
     const th = el.offsetHeight
     const vw = window.innerWidth
@@ -39,21 +37,29 @@ export function Tooltip({ item, mouseX, mouseY, visible }: TooltipProps) {
     const gapX = 12
     const gapY = 2
 
-    let x = mouseX + gapX
-    let y = mouseY - th - gapY  // above cursor by default
+    let x = globalMouse.x + gapX
+    let y = globalMouse.y - th - gapY  // above cursor by default
 
-    if (x + tw > vw - 4) x = mouseX - tw - gapX
-    if (y < 4) y = mouseY + gapY  // flip below if no space above
+    if (x + tw > vw - 4) x = globalMouse.x - tw - gapX
+    if (y < 4) y = globalMouse.y + gapY  // flip below if no space above
     if (y + th > vh - 4) y = vh - th - 4
 
-    setPos({ x, y })
-    setReady(true)
-  }, [mouseX, mouseY, visible, item, scale])
+    el.style.left = `${x}px`
+    el.style.top = `${y}px`
+    el.style.visibility = 'visible'
+  }
 
-  // Reset ready when tooltip becomes hidden
   useEffect(() => {
-    if (!visible) setReady(false)
-  }, [visible])
+    if (!visible) return
+
+    // Initial position immediately after mounting / becoming visible
+    applyPosition()
+
+    const onMove = () => applyPosition()
+    window.addEventListener('mousemove', onMove, { passive: true })
+    return () => window.removeEventListener('mousemove', onMove)
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [visible, item, scale])
 
   if (!visible) return null
 
@@ -64,8 +70,8 @@ export function Tooltip({ item, mouseX, mouseY, visible }: TooltipProps) {
     item.durability < item.maxDurability
 
   const fs = Math.round(8 * scale)
-  const pad = Math.round(4 * scale)
-  const gap2 = Math.round(1 * scale)
+  const pad = Math.round(3 * scale)
+  const gap2 = Math.round(0.5 * scale)
 
   const tooltip = (
     <div
@@ -73,15 +79,16 @@ export function Tooltip({ item, mouseX, mouseY, visible }: TooltipProps) {
       className={['mc-inv-tooltip', styles.tooltip].join(' ')}
       style={{
         position: 'fixed',
-        left: pos.x,
-        top: pos.y,
+        left: -9999,
+        top: -9999,
         zIndex: 10000,
         fontSize: fs,
         padding: pad,
         gap: gap2,
         minWidth: Math.round(80 * scale),
         maxWidth: Math.round(220 * scale),
-        visibility: ready ? 'visible' : 'hidden',
+        // Start invisible; applyPosition sets visibility after measuring dimensions
+        visibility: 'hidden',
         pointerEvents: 'none',
       }}
     >

package/src/connector/demo.ts

@@ -181,6 +181,10 @@ export function createDemoConnector(options: DemoConnectorOptions): InventoryCon
       emit({ type: 'windowClose' })
     },
 
+    openPlayerInventory: () => {
+      // Demo: nothing to ride, just a no-op (player inventory lives in playerState)
+    },
+
     subscribe: (listener: ConnectorListener) => {
       listeners.add(listener)
       return () => listeners.delete(listener)

package/src/connector/mineflayer.ts

@@ -29,8 +29,47 @@ function modeFromAction(action: InventoryAction): [number, number] {
   return [action.button === 'left' ? 0 : 1, 0]
 }
 
+/** Extended bot API from mineflayer plugins (villager, enchantment_table, anvil, beacon). */
+interface MineflayerBotExtended extends MineflayerBot {
+  trade?(villager: unknown, tradeIndex: number, count?: number): Promise<void>
+  supportFeature?(name: string): boolean
+  _client?: {
+    write(packet: string, data: unknown): void
+    writeChannel?(channel: string, data: unknown): void
+    registerChannel?(channel: string, schema: unknown): void
+  }
+}
+
+
+function isVillagerWindow(win: unknown): win is { trade: (i: number, c?: number) => Promise<void> } {
+  return (
+    win != null &&
+    typeof (win as Record<string, unknown>).trade === 'function' &&
+    Array.isArray((win as Record<string, unknown>).trades)
+  )
+}
+
+function isEnchantmentTableWindow(win: unknown): win is { enchant: (choice: number) => Promise<void> } {
+  return win != null && typeof (win as Record<string, unknown>).enchant === 'function'
+}
+
+function isAnvilWindow(
+  win: unknown
+): win is {
+  rename: (item: unknown, name: string) => Promise<void>
+  findInventoryItem?: (id: number) => unknown
+  slots?: Array<{ type?: number; metadata?: number; count?: number; nbt?: unknown } | null>
+} {
+  return win != null && typeof (win as Record<string, unknown>).rename === 'function'
+}
+
+function isBeaconWindow(win: unknown): win is { setBeaconEffects?: (primary: number, secondary: number) => Promise<void> } {
+  return win != null && (typeof (win as Record<string, unknown>).setBeaconEffects === 'function' || /beacon/i.test(String((win as Record<string, unknown>).type)))
+}
+
 export function createMineflayerConnector(bot: MineflayerBot): InventoryConnector {
   const listeners = new Set<ConnectorListener>()
+  const ext = bot as MineflayerBotExtended
 
   function emit(event: ConnectorEvent) {
     listeners.forEach((l) => l(event))
@@ -77,18 +116,123 @@ export function createMineflayerConnector(bot: MineflayerBot): InventoryConnecto
   bot.on('windowClose', onWindowClose)
   bot.on('setSlot', onSetSlot)
 
+  async function openPlayerInventory() {
+    const vehicle = bot.vehicle
+    let inventoryType = 'player'
+    
+    if (vehicle) {
+      const entityName = String(vehicle.name ?? vehicle.entityType ?? '').toLowerCase()
+      // Check if riding a llama (includes trader_llama)
+      if (/llama/i.test(entityName)) {
+        inventoryType = 'llama'
+      }
+    }
+    
+    // Build a window state for the player/llama inventory
+    const slots: SlotState[] = []
+    
+    if (inventoryType === 'llama') {
+      // Llama inventory structure (per registry):
+      // Slot 0: Carpet (saddle) - empty since we don't have entity data
+      slots.push({ index: 0, item: null })
+      // Slot 1: skipped (not used)
+      // Slots 2-16: Llama chest (5×3 grid = 15 slots) - empty since we don't have entity data
+      for (let i = 2; i <= 16; i++) {
+        slots.push({ index: i, item: null })
+      }
+      // Slots 17-43: Player inventory (bot.inventory.slots indices 9-35 map to window slots 17-43)
+      for (let i = 9; i <= 35; i++) {
+        slots.push({ index: i + 8, item: botSlotToItemStack(bot.inventory.slots[i]) })
+      }
+      // Slots 44-52: Hotbar (bot.inventory.slots indices 36-44 map to window slots 44-52)
+      for (let i = 36; i <= 44; i++) {
+        slots.push({ index: i + 8, item: botSlotToItemStack(bot.inventory.slots[i]) })
+      }
+      // Slot 53: Offhand (bot.inventory slot 45 maps to window slot 53)
+      slots.push({ index: 53, item: botSlotToItemStack(bot.inventory.slots[45]) })
+    } else {
+      // Player inventory window structure (per registry):
+      // Slots 0-8: Crafting result + grid + armor (not in bot.inventory.slots, leave empty)
+      for (let i = 0; i < 9; i++) {
+        slots.push({ index: i, item: null })
+      }
+      // Slots 9-35: Player inventory (bot.inventory.slots indices 9-35)
+      for (let i = 9; i <= 35; i++) {
+        slots.push({ index: i, item: botSlotToItemStack(bot.inventory.slots[i]) })
+      }
+      // Slots 36-44: Hotbar (bot.inventory.slots indices 36-44)
+      for (let i = 36; i <= 44; i++) {
+        slots.push({ index: i, item: botSlotToItemStack(bot.inventory.slots[i]) })
+      }
+      // Slot 45: Offhand (bot.inventory slot 45)
+      slots.push({ index: 45, item: botSlotToItemStack(bot.inventory.slots[45]) })
+    }
+    
+    const windowState: InventoryWindowState = {
+      windowId: -1, // Use -1 to indicate a synthetic/UI-only window
+      type: inventoryType,
+      title: inventoryType === 'llama' ? 'Llama' : undefined,
+      slots,
+      heldItem: botSlotToItemStack(bot.heldItem),
+    }
+    
+    emit({ type: 'windowOpen', state: windowState })
+  }
+
   return {
     getWindowState: buildWindowState,
     getPlayerState: buildPlayerState,
+    openPlayerInventory,
 
     sendAction: async (action: InventoryAction) => {
+      // Hotbar "open inventory" button — delegates to openPlayerInventory()
+      if (action.type === 'open-inventory') {
+        await openPlayerInventory()
+        return
+      }
+
+      const win = bot.currentWindow
+
+      if (action.type === 'trade' && win) {
+        if (ext.trade && isVillagerWindow(win)) {
+          await ext.trade(win, action.tradeIndex, 1)
+        } else if (isVillagerWindow(win)) {
+          await win.trade(action.tradeIndex, 1)
+        }
+        return
+      }
+
+      if (action.type === 'enchant' && win && isEnchantmentTableWindow(win)) {
+        await win.enchant(action.enchantIndex)
+        return
+      }
+
+      if (action.type === 'rename' && win && isAnvilWindow(win)) {
+        const w = win as { slots?: unknown[]; findInventoryItem?: (id: number) => unknown; rename: (item: unknown, name: string) => Promise<void> }
+        const inputSlot = w.slots?.[0] as { type?: number; metadata?: number; count?: number; nbt?: unknown } | null
+        const item = inputSlot?.type ? (w.findInventoryItem?.(inputSlot.type) ?? inputSlot) : null
+        if (item) await w.rename(item, action.text)
+        return
+      }
+
+      if (action.type === 'beacon' && win && isBeaconWindow(win)) {
+        if (typeof win.setBeaconEffects === 'function') {
+          await win.setBeaconEffects(action.primaryEffect, action.secondaryEffect)
+        } else if (ext._client) {
+          ext._client.write('beacon_effect', {
+            primaryEffect: action.primaryEffect,
+            secondaryEffect: action.secondaryEffect,
+          })
+        }
+        return
+      }
+
       if (action.type === 'click') {
         const [mouseButton, mode] = modeFromAction(action)
         await bot.clickWindow(action.slotIndex, mouseButton, mode)
       } else if (action.type === 'drop') {
         await bot.clickWindow(action.slotIndex, action.all ? 1 : 0, 4)
       } else if (action.type === 'close') {
-        const win = bot.currentWindow
         if (win) bot.closeWindow(win)
       } else if (action.type === 'hotbar-swap') {
         await bot.clickWindow(action.slotIndex, action.hotbarSlot, 2)

package/src/connector/types.ts

@@ -6,6 +6,12 @@ export interface InventoryConnector {
   sendAction(action: InventoryAction): void | Promise<void>
   closeWindow(): void | Promise<void>
   subscribe(listener: ConnectorListener): () => void
+  /**
+   * Open the player inventory, taking into account the entity the player is riding.
+   * For horse/llama/donkey/etc this activates the entity so the server sends a windowOpen.
+   * For unmounted players it emits a playerUpdate with the current inventory.
+   */
+  openPlayerInventory(): void | Promise<void>
 }
 
 export type ConnectorEvent =
@@ -17,25 +23,49 @@ export type ConnectorEvent =
 
 export type ConnectorListener = (event: ConnectorEvent) => void
 
+export interface MineflayerBotWindow {
+  id: number
+  type: string
+  title?: string
+  slots: Array<{ type: number; count: number; metadata?: number; nbt?: unknown } | null>
+}
+
+/** Villager window from bot.openVillager() — has trade() */
+export interface MineflayerVillagerWindow extends MineflayerBotWindow {
+  trade: (index: number, count?: number) => Promise<void>
+  trades: unknown[] | null
+}
+
+/** Enchantment table from bot.openEnchantmentTable() — has enchant() */
+export interface MineflayerEnchantmentTableWindow extends MineflayerBotWindow {
+  enchant: (choice: number) => Promise<void>
+}
+
+/** Anvil from bot.openAnvil() — has rename() and combine() */
+export interface MineflayerAnvilWindow extends MineflayerBotWindow {
+  rename: (item: { type: number; metadata?: number; count: number; nbt?: unknown }, name: string) => Promise<void>
+  combine: (itemOne: unknown, itemTwo: unknown, name?: string) => Promise<void>
+  findInventoryItem: (itemId: number) => unknown | null
+}
+
+/** Beacon — mineflayer has no dedicated plugin; uses packets. */
+export interface MineflayerBeaconWindow extends MineflayerBotWindow {}
+
 export interface MineflayerBot {
   inventory: {
     slots: Array<{ type: number; count: number; metadata?: number; nbt?: unknown } | null>
   }
-  currentWindow: {
-    id: number
-    type: string
-    title?: string
-    slots: Array<{ type: number; count: number; metadata?: number; nbt?: unknown } | null>
-  } | null
+  currentWindow: MineflayerBotWindow | null
   heldItem: { type: number; count: number; metadata?: number; nbt?: unknown } | null
-  health: number
-  food: number
-  foodSaturation: number
   experience: { level: number; progress: number; points: number }
   quickBarSlot: number
+  /** Entity currently being ridden, if any. Name is the mineflayer entity type string. */
+  vehicle?: { name?: string; entityType?: string; id?: number; [key: string]: unknown } | null
   clickWindow(slot: number, mouseButton: number, mode: number): Promise<void>
   closeWindow(window: unknown): void
   on(event: string, listener: (...args: unknown[]) => void): void
   off(event: string, listener: (...args: unknown[]) => void): void
   removeListener(event: string, listener: (...args: unknown[]) => void): void
+  /** For beacon/special packets; optional. */
+  _client?: { write: (name: string, data: unknown) => void }
 }

package/src/context/TextureContext.tsx

@@ -1,22 +1,23 @@
 import React, { createContext, useContext } from 'react'
 
-// Default: 1.16.4 for GUI textures (most containers existed here; 1.21.4 for items)
+// Default texture source: zardoy/mc-assets gh-pages
+export const MC_ASSETS_BASE =
+  'https://raw.githubusercontent.com/zardoy/mc-assets/refs/heads/gh-pages'
 export const MC_ITEMS_BASE =
-  'https://raw.githubusercontent.com/PrismarineJS/minecraft-assets/master/data/1.21.4'
-export const MC_GUI_BASE =
-  'https://raw.githubusercontent.com/PrismarineJS/minecraft-assets/master/data'
+  `${MC_ASSETS_BASE}/1.21.11/textures`
+export const MC_GUI_BASE = MC_ASSETS_BASE
 
 export interface TextureConfig {
   baseUrl: string
   getItemTextureUrl(item: { type: number; name?: string }): string
   getBlockTextureUrl(item: { type: number; name?: string }): string
-  /** version defaults to '1.16.4' for GUI textures unless overridden per-container */
+  /** Supports full mc-assets paths (e.g. "1.21.11/textures/gui/container/anvil.png") */
   getGuiTextureUrl(path: string, version?: string): string
 }
 
 function buildDefault(base: string): TextureConfig {
   const isRemote = base.startsWith('http')
-  // For remote default: use the same base for items, separate versioned base for GUI
+  // For remote default: use standardized versioned paths from mc-assets.
   const guiBase = isRemote ? MC_GUI_BASE : base
 
   return {
@@ -24,19 +25,24 @@ function buildDefault(base: string): TextureConfig {
 
     getItemTextureUrl({ type, name }) {
       const root = isRemote ? MC_ITEMS_BASE : base
-      if (name) return `${root}/items/${name}.png`
-      return `${root}/items/${type}.png`
+      if (name) return `${root}/item/${name}.png`
+      return `${root}/item/${type}.png`
     },
 
     getBlockTextureUrl({ type, name }) {
       const root = isRemote ? MC_ITEMS_BASE : base
-      if (name) return `${root}/blocks/${name}.png`
-      return `${root}/blocks/${type}.png`
+      if (name) return `${root}/block/${name}.png`
+      return `${root}/block/${type}.png`
     },
 
     getGuiTextureUrl(path: string, version = '1.16.4') {
       if (isRemote) {
-        return `${guiBase}/${version}/${path}.png`
+        // New format: "1.21.11/textures/gui/container/anvil.png"
+        if (path.endsWith('.png') && path.includes('/textures/')) {
+          return `${guiBase}/${path}`
+        }
+        // Backward compatibility with legacy "gui/container/anvil" + version fields.
+        return `${guiBase}/${version}/textures/${path}.png`
       }
       return `${base}/textures/${path}.png`
     },

package/src/generated/localTextures.ts

@@ -0,0 +1,112 @@
+// Auto-generated by scripts/generate-texture-imports.mjs — do not edit manually
+// Re-run `node scripts/generate-texture-imports.mjs` after changing inventories.
+
+import _gui_container_inventory from 'mc-assets/dist/other-textures/latest/gui/container/inventory.png'
+import _gui_container_shulker_box from 'mc-assets/dist/other-textures/latest/gui/container/shulker_box.png'
+import _gui_container_generic_54 from 'mc-assets/dist/other-textures/latest/gui/container/generic_54.png'
+import _gui_container_crafting_table from 'mc-assets/dist/other-textures/latest/gui/container/crafting_table.png'
+import _gui_container_furnace from 'mc-assets/dist/other-textures/latest/gui/container/furnace.png'
+import _gui_container_blast_furnace from 'mc-assets/dist/other-textures/latest/gui/container/blast_furnace.png'
+import _gui_container_smoker from 'mc-assets/dist/other-textures/latest/gui/container/smoker.png'
+import _gui_container_brewing_stand from 'mc-assets/dist/other-textures/latest/gui/container/brewing_stand.png'
+import _gui_container_anvil from 'mc-assets/dist/other-textures/latest/gui/container/anvil.png'
+import _gui_container_grindstone from 'mc-assets/dist/other-textures/latest/gui/container/grindstone.png'
+import _gui_container_enchanting_table from 'mc-assets/dist/other-textures/latest/gui/container/enchanting_table.png'
+import _gui_container_smithing from 'mc-assets/dist/other-textures/latest/gui/container/smithing.png'
+import _gui_container_hopper from 'mc-assets/dist/other-textures/latest/gui/container/hopper.png'
+import _gui_container_dispenser from 'mc-assets/dist/other-textures/latest/gui/container/dispenser.png'
+import _gui_container_beacon from 'mc-assets/dist/other-textures/latest/gui/container/beacon.png'
+import _gui_container_horse from 'mc-assets/dist/other-textures/latest/gui/container/horse.png'
+import _gui_container_villager2 from 'mc-assets/dist/other-textures/latest/gui/container/villager2.png'
+import _gui_container_cartography_table from 'mc-assets/dist/other-textures/latest/gui/container/cartography_table.png'
+import _gui_container_loom from 'mc-assets/dist/other-textures/latest/gui/container/loom.png'
+import _gui_container_stonecutter from 'mc-assets/dist/other-textures/latest/gui/container/stonecutter.png'
+import _gui_container_crafter from 'mc-assets/dist/other-textures/latest/gui/container/crafter.png'
+import _gui_container_creative_inventory_tab_items from 'mc-assets/dist/other-textures/latest/gui/container/creative_inventory/tab_items.png'
+import _gui_widgets from 'mc-assets/dist/other-textures/1.15/gui/widgets.png'
+
+/**
+ * Maps each inventory type name to its texture path (version prefix stripped).
+ * Useful for building custom texture resolvers or inspecting the full texture list.
+ */
+export const allContainerPaths: Record<string, string> = {
+  player: 'gui/container/inventory.png',
+  chest: 'gui/container/shulker_box.png',
+  generic_9x1: 'gui/container/shulker_box.png',
+  large_chest: 'gui/container/generic_54.png',
+  crafting_table: 'gui/container/crafting_table.png',
+  furnace: 'gui/container/furnace.png',
+  blast_furnace: 'gui/container/blast_furnace.png',
+  smoker: 'gui/container/smoker.png',
+  brewing_stand: 'gui/container/brewing_stand.png',
+  anvil: 'gui/container/anvil.png',
+  grindstone: 'gui/container/grindstone.png',
+  enchanting_table: 'gui/container/enchanting_table.png',
+  smithing_table: 'gui/container/smithing.png',
+  smithing_table_legacy: 'gui/container/smithing.png',
+  hopper: 'gui/container/hopper.png',
+  dispenser: 'gui/container/dispenser.png',
+  dropper: 'gui/container/dispenser.png',
+  beacon: 'gui/container/beacon.png',
+  horse: 'gui/container/horse.png',
+  donkey: 'gui/container/horse.png',
+  llama: 'gui/container/horse.png',
+  villager: 'gui/container/villager2.png',
+  shulker_box: 'gui/container/shulker_box.png',
+  barrel: 'gui/container/shulker_box.png',
+  cartography_table: 'gui/container/cartography_table.png',
+  loom: 'gui/container/loom.png',
+  stonecutter: 'gui/container/stonecutter.png',
+  crafter: 'gui/container/crafter.png',
+  creative: 'gui/container/creative_inventory/tab_items.png',
+  hotbar: 'gui/widgets.png',
+}
+
+// Internal: full versioned texture path → bundled asset URL (or undefined = not found)
+const _map: Record<string, string | undefined> = {
+  '1.21.11/textures/gui/container/inventory.png': _gui_container_inventory,
+  '1.21.11/textures/gui/container/shulker_box.png': _gui_container_shulker_box,
+  '1.21.11/textures/gui/container/generic_54.png': _gui_container_generic_54,
+  '1.21.11/textures/gui/container/crafting_table.png': _gui_container_crafting_table,
+  '1.21.11/textures/gui/container/furnace.png': _gui_container_furnace,
+  '1.21.11/textures/gui/container/blast_furnace.png': _gui_container_blast_furnace,
+  '1.21.11/textures/gui/container/smoker.png': _gui_container_smoker,
+  '1.21.11/textures/gui/container/brewing_stand.png': _gui_container_brewing_stand,
+  '1.21.11/textures/gui/container/anvil.png': _gui_container_anvil,
+  '1.21.11/textures/gui/container/grindstone.png': _gui_container_grindstone,
+  '1.21.11/textures/gui/container/enchanting_table.png': _gui_container_enchanting_table,
+  '1.21.11/textures/gui/container/smithing.png': _gui_container_smithing,
+  '1.16.4/textures/gui/container/smithing.png': _gui_container_smithing,
+  '1.21.11/textures/gui/container/hopper.png': _gui_container_hopper,
+  '1.21.11/textures/gui/container/dispenser.png': _gui_container_dispenser,
+  '1.21.11/textures/gui/container/beacon.png': _gui_container_beacon,
+  '1.21.11/textures/gui/container/horse.png': _gui_container_horse,
+  '1.14/textures/gui/container/villager2.png': _gui_container_villager2,
+  '1.21.11/textures/gui/container/cartography_table.png': _gui_container_cartography_table,
+  '1.21.11/textures/gui/container/loom.png': _gui_container_loom,
+  '1.21.11/textures/gui/container/stonecutter.png': _gui_container_stonecutter,
+  '1.21.11/textures/gui/container/crafter.png': _gui_container_crafter,
+  '1.21.11/textures/gui/container/creative_inventory/tab_items.png': _gui_container_creative_inventory_tab_items,
+  '1.15/textures/gui/widgets.png': _gui_widgets,
+}
+
+/**
+ * Partial TextureConfig that resolves inventory GUI textures from locally bundled
+ * mc-assets assets instead of remote GitHub URLs.
+ *
+ * Pass to `<TextureProvider config={localTexturesConfig}>` to use offline/bundled assets:
+ *
+ * ```tsx
+ * import { localTexturesConfig } from './generated/localTextures'
+ * <TextureProvider config={localTexturesConfig}>
+ *   <InventoryOverlay type="chest" ... />
+ * </TextureProvider>
+ * ```
+ */
+export const localTexturesConfig = {
+  getGuiTextureUrl(path: string): string {
+    // _map keys are the full versioned paths used in inventories.ts
+    // e.g. '1.21.11/textures/gui/container/anvil.png'
+    return (_map[path] as string | undefined) ?? path
+  },
+}

package/src/globals.d.ts

@@ -2,3 +2,7 @@ declare module '*.module.css' {
   const content: Record<string, string>
   export default content
 }
+declare module '*.png' {
+  const content: string
+  export default content
+}

package/src/index.tsx

@@ -14,7 +14,8 @@ export { ItemCanvas } from './components/ItemCanvas'
 export { Tooltip } from './components/Tooltip'
 export { JEI } from './components/JEI'
 export type { JEIItem } from './components/JEI'
-export { Hotbar } from './components/Hotbar'
+export { Notes } from './components/Notes'
+export type { Note } from './components/Notes'
 export { HUD } from './components/HUD'
 export { CursorItem } from './components/CursorItem'
 export { InventoryOverlay } from './components/InventoryOverlay'
@@ -46,7 +47,7 @@ export type { ActionLogEntry, DemoConnectorOptions } from './connector/demo'
 
 // Registry
 export { registerInventoryType, getInventoryType, getAllInventoryTypes } from './registry'
-export type { InventoryTypeDefinition } from './registry'
+export type { InventoryTypeDefinition, WindowType } from './registry'
 
 // Types
 export type {

package/src/registry/index.ts

@@ -19,3 +19,4 @@ export function getAllInventoryTypes(): InventoryTypeDefinition[] {
 
 export { inventoryDefinitions }
 export type { InventoryTypeDefinition }
+export type WindowType = keyof typeof inventoryDefinitions