HyDB is a professional base plugin for Hytale that provides a comprehensive SQLite database API for persistent data storage. It allows other plugins to easily store and retrieve data without managing database connections themselves.
Think of it as a database service layer - install HyDB once, and all your other plugins can use it for reliable, fast, thread-safe data storage.
/hydb list - View all databases with file sizes/hydb info <db> - Show database details and statistics/hydb tables <db> - List all tables with row counts/hydb query <db> "SQL" - Execute SELECT queries for debuggingHyDB-1.0.0.jarmods folderRequirements:
// Get the API
HyDBAPI api = HyDBPlugin.getAPI();
// Get or create a database
Database db = api.getGlobalDatabase("myplugin");
// Create a table
db.createTable("users",
"id INTEGER PRIMARY KEY AUTOINCREMENT",
"uuid TEXT NOT NULL UNIQUE",
"username TEXT NOT NULL",
"coins INTEGER DEFAULT 0"
);
// Insert data (async)
Map<String, Object> data = new HashMap<>();
data.put("uuid", player.getUniqueId().toString());
data.put("username", player.getName());
data.put("coins", 100);
db.insertAsync("users", data).thenAccept(rows -> {
System.out.println("Player data saved!");
});
// Query data (async)
db.queryFirstAsync("SELECT * FROM users WHERE uuid = ?", playerUUID.toString())
.thenAccept(user -> {
if (user != null) {
int coins = (int) user.get("coins");
// Use the data
}
});// Global database - shared across all worlds (economy, player stats)
Database global = api.getGlobalDatabase("economy");
// Per-world database - isolated per world (claims, regions)
Database world = api.getWorldDatabase(world, "claims");Perfect for plugins that need:
HyDB/
├── global/ # Global databases
│ ├── economy.db # Economy plugin
│ ├── stats.db # Stats plugin
│ └── yourplugin.db # Your plugin
└── worlds/ # Per-world databases
├── world1/
│ └── claims.db
└── world2/
└── claims.dbEach plugin gets its own database file containing multiple tables, providing:
Included files:
✅ Install once, benefits all plugins ✅ Centralized database management ✅ In-game debugging commands ✅ Better server performance (shared connection pooling)
✅ No database management code needed ✅ Simple, intuitive API ✅ Async operations prevent lag ✅ Well-documented with examples ✅ Schema migration support
| Feature | HyDB | JSON Files | Custom DB Code |
|---|---|---|---|
| Easy to Use | ✅ Simple API | ✅ Very Simple | ❌ Complex |
| Performance | ✅ Fast | ❌ Slow | ✅ Fast |
| Queries | ✅ SQL | ❌ Limited | ✅ SQL |
| Thread-Safe | ✅ Yes | ❌ No | ⚠️ Depends |
| Async | ✅ Built-in | ❌ Manual | ⚠️ Manual |
| Migrations | ✅ Built-in | ❌ Manual | ⚠️ Manual |
| Transactions | ✅ Built-in | ❌ No | ✅ Yes |
The download includes a complete example plugin showing:
Open source - free to use for Hytale servers and plugin development.
/hydb commands for debugging and monitoringVersion: 1.0.0 Compatibility: Hytale (current version) Mod Author: Oceride
Making data persistence simple and powerful for Hytale plugins! This is a required dependency / backend database mod.
Image Generated by GPT-4
Track and locate other players on your compass and map with customizable settings!
Track and locate other players on your compass and map with customizable settings!