Tiny DataLib
This project is a library with useful utilities such as a database system and more.
Screenshots
About this Mod
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!
Available Versions
How to Install Tiny DataLib on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set datapack Loader
In the panel under "Egg", select the datapack loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "Tiny DataLib". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Tiny DataLib server crashes on startup – what to do?
Most common cause: wrong datapack version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is Tiny DataLib compatible with datapack and fabric and forge and neoforge and quilt?
Tiny DataLib officially supports datapack, fabric, forge, neoforge, quilt for Minecraft 1.21.11. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Tiny DataLib – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Tiny DataLib consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Tiny DataLib with just one click on your server.