# Box3backup

**Repository Path**: SandMo/Box3backup

## Basic Information

- **Project Name**: Box3backup
- **Description**: Magic Code Island Box3 community backup (top 20 popular works + frontend offline package)
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-09
- **Last Updated**: 2026-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Box3backup

神奇代码岛 Box3（box3.dao3.fun）社区备份仓库

> 站点将于 2026 年 10 月停止运营，本仓库用于保存社区珍贵数据。

## 目录结构

```
Box3backup/
├── works/                      # 前 20 热门作品（按播放量排序）
│   ├── 01_100131463_源码精灵/
│   │   ├── metadata.json       # 作品完整元数据
│   │   ├── preview.jpg         # 封面图
│   │   ├── banner.gif          # 横幅图
│   │   └── author_avatar.png   # 作者头像
│   ├── 02_100012605_混沌神域[3区]/
│   └── ...
├── frontend/                   # 站点前端本地包（可离线打开）
│   ├── index.html              # 入口页（所有引用已重写为本地 ./cdn/block/）
│   ├── sw.js                   # Service Worker（importScripts 指向本地 worker）
│   ├── manifest.json           # PWA 清单
│   ├── frontend_manifest.json  # 镜像说明
│   ├── cdn/
│   │   ├── block/              # 全部 CDN 资源（649 个文件，约 58.7 MB）
│   │   │   ├── QmQoBi...js     # Service Worker 核心（含完整资源清单）
│   │   │   ├── QmaEJVu...js    # 编辑器主 JS（含 3D 引擎，5.9 MB）
│   │   │   ├── QmVnGYK...js    # Monaco typescript worker（4.6 MB）
│   │   │   ├── *.png/*.jpg     # 纹理 / 封面 / UI 图片
│   │   │   ├── *.css           # 样式（含 .js/.css 别名）
│   │   │   └── ...
│   │   └── block_manifest.json # 每个文件的名称/大小清单
├── top20_index.json            # 前 20 作品汇总清单
└── export_works.ps1            # 导出脚本（参考）
```

## 数据来源

- 作品元数据与榜单：`https://dao3.fun/` 首页 SSR（`__NEXT_DATA__`）
- 前端镜像源：`https://box3.dao3.fun/` + `https://static.box3.codemao.cn/block/`
- 备份时间：2026-08-09

## 覆盖范围

镜像了 `box3.dao3.fun` 的全部前端静态资源（从 Service Worker 内置的官方预缓存清单提取，
共 422 个资源 + index.html 引用的入口 chunk）：

- **编辑器完整代码**：入口 JS（edit/play/website 各版本）+ 全部 194 个动态 chunk
- **3D 引擎**：自研 WebGL 引擎（含 shader / mesh / texture / physics），5.9 MB 主文件
- **代码编辑器**：Monaco Editor workers（typescript/json/html/css/less 等）
- **3D 素材**：纹理（24+）、天空盒（cloud/stars/perlin）、粒子（sakura/snow/leaf 等）、水、动画
- **图元图标**：voxel/builder/sphere/torus 等建模工具图标
- **UI 资源**：logo、封面、按钮、占位图、二维码等
- **i18n**：中文/英文语言包（edit/music/play/voxelBuilder/website）
- **字体**：woff/woff2

## 使用说明

### 离线浏览前端

用任意静态文件服务器打开 `frontend/index.html` 即可（推荐 Python/Serve/http-server）。
运行时配置 `CLIENT_CONFIG.cdnPath="./cdn"`，资源加载路径 `./cdn/block/<hash>` 全部在本地命中，
不依赖外网。

> 注意：后端 API（`box3.codemao.cn/api`、`backend.box3.fun`）已停服，登录、作品拉取等
> 动态功能无法离线使用；编辑器界面与 3D 引擎本体可加载。

### 查看作品

每个作品目录下的 `metadata.json` 包含完整信息（名称、作者、简介、播放量、点赞、评论、
封面/横幅 URL），`preview.*` 为封面原图。

---

## dao3 站点及创作工具本地镜像

镜像 `https://dao3.fun/` 及其两个创作工具：ARENA 地图编辑器（`view.dao3.fun`）、
VOXA 体素编辑器（`voxa.dao3.fun`）。

### 目录结构

```
dao3/
├── main/                     # dao3.fun 主站 (Next.js 静态包)
│   ├── index.html … edit.html … create.html … (站点页壳)
│   ├── _next/static/         # webpack/chunks/css (119 JS + 17 CSS)
│   ├── activities/ pwa/ fonts/ assets_ext/   # 站点静态资源
│   └── writable/__ENV.js     # 运行时 env 存根
├── arena/                    # view.dao3.fun — ARENA 编辑器包 (76 个文件, 30 MB)
│   ├── e_index.html          # /e/[hash] 编辑器壳
│   └── _next/static/
├── voxa/                     # voxa.dao3.fun — VOXA 编辑器包 (69 个文件, 4.97 MB)
│   ├── player.html avatar.html avatar-editor.html
│   └── _next/static/
└── assets_ext/               # 三站共享第三方静态资源 (209 文件, 122 MB)
    ├── box3/                 # assets.box3.fun (头像/内容/纹理)
    └── createra/             # assets.createra.fun
```

### 引用重写

- 主站 `_app` chunk 的运行时配置（`urlTemplates`）已重写：`gameRoot→http://127.0.0.1:8743/`
  (ARENA)、`voxaRoot→http://127.0.0.1:8744/` (VOXA)、`apiRoot/appRoot→http://127.0.0.1:8742/8745/`。
- 所有 HTML/CSS/JS 中的 `https://assets.box3.fun/`、`https://assets.createra.fun/`
  及 Next.js 图像优化 `/​_next/image?url=…` 已改写为本地 `assets_ext/……`。
- `code-api-pc.dao3.fun` / `backend.dao3.fun` 等后端接口也指向本地存根。

### 本地运行

`server_dao3.ps1` 启动 4 个监听器：

| 端口 | 应用 | 说明 |
|------|------|------|
| 8742 | dao3.fun 主站 | SPA 回退到 `index.html`；`/edit/<hash>`→ARENA，`/edit-model/<id>`→VOXA |
| 8743 | view.dao3.fun (ARENA) | 编辑器壳 `e_index.html` |
| 8744 | voxa.dao3.fun (VOXA) | `/player`(viewer) / `/avatar` / `/avatar-editor` |
| 8745 | API stub | 所有接口返回 `{}` |

```
.\server_dao3.ps1        # 启动
# 浏览: http://localhost:8742/
```

### 限制（后端已停服/非镜像）

- **登录与编辑**：VOXA 编辑器入口 `/?modelId=…` 由服务端强制 307→登录，无法离线；
  后端 `code-api-pc.dao3.fun` / `backend.dao3.fun` 已改为 8745 存根，登录、作品/地图
  拉取、保存等动态接口无法使用。
- **编辑器内容**：avatar/模型部件图像采用运行时从 `assets.box3.fun/avatar/m/`、
  `engine/m/` 拼装，仅有 `assets_ext/box3/avatar/img` 等静态部分镜像。
- 仅镜像了**站点与编辑器 UI 壳** + 可静态获取的资源，供离线浏览与界面复核。