村民交易

村民交易

适用于 Fabric 和 NeoForge 的可配置多物品配方自定义交易村民。

功能

• 使用 /villager spawn <name> <outcome_item> <required_items...> 生成持久化自定义村民。
• 多输入交易（UI 中每行 3 个输入），带有主题背景的自定义交易界面。
• 默认设置包括无敌和冻结；可通过 /villager settings 切换。
• 跨维度持久化保存交易和村民数据。

命令

• /villager spawn <name> <outcome_item> <required_items...> — 创建一个交易者。示例：/villager spawn bookseller minecraft:enchanted_book:1 minecraft:paper:16 minecraft:emerald:2。
• /villager delete <name> — 移除一个交易者。
• /villager find <name> — 定位一个交易者并获取传送建议。
• /villager list [page] — 列出已跟踪的交易者。
• /villager settings invulnerable <true|false> [villager] — 设置默认或特定村民的无敌状态。
• /villager settings freeze <true|false> [villager] — 设置默认或特定村民的 AI/冻结状态。

权限：villager_tradings.command.villager（如果存在 Fabric Permissions API v0/v1），否则需要 OP 等级 3。

使用提示

• 所需物品是以空格分隔的 <item>:<count> 标记；使用命名空间（例如 minecraft:emerald:3）。
• 交易会消耗所有列出的输入；即使商人报价仅使用前两个槽位，游戏内 UI 也始终反映完整的输入列表。
• 自定义村民会被跟踪/持久化；当它们死亡时，其交易会被清理。

构建

./gradlew build

Fabric 和 NeoForge 的产物会在各自子项目的 build/libs 下生成，并带有 villager_tradings 前缀。