File	Date	Author	Commit
testdata	2015-10-07	Clark Gaebel	[10d252] Fixed #18
.gitignore	2022-04-01	WHR	[8a7089] Add option '-V' to mkfs.nbt and mount.nbt
MPL-2.0	2022-03-29	WHR	[3387f8] Add basic writing support for mount.nbt
Makefile	2025-05-06	WHR	[dbd559] Copy CPPFLAGS content into CFLAGS in Makefile f...
NBT.txt	2011-03-16	Clark Gaebel	[03359a] Added notch's NBT.txt for quick reference.
README	2024-03-12	WHR	[3113be] Fix typo in README
afl_check.c	2015-10-24	Clark Gaebel	[5850e3] afl_init
afl_check.sh	2015-10-24	Clark Gaebel	[190c57] afl checks
buffer.c	2011-03-30	Clark Gaebel	[85d879] Bugfix. I fail at pushing.
buffer.h	2011-03-29	Clark Gaebel	[51a1fc] Moved buffer's implementation into its own file.
cNBT-README	2022-03-31	WHR	[2b16cc] Add a new README
check.c	2012-07-11	Clark Gaebel	[d39163] Added checks for nbt_map and nbt_size.
list.h	2011-04-08	Louis Delacroix	[670b21] Made the headers C++ compatible (at least GCC-c...
mkfs.nbt.8	2023-10-20	WHR	[68f665] Fix some typos in man pages
mkfs.nbt.c	2022-04-01	WHR	[8a7089] Add option '-V' to mkfs.nbt and mount.nbt
mount.nbt.8	2025-02-22	WHR	[ea2a44] Mention available system calls to create new no...
mount.nbt.c	2025-03-28	WHR	[ddc0bb] Limit uses of the intermediate buffer in nbt_re...
nbt.h	2024-08-30	WHR	[fc0089] Correct header comment format in nbt.h
nbt_loading.c	2011-03-29	Clark Gaebel	[51a1fc] Moved buffer's implementation into its own file.
nbt_parsing.c	2023-07-20	WHR	[b09a7e] Check for failure from helper functions explici...
nbt_treeops.c	2022-03-31	WHR	[f469a2] Fix nbt_free(3) didn't free(3) TAG_LONG_ARRAY b...
nbt_util.c	2012-03-04	sztomi	[ad1ca9] PATCH: Added support for TAG_INT_ARRAY (tag 11).
nbtdump.1	2023-10-20	WHR	[ac4bd3] Revise header of man pages
nbtdump.c	2022-04-03	WHR	[3fcc55] Call nbt_free(3) immediately after nbt_dump_asc...
regiondump.1	2023-10-20	WHR	[ac4bd3] Revise header of man pages
regiondump.c	2023-11-08	WHR	[f35809] Correct error checkings of mmap(2) calls
syncrw.h	2022-03-29	WHR	[2ed5b4] Add support of writing region file
syncwrite.c	2022-03-29	WHR	[2ed5b4] Add support of writing region file

Read Me

This source tree contains utilities for maintaining NBT files and Minecraft
Region files. The primary part is a FUSE-based file system implementation
which allowing NBT file or Minecraft Region file be mounted as a file system,
and then modified using normal file operations.

NBT parser and writer are originally written by Lukas Niederbremer as cNBT
project which this project is based on.

INSTALL
=======
To build it from source, make sure you have GCC or a compatible C compiler,
GNU Make or BSD make, FUSE development library, as well as zlib development
library installed, then type 'make'; some environment variables are useful to
configure the build:
	CC		C compiler
	AR		archive tool for creating static library
	CFLAGS		prepend flags to C compiler
	LDFLAGS		prepend flags to linker (e.g. -L <path>)
Example:
	$ CC=gcc CFLAGS=-Os make

To install built programs and manual pages, type 'make install'; some
additional environment variables may be used here:
	PREFIX		installing prefix, default /usr/local
	BINDIR		default ${PREFIX}/bin
	SBINDIR		default ${PREFIX}/sbin
	DATADIR		default ${PREFIX}/share
	MANDIR		default ${DATADIR}/man

MONUT THE FILE SYSTEM
=====================
Use program mount.nbt(8) to mount the file system from a NBT file or a Region
file. The synopsis of the command line is:
	mount.nbt [-o <fs-options>] [<other-options>] <mount-from-file> <mount-point>
The <fs-options> accepts both generic and FS-specific mount options; some
of them are useful to specify here; see man page mount.nbt(8) for a detailed
description of each FS-specific option.

Example:
	# mount.nbt -o ro,region,umask=0022 /usr/home/minecraft/aether-realm/world/AETHER/region/r.1.1.mca /mnt/region/
	# ls -al /mnt/region/80/Level/
	total 0
	-rw-r--r--  1 root  wheel   256 Jan  1  1970 Biomes
	drwxr-xr-x  1 root  wheel     1 Jan  1  1970 Entities
	drwxr-xr-x  1 root  wheel  1024 Jan  1  1970 HeightMap
	-rw-r--r--  1 root  wheel     7 Jan  1  1970 InhabitedTime
	-rw-r--r--  1 root  wheel    10 Jan  1  1970 LastUpdate
	-rw-r--r--  1 root  wheel     2 Jan  1  1970 LightPopulated
	drwxr-xr-x  1 root  wheel    25 Jan  1  1970 Sections
	-rw-r--r--  1 root  wheel     2 Jan  1  1970 TerrainPopulated
	drwxr-xr-x  1 root  wheel     1 Jan  1  1970 TileEntities
	-rw-r--r--  1 root  wheel     2 Jan  1  1970 V
	-rw-r--r--  1 root  wheel     3 Jan  1  1970 xPos
	-rw-r--r--  1 root  wheel     3 Jan  1  1970 zPos
	# ls -al /mnt/region/80/Level/Sections/
	total 0
	-rw-r--r--  1 root  wheel  9 Jan  1  1970 .type
	drwxr-xr-x  1 root  wheel  6 Jan  1  1970 0
	drwxr-xr-x  1 root  wheel  6 Jan  1  1970 1
	drwxr-xr-x  1 root  wheel  6 Jan  1  1970 2
	drwxr-xr-x  1 root  wheel  6 Jan  1  1970 3
	# cat /mnt/region/80/Level/?Pos
	48
	34