DataFly Lib

Datafly

A shared async I/O library for Fly’s Minecraft mods providing centralized, high-performance disk persistence.

Features

• One shared thread pool across all mods — no wasted threads, no duplicated I/O code
• Write data from any thread and get a result via DataTask — no blocking, no callback hell
• Read-your-writes guarantee — reads always return the latest submitted value even before it hits disk
• Coalesces burst writes to the same key — only the last value in a time window actually writes to disk
• Atomic writes via tmp → fsync → rename — no half-written or corrupted files on crash
• Emergency gzip compression when buffer memory runs low — trades CPU for heap headroom
• Spill oversized writes to a temp spool directory instead of blocking or dropping data
• Crash recovery — leftover spool files are re-drained to their destinations on next startup
• Pluggable codec system — JSON, NBT, TOML, YAML, raw bytes, or bring your own
• Per-mod writer configuration — each mod controls its own heap limit, codec, coalesce window, and cache size
• Optional LRU read cache — skip disk entirely for hot keys
• update() — atomic read-modify-write with the write lock held for the full cycle
• computeIfAbsent() — create-or-update in one atomic call
• World-agnostic — works from the main menu, client-side, dedicated server, anywhere