Item Scroller - 批量物品操作助手
====================================

.. raw:: html

   <p style="margin:0 0 24px;">
     <a href="index.html" target="_blank" style="display:inline-block;padding:10px 20px;background:#57A64E;color:#fff;border-radius:6px;text-decoration:none;font-weight:bold;">
       🎮 打开 PPT 风格演示（含实机视频）
     </a>
   </p>

Item Scroller 是一款客户端物品操作 MOD，主要用于减少容器 GUI 中的重复点击。核心能力集中在三个场景：移动物品、丢弃物品和合成物品。

核心场景
------------------------

.. list-table::
   :header-rows: 1
   :widths: 16 32 52

   * - 场景
     - 用户需求
     - 核心操作
   * - 移动物品
     - 移动一个、固定数量、一个堆叠、同类全部或一批物品
     - 滚轮移动一个；鼠标右键拆半；``Shift + 鼠标左键`` 移动一个堆叠；``Alt + 鼠标左键`` 移动同类全部；``Shift + 鼠标左键 + 拖动`` 移动一批
   * - 丢弃物品
     - 丢弃一个、连续逐个丢弃、一个堆叠或一批物品
     - 按一次 ``Q`` 丢一个；按住 ``Q`` 连续丢；``Shift + Q + 鼠标左键`` 丢一个堆叠；保持组合键并拖动可丢弃一批
   * - 合成物品
     - 保存常用配方，并批量或循环合成
     - 按住 ``A`` 打开配方面板；用鼠标中键保存；``Ctrl + C`` 合成一轮；按住 ``Ctrl + Alt + C`` 循环合成

使用提示
------------------------

- 多个物品可用鼠标右键拆半，或在物品上滚动指定次数完成固定数量移动。
- 丢弃的物品会落在玩家附近，操作前注意岩浆和悬崖。
- 快捷键可能与其他 MOD 冲突，可在 Item Scroller 配置中调整。

实机演示视频
------------------------

顶部的 PPT 风格演示中包含三段 OBS 实机录屏，点击对应场景的视频按钮即可播放：

- ``物品取用放置.mp4``：展示移动物品
- ``物品丢弃.mp4``：展示丢弃物品
- ``物品极速合成.mp4``：展示合成物品

安装与项目
------------------------

- 同时安装与当前游戏版本匹配的 **Item Scroller** 和 **MaLiLib**。
- 根据下载页面选择对应的 Minecraft 版本与加载器文件。
- 作者：maruohon
- GitHub：https://github.com/maruohon/itemscroller/