World Loading

// World loading implementation from src/loadSave.ts
export const loadSave = async (root = '/world', connectOptions?: Partial<ConnectOptions>) => {
  // Read level.dat to detect version
  const { levelDat, dataRaw } = (await readLevelDat(root))!
  
  // Extract version information
  let version = levelDat.Version?.Name
  if (!version) {
    // Fallback for 1.8 and earlier
    version = '1.8.8'
  }
  
  // Handle player data override
  const playerUuid = nameToMcOfflineUUID(options.localUsername)
  const playerDatPath = `${root}/playerdata/${playerUuid}.dat`
  
  // Dispatch singleplayer event
  window.dispatchEvent(new CustomEvent('singleplayer', {
    detail: { version, worldFolder: root, connectOptions }
  }))
}

// Zip files stored in RAM from README.MD:74
// When opening zip files, they are stored entirely in your RAM.
// There is a ~300 MB file limit on iOS.

world/
├── level.dat          # World metadata (required)
├── region/            # Terrain data (required)
│   ├── r.-1.-1.mca
│   ├── r.-1.0.mca
│   ├── r.0.-1.mca
│   └── r.0.0.mca
├── playerdata/        # Player data files
│   └── <uuid>.dat
├── data/              # Scoreboard, structures, etc.
└── DIM-1/             # Nether dimension (optional)
    └── region/

// From src/loadSave.ts:37
export const readLevelDat = async (path) => {
  let levelDatContent
  try {
    levelDatContent = await fs.promises.readFile(`${path}/level.dat`)
  } catch (err) {
    if (err.code === 'ENOENT') {
      return undefined // level.dat not found
    }
    throw err
  }
  
  const { parsed } = await nbt.parse(Buffer.from(levelDatContent))
  const levelDat = nbt.simplify(parsed).Data
  return { levelDat, dataRaw: parsed.value.Data!.value }
}

// Version detection from src/loadSave.ts:88
let version = levelDat.Version?.Name
if (!version) {
  // For Minecraft 1.8 and earlier
  // level.dat doesn't contain version info
  const newVersion = '1.8.8'
  version = newVersion
}

?loadSave=my-world&version=1.19.4

?map=https://example.com/world.zip&mapVersion=1.20.1

// Export implementation from src/builtinCommands.ts:36
export const exportWorld = async (path: string, type: 'zip' | 'folder', zipName = 'world-prismarine-exported') => {
  try {
    if (type === 'zip') {
      setLoadingScreenStatus('Generating zip, this may take a few minutes')
      const zip = new JSZip()
      await addFolderToZip(path, zip, '')
      
      // Generate the ZIP archive content
      const zipContent = await zip.generateAsync({ type: 'blob' })
      
      // Create a download link and trigger the download
      const downloadLink = document.createElement('a')
      downloadLink.href = URL.createObjectURL(zipContent)
      downloadLink.download = `${zipName}.zip`
      downloadLink.click()
      
      URL.revokeObjectURL(downloadLink.href)
    }
  } finally {
    setLoadingScreenStatus(undefined)
  }
}

// Folder export from src/builtinCommands.ts:55
if (type === 'folder') {
  setLoadingScreenStatus('Preparing export folder')
  let dest = '/'
  if ((await fs.promises.readdir('/export')).length) {
    const { levelDat } = (await readLevelDat(path))!
    dest = await uniqueFileNameFromWorldName(levelDat.LevelName, path)
  }
  await copyFilesAsync(path, '/export' + dest)
}

?noSave=true

// From README.MD:194
// ?noSave=true - Disable auto save on unload / disconnect / export
// Only manual save with `/save` command will work

// FS state tracking from src/loadSave.ts:18
export const fsState = proxy({
  isReadonly: false,
  syncFs: false,
  inMemorySave: false,
  saveLoaded: false,
  openReadOperations: 0,
  openWriteOperations: 0,
  remoteBackend: false,
  inMemorySavePath: ''
})

// View current world state
fsState

// Check if world is read-only
fsState.isReadonly

// View save path
fsState.inMemorySavePath

// Access level.dat data
readLevelDat('/world').then(console.log)