Tiny DataLib

## Tiny DataLib: The Essential Utility Toolkit for Minecraft Datapacks

Tiny DataLib is a lightweight, high-performance library designed to handle the "heavy lifting" of datapack development. Whether you need to calculate complex distances, manage persistent entity data, or run precise raycasts, Tiny DataLib provides a clean, macro-powered API so you can focus on building your game mechanics, not debugging NBT.

### Key Features

| Feature | Description | Why it matters | | --- | --- | --- | | Hybrid Database | Store data using UUIDs (for players/entities) or Custom Keys (for global settings/configs). | Flexible enough for player stats, custom block data, or world-wide variables. | | In-Storage Var Math | Perform operations (`+=`, `-=`, `=`, `/=`, etc.) directly on database variables via macros. | No more manual scoreboard-to-NBT shuffling. Update data in a single function call. | | Granular Data Control | Precision `get/set` for specific NBT paths or `get_full/set_full` for entire objects. | Optimized performance: only move the data you actually need. | | Accurate Distance | Calculate the exact distance between any two entities or points in the world. | Perfect for range checks, custom AI, or area-of-effect spells. | | Intelligent Raycasting | High-speed block detection to find exactly what a player is looking at. | Essential for custom tools, magic wands, and interactive environments. |

### Designed for Modern Developers

Tiny DataLib is built for Minecraft 1. 21. 11, leveraging the latest engine features:

Macro-First Design: Use `$(variable)` inputs for extreme flexibility in your function calls. Developer Friendly: Clear return codes (e.g., `-1` for missing entries, `-2` for invalid paths) help you debug instantly. Optimized Performance: Uses "Entry" based logic to minimize lag and keep your tick-rate high.

### Getting Started

Using Tiny DataLib is as simple as running a single function call!

> Note: As of v0. 0. 2, the library has migrated from "Save" terminology to "Entry" for better technical accuracy.

You can find the complete API documentation, function parameters, and examples in our Wiki.

### Looking Ahead

We are continuously evolving Tiny DataLib. Future updates will focus on:

Advanced Raycasting: Improved entity hitbox detection. Distance Optimization: Further reducing overhead for high-frequency calculations. Custom Give 2. 0: Intelligent item stacking, overflow handling, and Component support. New Modules: Tools for Mannequin (Armor Stand) animation and easier Attribute management.

Ready to accelerate your development?

Licensed under the MIT License. Please remember to list Tiny DataLib as a dependency in your Modrinth project!