微型数据库

微型数据库

本项目是一个库,包含数据库系统等实用工具。

Tiny DataLib:Minecraft 数据包必备实用工具库

Tiny DataLib 是一个轻量级、高性能的库,旨在处理数据包开发中的“繁重工作”。无论你需要计算复杂距离、管理持久化实体数据,还是执行精确的射线检测,Tiny DataLib 都提供了一套整洁的、由宏驱动的 API,让你能够专注于构建游戏机制,而不是调试 NBT。


核心特性

特性 描述 为何重要
混合数据库 使用 UUID(用于玩家/实体)或 自定义键(用于全局设置/配置)存储数据。 足够灵活,可用于玩家统计、自定义方块数据或全局变量。
存储内变量运算 通过宏直接在数据库变量上执行运算(+=、-=、*=、/= 等)。 不再需要手动在记分板与 NBT 之间来回搬运。一次函数调用即可更新数据。
细粒度数据控制 针对特定 NBT 路径的精确 get/set,或针对整个对象的 get_full/set_full。 优化性能:只移动你真正需要的数据。
精确距离 计算世界中任意两个实体或点之间的精确距离。 非常适合范围检测、自定义 AI 或范围效果法术。
智能射线检测 高速方块检测,精确找出玩家正在注视的目标。 自定义工具、魔法杖和交互式环境的必备功能。

为现代开发者而设计

Tiny DataLib 基于 Minecraft 1.21.11 构建,充分利用了最新的引擎特性:

  • 宏优先设计: 使用 $(variable) 输入,让你的函数调用拥有极高的灵活性。
  • 开发者友好: 清晰的返回码(例如,-1 表示条目缺失,-2 表示路径无效)帮助你即时调试。
  • 优化性能: 采用基于“Entry”的逻辑,最大限度地减少卡顿并保持高刻速率。

快速上手

使用 Tiny DataLib 就像调用一个函数一样简单!

注意: 自 v0.0.2 起,该库已将“Save”术语迁移为 “Entry”,以提高技术准确性。

你可以在我们的 Wiki 中找到完整的 API 文档、函数参数和示例。


未来展望

我们正在持续改进 Tiny DataLib。未来的更新将聚焦于:

  • 高级射线检测: 改进实体碰撞箱检测。
  • 距离优化: 进一步降低高频计算的开销。
  • 自定义 Give 2.0: 智能物品堆叠、溢出处理以及组件支持。
  • 新模块: 用于 Mannequin(盔甲架)动画的工具,以及更便捷的属性管理。

准备好加速你的开发了吗? [立即下载 Tiny DataLib v0.0.3 ALPHA]

基于 MIT 许可证 授权。请记得在你的 Modrinth 项目中将 Tiny DataLib 列为依赖项!