自动出售

自动出售

为现代多人Minecraft服务器提供的轻量级自动化物品出售功能。

经济

AutoSell

Mod Loader Environment Modrinth License

一个客户端 Fabric 模组,当你的背包填满后,它会替你运行服务器的出售命令,并将你拾取的物品移入商店。

需求

  • Minecraft 26.2
  • Fabric Loader 0.18.5 或更新版本
  • Fabric API
  • Java 25

该模组仅在那些通过命令打开商店容器的服务器上才能发挥作用,例如 /sell。在单人游戏中,它没有可交互的对象。

用法

按 K 打开菜单。该按键可以在原版控制界面的 AutoSell 分类下重新绑定。

在菜单中你可以:

  • 选择要出售的物品。点击网格中的物品可将其添加或移除,最多可选 32 个。搜索框会匹配显示名称和注册表 ID,旁边的勾选按钮可将网格筛选为仅显示你已选择的物品。
  • 设置背包阈值。当你的 36 个背包槽位中被占用的比例达到该百分比,且至少有一件所选物品在其中时,AutoSell 便会触发。
  • 设置命令。默认为 sell。开头的斜杠会被去除,因此 sell 和 /sell 均可使用。
  • 使用阈值滑块旁的小按钮选择 HUD 的角落位置。

按下开始按钮并关闭菜单。AutoSell 运行时,所选角落中的一个小方框会显示它将出售的物品。其边框颜色会随当前状态变化:监视背包时为绿色,等待商店时为橙色,移动物品时为青色。

触发时,AutoSell 会发送命令,等待容器打开,将自己背包中所有匹配的物品堆快速移出,然后再次关闭容器。商店自身槽位中的物品绝不会被触碰。

如果命令连续三次未能打开商店,AutoSell 会自动停止,并在聊天中告知你。当你离开服务器时,或者当你关闭菜单时没有选择任何物品,它也会停止。

配置

设置存储在 config/autosell.json 中,每当你在菜单中更改内容时都会写入。

{
  "selectedItemIds": ["minecraft:cobblestone"],
  "inventoryThreshold": 90,
  "sellCommand": "sell",
  "hudCorner": "TOP_RIGHT"
}

hudCorner 接受 TOP_LEFT、TOP_RIGHT、BOTTOM_LEFT 和 BOTTOM_RIGHT。inventoryThreshold 会被限制在 1 到 100 之间。无法再解析的物品 ID 会被跳过,而不会被从文件中删除,因此缺失的模组不会清空你的选择。

构建

./gradlew build

jar 文件会生成在 build/libs 中。使用 ./gradlew runClient 启动开发客户端。

贡献

欢迎提交拉取请求。复刻仓库,在分支上工作,并描述你更改了什么以及为什么更改。请遵循现有代码风格,并确保在打开请求之前 ./gradlew build 通过。

问题与功能请求

在 GitHub 上打开 issue。对于 bug,请包含复现步骤、你的 Minecraft 和模组版本,以及日志中的相关部分。对于功能,请描述你想做什么以及为什么当前行为会妨碍你。