Better Than Datapacks is a data-driven system for creating custom blocks and items in Better Than Adventure, no coding required.

Everything is defined with .atom (TOML) files, packaged in a .zip, and loads straight into the game.

How it works

• Each block or item is a data/*.atom
• All Atoms live inside a .zip
• Datapack-like structure

my_atoms.zip
├─ data/*.atom
└─ assets/namespace/textures/...

Textures

Textures use the same vanilla-compatible system as BTA texturepacks:

assets/<namespace>/textures/...

Fully compatible with the current version of the game. Texturepacks can override Atom textures without hacks.

Current state (WIP) (Upcoming update 2.0.0)

✔ Normal blocks ✔ Items ✔ Vanilla-style block models ✔ .zip loading :construction: Sounds support :construction: Recipes (like vanilla works but with toml) :test_tube: External app for creating Atoms :question: Tiny Atom Store (idea) :question: Biome Generation | World Generation

(Support for loose .atom files will return in the future)

Perfect for mapmakers, artists, and anyone who wants custom content without coding.

Release v1.1.0 - Major Update

• Improved file format with new fields and customization

Example block

[meta]
author = "@Garkatron"
object_type = "BLOCK"
format_version = 1

[data]
name = "AtomBlock"
tags = [ "mineable_by_pickaxe" ]
immovable = true
unbreakable = false
resistance = 22
slipperiness = 0.6
hardness = 22
material = "cloth"
luminance = 2

[textures]
encoding = "base64"

[textures.faces]
top = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAUElEQVQ4jWNkYGD4z0ABYKJEMwMDAwMLjPH/P2kOYWRkpI4LRg0YFgbAE9JaY2O4YPDZsyQZ8p+BgeH//////68xMvpPLIDpo9gLjAwDnRsBIzM5/qUyzv4AAAAASUVORK5CYII="
bottom = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAS0lEQVQ4jWNkYGD4z0ABYKJEMwMDAwMLjPH/P2kOYWRkpI4LRg2gtgFrjY0Z1hobU+aC4LNnSTIEw4C1xsYMwWfPDiEXMDIMdG4EANR/E0USOuyJAAAAAElFTkSuQmCC"
north = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAASUlEQVQ4jWNkYGD4z0ABYKJEMwMDAwMLjPH/P2kOYWRkpI4LRg0YdAasNTbGyibJBcRqxGlA8NmzJBmCNQyCz54l2gBGhoHOjQDibw1Fa9elgQAAAABJRU5ErkJggg=="
south = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAXElEQVQ4je2TsQ2AMAwEzygTxaOwJhklMz2VJSgiOQqIhq/c/OmvsAFiIdtKGaDEIc0NMbNnFvyANwDNneY+BREgSTpqVTbRuwFmIENAFhK9cnUJ9733tL/x9TeepmSf3mreDRoAAAAASUVORK5CYII="
east = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAATElEQVQ4jWNkYGD4z0ABYKJEMwMDAwMLjPH/P2kOYWRkpI4LRg2gZjQyMDAwrDU2hrODz54l3QBSNMIAhhfWGhujuGTwu4CRYaBzIwAhaxBLpJtcuwAAAABJRU5ErkJggg=="
west = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAARklEQVQ4jWNkYGD4z0ABYKJEMwMDAwMLjPH/P2kOYWRkpI4LRg0YfgasNTbGStPUBQwMkMz0HwbWGBmh0LgATB8jw0DnRgBxdDhIJwkfyQAAAABJRU5ErkJggg=="

[events.on_break]
drop_itself = true

[[events.on_break.drops]]
item = 0
cause = "PROPER_TOOL"
chance = 0

[sounds]
sound = "GRASS"

[recipe]
enable_workbench = true
enable_furnace = false

[recipe.furnace]
out_item_id = 1
output_amount = 0

[recipe.workbench]
pattern = [ [ "", "", "" ], [ "A", "A", "" ], [ "", "", "" ] ]
output_amount = 0

[[recipe.workbench.symbols]]
A = 50

[lang]
key = "en_US"

[lang.locales.en_US]
name = "AtomBlock"
desc = "A test block"
tooltip = "Nothing here"

[flammability]
chance_to_catch_fire = 0
change_to_degrade = 0

[render]
is_cube_shaped = true
is_solid_render = true

[physics]
is_collidable = true

Data-Driven, Configurable & Shareable Blocks for BTA

Atoms is a lightweight, single-file, fully data-driven system for creating custom blocks in Better Than Adventure (BTA). Powered by TOML-based configuration, Atoms lets you define blocks quickly and cleanly. No Java/Lua coding required. Just edit a file, drop it in your game, and your new block comes to life.

Because every block lives in its own standalone file, Atoms makes creations easy to share, perfect for mapmakers and artists (texturepacks).

Current Features (WIP)

• -based block definitions

• Easy Translations

• Custom file extension for better organization

• An external block-creation app to simplify editing

• Tiny Block Store

Planned Features

• Data-driven items

• Blockbench model support

• Support for vanilla-style functional blocks (furnaces, chests, etc.)