mcphone Market Expansion
- By
````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