Nobodiiiii / Terraria-in-Minecraft

# 箱中泰拉（Terraria's Box）
中文 · English
## 中文
在 Minecraft 的箱子里游玩真实的 Terraria。
> 本项目为非官方社区项目，与 Minecraft（Mojang Studios / Microsoft）及 Terraria（泰拉瑞亚，Re-Logic）官方无关，未获其认可、赞助或背书。相关商标与游戏资源归各自权利人所有。
### 玩法
- 放入泰拉角色物品即可进入容器；挖开箱框可穿越相邻容器，漫游升级支持自由探索。
- 两端物品按 1:1 互通；未映射或带额外状态的物品转为异界遗物，送回来源游戏可恢复。
- 桥接角色和世界独立保存，不修改个人 Terraria 存档。
### 安装
需要 Windows x64、Minecraft Java 1.20.1 / Forge 47.3.22+（47.x）和正版 Steam Terraria 1.4.4.9。仅支持单人世界。
1. 保持 Steam 已登录运行，退出 Minecraft。
2. 解压 Windows 发行包，运行 `Configure-Integration.cmd` 安装模组。
3. 启动 Minecraft，在主菜单等待运行环境自动安装完成，再进入单人世界。
tModLoader 和配套泰拉模组自动安装。JEI、精妙存储为可选模组。
### 操作
| 按键 / 命令 | 用途 |
| ------------------------- | ---------------------------------- |
| `F6` | 切换 Minecraft / Terraria 控制焦点 |
| `F7` | 切换泰拉画面与箱内物品 |
| `/terrariamc check` | 检查安装 |
| `/terrariamc reinstall` | 重装运行环境，保留角色、世界和设置 |
关闭容器会正常保存并返还角色。安装后也可运行 `Play-Minecraft.cmd` 直接启动已有实例。
详细说明 · 物品转换 · 第三方依赖 · GPL-3.0-only
## English
Play the real Terraria inside Minecraft chests.
> This is an unofficial community project. It is not affiliated with, endorsed by, or sponsored by Minecraft (Mojang Studios / Microsoft) or Terraria (Re-Logic). All trademarks and game assets belong to their respective owners.
### Gameplay
- Insert a Terraria character item to enter a container. Break through its frame to move between adjacent containers; the Roaming Upgrade enables free exploration.
- Transfer items between the two games at a 1:1 ratio. Unmapped items and items with extra state become otherworldly relics; return them to their source game to restore them.
- Bridge characters and worlds are saved separately, without modifying your personal Terraria saves.
### Installation
Requires Windows x64, Minecraft Java 1.20.1 with Forge 47.3.22+ (47.x), and a legitimate Steam copy of Terraria 1.4.4.9. Only singleplayer worlds are supported.
1. Keep Steam running and signed in, and exit Minecraft.
2. Extract the Windows release package and run `Configure-Integration.cmd` to install the mod.
3. Launch Minecraft and wait at the main menu for the runtime to finish installing automatically, then enter a singleplayer world.
tModLoader and the companion Terraria mod are installed automatically. JEI and Sophisticated Storage are optional.
### Controls
| Key / Command | Action |
| ------------------------- | ----------------------------------------------------------------------- |
| `F6` | Switch control focus between Minecraft and Terraria |
| `F7` | Toggle between the Terraria view and container inventory |
| `/terrariamc check` | Check the installation |
| `/terrariamc reinstall` | Reinstall the runtime while preserving characters, worlds, and settings |
Closing a container saves normally and returns the character item. After installation, you can also run `Play-Minecraft.cmd` to launch an existing instance directly.
Documentation · Item mappings · Third-party dependencies · GPL-3.0-only