市场注册表 Market.json

MarketRegistry —— 决定市场 GUI 里卖什么、收什么、怎么分类的全部数据源。这是本 mod 真正的「配置」主体。

基本信息

文件结构

首次运行生成的 Market.json 顶层只有 4 个键（MarketRegistry.create）：

AbstractRegistry 的默认 schema（options / custom.entries 数组）在这里不生效——MarketRegistry.hasCustomLoader() 返回 true，走自己的 load(JsonObject)。

加载顺序（顺序有语义）

MarketRegistry.load（registry/MarketRegistry.java:95）按固定四步执行：

[!NOTE] 由此得出两条实用规则：想让默认批次彻底消失应用 defaults 开关（步骤 2）而不是 blacklist（步骤 3）；而 custom entries 里写一个同 output 物品即等于覆盖默认价格。

条目语法

output 与 cost 共用同一个 ItemStack 字符串格式，正则（MarketRegistry.ITEMSTACK_PATTERN）：

(?:([0-9]+)\*)?(?:([\w]+):)([\w]+)(?::([0-9]+))?(?:@(.+))?

示例（custom entries 中的一对 key/value）：

getEntryFor 匹配用 isItemEqual 加 areItemStackTagsEqual，所以带 NBT 的刷怪蛋与不带 NBT 的刷怪蛋是两条不同条目。

[!WARNING] custom entries 的 __comment 写着 “Prefix with ! to blacklist instead.”，但 loadMarketEntry 只跳过 __comment 与 examplemod:example_item 两个键，没有任何 ! 前缀处理。该特性在当前 commit 未实现；想屏蔽默认条目只能用 defaults blacklist。

默认批次全表

registerDefaultHandler 被调用 10 次，覆盖 5 个 compat addon。EntryType 见下方枚举。

※ 数量不由本仓库决定：#2 的循环上界是原版 BlockSapling.field_149882_a.length（1.7.10 为 6：oak / spruce / birch / jungle / acacia / dark_oak），#7 取决于玩家安装的 Forestry 树种数。两者的数组与类都不在本仓库内。

批次间的实质差异

[!NOTE] #1/#2/#3/#4 内部所有条目共享同一个 defaultPayment ItemStack 实例引用（registerEntry 不做 copy()），四条 handler 各持有自己的一个实例。GuiMarket 读 entry.getCostItem().stackSize 只读不写，故无副作用；ContainerMarket.onItemBought 的 decrStackSize 作用于玩家输入槽的另一份 ItemStack，也不受影响。

#4 Animal Eggs 的 9 个 EntityTag.id

NBT 结构为 root → EntityTag → {id: "<字符串>"}。源码在此处注明 Praise SideOnly：刷怪蛋 ItemStack 的 NBT 构造被放进 apply()（服务端执行）里。

#5 Pams Harvestcraft Seeds 全 60 个条目

物品 ID 形如 harvestcraft:<crop>seeditem。按源码数组顺序（缺失物品静默跳过，不报错）：

blackberry、blueberry、candleberry、raspberry、strawberry、cactusfruit、asparagus、barley、oats、rye、corn、bambooshoot、cantaloupe、cucumber、wintersquash、zucchini、beet、onion、parsnip、peanut、radish、rutabaga、sweetpotato、turnip、rhubarb、celery、garlic、ginger、spiceleaf、tealeaf、coffeebean、mustardseeds、broccoli、cauliflower、leek、lettuce、scallion、artichoke、brusselsprout、cabbage、spinach、whitemushroom、bean、soybean、bellpepper、chilipepper、eggplant、okra、peas、tomato、cotton、pineapple、grape、kiwi、cranberry、rice、seaweed、curryleaf、sesameseeds、waterchestnut

#6 Pams Harvestcraft Saplings 全 36 个条目

物品 ID 形如 harvestcraft:<tree>_sapling：

apple、almond、apricot、avocado、banana、cashew、cherry、chestnut、coconut、date、dragonfruit、durian、fig、gooseberry、grapefruit、lemon、lime、mango、nutmeg、olive、orange、papaya、peach、pear、pecan、peppercorn、persimmon、pistachio、plum、pomegranate、starfruit、vanillabean、walnut、cinnamon、maple、paperbark

条目总数

custom entries 里每追加一条即 +1；defaults blacklist 每命中一条即 -1。

EntryType 全枚举（3 值）

MarketEntry.EntryType，客户端筛选按钮与列表排序都基于 ordinal()。

按钮贴图统一取自 farmingforengineers:textures/gui/market.png，getIconTextureY() 基值 14，hover 时 +20，非当前筛选态时 +40。

排序：ContainerMarketClient 用 Comparator.comparingInt(o -> o.getType().ordinal()) 稳定排序，故市场内顺序恒为「全部种子 → 全部树苗 → 全部其他」，同类别内保持注册顺序。

客户端筛选与搜索

ContainerMarketClient（extends ContainerMarket）新增 4 个字段：itemList / filteredItems / currentSearch / currentFilter / isDirty / scrollOffset。

购买流程与槽位布局

ContainerMarket 共 50 个槽位（container/ContainerMarket.java:46）：

FakeSlot 的 putStack / decrStackSize / onSlotChanged 全部 no-op，isItemValid 与 canTakeStack 恒 false，getSlotStackLimit 为 64——纯粹是只读展示格，不能被 vanilla 的 Container.mergeItemStack 逻辑污染。

交易规则

[!NOTE] 市场没有红石/按钮/自动化接口：SlotMarketBuy 只能靠玩家鼠标点击取出，没有任何 TileEntity 状态机、tick 逻辑或比较器输出。TileMarket 是空类（见 Market 方块）。整条交易链路纯粹是「玩家点格子 → 服务端发包确认 → 客户端扣款」。

错误与告警上报

AbstractRegistry 维护静态 List<String> registryErrors：

错误在两个时机发给玩家：

1. 玩家进服时 FarmingForEngineers.onPlayerLogin（@SubscribeEvent PlayerEvent.PlayerLoggedInEvent）逐条聊天栏输出
2. /farmingforengineers reload 执行后立即输出（见 reload 指令）

refuseSave 标志在 JSON 语法错误、tryGetObject/tryGetArray 类型不符、tryParseInt 数字解析失败时置位，阻止把半成品回写覆盖用户的文件。

相关条目

• Market 方块 - 打开本 GUI 的入口
• Merchant - 另一条打开本 GUI 的路径（右键商人）
• FarmingForEngineers.cfg - 控制告警是否上屏的唯一配置项
• reload 指令 - 热重载 Market.json