MCphone

A working smartphone in Minecraft: camera, gallery, custom wallpapers, a music player, an in-game chat app, and an open app system that add-on mods can plug into.


GETTING A PHONE

Craft one at a crafting table:

    Glass        Glass         Glass
    Red Dye      Yellow Dye    Blue Dye
    Iron Ingot   Redstone      Iron Ingot

Right-click while holding it to turn it on. Press Esc, or click outside the phone body, to turn it off. You can also press H to open it while the phone is in your inventory or in a Curios slot (rebindable under Options → Controls → MCphone).


BUILT-IN APPS

- Camera. Viewfinder and frame-by-frame capture. Photos go to the game's screenshots/ folder.
- Gallery. Thumbnail grid, paging, full-size view, swipe left and right, delete.
- Music. Plays your own OGG / MP3 / WAV files from config/mcphone/music/. There is also a disc tray: put a music disc into the phone and the sound follows you around, and everyone nearby can hear it.
- Axolotl. A chat app on the phone. Mutual friend requests, a conversation list, bubble-style chat. Messages are stored in the world save, so you can write to someone who is offline. Tap the small icon on an online friend's row to teleport to them. Server owners can turn that off in serverconfig/mcphone-server.toml.
- Notes. Notes travel with the player and survive death. You can print one into a book and hand it to someone.
- Ender Chest. Opens your own ender chest anywhere. It is the vanilla one, fully shared with ender chest blocks and across dimensions. Paid app, costs 1 ender chest.
- App Store. Install and uninstall apps. What you installed is remembered per save.
- Settings. Wallpapers, font color, naming your device, app manager.

The home screen is yours to arrange: hold an icon and drag it, and the others move aside live. Past 20 apps it pages automatically, and you can scroll, swipe sideways, or tap the page dots to turn a page. The layout is remembered per world.


WORKS WITH (all optional)

- Curios. The phone gets a belt slot, so carrying it costs no inventory space.
- Waystones. Adds a Waystones app that opens the waystone selection screen.
- MCEF. Adds a Browser app: real web browsing inside the phone.
- NetMusic. CDs burned with NetMusic fit the phone's disc tray and play wherever you walk.
- Patchouli. Adds a Reader app that collects every guidebook in the pack into one bookstore.
- GuideME. The Reader's bookstore also picks up guidebooks built with GuideME (both AE2 and Modern Industrialization depend on it), discovered automatically.
- Immersive Engineering. The Reader gains the Engineer's Manual.
- FTB Quests. Adds a Quests app, so the pack's quest book is one tap away.

When a mod is not installed, the app that needs it does not appear on the home screen or in the app store at all. An app sitting in the store that throws an error when you tap it is worse than one that is not there.


FOR ADD-ON AUTHORS

The app system is open through Java's SPI, and your mod does not need MCphone to know about it: implement IPhoneApp and register one line under META-INF/services/. Interface documentation:

https://github.com/november521/mcphone/blob/main/docs/addon-api.md


VERSIONS

- Minecraft 1.21.1 with NeoForge 21.1.200+. The main line.
- Minecraft 1.20.1 with Forge 47.4.0+. Fully ported, but much younger than the main line.

Required on both the client and the server.


SOURCE AND LICENSE

https://github.com/november521/mcphone

MIT


------------------------------------------------------------


中文说明

把一部能用的智能手机塞进 Minecraft —— 拍照、翻相册、换壁纸、听歌、聊天、装 App，还能给自己那一部手机起个名。


怎么拿到手机

工作台合成，一次一部：

    玻璃     玻璃     玻璃
    红染料   黄染料   蓝染料
    铁锭     红石     铁锭

拿在手上右键开机，按 Esc、或点机身外的区域关机。手机放在背包或饰品槽里时按 H 也能开机（可在原版「选项 → 按键设置 → MCphone」改键）。


自带的 App

- 相机。取景框 + 分帧截图，照片存进游戏目录的 screenshots/。
- 相册。缩略图网格、分页、大图查看、左右切换、删除。
- 音乐。播放 config/mcphone/music/ 下你自己的 OGG / MP3 / WAV。另有唱片仓：把唱片放进手机，声音跟着你走，周围的人也听得见。
- 美西螈。手机上的聊天 App。双向好友、会话列表、气泡界面，消息存进世界存档，对方离线也能发。在线好友那一行点一下就传送到他身边（服主可在 serverconfig/mcphone-server.toml 里关掉）。
- 记事本。笔记跟着玩家走，死了也不会丢，写完能印成一本书递给别人。
- 末影箱。随身打开自己的末影箱，与方块末影箱、跨维度完全互通。付费 App，售价 1 × 末影箱。
- 应用商店。安装 / 卸载 App，安装状态按存档持久化。
- 设置。更换壁纸、字体颜色、设备命名、App 管理器。

主屏可以自己摆：按住图标直接拖就能换位置，其余图标实时让位。装多了自动分页，滚轮、横划、点页码点都能翻。摆好的顺序按存档记下来，重进游戏还在原位。


装了这些模组会多点东西（都不是必需的）

- Curios。手机多一个饰品栏槽位，可以挂在腰上。
- Waystones。多一个「传送石」App，去任何一个已激活的传送点。
- MCEF。多一个「浏览器」App，在手机里上网。
- NetMusic。它刻出来的 CD 能塞进手机的唱片仓，走到哪儿放到哪儿。
- Patchouli。多一个「阅读」App，整合包里所有教程手册收进一个书城。
- GuideME。「阅读」的书城里多出用它做手册的模组那几本（AE2、现代化工艺都硬依赖它），自动发现。
- Immersive Engineering。「阅读」的书城里多一本《工程师手册》。
- FTB Quests。多一个「任务书」App，开机点一下就是。

没装对应模组时，依赖它的 App 不会出现在主屏和应用商店里 —— 商店里躺着一个点了会报错的东西，比它不存在更糟。


版本

- Minecraft 1.21.1 + NeoForge 21.1.200+ —— 当前主力版本
- Minecraft 1.20.1 + Forge 47.4.0+ —— 功能已完整移植，但比主力版本年轻得多

客户端与服务端都需安装。