{"article":{"slug":"walking-across-my-minecraft-backups-with-plakar","title":"Walking across my Minecraft backups with Plakar","subtitle":null,"summary":"Gilles Chehade had an AI write a Plakar integration that backs up running Minecraft servers by pausing world saves over RCON during the backup, so players can keep playing.","content_type":"blog_post","language":"en","canonical_url":"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/","author":{"name":"Gilles Chehade","url":null,"person_slug":null,"person_url":null},"authored_by":"human","publisher":{"name":"poolp.org","url":"https://poolp.org/","listing_slug":null,"listing":null},"topics":[{"name":"open-source","slug":"open-source","url":"https://listedarticles.com/topics/open-source"},{"name":"devops","slug":"devops","url":"https://listedarticles.com/topics/devops"},{"name":"ai","slug":"ai","url":"https://listedarticles.com/topics/ai"},{"name":"software-engineering","slug":"software-engineering","url":"https://listedarticles.com/topics/software-engineering"}],"about_listings":[],"cover_image_url":null,"license":"all-rights-reserved","word_count":2945,"reading_minutes":13,"published_at":"2026-11-14T00:00:00.000Z","added_at":"2026-11-15T01:49:10.654Z","updated_at":"2026-11-15T01:49:10.654Z","added_via":"api","contributor":{"type":"agent","name":"ListedStartups Using Bot","registered":true},"profile_url":"https://listedarticles.com/articles/walking-across-my-minecraft-backups-with-plakar","markdown_url":"https://listedarticles.com/articles/walking-across-my-minecraft-backups-with-plakar.md","example":false,"citation":"Gilles Chehade, poolp.org. \"Walking across my Minecraft backups with Plakar.\" 14 Nov 2026. https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ (all-rights-reserved)","access":{"human_view":"preview","full_text_available":true,"source_url":"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/"},"body_markdown":"# Walking across my Minecraft backups with Plakar\n\n14 November 2026·2824 words·14 mins·\n\n[Technology](https://poolp.org/categories/technology/)[Plakar](https://poolp.org/tags/plakar/)[Minecraft](https://poolp.org/tags/minecraft/)[Backups](https://poolp.org/tags/backups/)\n\n> **TL;DR:**\n> I had an AI write a plakar integration to back up Minecraft servers without stopping them,\n> it pauses world saves over RCON while the backup runs and lets players keep digging.\n\n## First, what’s plakar ? [#](#first-whats-plakar-)\n\nFor those who haven’t followed, [plakar](https://plakar.io) is an open-source backup solution that I started in 2015, free to use, ISC-licensed, written in Go and built on top of kloset, a content-addressed storage engine that deduplicates, compresses and encrypts everything it stores and keeps snapshots immutable.\nIt backs up from a lot of sources, stores on a lot of storages, and restores to a lot of destinations: a filesystem, an S3 bucket, an SFTP server and many more…\nThese sources and destinations are not baked into plakar: they’re connectors, packaged as integrations that anyone can write and install.\n\nDon’t forget to [star the project on Github](https://github.com/PlakarKorp/plakar) and [join the Plakar discord](https://discord.com/invite/uuegtnF2Q5).\n\n## What’s this article about ? [#](#whats-this-article-about-)\n\nFor the last few years,\nI’ve been claiming that Plakar was designed with a goal to backup anything…\nbut a claim is only a claim if it’s not backed up (pun intended) by facts.\nWe have written 45 connectors so far but pretty much none of them are targeting general consumer products and tools,\nso… every now and then I’ll pick a random project, have an AI generate a fully-working connector for it, and make it available to the plakar community.\n\nI’ll use an AI because this is what most people will do and I really want to show that there’s no excuse not to protect your data,\nwhatever it is,\neven if you’re not a programmer.\nI hope this will inspire people to write new connectors and share them with the community.\n\nOh and one more note, this is not company endorsed and not done on my work time,\nI’m doing this on my spare time and distributing them on my personal Github account,\njust like any open-source contributor.\n\n![](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/backup-the-planet_hu_f0941b59a3ff03bc.png)\n\nFirst one up: Minecraft.\n\n## Why Minecraft needs care [#](#why-minecraft-needs-care)\n\nA Minecraft server looks like the easiest thing in the world to back up:\nit’s a directory, you copy it, done. Nope.\nA running server rewrites its region files all the time,\nand a copy taken while it does is a world made of chunks from different moments… which may or may not load the day you need it, and you’ll only find out then.\n\nThe usual answers are to stop the server for the backup, which nobody enjoys when there are people playing, or to wrap `rsync` in a shell script that pokes the console and hopes for the best.\nWhile looking for existing solutions people implemented I found a fair share of those scripts and well…\nit’s very often a leap of faith.\n\nplakar already knows how to back up a directory, deduplicate it, encrypt it and push it wherever you want, so the missing piece was small: tell the server to hold still, back up, let it go.\n\n## Here’s the prompt that was used [#](#heres-the-prompt-that-was-used)\n\nNothing hidden, this is the prompt that produced the integration with Claude Opus 5.5:\n\n```\nImplement a fully working minecraft server integration for Plakar,\ninspiring yourself from other integrations in PlakarKorp/integrations.\n\nIt needs to provide fully working and consistent backup and restore.\n\nIt needs to be tested on a real implementation with a roundtrip:\nback up worlds, restore them to a new instance, ensure they are identical.\n\nWrite full test coverage validating behavior not code.\n```\n\nThis is under-specified of course, but with our straight-forward SDK and other examples, it’s enough to get going.\n\n## How does it work ? [#](#how-does-it-work-)\n\nEvery Minecraft server ships with RCON, a remote console that accepts the same commands an operator would type, so there is no need to be clever. The importer connects to it and wraps the backup with four steps:\n\n1. `save-off`: autosave stops and the region files stop changing\n2. `save-all flush`: everything loaded in memory is written to disk\n3. the directory is backed up like any other\n4. `save-on`: autosave resumes once the last file has been read\n\nPlayers keep playing throughout, whatever they do during the backup stays in memory until autosave resumes and lands on disk as usual. A stopped server doesn’t need any of this and is backed up as is.\n\nThe importer and exporter are really the `fs` connectors with the server-side care added on top, which means excludes, permissions, ownership and times behave exactly like a regular filesystem backup. It also means the whole server directory goes in, not just the world: `server.properties`, whitelist and bans, plugins or mods and their configuration, everything you’d need to bring the server back up elsewhere.\n\n## Installing [#](#installing)\n\nThe package is built and available in the devel channel, so installing it is a one-liner:\n\n```\n$ plakar pkg add -devel minecraft\n```\n\nIf you’d rather build it yourself, the code lives on the `integration/minecraft` branch of [poolpOrg/plakar-integrations](https://github.com/poolpOrg/plakar-integrations) and `make install` packages it and installs it in your local plakar:\n\n```\n$ git clone -b integration/minecraft https://github.com/poolpOrg/plakar-integrations\n$ cd plakar-integrations/minecraft\n$ make install\n```\n\n## Enabling RCON [#](#enabling-rcon)\n\nIf RCON isn’t enabled already, it’s three lines in `server.properties` and a restart of the server:\n\n```\nenable-rcon=true\nrcon.port=25575\nrcon.password=choose-one\n```\n\nThe integration reads these settings from the server directory so there’s nothing to configure on the plakar side.\nKeep in mind that the console speaks plaintext, so keep the port on localhost or on a private network and not on the internet (please !).\n\nWithout RCON, a stopped server still backs up fine, but a running one is refused rather than copied inconsistently. I’d rather have a backup fail loudly tonight than have a restore fail silently in three months.\n\n## Backing up [#](#backing-up)\n\nAssuming a repository was created with `plakar at /var/backups/minecraft create`, backing up the server is just:\n\n```\n$ plakar at /var/backups/minecraft backup minecraft:///srv/minecraft\n```\n\nLogs are rarely worth keeping, so they can be left out:\n\n```\n$ plakar at /var/backups/minecraft backup -exclude 'logs/**' \\\n  minecraft:///srv/minecraft\n```\n\nand since nobody gets kicked out, there’s no reason not to run it from cron every night, with a tag to find them easily later on:\n\n```\n0 4 * * * plakar at /var/backups/minecraft backup -tag nightly \\\n          minecraft:///srv/minecraft\n```\n\nThis is where plakar makes a real difference compared to a tarball a night. From one night to the next most of a world doesn’t change, players hang around their bases and the rest of the map just sits there, and since plakar splits files into content-defined chunks and stores each chunk once, a region file that barely changed only costs the bytes that did. Keeping months of nightly snapshots is cheap, and each one of them is a complete server you can browse, diff or restore.\n\nHere’s a nice screenshot of a world at the time of a backup:\n\n![Screenshot of a world prior to backup](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/worldA-center_hu_e0a319e2a07445ca.png)\n\nHere’s how it appears after three backups in plakar:\n\n![UI](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-dashboard_hu_8c82c86f4ef0eb3e.png)\n\nAnd picking into server directory, world folder and region files:\n\n![server folder](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-browse-server_hu_c5cead9a46a47420.png)![world folder](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-browse-world_hu_fc7e5bfa93ed5f0e.png)![regions folder](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-browse-regions_hu_8a30698d7eb84026.png)\n\nWith a preview of the EULA and properties:\n\n![eula](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-preview-eula_hu_6f794ed607497cf1.png)![alt text](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-preview-properties_hu_58ff1d6e109c1b5b.png)\n\n## Restoring [#](#restoring)\n\nRestores refuse to write into a directory where a server is running, because writing region files under a live server is the fastest way to corrupt a world. Stop it first.\n\nRestoring the whole server where it was:\n\n```\n$ plakar at /var/backups/minecraft restore -to minecraft:///srv/minecraft \\\n  <snapid>:/srv/minecraft/\n```\n\nSomeone blew up spawn last night but the rest is fine ? Restore only the overworld:\n\n```\n$ plakar at /var/backups/minecraft restore -to minecraft:///srv/minecraft \\\n  <snapid>:/srv/minecraft/world\n```\n\nAnd moving the server to another machine is the same command, pointed at wherever the repository lives:\n\n```\n$ plakar at s3://backups/minecraft restore -to minecraft:///srv/minecraft \\\n  <snapid>:/srv/minecraft/\n```\n\nSo you can technically use `plakar` as a minecraft server migration tool :-)\n\nThere’s an `allow_running` option on the exporter to restore files the server doesn’t hold open, a plugin configuration for example, without stopping it.\nIt’s there for that and nothing else, don’t come complaining if you use it on a world and hell breaks loose.\n\nHere’s a screenshot of a world after restore, identical to the previous one:\n\n![Screenshot of a restored world](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/worldA-restored-center_hu_ab45b7dfebfa96f.png)\n\n## A few knobs [#](#a-few-knobs)\n\nMost setups won’t need any of these, but on the importer `quiesce` (on by default) can be turned off to copy the directory as is whatever the server is doing, `rcon` sets the console address if it’s not the one from `server.properties`, `timeout` (5 minutes by default) is the time allowed for each console exchange because `save-all flush` on a large world takes a while, and `dont_traverse_fs` keeps it from following mount points under the directory.\n\nThe exporter has `allow_running`, `rcon` and `timeout` (30 seconds there), plus the usual `skip_ownership`, `skip_permissions` and `skip_times` from `fs`.\n\nAs usual,\ndon’t use an option if you don’t know that you need it,\nthe defaults should be fine for most.\n\n## Things you should know [#](#things-you-should-know)\n\nIf plakar is killed between `save-off` and `save-on`, saving stays off until someone runs `save-on` on the console. A cancelled backup turns it back on by itself, a crash cannot… so if your backups run unattended, it’s worth keeping an eye on.\n\nA server in a container on Docker Desktop holds its world locks inside the Docker VM where the host can’t see them, so there the connectors only know the server is up through the console. Keep RCON enabled and published.\n\nFinally, worlds on a Bukkit, Spigot or Paper server are three directories, `world`, `world_nether` and `world_the_end`, and they should be restored together unless you enjoy Nether portals leading nowhere.\n\nAll of this was tested with vanilla 26.3 in the `itzg/minecraft-server` image: a backup of the live server with saves paused, a restore refused while it ran, then a restore of the snapshot into a new directory and a server booted from it with the same seed and the same world \\o/\n\n## WAIT ! WHAT ABOUT USING MINECRAFT AS A STORE ? [#](#wait--what-about-using-minecraft-as-a-store-)\n\nIf you’ve followed me for a while, you know that I like stupid :-)\n\nTechnically, nothing prevents us from using a minecraft server as a store for backups and encode the data as blocks to be turned into a walkable landscape.\n\nIs it useful ? nopes.\nShall we do it ? yes, we MUST.\n\nI present to you the stupidest idea of this week-end: **backups as a world**.\n\n## The world is the store [#](#the-world-is-the-store)\n\nBacking up a Minecraft server is the sensible half of this integration.\nThe other half is half a joke, half a technical demonstration: if plakar can back up a world, could a world be the thing plakar backs up *to* ?\nNot a folder on the server, the world itself. Blocks.\n\nIt turns out the storage contract makes that easier than it sounds.\nA kloset store has to do very little: hold packfiles and states, give them back by content address, serve a byte range out of a packfile, list what it has, delete what it is told to. It does not care what the bytes are stored *as*. The fs store writes files, the S3 store writes objects, and nothing in kloset would notice if a store wrote terrain. So the problem is not plumbing, it is a codec to translate our bytes back and forth to something sensible.\n\n### Two bytes per column [#](#two-bytes-per-column)\n\nEvery column of a Minecraft world, every x and z, carries two bytes. The low nibble of the first byte is a height: that many blocks of stone above a base at y=64. On top of the stone sit three blocks, a stained glass, a terracotta and a concrete, and each comes in sixteen colours, so the remaining three nibbles are colours. A chunk is 256 columns, so it holds 512 bytes. A region file is 32 by 32 chunks, and chunk (0,0) of every region is a header that says which packfile or state this is, how long it is and where this region sits in it, encoded as terrain like everything else. The remaining 1023 chunks hold 511 KiB of payload.\n\nA packfile is placed by hashing its address into region coordinates, so there is no catalog to keep in sync: listing the store is a scan of the region files and a read of each header chunk. Locks and the kloset configuration are plain files next to the world, because they change, and terrain is not meant to.\n\n![Eight regions of the store from above](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/worldB-store_hu_fdc53185e795c125.png)\n\nThat is eight region files of my plakar checkout, seen from above at one pixel per block.\nSince plakar compresses and encrypts data before storing, this makes a surface that looks like noise, which is correct. The white squares in the corners are the header chunks: the padding after a header is zeros, and a zero column is white glass, white terracotta and white concrete on no stone at all.\n\n![The same terrain, up close](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/worldB-iso_hu_39bcb097287b6691.png)\n\nUp close it is a field of pillars, each one a column of stone with three coloured blocks on top. This is what a player walks across (or at least tries to walk across :p). The heights are a nibble so the hills stay walkable, and nothing in the palette falls, burns, flows, spreads or gets picked up by an enderman, because the server will keep running on this world and the bytes have to survive it.\n\n### Why not a solid cube [#](#why-not-a-solid-cube)\n\nThe dense version of this is obvious: 256 block types, one byte per block, 96 MiB per region, and we’re done.\nIt would also be a solid cube of static nobody can walk on, and walking on your backups is the whole point otherwise… it’s boring and no fun.\nTerrain costs density,\ntwo bytes per column instead of one per block,\nand the region files on disk come out at roughly ten times the kloset.\nWe’re not building something serious here so it’s fine, I’ll trade space for lulz.\n\nThe more interesting constraint is that a running server does not leave region files alone. It relights chunks it loads, it rewrites them on save, and when you upgrade the server it runs every chunk through its data fixers. So the codec cannot depend on how a chunk is laid out on disk, only on which block is where.\n\n### Read-only, in the Minecraft sense [#](#read-only-in-the-minecraft-sense)\n\nPlayers cannot be allowed to change a byte, otherwise they break the store.\nThat is three layers:\n\n- The server runs in forced adventure mode, where blocks cannot be broken or placed.\n- The gamerules the store writes into `level.dat` stop random ticks, fire, weather, mob spawning and mob griefing, so nothing grows, melts, burns or wanders off with a block.\n- And the palette is inert on its own.\n\nIf something gets through anyway, kloset verifies every read against its address, so a creeper that edits a packfile produces an error, not a quietly wrong restore.\n\n### Does it actually work [#](#does-it-actually-work)\n\n```\n$ plakar at minecraft:///srv/minecraft create\n$ plakar at minecraft:///srv/minecraft backup ./plakar\n$ plakar at minecraft:///srv/minecraft backup ./plakar\n$ plakar at minecraft:///srv/minecraft backup ./plakar\n$ plakar at minecraft:///srv/minecraft ls\n2026-11-14T21:57:05Z   b81e9a60   106 MiB        0s /Users/gilles/Wip/github.com/PlakarKorp/plakar\n2026-11-14T21:57:03Z   703d4848   106 MiB        1s /Users/gilles/Wip/github.com/PlakarKorp/plakar\n2026-11-14T21:56:15Z   881849ce   106 MiB        1s /Users/gilles/Wip/github.com/PlakarKorp/plakar\n\n$ plakar at minecraft:///srv/minecraft cat b81e9a60:/Users/gilles/Wip/github.com/PlakarKorp/plakar/README.md\n<div align=\"center\">\n\n<img src=\"./docs/banner.png\" alt=\"Plakar: open source backup engine\" />\n\n# Plakar: open source backup engine\n\n**Encrypted, deduplicated, verifiable, and scalable.**\n\nBack up anything, store anywhere, restore everywhere, with zero-trust encryption and no vendor lock-in.\n...\n## What is Plakar?\n\nPlakar is an open-source backup solution powered by Kloset and ptar. It creates snapshots of your data, stores them in an encrypted and deduplicated store, and lets you inspect, verify, and restore them later.\n```\n\nIt does. Three backups of the checkout went in, deduplicated as usual, and `ls` and `cat` came back out working just like they would on a filesystem or an S3 store.\n\nMore interestingly, I launched the UI on the minecraft server store:\n\n```\n$ plakar at minecraft:///srv/minecraft ui\n```\n\nand you can browse the snapshots and preview files:\n\n![The UI on a kloset that is a Minecraft world](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-minecraft-store_hu_f9a15e05de76e68d.png)![preview source](https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-minecraft-preview-source_hu_29e729d4b08ead0d.png)\n\n### What this is for [#](#what-this-is-for)\n\nNothing, mostly. It is a toy, and I am fond of it. But it is an honest toy: it exists because the store contract is narrow enough that anything which can hold bytes and hand them back by offset can be a kloset, and the integrity checks are strong enough that a store you do not trust, like a world full of players, is still safe to restore from. Those are the properties that make plakar work on the stores that matter. This one just happens to have hills.\n\nDo backup your minecraft servers, and do restore them.\n\n**DON’T store your backups on a minecraft server as world, really, DON’T :-)**\n\n## What’s next ? [#](#whats-next-)\n\nIt’s in the devel channel for now, so give it a try and tell me what breaks, issues and pull requests go to the `integration/minecraft` branch of [poolpOrg/plakar-integrations](https://github.com/poolpOrg/plakar-integrations).\n\nAs for the series, I’ll keep picking random projects and generating connectors for them every now and then. If there’s something you value and would like to see backed up, tell me… or better, grab the SDK and the docs and beat me to it: I’ll make sure the authors of the funniest integrations get their goodies :-)\n\nStay tuned !\n\nI take short consulting engagements — architecture review, technical due\ndiligence, mail infrastructure — through\n[aljuna.tech](https://aljuna.tech).\n","body_html":"<h1 id=\"walking-across-my-minecraft-backups-with-plakar\">Walking across my Minecraft backups with Plakar</h1>\n<p>14 November 2026·2824 words·14 mins·</p>\n<p><a href=\"https://poolp.org/categories/technology/\" rel=\"nofollow ugc noopener\">Technology</a><a href=\"https://poolp.org/tags/plakar/\" rel=\"nofollow ugc noopener\">Plakar</a><a href=\"https://poolp.org/tags/minecraft/\" rel=\"nofollow ugc noopener\">Minecraft</a><a href=\"https://poolp.org/tags/backups/\" rel=\"nofollow ugc noopener\">Backups</a></p>\n<blockquote><p><strong>TL;DR:</strong>\nI had an AI write a plakar integration to back up Minecraft servers without stopping them,\nit pauses world saves over RCON while the backup runs and lets players keep digging.</p></blockquote>\n<h2 id=\"first-what-s-plakar\">First, what’s plakar ? <a href=\"#first-whats-plakar-\">#</a></h2>\n<p>For those who haven’t followed, <a href=\"https://plakar.io\" rel=\"nofollow ugc noopener\">plakar</a> is an open-source backup solution that I started in 2015, free to use, ISC-licensed, written in Go and built on top of kloset, a content-addressed storage engine that deduplicates, compresses and encrypts everything it stores and keeps snapshots immutable.\nIt backs up from a lot of sources, stores on a lot of storages, and restores to a lot of destinations: a filesystem, an S3 bucket, an SFTP server and many more…\nThese sources and destinations are not baked into plakar: they’re connectors, packaged as integrations that anyone can write and install.</p>\n<p>Don’t forget to <a href=\"https://github.com/PlakarKorp/plakar\" rel=\"nofollow ugc noopener\">star the project on Github</a> and <a href=\"https://discord.com/invite/uuegtnF2Q5\" rel=\"nofollow ugc noopener\">join the Plakar discord</a>.</p>\n<h2 id=\"what-s-this-article-about\">What’s this article about ? <a href=\"#whats-this-article-about-\">#</a></h2>\n<p>For the last few years,\nI’ve been claiming that Plakar was designed with a goal to backup anything…\nbut a claim is only a claim if it’s not backed up (pun intended) by facts.\nWe have written 45 connectors so far but pretty much none of them are targeting general consumer products and tools,\nso… every now and then I’ll pick a random project, have an AI generate a fully-working connector for it, and make it available to the plakar community.</p>\n<p>I’ll use an AI because this is what most people will do and I really want to show that there’s no excuse not to protect your data,\nwhatever it is,\neven if you’re not a programmer.\nI hope this will inspire people to write new connectors and share them with the community.</p>\n<p>Oh and one more note, this is not company endorsed and not done on my work time,\nI’m doing this on my spare time and distributing them on my personal Github account,\njust like any open-source contributor.</p>\n<figure><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/backup-the-planet_hu_f0941b59a3ff03bc.png\" alt=\"\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>First one up: Minecraft.</p>\n<h2 id=\"why-minecraft-needs-care\">Why Minecraft needs care <a href=\"#why-minecraft-needs-care\">#</a></h2>\n<p>A Minecraft server looks like the easiest thing in the world to back up:\nit’s a directory, you copy it, done. Nope.\nA running server rewrites its region files all the time,\nand a copy taken while it does is a world made of chunks from different moments… which may or may not load the day you need it, and you’ll only find out then.</p>\n<p>The usual answers are to stop the server for the backup, which nobody enjoys when there are people playing, or to wrap <code>rsync</code> in a shell script that pokes the console and hopes for the best.\nWhile looking for existing solutions people implemented I found a fair share of those scripts and well…\nit’s very often a leap of faith.</p>\n<p>plakar already knows how to back up a directory, deduplicate it, encrypt it and push it wherever you want, so the missing piece was small: tell the server to hold still, back up, let it go.</p>\n<h2 id=\"here-s-the-prompt-that-was-used\">Here’s the prompt that was used <a href=\"#heres-the-prompt-that-was-used\">#</a></h2>\n<p>Nothing hidden, this is the prompt that produced the integration with Claude Opus 5.5:</p>\n<pre><code>Implement a fully working minecraft server integration for Plakar,\ninspiring yourself from other integrations in PlakarKorp/integrations.\n\nIt needs to provide fully working and consistent backup and restore.\n\nIt needs to be tested on a real implementation with a roundtrip:\nback up worlds, restore them to a new instance, ensure they are identical.\n\nWrite full test coverage validating behavior not code.</code></pre>\n<p>This is under-specified of course, but with our straight-forward SDK and other examples, it’s enough to get going.</p>\n<h2 id=\"how-does-it-work\">How does it work ? <a href=\"#how-does-it-work-\">#</a></h2>\n<p>Every Minecraft server ships with RCON, a remote console that accepts the same commands an operator would type, so there is no need to be clever. The importer connects to it and wraps the backup with four steps:</p>\n<ol><li><code>save-off</code>: autosave stops and the region files stop changing</li><li><code>save-all flush</code>: everything loaded in memory is written to disk</li><li>the directory is backed up like any other</li><li><code>save-on</code>: autosave resumes once the last file has been read</li></ol>\n<p>Players keep playing throughout, whatever they do during the backup stays in memory until autosave resumes and lands on disk as usual. A stopped server doesn’t need any of this and is backed up as is.</p>\n<p>The importer and exporter are really the <code>fs</code> connectors with the server-side care added on top, which means excludes, permissions, ownership and times behave exactly like a regular filesystem backup. It also means the whole server directory goes in, not just the world: <code>server.properties</code>, whitelist and bans, plugins or mods and their configuration, everything you’d need to bring the server back up elsewhere.</p>\n<h2 id=\"installing\">Installing <a href=\"#installing\">#</a></h2>\n<p>The package is built and available in the devel channel, so installing it is a one-liner:</p>\n<pre><code>$ plakar pkg add -devel minecraft</code></pre>\n<p>If you’d rather build it yourself, the code lives on the <code>integration/minecraft</code> branch of <a href=\"https://github.com/poolpOrg/plakar-integrations\" rel=\"nofollow ugc noopener\">poolpOrg/plakar-integrations</a> and <code>make install</code> packages it and installs it in your local plakar:</p>\n<pre><code>$ git clone -b integration/minecraft https://github.com/poolpOrg/plakar-integrations\n$ cd plakar-integrations/minecraft\n$ make install</code></pre>\n<h2 id=\"enabling-rcon\">Enabling RCON <a href=\"#enabling-rcon\">#</a></h2>\n<p>If RCON isn’t enabled already, it’s three lines in <code>server.properties</code> and a restart of the server:</p>\n<pre><code>enable-rcon=true\nrcon.port=25575\nrcon.password=choose-one</code></pre>\n<p>The integration reads these settings from the server directory so there’s nothing to configure on the plakar side.\nKeep in mind that the console speaks plaintext, so keep the port on localhost or on a private network and not on the internet (please !).</p>\n<p>Without RCON, a stopped server still backs up fine, but a running one is refused rather than copied inconsistently. I’d rather have a backup fail loudly tonight than have a restore fail silently in three months.</p>\n<h2 id=\"backing-up\">Backing up <a href=\"#backing-up\">#</a></h2>\n<p>Assuming a repository was created with <code>plakar at /var/backups/minecraft create</code>, backing up the server is just:</p>\n<pre><code>$ plakar at /var/backups/minecraft backup minecraft:///srv/minecraft</code></pre>\n<p>Logs are rarely worth keeping, so they can be left out:</p>\n<pre><code>$ plakar at /var/backups/minecraft backup -exclude &#39;logs/**&#39; \\\n  minecraft:///srv/minecraft</code></pre>\n<p>and since nobody gets kicked out, there’s no reason not to run it from cron every night, with a tag to find them easily later on:</p>\n<pre><code>0 4 * * * plakar at /var/backups/minecraft backup -tag nightly \\\n          minecraft:///srv/minecraft</code></pre>\n<p>This is where plakar makes a real difference compared to a tarball a night. From one night to the next most of a world doesn’t change, players hang around their bases and the rest of the map just sits there, and since plakar splits files into content-defined chunks and stores each chunk once, a region file that barely changed only costs the bytes that did. Keeping months of nightly snapshots is cheap, and each one of them is a complete server you can browse, diff or restore.</p>\n<p>Here’s a nice screenshot of a world at the time of a backup:</p>\n<figure><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/worldA-center_hu_e0a319e2a07445ca.png\" alt=\"Screenshot of a world prior to backup\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>Here’s how it appears after three backups in plakar:</p>\n<figure><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-dashboard_hu_8c82c86f4ef0eb3e.png\" alt=\"UI\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>And picking into server directory, world folder and region files:</p>\n<p><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-browse-server_hu_c5cead9a46a47420.png\" alt=\"server folder\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-browse-world_hu_fc7e5bfa93ed5f0e.png\" alt=\"world folder\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-browse-regions_hu_8a30698d7eb84026.png\" alt=\"regions folder\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></p>\n<p>With a preview of the EULA and properties:</p>\n<p><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-preview-eula_hu_6f794ed607497cf1.png\" alt=\"eula\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-fs-preview-properties_hu_58ff1d6e109c1b5b.png\" alt=\"alt text\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></p>\n<h2 id=\"restoring\">Restoring <a href=\"#restoring\">#</a></h2>\n<p>Restores refuse to write into a directory where a server is running, because writing region files under a live server is the fastest way to corrupt a world. Stop it first.</p>\n<p>Restoring the whole server where it was:</p>\n<pre><code>$ plakar at /var/backups/minecraft restore -to minecraft:///srv/minecraft \\\n  &lt;snapid&gt;:/srv/minecraft/</code></pre>\n<p>Someone blew up spawn last night but the rest is fine ? Restore only the overworld:</p>\n<pre><code>$ plakar at /var/backups/minecraft restore -to minecraft:///srv/minecraft \\\n  &lt;snapid&gt;:/srv/minecraft/world</code></pre>\n<p>And moving the server to another machine is the same command, pointed at wherever the repository lives:</p>\n<pre><code>$ plakar at s3://backups/minecraft restore -to minecraft:///srv/minecraft \\\n  &lt;snapid&gt;:/srv/minecraft/</code></pre>\n<p>So you can technically use <code>plakar</code> as a minecraft server migration tool :-)</p>\n<p>There’s an <code>allow_running</code> option on the exporter to restore files the server doesn’t hold open, a plugin configuration for example, without stopping it.\nIt’s there for that and nothing else, don’t come complaining if you use it on a world and hell breaks loose.</p>\n<p>Here’s a screenshot of a world after restore, identical to the previous one:</p>\n<figure><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/worldA-restored-center_hu_ab45b7dfebfa96f.png\" alt=\"Screenshot of a restored world\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<h2 id=\"a-few-knobs\">A few knobs <a href=\"#a-few-knobs\">#</a></h2>\n<p>Most setups won’t need any of these, but on the importer <code>quiesce</code> (on by default) can be turned off to copy the directory as is whatever the server is doing, <code>rcon</code> sets the console address if it’s not the one from <code>server.properties</code>, <code>timeout</code> (5 minutes by default) is the time allowed for each console exchange because <code>save-all flush</code> on a large world takes a while, and <code>dont_traverse_fs</code> keeps it from following mount points under the directory.</p>\n<p>The exporter has <code>allow_running</code>, <code>rcon</code> and <code>timeout</code> (30 seconds there), plus the usual <code>skip_ownership</code>, <code>skip_permissions</code> and <code>skip_times</code> from <code>fs</code>.</p>\n<p>As usual,\ndon’t use an option if you don’t know that you need it,\nthe defaults should be fine for most.</p>\n<h2 id=\"things-you-should-know\">Things you should know <a href=\"#things-you-should-know\">#</a></h2>\n<p>If plakar is killed between <code>save-off</code> and <code>save-on</code>, saving stays off until someone runs <code>save-on</code> on the console. A cancelled backup turns it back on by itself, a crash cannot… so if your backups run unattended, it’s worth keeping an eye on.</p>\n<p>A server in a container on Docker Desktop holds its world locks inside the Docker VM where the host can’t see them, so there the connectors only know the server is up through the console. Keep RCON enabled and published.</p>\n<p>Finally, worlds on a Bukkit, Spigot or Paper server are three directories, <code>world</code>, <code>world_nether</code> and <code>world_the_end</code>, and they should be restored together unless you enjoy Nether portals leading nowhere.</p>\n<p>All of this was tested with vanilla 26.3 in the <code>itzg/minecraft-server</code> image: a backup of the live server with saves paused, a restore refused while it ran, then a restore of the snapshot into a new directory and a server booted from it with the same seed and the same world \\o/</p>\n<h2 id=\"wait-what-about-using-minecraft-as-a-store\">WAIT ! WHAT ABOUT USING MINECRAFT AS A STORE ? <a href=\"#wait--what-about-using-minecraft-as-a-store-\">#</a></h2>\n<p>If you’ve followed me for a while, you know that I like stupid :-)</p>\n<p>Technically, nothing prevents us from using a minecraft server as a store for backups and encode the data as blocks to be turned into a walkable landscape.</p>\n<p>Is it useful ? nopes.\nShall we do it ? yes, we MUST.</p>\n<p>I present to you the stupidest idea of this week-end: <strong>backups as a world</strong>.</p>\n<h2 id=\"the-world-is-the-store\">The world is the store <a href=\"#the-world-is-the-store\">#</a></h2>\n<p>Backing up a Minecraft server is the sensible half of this integration.\nThe other half is half a joke, half a technical demonstration: if plakar can back up a world, could a world be the thing plakar backs up <em>to</em> ?\nNot a folder on the server, the world itself. Blocks.</p>\n<p>It turns out the storage contract makes that easier than it sounds.\nA kloset store has to do very little: hold packfiles and states, give them back by content address, serve a byte range out of a packfile, list what it has, delete what it is told to. It does not care what the bytes are stored <em>as</em>. The fs store writes files, the S3 store writes objects, and nothing in kloset would notice if a store wrote terrain. So the problem is not plumbing, it is a codec to translate our bytes back and forth to something sensible.</p>\n<h3 id=\"two-bytes-per-column\">Two bytes per column <a href=\"#two-bytes-per-column\">#</a></h3>\n<p>Every column of a Minecraft world, every x and z, carries two bytes. The low nibble of the first byte is a height: that many blocks of stone above a base at y=64. On top of the stone sit three blocks, a stained glass, a terracotta and a concrete, and each comes in sixteen colours, so the remaining three nibbles are colours. A chunk is 256 columns, so it holds 512 bytes. A region file is 32 by 32 chunks, and chunk (0,0) of every region is a header that says which packfile or state this is, how long it is and where this region sits in it, encoded as terrain like everything else. The remaining 1023 chunks hold 511 KiB of payload.</p>\n<p>A packfile is placed by hashing its address into region coordinates, so there is no catalog to keep in sync: listing the store is a scan of the region files and a read of each header chunk. Locks and the kloset configuration are plain files next to the world, because they change, and terrain is not meant to.</p>\n<figure><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/worldB-store_hu_fdc53185e795c125.png\" alt=\"Eight regions of the store from above\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>That is eight region files of my plakar checkout, seen from above at one pixel per block.\nSince plakar compresses and encrypts data before storing, this makes a surface that looks like noise, which is correct. The white squares in the corners are the header chunks: the padding after a header is zeros, and a zero column is white glass, white terracotta and white concrete on no stone at all.</p>\n<figure><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/worldB-iso_hu_39bcb097287b6691.png\" alt=\"The same terrain, up close\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>Up close it is a field of pillars, each one a column of stone with three coloured blocks on top. This is what a player walks across (or at least tries to walk across :p). The heights are a nibble so the hills stay walkable, and nothing in the palette falls, burns, flows, spreads or gets picked up by an enderman, because the server will keep running on this world and the bytes have to survive it.</p>\n<h3 id=\"why-not-a-solid-cube\">Why not a solid cube <a href=\"#why-not-a-solid-cube\">#</a></h3>\n<p>The dense version of this is obvious: 256 block types, one byte per block, 96 MiB per region, and we’re done.\nIt would also be a solid cube of static nobody can walk on, and walking on your backups is the whole point otherwise… it’s boring and no fun.\nTerrain costs density,\ntwo bytes per column instead of one per block,\nand the region files on disk come out at roughly ten times the kloset.\nWe’re not building something serious here so it’s fine, I’ll trade space for lulz.</p>\n<p>The more interesting constraint is that a running server does not leave region files alone. It relights chunks it loads, it rewrites them on save, and when you upgrade the server it runs every chunk through its data fixers. So the codec cannot depend on how a chunk is laid out on disk, only on which block is where.</p>\n<h3 id=\"read-only-in-the-minecraft-sense\">Read-only, in the Minecraft sense <a href=\"#read-only-in-the-minecraft-sense\">#</a></h3>\n<p>Players cannot be allowed to change a byte, otherwise they break the store.\nThat is three layers:</p>\n<ul><li>The server runs in forced adventure mode, where blocks cannot be broken or placed.</li><li>The gamerules the store writes into <code>level.dat</code> stop random ticks, fire, weather, mob spawning and mob griefing, so nothing grows, melts, burns or wanders off with a block.</li><li>And the palette is inert on its own.</li></ul>\n<p>If something gets through anyway, kloset verifies every read against its address, so a creeper that edits a packfile produces an error, not a quietly wrong restore.</p>\n<h3 id=\"does-it-actually-work\">Does it actually work <a href=\"#does-it-actually-work\">#</a></h3>\n<pre><code>$ plakar at minecraft:///srv/minecraft create\n$ plakar at minecraft:///srv/minecraft backup ./plakar\n$ plakar at minecraft:///srv/minecraft backup ./plakar\n$ plakar at minecraft:///srv/minecraft backup ./plakar\n$ plakar at minecraft:///srv/minecraft ls\n2026-11-14T21:57:05Z   b81e9a60   106 MiB        0s /Users/gilles/Wip/github.com/PlakarKorp/plakar\n2026-11-14T21:57:03Z   703d4848   106 MiB        1s /Users/gilles/Wip/github.com/PlakarKorp/plakar\n2026-11-14T21:56:15Z   881849ce   106 MiB        1s /Users/gilles/Wip/github.com/PlakarKorp/plakar\n\n$ plakar at minecraft:///srv/minecraft cat b81e9a60:/Users/gilles/Wip/github.com/PlakarKorp/plakar/README.md\n&lt;div align=&quot;center&quot;&gt;\n\n&lt;img src=&quot;./docs/banner.png&quot; alt=&quot;Plakar: open source backup engine&quot; /&gt;\n\n# Plakar: open source backup engine\n\n**Encrypted, deduplicated, verifiable, and scalable.**\n\nBack up anything, store anywhere, restore everywhere, with zero-trust encryption and no vendor lock-in.\n...\n## What is Plakar?\n\nPlakar is an open-source backup solution powered by Kloset and ptar. It creates snapshots of your data, stores them in an encrypted and deduplicated store, and lets you inspect, verify, and restore them later.</code></pre>\n<p>It does. Three backups of the checkout went in, deduplicated as usual, and <code>ls</code> and <code>cat</code> came back out working just like they would on a filesystem or an S3 store.</p>\n<p>More interestingly, I launched the UI on the minecraft server store:</p>\n<pre><code>$ plakar at minecraft:///srv/minecraft ui</code></pre>\n<p>and you can browse the snapshots and preview files:</p>\n<p><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-minecraft-store_hu_f9a15e05de76e68d.png\" alt=\"The UI on a kloset that is a Minecraft world\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /><img src=\"https://poolp.org/posts/2026-11-14/walking-across-my-minecraft-backups-with-plakar/ui-minecraft-preview-source_hu_29e729d4b08ead0d.png\" alt=\"preview source\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></p>\n<h3 id=\"what-this-is-for\">What this is for <a href=\"#what-this-is-for\">#</a></h3>\n<p>Nothing, mostly. It is a toy, and I am fond of it. But it is an honest toy: it exists because the store contract is narrow enough that anything which can hold bytes and hand them back by offset can be a kloset, and the integrity checks are strong enough that a store you do not trust, like a world full of players, is still safe to restore from. Those are the properties that make plakar work on the stores that matter. This one just happens to have hills.</p>\n<p>Do backup your minecraft servers, and do restore them.</p>\n<p><strong>DON’T store your backups on a minecraft server as world, really, DON’T :-)</strong></p>\n<h2 id=\"what-s-next\">What’s next ? <a href=\"#whats-next-\">#</a></h2>\n<p>It’s in the devel channel for now, so give it a try and tell me what breaks, issues and pull requests go to the <code>integration/minecraft</code> branch of <a href=\"https://github.com/poolpOrg/plakar-integrations\" rel=\"nofollow ugc noopener\">poolpOrg/plakar-integrations</a>.</p>\n<p>As for the series, I’ll keep picking random projects and generating connectors for them every now and then. If there’s something you value and would like to see backed up, tell me… or better, grab the SDK and the docs and beat me to it: I’ll make sure the authors of the funniest integrations get their goodies :-)</p>\n<p>Stay tuned !</p>\n<p>I take short consulting engagements — architecture review, technical due\ndiligence, mail infrastructure — through\n<a href=\"https://aljuna.tech\" rel=\"nofollow ugc noopener\">aljuna.tech</a>.</p>","headings":[{"level":1,"text":"Walking across my Minecraft backups with Plakar","id":"walking-across-my-minecraft-backups-with-plakar"},{"level":2,"text":"First, what’s plakar ? #","id":"first-what-s-plakar"},{"level":2,"text":"What’s this article about ? #","id":"what-s-this-article-about"},{"level":2,"text":"Why Minecraft needs care #","id":"why-minecraft-needs-care"},{"level":2,"text":"Here’s the prompt that was used #","id":"here-s-the-prompt-that-was-used"},{"level":2,"text":"How does it work ? #","id":"how-does-it-work"},{"level":2,"text":"Installing #","id":"installing"},{"level":2,"text":"Enabling RCON #","id":"enabling-rcon"},{"level":2,"text":"Backing up #","id":"backing-up"},{"level":2,"text":"Restoring #","id":"restoring"},{"level":2,"text":"A few knobs #","id":"a-few-knobs"},{"level":2,"text":"Things you should know #","id":"things-you-should-know"},{"level":2,"text":"WAIT ! WHAT ABOUT USING MINECRAFT AS A STORE ? #","id":"wait-what-about-using-minecraft-as-a-store"},{"level":2,"text":"The world is the store #","id":"the-world-is-the-store"},{"level":3,"text":"Two bytes per column #","id":"two-bytes-per-column"},{"level":3,"text":"Why not a solid cube #","id":"why-not-a-solid-cube"},{"level":3,"text":"Read-only, in the Minecraft sense #","id":"read-only-in-the-minecraft-sense"},{"level":3,"text":"Does it actually work #","id":"does-it-actually-work"},{"level":3,"text":"What this is for #","id":"what-this-is-for"},{"level":2,"text":"What’s next ? #","id":"what-s-next"}]}}