Phase 7: player inventory viewer (NBT + online item icons)

Verified: smoke writes a real playerdata .dat and asserts the inventory parses
(diamond_sword extracted).

- Read Inventory from player NBT (handles pre-1.20.5 Count + 1.20.5+ count)
- Inventory grid in the player detail modal; item/block icons from an online,
  updatable source (assets.mcasset.cloud) with item->block->text fallback
- README updated for the big update; web panel + store marked beta / off by
  default

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: CaYatur

README.md

@@ -49,9 +49,20 @@ create, configure, monitor and control servers from a clean graphical interface.
 | Cron scheduler (restart / backup / command / broadcast) | ✅ |
 | Crash analyzer (known-pattern detection with fixes) | ✅ |
 | CI + automated portable-exe releases + in-app update check | ✅ |
-
-> Notes: Forge/NeoForge run their official installer (`--installServer`) on create.
-> Spigot is intentionally not one-click (it requires BuildTools compilation).
+| Syntax-highlighted file editor (CodeMirror) with tabs + split view | ✅ |
+| Player inventory viewer (NBT) with online item icons | ✅ |
+| Splash screen + CaYaDev branding | ✅ |
+| **Web panel** — bearer-auth, per-server RBAC, mobile-friendly (off by default) | ✅ (beta) |
+| **Store / economy** — currency, items + crates (animated), in-game delivery | ✅ (beta) |
+
+> Notes:
+> - Forge/NeoForge run their official installer (`--installServer`) on create;
+>   Spigot is intentionally not one-click (requires BuildTools compilation).
+> - The web panel is **off by default** and binds to `127.0.0.1`. LAN/mobile
+>   access is an explicit opt-in and has **no HTTPS** — only enable on a trusted
+>   network. Web panel + store are marked **beta**.
+> - A visual website/CMS builder (page design, posts) is planned; the store/
+>   economy core (products, crates, delivery, balances) is implemented.
 
 ### 🚀 Getting started (development)
 ```bash

src/main/core/players.ts

@@ -58,6 +58,19 @@ async function readPlayerData(file: string, p: PlayerInfo): Promise<void> {
     if (v?.Health) p.health = Math.round(tag(v.Health))
     if (v?.foodLevel) p.food = tag(v.foodLevel)
     if (v?.XpLevel) p.xpLevel = tag(v.XpLevel)
+    // Inventory (list of item compounds). Handles pre-1.20.5 (Count) and
+    // 1.20.5+ (count) shapes.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const inv = v?.Inventory?.value?.value as any[]
+    if (Array.isArray(inv)) {
+      p.inventory = inv
+        .map((it) => ({
+          slot: tag(it.Slot) ?? tag(it.slot) ?? -1,
+          id: String(tag(it.id) ?? '').replace('minecraft:', ''),
+          count: tag(it.Count) ?? tag(it.count) ?? 1
+        }))
+        .filter((x) => x.id)
+    }
     p.lastSeen = statSync(file).mtimeMs
   } catch {
     /* ignore unreadable */

src/main/smoke.ts

@@ -1,6 +1,7 @@
 import { app, BrowserWindow } from 'electron'
-import { existsSync } from 'node:fs'
+import { existsSync, writeFileSync, mkdirSync, rmSync } from 'node:fs'
 import { join } from 'node:path'
+import * as nbt from 'prismarine-nbt'
 import { processManager } from './core/processManager'
 import { getConfig, updateConfig } from './config'
 import { startWebServer, stopWebServer } from './web/server'
@@ -192,6 +193,50 @@ export async function runSmoke(): Promise<void> {
   if (!steve || !steve.op) return fail('players: op merge failed')
   console.log('SMOKE: rcon-enable + players merge OK')
 
+  // --- 2d. inventory NBT parse (write a real playerdata .dat) ---
+  const spath = getConfig().servers.find((s) => s.id === id)?.path ?? ''
+  const invUuid = '22222222-2222-2222-2222-222222222222'
+  const pdDir = join(spath, 'world', 'playerdata')
+  mkdirSync(pdDir, { recursive: true })
+  const datBuf = nbt.writeUncompressed(
+    {
+      type: 'compound',
+      name: '',
+      value: {
+        Health: { type: 'float', value: 20 },
+        Inventory: {
+          type: 'list',
+          value: {
+            type: 'compound',
+            value: [
+              {
+                Slot: { type: 'byte', value: 0 },
+                id: { type: 'string', value: 'minecraft:diamond_sword' },
+                Count: { type: 'byte', value: 1 }
+              }
+            ]
+          }
+        }
+      }
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    } as any,
+    'big'
+  )
+  writeFileSync(join(pdDir, invUuid + '.dat'), datBuf)
+  sf.writeTextFile(id, 'usercache.json', JSON.stringify([{ name: 'InvTester', uuid: invUuid }]))
+  const players2 = await playersMod.getPlayers(id)
+  const invp = players2.find((p) => p.name === 'InvTester')
+  sf.deleteEntry(id, 'usercache.json')
+  try {
+    rmSync(join(spath, 'world'), { recursive: true, force: true })
+  } catch {
+    /* ignore */
+  }
+  if (!invp?.inventory?.some((it) => it.id === 'diamond_sword')) {
+    return fail('inventory NBT not parsed')
+  }
+  console.log('SMOKE: inventory NBT parse OK')
+
   // --- 3. command over stdin ---
   processManager.sendCommand(id, 'say hello-from-smoke')
   await sleep(400)

src/renderer/src/components/ItemIcon.tsx

@@ -0,0 +1,43 @@
+import { useState, useEffect } from 'react'
+
+/**
+ * Minecraft item/block icon from an online, always-updatable source
+ * (assets.mcasset.cloud, which mirrors Mojang textures by version).
+ * Tries item/ then block/, then falls back to a text chip.
+ */
+export function ItemIcon({
+  id,
+  version,
+  size = 32
+}: {
+  id: string
+  version?: string
+  size?: number
+}): JSX.Element {
+  const ver = version && /^1\.\d+(\.\d+)?$/.test(version) ? version : '1.21.4'
+  const [stage, setStage] = useState(0) // 0=item, 1=block, 2=text
+  useEffect(() => setStage(0), [id, ver])
+
+  if (stage >= 2) {
+    return (
+      <div className="item-fallback" style={{ width: size, height: size }} title={id}>
+        {id.slice(0, 3)}
+      </div>
+    )
+  }
+  const folder = stage === 0 ? 'item' : 'block'
+  const url = `https://assets.mcasset.cloud/${ver}/assets/minecraft/textures/${folder}/${id}.png`
+  return (
+    <img
+      className="item-icon"
+      src={url}
+      width={size}
+      height={size}
+      alt={id}
+      title={id}
+      loading="lazy"
+      style={{ imageRendering: 'pixelated' }}
+      onError={() => setStage((s) => s + 1)}
+    />
+  )
+}

src/renderer/src/locales/en.ts

@@ -187,6 +187,7 @@ export default {
     position: 'Position',
     inventory: 'Inventory',
     inventorySoon: 'Live inventory viewer is coming in a later update.',
+    noInventory: 'No saved inventory (the player must have logged in and the world saved). Icons load from an online source.',
     clickHint: 'Click a player card for details and actions.',
     offline: 'Offline'
   },

src/renderer/src/locales/tr.ts

@@ -190,6 +190,7 @@ const tr: typeof en = {
     position: 'Konum',
     inventory: 'Envanter',
     inventorySoon: 'Canlı envanter görüntüleyici sonraki güncellemede gelecek.',
+    noInventory: 'Kayıtlı envanter yok (oyuncu giriş yapmış ve dünya kaydedilmiş olmalı). Simgeler çevrimiçi kaynaktan yüklenir.',
     clickHint: 'Ayrıntılar ve işlemler için bir oyuncu kartına tıklayın.',
     offline: 'Çevrimdışı'
   },

src/renderer/src/styles.css

@@ -1051,6 +1051,47 @@ textarea.input:focus {
   color: var(--text);
 }
 
+/* ---------- Inventory grid ---------- */
+.inv-grid {
+  display: grid;
+  grid-template-columns: repeat(9, 1fr);
+  gap: 4px;
+}
+.inv-slot {
+  position: relative;
+  aspect-ratio: 1;
+  display: grid;
+  place-items: center;
+  background: var(--bg-input);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+}
+.inv-count {
+  position: absolute;
+  right: 2px;
+  bottom: 1px;
+  font-size: 10px;
+  font-weight: 700;
+  color: #fff;
+  text-shadow: 1px 1px 0 #000;
+}
+.item-icon {
+  image-rendering: pixelated;
+}
+.item-fallback {
+  display: grid;
+  place-items: center;
+  font-size: 9px;
+  color: var(--text-faint);
+  text-transform: lowercase;
+  overflow: hidden;
+}
+@media (max-width: 560px) {
+  .inv-grid {
+    grid-template-columns: repeat(6, 1fr);
+  }
+}
+
 /* ---------- Mods / backups / scheduler rows ---------- */
 .mod-row {
   display: flex;

src/renderer/src/views/PlayersView.tsx

@@ -23,6 +23,7 @@ import {
 } from 'lucide-react'
 import { useStore } from '../store'
 import { PlayerAvatar } from '../components/PlayerAvatar'
+import { ItemIcon } from '../components/ItemIcon'
 import type { PlayerInfo } from '@shared/types'
 
 const GAMEMODES = ['survival', 'creative', 'adventure', 'spectator']
@@ -74,6 +75,7 @@ export function PlayersView(): JSX.Element {
   const { t } = useTranslation()
   const id = useStore((s) => s.activeServerId) as string
   const status = useStore((s) => s.activeStatus().status)
+  const mcVersion = useStore((s) => s.activeServer()?.mcVersion)
   const toast = useStore((s) => s.toast)
   const [list, setList] = useState<PlayerInfo[]>([])
   const [selected, setSelected] = useState<PlayerInfo | null>(null)
@@ -223,7 +225,18 @@ export function PlayersView(): JSX.Element {
               <Package size={13} style={{ verticalAlign: -2, marginRight: 6 }} />
               {t('players.inventory')}
             </div>
-            <p className="hint" style={{ marginTop: 0 }}>{t('players.inventorySoon')}</p>
+            {selected.inventory && selected.inventory.length > 0 ? (
+              <div className="inv-grid">
+                {selected.inventory.map((it, i) => (
+                  <div className="inv-slot" key={i} title={`${it.id} ×${it.count}`}>
+                    <ItemIcon id={it.id} version={mcVersion} size={30} />
+                    {it.count > 1 && <span className="inv-count">{it.count}</span>}
+                  </div>
+                ))}
+              </div>
+            ) : (
+              <p className="hint" style={{ marginTop: 0 }}>{t('players.noInventory')}</p>
+            )}
           </div>
         </div>
       )}

src/shared/types.ts

@@ -175,6 +175,13 @@ export interface PlayerInfo {
   lastSeen?: number
   playtimeHours?: number
   ip?: string
+  inventory?: InventoryItem[]
+}
+
+export interface InventoryItem {
+  slot: number
+  id: string
+  count: number
 }
 
 export type PlayerAction =