d{IgY/dZddlZddlZddlZddlmZddlmZddlmZmZGdde Z Gd d e Z Gd d e Z Gd de ZGdde Zeee gZ Gdde ZdS)z Handles a Minecraft world save using either the Anvil or McRegion format. For more information about the world format: https://minecraft.gamepedia.com/Level_format N)region)chunk)InconceivedChunkLocationceZdZdZddZdS)UnknownWorldFormatz Unknown or invalid world folder.c||_dSN)msg)selfr s K/var/www/CMSBlueprintStation/venv/lib/python3.11/site-packages/nbt/world.py__init__zUnknownWorldFormat.__init__s N)r )__name__ __module__ __qualname____doc__rrrr r s.**rr ceZdZdZdZdZejZdZ dZ dZ dZ dZ d Zd Zdd Zd ZdZdZddZdZddZdZdZdZdZd S)_BaseWorldFolderz Abstract class, representing either a McRegion or Anvil world folder. This class will use either Anvil or McRegion, with Anvil the preferred format. Simply calling WorldFolder() will do this automatically. Genericr c||_i|_i|_d|_t j|||dS)zInitialize a WorldFolder.N) worldfolder regionfilesregionschunksoslistdirset_regionfiles get_filenames)r world_folders rrz_BaseWorldFolder.__init__sX'   <    T//1122222rc ttjtj|jdd|jzS)zFind all matching file names in the world folder. This method is private, and it's use it deprecated. Use get_regionfiles() instead.rzr.*.*.)listglobrpathjoinr extensionrs rr"z_BaseWorldFolder.get_filenames(s8 DIbgll4+;HXdnE\]]^^___rc,|D]}tjd|jztj|}|rEt |d}t |d}n ||j||f<dS)z This method directly sets the region files for this instance to use. It assumes the filenames are in the form r... zr.(\-?\d+).(\-?\d+).rN) rematchr)rr'basenameintgroupr)r filenamesfilenamemxzs rr!z _BaseWorldFolder.set_regionfiles/s " / /H0?AQAQRZA[A[\\A  OO OO&.D aU # # / /rcNt|jS)z/Return a list of full path of all region files.)r%rvaluesr*s rget_regionfilesz _BaseWorldFolder.get_regionfilesEsD$++--...rc2t|jdkS)z&Return True is the world is non-empty.r)lenrr*s rnonemptyz_BaseWorldFolder.nonemptyIs4#$$q((rcL||f|jvs|j||fjrw||f|jvr,tj|j||f|j||f<ntj|j||f<t |||j||f_|j||fS)z>Get a region using x,z coordinates of a region. Cache results.r5r6)rclosedrr RegionFilerlocrr5r6s r get_regionz_BaseWorldFolder.get_regionMs a5 $ $ QqS(9(@ $!u(((&,&78H!A8O&P&P aU##'-&7&9&9 aU#&.Q&7&7&7DL!A  #|QqE""rc#pK|jD]\}}d}||f|jvr|j||f}n@tj|j||f|j}t |||_d} |V|r|~#|r|wwxYwdS)z Return an iterable list of all region files. Use this function if you only want to loop through each region files once, and do not want to cache the results. F) chunkclassr>TN) rkeysrrr@rErrAclose)rr5r6close_after_use regionfiles r iter_regionsz_BaseWorldFolder.iter_regions\s#((** ' 'CAa#O!u $$!\1Q%0 $.t/?1/FUYUdeee !)A!2!2!2 "& '    "'$$&&&#'$$&&&&' ' 's ?BB3Nct)a1 Return an iterable that calls callback_function for each region file in the world. This is equivalent to: ``` for the_region in iter_regions(): yield callback_function(the_region) ```` This function is threaded. It uses pickle to pass values between threads. See [What can be pickled and unpickled?](https://docs.python.org/library/pickle.html#what-can-be-pickled-and-unpickled) in the Python documentation for limitation on the output of `callback_function()`. NotImplementedErrorrcallback_function boundingboxs rcall_for_each_regionz%_BaseWorldFolder.call_for_each_regions"###rct|d\}}t|d\}}||f|jvr!||f|jvrtd|d|d|||||}|dksJ|S)z Return a NBT specified by the chunk coordinates x,z. Raise InconceivedChunk if the NBT file is not yet generated. To get a Chunk object, use get_chunk. zChunk ,z is not present in worldN)divmodrrrrCget_nbt)rr5r6rxcxrzcznbts rrWz_BaseWorldFolder.get_nbts q 2q 2 r7$, & &Br7$:J+J+J""AAAaaa#PQQ Qoob$$,,R33d{{{{ rct)a Set a chunk. Overrides the NBT if it already existed. If the NBT did not exists, adds it to the Regionfile. May create a new Regionfile if that did not exist yet. nbt must be a nbt.NBTFile instance, not a Chunk or regular TAG_Compound object. rL)rr5r6r\s rset_nbtz_BaseWorldFolder.set_nbts "###rc#dK|D]}|jD]}|VdS)z Return an iterable list of all NBT. Use this function if you only want to loop through the chunks once, and don't need the block or data arrays. N)rJ iter_chunks)rrcs riter_nbtz_BaseWorldFolder.iter_nbtsW''))  F'V'))     rct)a) Return an iterable that calls callback_function for each NBT structure in the world. This is equivalent to: ``` for the_nbt in iter_nbt(): yield callback_function(the_nbt) ```` This function is threaded. It uses pickle to pass values between threads. See [What can be pickled and unpickled?](https://docs.python.org/library/pickle.html#what-can-be-pickled-and-unpickled) in the Python documentation for limitation on the output of `callback_function()`. rLrNs rcall_for_each_nbtz"_BaseWorldFolder.call_for_each_nbtrRrcT||||S)z Return a chunk specified by the chunk coordinates x,z. Raise InconceivedChunk if the chunk is not yet generated. To get the raw NBT data, use get_nbt. )rErWrBs r get_chunkz_BaseWorldFolder.get_chunks$ t||Aq11222rcr|jdkr&t||_|jS)z Return a list of all chunks. Use this function if you access the chunk list frequently and want to cache the result. Use iter_chunks() if you only want to loop through the chunks once or have a very large world. N)rr%r`)rrPs r get_chunksz_BaseWorldFolder.get_chunkss4 ;$  t//1122DK{rc#fK|D]}||VdS)ag Return an iterable list of all chunks. Use this function if you only want to loop through the chunks once or have a very large world. Use get_chunks() if you access the chunk list frequently and want to cache the results. Use iter_nbt() if you are concerned about speed and don't want to parse the block data. N)rbrE)rras rr`z_BaseWorldFolder.iter_chunkssD % %A//!$$ $ $ $ $ % %rcfd}|D]}||z }|S)z2Return a count of the chunks in this world folder.r)rJ chunk_count)rrars rrkz_BaseWorldFolder.chunk_counts; ""$$ ! !A  AArct}|jD]d\}}|||}d|zd|z}}|jD]/}||dz||dz}}||d|0e|S)zs Return minimum and maximum x and z coordinates of the chunks that make up this world save rTr5r6N) BoundingBoxrrFrCget_chunk_coordsexpand)rbrXrZrccr5r6s rget_boundingboxz _BaseWorldFolder.get_boundingboxs MM%**,, # #EBr__R++FrE"R%rB-f-// # #"S'z"RW*!4"""" #rc0|jjd|jdS)N()) __class__rrr*s r__repr__z_BaseWorldFolder.__repr__s!>22243C3C3CDDrr )rrrrtyper)rChunkrErr"r!r9r<rCrJrQrWr^rbrdrfrhr`rkrsrxrrrrrsV DIJ 3 3 3```///,///))) # # #'''. $ $ $ $   $$$    $ $ $ $333     % % %   EEEEErrc(eZdZdZdZdZejZdS)McRegionWorldFolderz6Represents a world save using the old McRegion format.McRegionmcrN) rrrrryr)r McRegionChunkrErrrr|r|s&@@ DI$JJJrr|c(eZdZdZdZdZejZdS)AnvilWorldFolderz3Represents a world save using the new Anvil format.AnvilmcaN) rrrrryr)r AnvilChunkrErrrrrs&== DI!JJJrrceZdZdZdZdZdS)_WorldFolderFactoryzFactory class: instantiate the subclassses in order, and the first instance whose nonempty() method returns True is returned. If no nonempty() returns True, a UnknownWorldFormat exception is raised.c||_dSr ) subclasses)rrs rrz_WorldFolderFactory.__init__s $rct|jD]"}||i|}|r|cS#td)NzEmpty world or unknown format)rr<r )rargskwargsclswfs r__call__z_WorldFolderFactory.__call__sT?  Cd%f%%B{{}}    !@AAArN)rrrrrrrrrrrsA11%%%BBBBBrrc8eZdZdZd dZdZdZdZdZdZ dS) rnz$A bounding box of x,y,z coordinates.Nc`||c|_|_||c|_|_||c|_|_dSr minxmaxxminymaxyminzmaxz)rrrrrrrs rrzBoundingBox.__init__s6"D $)"D $)"D $)))rc^|dkr2|j ||jkr||_|j ||jkr||_|dkr2|j ||jkr||_|j ||jkr||_|dkr4|j ||jkr||_|j ||jkr ||_dSdSdS)z& Expands the bounding Nr)rr5yr6s rrpzBoundingBox.expands 99y A MM y A MM 99y A MM y A MM 99y A MM y A MM 9%2MrcF|j|jdS|j|jz dzSNrr)rrr*s rlenxzBoundingBox.lenx&* 9  11y"1$$rcF|j|jdS|j|jz dzSr)rrr*s rlenyzBoundingBox.leny*rrcF|j|jdS|j|jz dzSr)rrr*s rlenzzBoundingBox.lenz.rrc|jjd|jd|jd|jd|jd|jd|jdS)NrurUrv)rwrrrrrrrr*s rrxzBoundingBox.__repr__2sK*..*A*A*A$)))DIII $)))DIIIdiii9 9r)NNNNNN) rrrrrrprrrrxrrrrnrn sy..))))&%%%%%%%%%99999rrn)rrr&r-r rrrr Exceptionr objectrr|rr WorldFolderrnrrrrs........ TETETETETEvTETETEn%%%%%*%%%"""""'""" B B B B B& B B B"!#35H"IJJ '9'9'9'9'9&'9'9'9'9'9r