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?
[Download Tiny DataLib v0.0.3 ALPHA Today]

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