{"url":"https://levimc.org/mods/github.com/amatouhake/LaminaPeek/","id":"github.com/amatouhake/LaminaPeek","name":"LaminaPeek","description":"Client-side item preview mod for LeviLamina Client (Shulker Box contents on hover)","owner":"amatouhake","logo":"https://levimc.org/mods/icons/ec2755e783ac8b11-288.webp","repository":"https://github.com/amatouhake/LaminaPeek","issues":"https://github.com/amatouhake/LaminaPeek/issues","releases":"https://github.com/amatouhake/LaminaPeek/releases","stars":4,"downloads":239,"updated":"2026-09-20T16:48:44Z","published":"2026-09-20T16:48:44Z","created":"2026-09-19T18:36:09Z","license":"MIT","side":["client"],"platform":["win-x64"],"gameVersions":["1.26.51"],"tags":["platform:levilamina","type:mod"],"latest":{"variant":"client","version":"0.1.0","install":"lip install github.com/amatouhake/LaminaPeek#client@0.1.0"},"readmes":[{"file":"README.md","lang":"en","text":"# LaminaPeek\n\nA client-side item preview mod for Minecraft Bedrock Edition, built on\n[LeviLamina Client](https://github.com/LiteLDev/LeviLamina).\n\nLaminaPeek shows the contents of container-like items directly while you hover\nthem in an inventory screen, so you can inspect many stored items quickly\nwithout opening each one.\n\n## Target\n\n* LeviLamina **v26.51.3** (client)\n* Minecraft Bedrock Edition **1.26.51.x** (Windows x64)\n\nThis is a pure client mod. It does not need any server-side component and it\nnever modifies inventories, sends transactions, or alters packets.\n\n## Current scope (MVP)\n\n* Hover a **Shulker Box** in the player inventory, a Chest, or an Ender Chest.\n* Its contents are shown immediately as a 9×3 grid (item icons and stack\n  counts), preserving the real slot layout.\n* No keybind is required; moving the cursor between Shulker Boxes updates the\n  preview instantly.\n\nPlanned (not yet implemented): Bundle preview.\n\n## How it works\n\nThree concerns are kept apart so that more item types can be added later:\n\n* `src/mod/hover/` tracks the hovered container slot by observing the game's\n  own `ContainerScreenController` hover callbacks.\n* `src/mod/preview/` turns a supported item into a `ContainerPreview` grid\n  through a small `PreviewProvider` boundary (`ShulkerPreviewProvider` reads\n  the `Items` list from the item's NBT).\n* `src/mod/render/` draws a `ContainerPreview` on top of the container screen\n  from LeviLamina's `AfterUIRenderEvent`.\n\n## Installation\n\nDownload `LaminaPeek-client-windows-x64.zip` from the\n[GitHub Releases](https://github.com/amatouhake/LaminaPeek/releases) page and\ncopy the `LaminaPeek/` directory it contains (`LaminaPeek.dll` +\n`manifest.json`) into the `mods/` directory of a LeviLamina client\ninstallation (for a LeviLauncher instance:\n`%APPDATA%\\levilauncher.exe\\versions\\<version>\\mods\\LaminaPeek\\`).\n\nThe repository also ships a `tooth.json`, so the release can be installed as\nthe LIP package `github.com/amatouhake/LaminaPeek` where LIP / LeviLauncher\npackage installation is available.\n\nLaminaPeek is early (`0.x`) software: the Shulker Box preview is usable, but\nits behaviour and configuration may still change between releases.\n\n## Building\n\nRequirements: [xmake](https://xmake.io), Visual Studio 2022 build tools, and a\nclang-cl toolchain (LLVM).\n\n```shell\nxmake f -y -p windows -a x64 -m release --target_type=client\nxmake\n```\n\nThe packaged mod (`LaminaPeek.dll` + `manifest.json`) is written to\n`bin/LaminaPeek/`; install that folder as described under\n[Installation](#installation). The `version` in the generated `manifest.json`\nis derived from the nearest `vMAJOR.MINOR.PATCH` Git tag (`0.0.0` when there\nis none).\n\nKeep the generated `manifest.json`: LeviLamina only loads mods whose manifest\nsays `\"type\": \"native\"`. Importing the bare DLL through LeviLauncher's\n\"import mod\" dialog as `preload-native` produces a manifest LeviLamina ignores,\nso the mod never loads.\n\n## Configuration\n\nOn first start LaminaPeek writes `mods/LaminaPeek/config/config.json` with the\ndefaults below. Settings are grouped per preview provider so future providers\n(for example a `bundle` section) can be added without reshaping the file.\n\n```json\n{\n    \"version\": 1,\n    \"shulker\": {\n        \"enabled\": true,\n        \"showEmpty\": false,\n        \"disableVanillaContentsPreview\": true\n    }\n}\n```\n\n* `shulker.enabled` – master switch. When `false`, LaminaPeek draws no Shulker\n  preview and leaves vanilla behaviour untouched.\n* `shulker.showEmpty` – draw the 9×3 grid for a Shulker Box with no items.\n* `shulker.disableVanillaContentsPreview` – drop only the vanilla \"contained\n  items\" lines from the Shulker Box hover text; the item name, custom name,\n  lore and every other line stay.\n\nThe file is read once at mod load; restart the game after editing it.\n\nFor runtime diagnostics, configure with `--trace=y`; the mod then logs hover,\nextraction and render events at debug level and mirrors them, flushed\nimmediately, to `mods/LaminaPeek/trace.log`.\n\nUnit tests for the game-independent layout math:\n\n```shell\nxmake build LaminaPeekTests\nxmake run LaminaPeekTests\n```\n\n## Contributing\n\nAsk questions by creating an issue. PRs accepted.\n\n## License\n\n[MIT](LICENSE) © amatouhake\n\nBootstrapped from the CC0-1.0 licensed\n[levilamina-mod-template](https://github.com/LiteLDev/levilamina-mod-template).\n"}],"gallery":[],"versions":[{"version":"0.1.0","prerelease":false,"released":"2026-09-20T16:48:44Z","releaseUrl":"https://github.com/amatouhake/LaminaPeek/releases/tag/v0.1.0","manifestUrl":"https://github.com/amatouhake/LaminaPeek/blob/v0.1.0/tooth.json","info":{"name":"LaminaPeek","description":"Client-side item preview mod for LeviLamina Client (Shulker Box contents on hover)","tags":["platform:levilamina","type:mod"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.51.*"}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}