Tea Craft hs

1.1 Obtaining a tea seed
--------------------------------------------------------------------------------

Tea seeds cannot be crafted. The only way to get one is to kill zombies.

  A zombie may spawn holding a tea seed in its main hand.
  When killed, it ALWAYS drops the seed.

  Probability (identical to "zombie holding an iron shovel",
  derived by decompiling vanilla):

    Hard difficulty     5%  x 4/6  =  3.33%
    Other difficulties  1%  x 4/6  =  0.67%

  In practice: on Peaceful/Easy/Normal you need roughly 150 zombies per seed;
  on Hard, roughly 30.

  Note: holding the seed does not matter — we deliberately set it to
  "always drops on death" instead of the vanilla 8.5% equipment drop rate.

--------------------------------------------------------------------------------
1.2 Planting: temperature is everything
--------------------------------------------------------------------------------

Plant the tea seed on grass or dirt. It goes through 4 stages:

  age 0  Seedling       just planted
  age 1  Growing        random-tick growth (bonemeal works)
  age 2  Grown          full one block tall (bonemeal caps here)
  age 3  Harvestable    tender green leaves appear at the top
                        ONLY time advances past age 2 — bonemeal does nothing

  Important design note: bonemeal can speed up growth to a full bush,
  but it cannot produce harvestable leaves. You must wait for the timer.
  Those tender leaves at the top are the "ready" visual cue.

  Growth time (from planting to fully grown):
    Hottest biome   3 in-game days
    Coldest biome   8 in-game days
    Linear interpolation by temperature in between

--------------------------------------------------------------------------------
1.3 Biome temperature -> tea quality (the most important table)
--------------------------------------------------------------------------------

At harvest time the leaves remember the biome they grew in.
That temperature decides the finished tea's QUALITY TIER,
and the tier decides the EFFECT DURATION.

  Biome temperature      Tier    Duration
  ---------------------  ------  -----------
  Tropical    >=  1.10   1       20 minutes
  Subtropical >=  0.85   2       40 minutes
  Temperate   >=  0.55   3       60 minutes
  Boreal      >=  0.15   4       80 minutes
  Polar       <   0.15   5      100 minutes

  The colder the biome, the better the tea.

  Origin information travels with the leaves the whole way:
  harvest -> every processing step -> finished tea -> brewed tea.
  It will never silently reset to "Temperate" during processing.

--------------------------------------------------------------------------------
1.4 Boreal and Polar biomes: you need a campfire
--------------------------------------------------------------------------------

Tea bushes in Boreal (tier 4) and Polar (tier 5) biomes need a CAMPFIRE
within a 2-block radius.

  No campfire  ->  the bush does not grow.
  Walk up to it and you will see: "It's too cold — put a campfire nearby."

  The campfire must be lit.

  This is the price of high-tier tea: the good stuff does not grow
  in comfortable places.

--------------------------------------------------------------------------------
1.5 Harvesting
--------------------------------------------------------------------------------

Right-click a fully grown bush (age 3).

  1 to 3 fresh leaves per harvest (random).
  The bush returns to the GROWN state (age 2), not to a seedling —
  so it does not have to grow tall again; the next maturity countdown
  starts immediately.

  Fresh leaves come in 5 item variants by origin:
    Tropical / Subtropical / Temperate / Boreal / Polar leaves

  Fresh leaves cannot be eaten. The message "Finished tea can't be eaten
  directly — put it in a gaiwan and add water" also appears for fresh
  leaves, because they belong to the same item family.
  Their only use is going into a drying tray to start processing.

--------------------------------------------------------------------------------
1.6 Maturity countdown (HUD)
--------------------------------------------------------------------------------

Look at a tea bush and a panel appears near the bottom of the screen:

  Growing:      Tea Bush · 2d5h13m7s left        <- green progress bar
  Grown, waiting: Tea Bush · 41s left
  Paused (cold):  Tea Bush · 41s left
                  Too cold, growth paused (place a campfire to resume)
                                                 <- bar turns blue
  Ripe:         Tea Bush · Ready to harvest
                Right-click to pick · Shears to take cuttings

  The countdown is accurate to the SECOND.
  Units are real time: 1 second = 20 game ticks, 1 in-game day = 20 real minutes.
  Example: a 3-day maturity (72000 ticks) shows as "1h".
  The timer runs on game ticks, so game speed-ups (/tick sprint, /tick rate)
  also speed up maturity.
  When paused by cold, the countdown FREEZES (it does not reset to zero).
  Put the campfire back and it continues from where it stopped.

--------------------------------------------------------------------------------
1.7 Taking cuttings with shears
--------------------------------------------------------------------------------

Right-click a RIPE bush (age 3) while holding SHEARS:

  You get 2 new tea seeds
  The old bush reverts to a seedling (age 0) and starts over
  The shears lose 1 durability

  This is how tea is propagated. Tea seeds cannot be crafted — you get them
  from zombies or from cuttings.

  Only RIPE bushes (age 3) can be cut. On an unripe bush you get
  "This bush is not ripe yet — taking cuttings would harm it",
  and the shears are NOT damaged.

  Picking and cutting are different actions:
    Empty hand  -> pick, 1~3 fresh leaves, bush returns to GROWN
    Shears      -> cuttings, 2 tea seeds, bush returns to SEEDLING

  Both reset the maturity timer, so pick whichever you need.

1.1 拿到茶树种
--------------------------------------------------------------------------------

茶树种无法合成，只能靠击杀僵尸获得。

  僵尸刷新时有概率主手拿着茶树种，被打死后【必定掉落】。

  概率（与「僵尸手持铁锹」完全一致，反编译原版算出来的）：
    困难难度    5%  × 4/6  ≈  3.33%
    其它难度    1%  × 4/6  ≈  0.67%

  也就是说：和平/简单/普通难度下，平均约 150 只僵尸出一棵树种；
  困难难度约 30 只。

  ⚠ 拿着茶树种也没关系——它不会掉，我们把它设成了「打死必掉」。

--------------------------------------------------------------------------------
1.2 种茶：温度决定一切
--------------------------------------------------------------------------------

把茶树种在【草方块或泥土】上。它会经历 4 个阶段：

  age 0  幼体         刚种下
  age 1  生长期       随机刻成长（可用骨粉）
  age 2  成树         长满一格高（骨粉最多催到这一阶段）
  age 3  可采摘       顶端冒出嫩绿小叶 —— 【只能等时间，骨粉无效】

  ⚠ 关键设计：骨粉可以催大，但催不出茶叶。
    想要采，必须等它自己长够时间。顶端那几片嫩叶就是「长够了」的信号。

  生长速度（从种下到成树）：
    最热群系  3 个游戏日
    最冷群系  8 个游戏日
    中间按温度线性插值

--------------------------------------------------------------------------------
1.3 群系温度 → 茶叶品质（本文最重要的一张表）
--------------------------------------------------------------------------------

采摘时，茶叶会记住它生长的群系。这个温度决定成品茶的【品质等级】，
而品质等级决定【效果时长】。

  群系温度              品质    效果时长
  --------------------  ----    -----------
  热带   ≥  1.10         1 级    20 分钟
  亚热带 ≥  0.85         2 级    40 分钟
  温带   ≥  0.55         3 级    60 分钟
  寒带   ≥  0.15         4 级    80 分钟
  极寒   <  0.15         5 级   100 分钟

  ★ 越冷的地方，茶越好。

  ★ 产地信息全程跟着茶叶走：采摘 → 每一道工序 → 成品 → 泡成茶汤。
    不会在加工过程中变成「温带」。

--------------------------------------------------------------------------------
1.4 寒带与极寒：必须生火
--------------------------------------------------------------------------------

寒带（4 级）和极寒（5 级）的茶树，半径 2 格内必须有【篝火】。

  没有篝火 → 茶树不生长。
  此时靠近它会看到提示：「它太冷了，放一个篝火在旁边吧」

  篝火可以是任意状态（点着或者熄了都算吗？—— 点着的才有效）。

  ⚠ 这是拿高等级茶的必要代价：好东西不长在舒服的地方。

--------------------------------------------------------------------------------
1.5 采摘
--------------------------------------------------------------------------------

右键成熟的茶树（age 3）。

  每次采 1~3 片鲜叶（随机）。
  ★ 采摘后茶树退回「成树」（age 2），不是退回幼苗 ——
    所以它不用重新长高，直接开始下一轮成熟倒计时。

  采下来的鲜叶按产地分 5 种物品：
    热带茶叶 / 亚热带茶叶 / 温带茶叶 / 寒带茶叶 / 极寒茶叶

  ⚠ 鲜叶不能直接吃，会提示「成品茶不能直接吃，请放入盖碗注水泡开」——
    但这行提示对鲜叶也生效，因为鲜叶同属茶叶类物品。
    鲜叶的用途只有一个：放进晒盘开始加工。

--------------------------------------------------------------------------------
1.6 成熟倒计时（HUD）
--------------------------------------------------------------------------------

准星对准茶树，屏幕下方会显示一个面板：

  生长中：  茶树 · 还剩 2天5小时13分钟7秒     ← 带绿色进度条
  成树等待：茶树 · 还剩 41秒
  太冷暂停：茶树 · 还剩 41秒
            太冷，生长暂停（放篝火即恢复）    ← 进度条变蓝
  已成熟：  茶树 · 可以采茶了
            右键采摘 · 剪刀分枝可得茶树种

  ★ 倒计时精确到秒。
  ★ 单位是现实时间：1 秒 = 20 游戏刻，1 个游戏日 = 20 分钟现实时间。
    例：3 个游戏日的成熟期 = 72000 刻 = 3600 秒，显示「1小时」。
  ★ 计时由游戏刻驱动，所以游戏加速（/tick sprint、/tick rate）也会加速成熟。
  ★ 太冷暂停时倒计时【停住不归零】。放回篝火后从原值继续倒数，
    不需要从头再等。

--------------------------------------------------------------------------------
1.7 剪刀分枝
--------------------------------------------------------------------------------

手持【剪刀】右键【成熟】的茶树（age 3）：

  得到 2 个新茶树种
  老苗退回幼苗（age 0），重新开始生长
  剪刀掉 1 点耐久

  ★ 这是茶的「繁殖」方式。茶树种无法合成，只能靠打僵尸或分枝获得。

  ⚠ 只有成熟（age 3）的茶树能分枝。
    未成熟时右键会提示「这株茶树还没成熟，分枝会伤到它」，
    并且【不消耗剪刀耐久】。

  ⚠ 分枝和采摘是两种不同的操作：
      空手右键  → 采摘，得 1~3 片鲜叶，茶树退回成树
      剪刀右键  → 分枝，得 2 个茶树种，茶树退回幼苗
    两者都会重置成熟计时，按需要选一个就行。