Tiny DataLib
This project is a library with useful utilities such as a database system and more.
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.,
-1for missing entries,-2for 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!
