自动拾取(Simple AutoPickup)

自动拾取(Simple AutoPickup)

---

Github | 相关wiki | 源站链接

支持: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11,

Auto Pickup 是一款轻量级的 Fabric 模组，能自动将挖掘方块和击杀生物的战利品直接收入背包，无需手动拾取，支持多种配置选项。

Auto Pickup 模组介绍

Auto Pickup 是一款简单、轻量级的服务器端 Fabric 模组，它能自动将破坏方块和击杀生物掉落的物品与经验直接放入你的背包，无需追逐掉落物，避免物品丢失。

✨ 主要功能

• 无缝收集：破坏方块和生物掉落的物品会立即添加到背包中。
• 自动经验收集：经验球通过缓存系统直接收集，不会在世界上生成实体。
• 减少延迟：防止物品和经验球实体生成，有助于降低服务器延迟。
• 智能处理：如果背包已满，无法拾取的物品会安全地掉落在你的脚下。
• 广泛的模组兼容性：自动与大多数模组协同工作。
• 精细控制：通过命令或配置文件切换特定功能。
• 客户端控制：可选设置允许玩家使用 Mod Menu 切换自己的自动拾取设置。

⚙️ 配置方法

Auto Pickup 不再通过游戏规则控制，现在使用配置文件（config/autopickup.toml）和游戏内命令进行配置。

🖥️ Mod Menu 集成（客户端）

如果你安装了 Mod Menu，可以在主菜单或暂停屏幕通过 Mods 按钮直接配置模组。

• 注意：更改这里的设置仅当服务器管理员启用了 allowClientControl 时才会影响服务器。

📜 命令（服务器管理员）

服务器操作员（OP 等级 2+）可以使用 /autopickup 命令配置全局默认设置。

📂 配置文件

配置存储在 config/autopickup.toml 中，你可以直接编辑此文件。

<h1>AutoPickup 配置</h1>

auto_pickup = true
auto_pickup_blocks = true
auto_pickup_mob_loot = false
auto_pickup_xp = true
allow_client_control = falseCopy已复制！

📦 安装步骤

这是一个标准的 Fabric 模组。

1. 确保已安装 Fabric Loader。
2. 下载 Fabric API 并放入 mods 文件夹。
3. 从发布页面下载 Auto Pickup 的 JAR 文件。
4. 将 auto-pickup-x.x.x.jar 文件放入 mods 文件夹。

✅ 兼容性

Auto Pickup 通过挂钩到 Minecraft 的基础机制，设计为最大兼容性。

• 连锁挖矿 / 轻量挖矿：完全支持。挖掘连锁方块会立即拾取所有掉落物和经验。
• 树木收割：完全支持。砍树时，原木和其他掉落物会被拾取，而自动重植所需的树苗会被重植。
• 旅行者背包：完全支持。如果你有带 自动拾取升级 的背包，物品会先路由到背包过滤器。如果背包已满或物品未被过滤，则回退到主背包。
• 通用模组支持：适用于大多数使用原版方块破坏和战利品钩子的模组。

👩‍💻 开发者指南：使用 API

兼容性设计挂钩到 ServerPlayerInteractionManager.tryBreakBlock、BlockState.getDroppedStacks 和 ServerWorld.spawnEntity。只要你的模组使用这些标准方法，Auto Pickup 就会自动工作。

如果你有自定义逻辑（例如通过命令或任务给予物品），可以使用 API 将物品路由通过 Auto Pickup 逻辑。

1. 添加 Auto Pickup 作为依赖

dependencies {
    modCompileOnly(files("libs/auto-pickup-x.x.x.jar"))
}Copy已复制！

2. 使用 API

import com.lukarbonite.autopickup.AutoPickupApi;
import net.fabricmc.loader.api.FabricLoader;

public void giveQuestReward(PlayerEntity player, List<ItemStack> rewards, int xp) {
    if (FabricLoader.getInstance().isModLoaded("auto-pickup")) {
        // 这会自动处理背包插入、背包路由和配置检查。
        // 返回无法拾取的物品列表（背包已满）。
        List<ItemStack> remaining = AutoPickupApi.tryPickup(player, rewards);

        // 处理经验
        AutoPickupApi.tryPickupExperience(player, xp);

        // 掉落剩余物品
        for (ItemStack stack : remaining) {
            player.dropItem(stack, false);
        }
    } else {
        // 备用逻辑
    }
}Copy已复制！

📜 许可证

本项目采用 AGPL 3.0 许可证。详情请参阅 LICENSE 文件。欢迎在模组包中使用。

截图：