Blockshin Menu

# Blockshin Menu

A server-menu mod for **Minecraft 1.21.1**. Inspired by the menu design language of Genshin Impact, Blockshin Menu provides an in-game managed main menu, daily rewards, and a mailbox system for servers. Visual assets are created with AI assistance.

## Features

– Open the menu with the default **V** key or **`/bm`**. The keybind can be changed in Minecraft’s Controls settings.
– Sidebar navigation, profile-card backgrounds, a compact feature grid, scrollable lists, and smooth open/close animations.
– Administrators can add, edit, delete, and reorder up to **32** feature entries directly in game.
– Each entry can execute either a player command or a server command, and can use a vanilla item or a built-in preset icon.
– Supports flexible submenus for any grouped functions.
– Built-in profile-card and icon pickers. Card and icon resources are maintained in separate folders for easy server-side replacement and expansion.
– Mailbox system: mail to all players or specific players, multiple attachments, claiming, read-state deletion, administrator recall, expiry dates, scheduled delivery, and event mail triggered by first join or advancements.
– Daily rewards: players can claim once per day; administrators can configure the reward template from their inventory.
– Optional **ViScriptShop** integration: when ViScriptShop is installed, the player’s balance is displayed in the profile-card area.

## Commands

| Command | Description |
| — | — |
| `/bm` | Open Blockshin Menu |
| `/bm edit` | Open the administrator menu editor (requires OP permission level 2) |
| `/bm reload` | Reload the menu configuration (requires OP permission level 2) |
| `/bm daily` | Claim the daily reward |
| `/bm daily setfrominventory` | Configure the daily reward from the administrator’s current inventory |
| `/bm daily status` | View the daily reward configuration |
| `/bm daily clear` | Clear the daily reward configuration |

`/daily` is also available as a shortcut for claiming daily rewards.

## Requirements and Installation

**Required:**

– Minecraft **1.21.1**
– NeoForge **21.1.228** or a compatible version
– LDLib2 **2.2.28 – 2.3.x**

Place the JAR in the `mods` folder on both the client and server, then launch the game. Server configuration is stored under `serverconfig` in the world save directory.

## Administration and Resource Maintenance

– Icon resources: `assets/blockshin_menu/textures/menu/icons/`
– Profile-card resources: `assets/blockshin_menu/textures/menu/cards/`
– Icon manifest: `assets/blockshin_menu/menu/icons.json`
– Profile-card manifest: `assets/blockshin_menu/menu/cards.json