mcphone Market Expansion

````markdown
# mcphone-Expansion · BlockFinance

**A finance expansion for Minecraft 1.20.1 (Forge), built on mcphone.**

> ⚠️ **REQUIRED: [mcphone](https://github.com/november521/mcphone) 0.10.2 or newer.**
> The game will not start without it. Install this mod **and** MCphone on **both client and server**.

> ⚠️ **Protect your items:** the Trading Platform, Public Market Terminal, Computer Monitor and Computer Tower
> can all be mined by hand and **drop themselves**, but **items stored inside are NOT dropped**.
> Always empty a block before you break it.

---

## Fixed in this build (v4.5.6 hotfix)

- **Computer Monitor and Memory Stick recipes now work.** They previously failed to register because of an invalid ingredient format and invalid item IDs.
- **Trading Platform and Public Market Terminal now drop themselves when mined.** Previously they dropped nothing, so the crafted item was lost forever.
- **Help pages now show a prominent red warning** that breaking a block loses whatever is stored inside.
- **Fixed the help text being cut off and overlapping the warning banner**; the phone guide page no longer wastes vertical space.
- **Fixed the falling-coin animation in the trading screen** drifting outside the window.

## Features

- **Spot / futures / stock trading** — server-side market with daily price updates, synced to everyone and saved with the world
- **Wallet settlement** — trades execute instantly; you cannot order without enough balance
- **Finance app for your phone** — built on the MCphone App SPI: quotes, orders, holdings, help
- **Computer equipment** — a monitor (control console) and a computer tower; tower storage starts at 9 slots and grows by **9 slots per memory stick, up to 81**
- **Tower automation** — set a role (buy / sell / storage), a redstone condition and a trigger (after the daily update / price threshold / redstone), with per-item threshold and amount; each rule fires at most once per day
- **Live candlestick charts** — every asset keeps a rolling 15-day price history, drawn as red-up / green-down candles, with a per-day tooltip
- **Chinese pinyin search** — search item lists by Chinese, full pinyin (`tiekuai`) or initials (`tk`)
- **Comfortable UI** — smooth row-aligned scrolling, and full vanilla storage shortcuts (right-drag to place one item per slot, drag to split, shift-click to move, number keys, double-click, Q); scales correctly with every GUI Scale setting

## Crafting recipes

**Memory Stick** (also sold by librarian villagers: 3 gold ingots → 1 stick)

```
Green Dye    Green Dye    Green Dye
Copper Block Redstone Bl. Copper Block
Gold Ingot   Gold Block   Gold Ingot
```

**Computer Monitor**

```
Glass        Iron Block   Redstone Comparator
Glass        Redstone Bl. Memory Stick
Glass        Iron Block   Redstone Repeater
```

**Computer Tower**

```
Iron Block   Iron Bars    Iron Block
Iron Block   Redstone Bl. Iron Block
Iron Block   Iron Bars    Iron Block
```

**Dollar Bill** → used to craft the Trading Platform

```
Gold Block   Diamond Block Gold Block
Diamond Block Emerald Block Diamond Block
Gold Block   Diamond Block Gold Block
```

**Trading Platform** · **Public Market Terminal**

```
Obsidian     Dollar Bill  Black Wool          Bookshelf    Lapis Block  Bookshelf
Diamond      Gold Ingot   Emerald             Gold Block   Gold Block   Gold Block
Bookshelf    Enchant Table Bookshelf           Bookshelf    Bookshelf    Bookshelf
```

## Installation

1. Minecraft **1.20.1** + Forge **47.4.0** (or newer)
2. Install **[MCphone](https://github.com/november521/mcphone) 0.10.2+** (required)
3. Put this mod's jar into `mods/` — **on both client and server**
4. Launch the game

## Quick start

1. Craft the **Trading Platform** and right-click it to open the terminal (spot / futures / stock)
2. Craft a **Computer Monitor** and a **Computer Tower**, and place the tower **next to** the monitor
3. Right-click the monitor to open the console → pick the tower side → expand it with memory sticks → set rules so it trades for you

## FAQ

| Question | Answer |
|---|---|
| Crash on startup / missing dependency | Make sure MCphone ≥ 0.10.2 is installed on both client and server |
| The monitor or memory stick cannot be crafted | Fixed in this build — update to **v4.5.6 (hotfix)** |
| My crafted block disappeared when I mined it | Fixed in this build; blocks now drop themselves. Note that items stored inside are still **not** dropped — empty the block first |
| Tower side buttons are gray | The tower must be placed in a block **adjacent** to the monitor |
| Automation never fires | Check the tower **role** (buy rules only run on "buy" towers), the trigger condition, whether the rule is **enabled**, and that it has not fired today |
| Cannot take a memory stick out | Safety check: removing it would hide items beyond the new capacity — take those items out first |
| Typing in the search box closes the screen | Fixed in **4.5.1+**; E / Q / F / number keys no longer trigger vanilla shortcuts while typing |

## License

MIT. The required dependency **MCphone** is published and licensed separately by **november521**;
this project does **not** include its code or binaries.

## Links

- Source: https://github.com/XinDeFly/mcphone-Expansion
- Issues: https://github.com/XinDeFly/mcphone-Expansion/issues
- Wiki / guides: https://github.com/XinDeFly/mcphone-Expansion/wiki

---

## 中文说明

# 方块金融 · mcphone-Expansion

**基于 MCphone 的 Minecraft 1.20.1 (Forge) 金融扩展模组。**

> ⚠️ **必需前置：[MCphone](https://github.com/november521/mcphone) 0.10.2 及以上** —— 未安装游戏无法启动；
> **客户端与服务端都要安装**本模组与 MCphone。

> ⚠️ **注意保护物品**：便捷交易平台、公共市场终端、电脑显示器、电脑机箱都可以徒手挖掉并**返还方块本身**，
> 但**方块内已存入的物品不会掉落** —— 挖掉前请先把里面的东西全部取出。

## 本次修复（v4.5.6 hotfix）

- **电脑显示器与内存条的合成配方已修复**（此前因材料格式错误与无效物品 ID，配方根本没有注册成功）
- **便捷交易平台与公共市场终端现在会掉落自身**（此前挖掉什么都不返还，合成材料白白损失）
- **说明页面顶部新增醒目红色警示**，提示挖掉方块会丢失内部物品
- **修复说明正文被裁切、并覆盖警示条的问题**；手机说明页不再浪费大片垂直空间
- **修复交易界面金币动画飘出窗口之外的问题**

## 功能

- **现货 / 期货 / 股票交易**：服务端统一行情、每日更新，全服同步、随存档持久化
- **钱包结算**：买卖即时成交，余额不足无法下单
- **手机金融 App**：基于 MCphone App SPI，可看行情、下单、看持仓
- **电脑设备**：显示器（控制台）+ 电脑机箱；机箱存储基础 9 格，每条内存条 +9 格，上限 81 格
- **机箱自动化**：角色（购入/出售/存储）+ 红石条件 + 触发时机（每日更新后 / 达价 / 红石），按物品设阈值与数量，同一规则每日一次
- **15 日 K 线**：红涨绿跌，鼠标悬停可看某日价格与涨跌幅
- **中文拼音搜索**：支持中文、全拼（`tiekuai`）、首字母（`tk`）
- **顺手好用的界面**：按行对齐的平滑滚动；支持原版全部存储快捷操作（右键拖拽逐个摆放、拖拽分堆、Shift 快速移动、数字键、双击、Q）；适配所有「界面尺寸」档位

## 合成配方

**内存条**（也可由图书管理员村民用 3 金锭兑换）

```
绿色染料   绿色染料   绿色染料
铜块       红石块     铜块
金锭       金块       金锭
```

**电脑显示器**

```
玻璃       铁块       红石比较器
玻璃       红石块     内存条
玻璃       铁块       红石中继器
```

**电脑机箱**

```
铁块       铁栏杆     铁块
铁块       红石块     铁块
铁块       铁栏杆     铁块
```

**美元纸钞**（合成便捷交易平台的材料）

```
金块       钻石块     金块
钻石块     绿宝石块   钻石块
金块       钻石块     金块
```

**便捷交易平台** · **公共市场终端**

```
黑曜石     美元纸钞   黑色羊毛        书架       青金石块   书架
钻石       金锭       绿宝石          金块       金块       金块
书架       附魔台     书架            书架       书架       书架
```

## 安装

1. Minecraft **1.20.1** + Forge **47.4.0** 或更高
2. 安装 **[MCphone](https://github.com/november521/mcphone) 0.10.2+（必需前置）**
3. 把本模组 jar 放进 `mods/` —— **客户端与服务端都要放**
4. 启动游戏

## 快速上手

1. 合成「便捷交易平台」并右键，打开金融交易终端（现货 / 期货 / 股票）
2. 合成「电脑显示器」与「电脑机箱」，把机箱放在显示器的**相邻方块**
3. 右键显示器打开控制台 → 选择机箱方位 → 用内存条扩容 → 设定规则让它自动交易

## 常见问题

| 问题 | 解决 |
|---|---|
| 启动崩溃 / 缺前置 | 确认 MCphone ≥ 0.10.2 已装，且客户端与服务端都装了 |
| 显示器 / 内存条合成不了 | 本次已修复，请更新到 **v4.5.6 (hotfix)** |
| 挖掉方块后合成的东西消失了 | 本次已修复（方块会返还自身）；但**方块内的物品仍不会掉落**，请先取出 |
| 显示器里方位按钮是灰的 | 机箱必须放在显示器的**相邻方块** |
| 自动化规则不触发 | 检查机箱**角色**、触发时机、规则是否**已启用**、当日是否已触发过 |
| 内存条取不出来 | 保护机制：缩容会导致物品超容量，先取出超出的物品再拔内存条 |
| 搜索框打字会关掉界面 | 4.5.1+ 已修复（E / Q / F / 数字不再误触发原版快捷键） |

## 许可

MIT License。前置模组 **MCphone** 由其作者 **november521** 独立发布与授权，本模组**不包含**其代码或二进制文件。

## 链接

- 源码：https://github.com/XinDeFly/mcphone-Expansion
- 问题反馈：https://github.com/XinDeFly/mcphone-Expansion/issues
- 使用指南 / 常见问题：https://github.com/XinDeFly/mcphone-Expansion/wiki