LEVELDB_ZLIB_RAW_COMPRESSION, "block_size" => 64 * 1024 //64KB, big enough for most chunks ]); } public function __construct(string $path){ self::checkForLevelDBExtension(); parent::__construct($path); try{ $this->db = self::createDB($path); }catch(\LevelDBException $e){ //we can't tell the difference between errors caused by bad permissions and actual corruption :( throw new CorruptedWorldException(trim($e->getMessage()), 0, $e); } } protected function loadLevelData() : WorldData{ return new BedrockWorldData($this->getPath() . DIRECTORY_SEPARATOR . "level.dat"); } public function getWorldHeight() : int{ return 256; } public static function isValid(string $path) : bool{ return file_exists($path . "/level.dat") and is_dir($path . "/db/"); } public static function generate(string $path, string $name, int $seed, string $generator, array $options = []) : void{ Utils::testValidInstance($generator, Generator::class); self::checkForLevelDBExtension(); if(!file_exists($path . "/db")){ mkdir($path . "/db", 0777, true); } BedrockWorldData::generate($path, $name, $seed, $generator, $options); } protected function deserializePaletted(BinaryStream $stream) : PalettedBlockArray{ $bitsPerBlock = $stream->getByte() >> 1; try{ $words = $stream->get(PalettedBlockArray::getExpectedWordArraySize($bitsPerBlock)); }catch(\InvalidArgumentException $e){ throw new CorruptedChunkException("Failed to deserialize paletted storage: " . $e->getMessage(), 0, $e); } $nbt = new LittleEndianNbtSerializer(); $palette = []; $idMap = LegacyBlockIdToStringIdMap::getInstance(); for($i = 0, $paletteSize = $stream->getLInt(); $i < $paletteSize; ++$i){ $offset = $stream->getOffset(); $tag = $nbt->read($stream->getBuffer(), $offset)->mustGetCompoundTag(); $stream->setOffset($offset); $id = $idMap->stringToLegacy($tag->getString("name")) ?? BlockLegacyIds::INFO_UPDATE; $data = $tag->getShort("val"); $palette[] = ($id << 4) | $data; } //TODO: exceptions return PalettedBlockArray::fromData($bitsPerBlock, $words, $palette); } protected static function deserializeExtraDataKey(int $chunkVersion, int $key, ?int &$x, ?int &$y, ?int &$z) : void{ if($chunkVersion >= 3){ $x = ($key >> 12) & 0xf; $z = ($key >> 8) & 0xf; $y = $key & 0xff; }else{ //pre-1.0, 7 bits were used because the build height limit was lower $x = ($key >> 11) & 0xf; $z = ($key >> 7) & 0xf; $y = $key & 0x7f; } } /** * @return PalettedBlockArray[] */ protected function deserializeLegacyExtraData(string $index, int $chunkVersion) : array{ if(($extraRawData = $this->db->get($index . self::TAG_BLOCK_EXTRA_DATA)) === false or $extraRawData === ""){ return []; } /** @var PalettedBlockArray[] $extraDataLayers */ $extraDataLayers = []; $binaryStream = new BinaryStream($extraRawData); $count = $binaryStream->getLInt(); for($i = 0; $i < $count; ++$i){ $key = $binaryStream->getLInt(); $value = $binaryStream->getLShort(); self::deserializeExtraDataKey($chunkVersion, $key, $x, $fullY, $z); $ySub = ($fullY >> 4) & 0xf; $y = $key & 0xf; $blockId = $value & 0xff; $blockData = ($value >> 8) & 0xf; if(!isset($extraDataLayers[$ySub])){ $extraDataLayers[$ySub] = new PalettedBlockArray(BlockLegacyIds::AIR << 4); } $extraDataLayers[$ySub]->set($x, $y, $z, ($blockId << 4) | $blockData); } return $extraDataLayers; } /** * @throws CorruptedChunkException */ protected function readChunk(int $chunkX, int $chunkZ) : ?Chunk{ $index = LevelDB::chunkIndex($chunkX, $chunkZ); $chunkVersionRaw = $this->db->get($index . self::TAG_VERSION); if($chunkVersionRaw === false){ return null; } /** @var SubChunk[] $subChunks */ $subChunks = []; /** @var BiomeArray|null $biomeArray */ $biomeArray = null; $chunkVersion = ord($chunkVersionRaw); $hasBeenUpgraded = $chunkVersion < self::CURRENT_LEVEL_CHUNK_VERSION; switch($chunkVersion){ case 15: //MCPE 1.12.0.4 beta (???) case 14: //MCPE 1.11.1.2 (???) case 13: //MCPE 1.11.0.4 beta (???) case 12: //MCPE 1.11.0.3 beta (???) case 11: //MCPE 1.11.0.1 beta (???) case 10: //MCPE 1.9 (???) case 9: //MCPE 1.8 (???) case 7: //MCPE 1.2 (???) case 6: //MCPE 1.2.0.2 beta (???) case 4: //MCPE 1.1 //TODO: check beds case 3: //MCPE 1.0 $convertedLegacyExtraData = $this->deserializeLegacyExtraData($index, $chunkVersion); for($y = 0; $y < Chunk::MAX_SUBCHUNKS; ++$y){ if(($data = $this->db->get($index . self::TAG_SUBCHUNK_PREFIX . chr($y))) === false){ continue; } $binaryStream = new BinaryStream($data); if($binaryStream->feof()){ throw new CorruptedChunkException("Unexpected empty data for subchunk $y"); } $subChunkVersion = $binaryStream->getByte(); if($subChunkVersion < self::CURRENT_LEVEL_SUBCHUNK_VERSION){ $hasBeenUpgraded = true; } switch($subChunkVersion){ case 0: case 2: //these are all identical to version 0, but vanilla respects these so we should also case 3: case 4: case 5: case 6: case 7: try{ $blocks = $binaryStream->get(4096); $blockData = $binaryStream->get(2048); if($chunkVersion < 4){ $binaryStream->get(4096); //legacy light info, discard it $hasBeenUpgraded = true; } }catch(BinaryDataException $e){ throw new CorruptedChunkException($e->getMessage(), 0, $e); } $storages = [SubChunkConverter::convertSubChunkXZY($blocks, $blockData)]; if(isset($convertedLegacyExtraData[$y])){ $storages[] = $convertedLegacyExtraData[$y]; } $subChunks[$y] = new SubChunk(BlockLegacyIds::AIR << 4, $storages); break; case 1: //paletted v1, has a single blockstorage $storages = [$this->deserializePaletted($binaryStream)]; if(isset($convertedLegacyExtraData[$y])){ $storages[] = $convertedLegacyExtraData[$y]; } $subChunks[$y] = new SubChunk(BlockLegacyIds::AIR << 4, $storages); break; case 8: //legacy extradata layers intentionally ignored because they aren't supposed to exist in v8 $storageCount = $binaryStream->getByte(); if($storageCount > 0){ $storages = []; for($k = 0; $k < $storageCount; ++$k){ $storages[] = $this->deserializePaletted($binaryStream); } $subChunks[$y] = new SubChunk(BlockLegacyIds::AIR << 4, $storages); } break; default: //TODO: set chunks read-only so the version on disk doesn't get overwritten throw new CorruptedChunkException("don't know how to decode LevelDB subchunk format version $subChunkVersion"); } } if(($maps2d = $this->db->get($index . self::TAG_DATA_2D)) !== false){ $binaryStream = new BinaryStream($maps2d); try{ $binaryStream->get(512); //heightmap, discard it $biomeArray = new BiomeArray($binaryStream->get(256)); //never throws }catch(BinaryDataException $e){ throw new CorruptedChunkException($e->getMessage(), 0, $e); } } break; case 2: // < MCPE 1.0 case 1: case 0: //MCPE 0.9.0.1 beta (first version) $convertedLegacyExtraData = $this->deserializeLegacyExtraData($index, $chunkVersion); $legacyTerrain = $this->db->get($index . self::TAG_LEGACY_TERRAIN); if($legacyTerrain === false){ throw new CorruptedChunkException("Missing expected LEGACY_TERRAIN tag for format version $chunkVersion"); } $binaryStream = new BinaryStream($legacyTerrain); try{ $fullIds = $binaryStream->get(32768); $fullData = $binaryStream->get(16384); $binaryStream->get(32768); //legacy light info, discard it }catch(BinaryDataException $e){ throw new CorruptedChunkException($e->getMessage(), 0, $e); } for($yy = 0; $yy < 8; ++$yy){ $storages = [SubChunkConverter::convertSubChunkFromLegacyColumn($fullIds, $fullData, $yy)]; if(isset($convertedLegacyExtraData[$yy])){ $storages[] = $convertedLegacyExtraData[$yy]; } $subChunks[$yy] = new SubChunk(BlockLegacyIds::AIR << 4, $storages); } try{ $binaryStream->get(256); //heightmap, discard it $biomeArray = new BiomeArray(ChunkUtils::convertBiomeColors(array_values(unpack("N*", $binaryStream->get(1024))))); //never throws }catch(BinaryDataException $e){ throw new CorruptedChunkException($e->getMessage(), 0, $e); } break; default: //TODO: set chunks read-only so the version on disk doesn't get overwritten throw new CorruptedChunkException("don't know how to decode chunk format version $chunkVersion"); } $nbt = new LittleEndianNbtSerializer(); /** @var CompoundTag[] $entities */ $entities = []; if(($entityData = $this->db->get($index . self::TAG_ENTITY)) !== false and $entityData !== ""){ try{ $entities = array_map(function(TreeRoot $root) : CompoundTag{ return $root->mustGetCompoundTag(); }, $nbt->readMultiple($entityData)); }catch(NbtDataException $e){ throw new CorruptedChunkException($e->getMessage(), 0, $e); } } /** @var CompoundTag[] $tiles */ $tiles = []; if(($tileData = $this->db->get($index . self::TAG_BLOCK_ENTITY)) !== false and $tileData !== ""){ try{ $tiles = array_map(function(TreeRoot $root) : CompoundTag{ return $root->mustGetCompoundTag(); }, $nbt->readMultiple($tileData)); }catch(NbtDataException $e){ throw new CorruptedChunkException($e->getMessage(), 0, $e); } } $chunk = new Chunk( $chunkX, $chunkZ, $subChunks, $entities, $tiles, $biomeArray ); //TODO: tile ticks, biome states (?) $chunk->setGenerated(); $chunk->setPopulated(); if($hasBeenUpgraded){ $chunk->setDirty(); //trigger rewriting chunk to disk if it was converted from an older format } return $chunk; } protected function writeChunk(Chunk $chunk) : void{ $idMap = LegacyBlockIdToStringIdMap::getInstance(); $index = LevelDB::chunkIndex($chunk->getX(), $chunk->getZ()); $write = new \LevelDBWriteBatch(); $write->put($index . self::TAG_VERSION, chr(self::CURRENT_LEVEL_CHUNK_VERSION)); if($chunk->getDirtyFlag(Chunk::DIRTY_FLAG_TERRAIN)){ $subChunks = $chunk->getSubChunks(); foreach($subChunks as $y => $subChunk){ $key = $index . self::TAG_SUBCHUNK_PREFIX . chr($y); if($subChunk->isEmptyAuthoritative()){ $write->delete($key); }else{ $subStream = new BinaryStream(); $subStream->putByte(self::CURRENT_LEVEL_SUBCHUNK_VERSION); $layers = $subChunk->getBlockLayers(); $subStream->putByte(count($layers)); foreach($layers as $blocks){ $subStream->putByte($blocks->getBitsPerBlock() << 1); $subStream->put($blocks->getWordArray()); $palette = $blocks->getPalette(); $subStream->putLInt(count($palette)); $tags = []; foreach($palette as $p){ $tags[] = new TreeRoot(CompoundTag::create() ->setString("name", $idMap->legacyToString($p >> 4) ?? "minecraft:info_update") ->setInt("oldid", $p >> 4) //PM only (debugging), vanilla doesn't have this ->setShort("val", $p & 0xf)); } $subStream->put((new LittleEndianNbtSerializer())->writeMultiple($tags)); } $write->put($key, $subStream->getBuffer()); } } } if($chunk->getDirtyFlag(Chunk::DIRTY_FLAG_BIOMES)){ $write->put($index . self::TAG_DATA_2D, str_repeat("\x00", 512) . $chunk->getBiomeIdArray()); } //TODO: use this properly $write->put($index . self::TAG_STATE_FINALISATION, chr(self::FINALISATION_DONE)); $this->writeTags($chunk->getNBTtiles(), $index . self::TAG_BLOCK_ENTITY, $write); $this->writeTags($chunk->getNBTentities(), $index . self::TAG_ENTITY, $write); $write->delete($index . self::TAG_DATA_2D_LEGACY); $write->delete($index . self::TAG_LEGACY_TERRAIN); $this->db->write($write); } /** * @param CompoundTag[] $targets */ private function writeTags(array $targets, string $index, \LevelDBWriteBatch $write) : void{ if(count($targets) > 0){ $nbt = new LittleEndianNbtSerializer(); $write->put($index, $nbt->writeMultiple(array_map(function(CompoundTag $tag) : TreeRoot{ return new TreeRoot($tag); }, $targets))); }else{ $write->delete($index); } } public function getDatabase() : \LevelDB{ return $this->db; } public static function chunkIndex(int $chunkX, int $chunkZ) : string{ return Binary::writeLInt($chunkX) . Binary::writeLInt($chunkZ); } public function doGarbageCollection() : void{ } public function close() : void{ $this->db->close(); } public function getAllChunks(bool $skipCorrupted = false, ?\Logger $logger = null) : \Generator{ foreach($this->db->getIterator() as $key => $_){ if(strlen($key) === 9 and substr($key, -1) === self::TAG_VERSION){ $chunkX = Binary::readLInt(substr($key, 0, 4)); $chunkZ = Binary::readLInt(substr($key, 4, 4)); try{ if(($chunk = $this->loadChunk($chunkX, $chunkZ)) !== null){ yield $chunk; } }catch(CorruptedChunkException $e){ if(!$skipCorrupted){ throw $e; } if($logger !== null){ $logger->error("Skipped corrupted chunk $chunkX $chunkZ (" . $e->getMessage() . ")"); } } } } } public function calculateChunkCount() : int{ $count = 0; foreach($this->db->getIterator() as $key => $_){ if(strlen($key) === 9 and substr($key, -1) === self::TAG_VERSION){ $count++; } } return $count; } }