{"url":"https://levimc.org/mods/github.com/killcerr/rocksdb-storage/","id":"github.com/killcerr/rocksdb-storage","name":"rocksdb-storage","description":"RocksDB-backed world storage for Bedrock Dedicated Server: hooks leveldb::DB::Open, migrates an existing LevelDB world once and leaves the original db directory in place.","owner":"killcerr","logo":"https://levimc.org/mods/icons/5529a2ddb094a7e3-288.webp","repository":"https://github.com/killcerr/rocksdb-storage","issues":"https://github.com/killcerr/rocksdb-storage/issues","releases":"https://github.com/killcerr/rocksdb-storage/releases","stars":1,"downloads":9,"updated":"2026-10-14T03:55:38Z","published":"2026-10-14T03:55:38Z","created":"2026-10-13T12:04:59Z","license":"GPL-3.0","side":["server"],"platform":["win-x64"],"gameVersions":["1.26.60","1.26.51"],"tags":["platform:levilamina","type:mod"],"latest":{"variant":"","version":"0.0.1","install":"lip install github.com/killcerr/rocksdb-storage@0.0.1"},"readmes":[{"file":"README.md","lang":"en","text":"# rocksdb-storage\n\nA [LeviLamina](https://lamina.levimc.org/) mod that moves a Bedrock Dedicated Server world off\nLevelDB and onto [RocksDB](https://rocksdb.org/). The existing world data is left untouched.\n\nEnglish | [中文](README.zh-CN.md)\n\n---\n\n## What it is\n\nBDS stores its world with an old LevelDB engine. With this mod installed, the server reads and writes\nworld data through RocksDB instead — an actively developed key-value store with more tuning options.\nWorlds that already exist are migrated automatically, and the original directory is kept as is: nothing\nis deleted or renamed.\n\n## Install\n\n1. The server needs LeviLamina 26.51.7 or newer and BDS 1.26.51.1 (back up first if you run anything else).\n2. From the server root, install it with [lip](https://lip.levimc.org/):\n\n   ```bash\n   lip install github.com/killcerr/rocksdb-storage\n   ```\n\n   Add `@version` to pin one, e.g. `lip install github.com/killcerr/rocksdb-storage@0.0.0`.\n3. Restart the server.\n\nThis line in the log means it is in effect:\n\n```\n[rocksdb-storage] rocksdb-storage: opened rocksdb database at worlds/Bedrock level\\rocksdb\n```\n\n## What happens on the first start\n\nIf the world directory still holds a LevelDB database (the `db` folder), the mod copies it into a\nsibling `rocksdb` folder on the first start and reports progress in the log:\n\n```\nrocksdb-storage: migrating worlds/Bedrock level/db into worlds/Bedrock level\\rocksdb\nrocksdb-storage: migrated worlds/Bedrock level/db into worlds/Bedrock level\\rocksdb (keys=..., 3.2s), leveldb database kept at worlds/Bedrock level/db\n```\n\nDo not kill the server while this runs; should it be interrupted, the next start simply migrates again,\nbecause the original `db` is never modified.\n\nOnce migrated:\n\n```\nworlds/Bedrock level/\n├── db/        the old database, untouched\n├── rocksdb/   what the server actually uses\n└── level.dat\n```\n\n## Configuration\n\n`plugins/rocksdb-storage/config/config.json` (a restart applies changes):\n\n```json\n{\n    \"version\": 1,\n    \"enabled\": true,\n    \"migrateExisting\": true\n}\n```\n\n| Key | Default | Meaning |\n| --- | --- | --- |\n| `enabled` | `true` | When `false`, worlds are opened with the original LevelDB again. |\n| `migrateExisting` | `true` | When `false`, an existing world is opened as it is instead of being migrated. |\n\n## Things to know\n\n- **There is no migration back.** After the first start, `db` is a snapshot of the moment the world was\n  migrated. Removing the mod, or deleting the `rocksdb` folder, makes the server fall back to that\n  snapshot — the world looks reverted, so keep `rocksdb` to keep your progress.\n- **Compression is off** for now, so `rocksdb` takes up somewhat more space than `db`.\n- Servers that enable the non-default database file encryption are not supported.\n- Only BDS 1.26.51.1 with LeviLamina 26.51.7 has been verified. On other versions the mod stays out of\n  the way and does not touch your data.\n- Server-side only; there is nothing to install on clients.\n- Development stage, version `0.0.0`.\n\n## Build from source\n\nRequires xmake and clang-cl:\n\n```bash\nxmake f -y -p windows -a x64 -m release\nxmake\n```\n\nThe result is in `bin/rocksdb-storage/`; copy that folder into the mods directory. The first build\ndownloads and compiles the dependencies, including rocksdb, which takes a few minutes.\n\n## License\n\nGPL-3.0-or-later — see [LICENSE](LICENSE). Third-party code:\n\n- `src/leveldb/`, `src/db/`, `src/util/` are taken from\n  [mojang/leveldb](https://github.com/mojang/leveldb) (`origin/main`), BSD-3-Clause © The LevelDB\n  Authors; its `LICENSE` and `AUTHORS` ship next to the vendored sources, and every file keeps its\n  original notice;\n- RocksDB is used under Apache-2.0 and statically linked into the build output (xmake package); the\n  license texts live in [`licenses/rocksdb/`](licenses/rocksdb) and are included in the release zip.\n"},{"file":"README.zh-CN.md","lang":"zh-Hans","text":"# rocksdb-storage\n\n把 Bedrock 专用服务器的世界存档从 LevelDB 换成 [RocksDB](https://rocksdb.org/) 的\n[LeviLamina](https://lamina.levimc.org/) 模组。原存档不会被改动。\n\n[English](README.md) | 中文\n\n---\n\n## 这是什么\n\nBDS 一直用一个老式的 LevelDB 来存世界存档。装上这个模组后，服务器读写存档都会经过\nRocksDB——一个更活跃、可调优的键值存储引擎。装之前就已经存在的存档会被自动迁移，\n原目录原样保留，不会删除或改名。\n\n## 安装\n\n1. 服务器需要 LeviLamina 26.51.7 或更高版本，BDS 1.26.51.1（其他版本请先备份再用）。\n2. 在服务器根目录用 [lip](https://lip.levimc.org/) 安装：\n\n   ```bash\n   lip install github.com/killcerr/rocksdb-storage\n   ```\n\n   需要指定版本时加 `@版本号`，例如 `lip install github.com/killcerr/rocksdb-storage@0.0.0`。\n3. 重启服务器。\n\n启动日志里出现下面这行就说明生效了：\n\n```\n[rocksdb-storage] rocksdb-storage: opened rocksdb database at worlds/Bedrock level\\rocksdb\n```\n\n## 第一次启动会发生什么\n\n如果世界目录里已经有一份旧的 LevelDB 存档（`db` 文件夹），模组会在第一次启动时把它\n复制到同级的 `rocksdb` 文件夹，日志里能看到进度：\n\n```\nrocksdb-storage: migrating worlds/Bedrock level/db into worlds/Bedrock level\\rocksdb\nrocksdb-storage: migrated worlds/Bedrock level/db into worlds/Bedrock level\\rocksdb (keys=..., 3.2s), leveldb database kept at worlds/Bedrock level/db\n```\n\n迁移期间不要强杀服务器；万一中断，下次启动会重新来一次，因为原始 `db` 从头到尾没有被改动。\n\n迁移完成后：\n\n```\nworlds/Bedrock level/\n├── db/        旧存档，保持原样\n├── rocksdb/   服务器实际使用的存档\n└── level.dat\n```\n\n## 配置\n\n`plugins/rocksdb-storage/config/config.json`（改完需要重启）：\n\n```json\n{\n    \"version\": 1,\n    \"enabled\": true,\n    \"migrateExisting\": true\n}\n```\n\n| 键 | 默认 | 说明 |\n| --- | --- | --- |\n| `enabled` | `true` | 关掉后世界会用原来的 LevelDB 打开。 |\n| `migrateExisting` | `true` | 设为 `false` 时不迁移旧存档，直接按原样打开它。 |\n\n## 注意事项\n\n- **没有反向迁移。** 迁移之后 `db` 里就是迁移那一刻的旧快照。移除模组或删掉 `rocksdb` 文件夹，\n  服务器只会看到那份旧快照（世界看起来回退了），所以想保留新进度就别动 `rocksdb`。\n- 目前**未启用压缩**，`rocksdb` 占用会比 `db` 大一些。\n- 如果服务器开了非默认的数据库文件加密，本模组不适用。\n- 只在 BDS 1.26.51.1 + LeviLamina 26.51.7 上验证过；换成别的版本，模组不会生效，也不会破坏数据。\n- 客户端不支持（这是服务器端模组）。\n- 目前是开发阶段，版本 `0.0.0`。\n\n## 从源码构建\n\n需要 xmake 和 clang-cl：\n\n```bash\nxmake f -y -p windows -a x64 -m release\nxmake\n```\n\n产物在 `bin/rocksdb-storage/`，把它整个拷到 mods 目录即可。第一次构建会下载并编译依赖\n（包括 rocksdb），需要几分钟。\n\n## 许可\n\n本项目采用 GPL-3.0-or-later（见 [LICENSE](LICENSE)）。第三方代码：\n\n- `src/leveldb/`、`src/db/`、`src/util/` 取自 [mojang/leveldb](https://github.com/mojang/leveldb)\n  （`origin/main`），BSD-3-Clause © The LevelDB Authors，随源码保留其 `LICENSE`/`AUTHORS`，各文件头也\n  保留原声明；\n- RocksDB 按 Apache-2.0 使用并静态链接进产物（xmake 包），许可文本见\n  [`licenses/rocksdb/`](licenses/rocksdb)，发布包（zip）里也会带上。\n"}],"gallery":[],"versions":[{"version":"0.0.1","prerelease":false,"released":"2026-10-14T03:55:38Z","releaseUrl":"https://github.com/killcerr/rocksdb-storage/releases/tag/v0.0.1","manifestUrl":"https://github.com/killcerr/rocksdb-storage/blob/v0.0.1/tooth.json","info":{"name":"rocksdb-storage","description":"RocksDB-backed world storage for Bedrock Dedicated Server: hooks leveldb::DB::Open, migrates an existing LevelDB world once and leaves the original db directory in place.","tags":["platform:levilamina","type:mod"]},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":">=26.51.7"}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}