Neo Favorite Items

Neo Favorite Items is an inventory slot favorite and lock mod for Minecraft 1.21.1. It supports Fabric, Forge, and NeoForge. The mod adds lock states to player inventory slots and displays configurable overlay markers on those slots.

Neo Favorite Items 是一个适用于 Minecraft 1.21.1 的物品栏槽位收藏与锁定模组，支持 Fabric、Forge 与 NeoForge。模组用于为玩家物品栏槽位添加锁定状态，并在对应槽位上显示可配置的标记图层。

The goal of this mod is to provide a focused, standalone slot-locking mod for Minecraft 1.21.1, especially for NeoForge environments. It does not include inventory sorting, auto-refill, or inventory rule management features.

本模组的制作目标是为 Minecraft 1.21.1，尤其是 NeoForge 环境，提供一个功能范围集中的独立槽位锁定模组。它不包含自动整理、自动补货、物品栏规则管理等扩展功能。

Compared with client-side inventory management mods such as Inventory Profiles Next, Neo Favorite Items focuses on slot locking itself and provides server-authoritative state and interaction interception when installed on the server. This design is intended for server-side inventory operation scenarios that client-only mods cannot fully cover, such as sorting, quick transfer, or inventory slot changes triggered by other mods.

与以客户端物品栏管理为主的 Inventory Profiles Next 不同，Neo Favorite Items 更侧重槽位锁定本身，并在服务端安装时提供权威状态与交互拦截能力。该设计可用于处理部分仅客户端模组无法覆盖的服务端物品栏操作场景，例如整理、快速转移，以及其他模组交互导致的玩家物品栏槽位变动。

Basic Information

基本信息

• Supported Minecraft version: 1.21.1.
• 支持的 Minecraft 版本：1.21.1。
• Supported loaders: Fabric, Forge, NeoForge.
• 支持的加载器：Fabric、Forge、NeoForge。
• Mod ID: neo_favorite_items.
• Mod ID：neo_favorite_items。
• Main features: player inventory slot favorites, slot locking, interaction interception, and lock marker rendering.
• 主要功能：玩家物品栏槽位收藏、槽位锁定、交互拦截、锁定标记显示。
• Config file: config/neo-favorite-items.toml.
• 配置文件：config/neo-favorite-items.toml。
• Default lock-operation key: Left Alt.
• 默认锁定操作键：Left Alt。
• Default bypass key: Left Control.
• 默认旁路键：Left Control。

Features

功能说明

Hold the lock-operation key and click a player inventory slot to toggle its favorite state. Favorited slots display a lock marker and can block configured interaction types.

玩家按住锁定操作键后，可以点击玩家物品栏槽位来切换该槽位的收藏状态。被收藏的槽位会显示锁定标记，并根据配置阻止指定类型的交互。

Current logical slot ranges:

当前槽位索引范围如下：

• 0..8: hotbar.
• 0..8：快捷栏。
• 9..35: main inventory.
• 9..35：主背包。
• 36..39: armor slots.
• 36..39：护甲栏。
• 40: offhand slot.
• 40：副手。

The mod only applies to player inventory slots. It does not lock container-owned slots such as chest or furnace slots.

模组只针对玩家物品栏槽位生效，不会锁定箱子、熔炉等容器自身的槽位。

Interaction Interception

交互拦截

The mod can block the following operations according to configuration:

模组可根据配置阻止以下操作：

• Clicking locked slots.
• 点击已锁定槽位。
• Dropping items from locked slots.
• 从已锁定槽位丢弃物品。
• Quick-moving items from locked slots.
• 从已锁定槽位快速移动物品。
• Shift-clicking locked slots.
• Shift 点击已锁定槽位。
• Dragging items through locked slots.
• 拖拽物品经过已锁定槽位。
• Swapping items with locked slots.
• 与已锁定槽位交换物品。

When installed on the server, the mod handles favorite state and part of the interaction interception logic server-side. This can be used to intercept player inventory slot changes caused by server-side actions or other mods.

服务端安装本模组时，收藏状态与部分拦截逻辑由服务端处理。该机制可用于拦截由服务端操作或其他模组触发的玩家物品栏槽位变动。

Bypass Key

旁路键

Players can hold the bypass key to temporarily allow some operations on locked slots. Whether bypassing is allowed, how overlays appear while bypassing, and related behavior can be adjusted in the config file.

玩家可以按住旁路键临时允许部分被锁定槽位的操作。是否允许旁路、旁路时的显示效果以及相关交互行为，可以在配置文件中调整。

The default bypass key is Left Control, and it can be changed in Minecraft Controls.

默认旁路键为 Left Control，可在 Minecraft 控制设置中修改。

Overlay Markers

标记显示

Favorited slots display overlay markers in GUI screens. Locked hotbar slots also display markers on the hotbar HUD outside GUI screens.

已收藏槽位会在 GUI 中显示 Overlay 标记，退出 GUI 后也会在快捷栏 HUD 中显示对应标记。

Available overlay styles:

当前提供以下 Overlay 样式：

• border
• classic
• framework
• highlight
• brackets
• lock
• mark
• tag
• star

Overlay color, opacity, and whether the marker renders in front of item icons can be configured. Colors support among 0xAARRGGBB luv(L, u, v, alpha) and rgba(r, g, b, alpha) formats.

Overlay 的颜色、透明度、是否显示在物品图标前方等内容均可通过配置文件调整。颜色支持 0xAARRGGBB luv(L, u, v, alpha) 与 rgba(r, g, b, alpha) 三种写法。

Data Storage

数据保存

The mod stores favorite slot states per player. Storage location depends on whether the game is running in singleplayer, multiplayer, or client-only mode.

模组会按玩家保存槽位收藏状态。单人游戏、多人游戏与仅客户端使用时的数据位置会根据运行环境分别处理。

When installed on the server, the server loads and saves favorite data when players join or leave, and synchronizes favorite state to clients.

服务端安装本模组时，服务端会在玩家加入和离开时处理收藏数据的加载与保存，并向客户端同步收藏状态。

Configuration

配置内容

The config file is located at:

配置文件位于：

config/neo-favorite-items.toml

Main configuration items include:

主要配置项包括：

• Whether empty slots can be locked.
• 是否允许锁定空槽位。
• Whether empty slots automatically unlock.
• 空槽位是否自动解锁。
• Whether items can enter locked empty slots.
• 是否允许物品进入锁定的空槽位。
• Interaction interception rules for different operation types.
• 不同交互类型的拦截策略。
• How favorite state behaves when items move.
• 收藏状态在物品移动时的处理方式。
• Overlay style, color, and opacity.
• Overlay 样式、颜色与透明度。
• Lock, unlock, and bypass display behavior.
• 锁定提示、解锁提示与旁路显示效果。
• Debug logging switch.
• 调试日志开关。

Use Cases

适用场景

This mod is suitable for players or servers that need standalone slot locking. Its feature scope is focused and does not include complex inventory management features.

本模组适合需要单独槽位锁定功能的玩家或服务器使用。它的功能范围集中，不包含复杂物品栏管理功能。

For Minecraft 1.21.1 NeoForge environments, this mod can be used when independent slot locking, marker rendering, and server-side interception are required.

在 Minecraft 1.21.1 NeoForge 环境中，如果需要独立的槽位锁定、标记显示与服务端拦截能力，可以使用本模组。

Current Limitations

当前限制

• Only player inventory slots are supported. Container-owned slots are not supported.
• 当前只支持玩家物品栏槽位，不支持容器自身槽位锁定。
• Server-authoritative synchronization is implemented, but complex multiplayer interactions still need validation with specific mod combinations.
• 服务端权威同步已实现，但多人环境中的复杂交互仍需要按具体模组组合进行验证。
• Item movement policy configuration exists, but state tracking for complex movement cases is still being improved.
• 物品移动策略已提供配置入口，复杂移动场景下的状态跟踪仍在完善中。
• Visual feedback and sound feedback triggers are still under development.
• 视觉反馈与音效反馈的实际触发逻辑仍在开发中。