Docker setup + config for ninjas who craft in groups.

Also useful as a starting point for deploying your own server.

• Server: 1.21.1 (Paper)
• Address: mc.koditoriet.se
• Seed: -2135836821937050197
• Gamemode: survival
• Difficulty: hard
• PvP: off

• mcMMO
• EssentialsX
• SilkSpawners
• BlockLocker
• Lasso

See datapacks for all enabled datapacks.

Some particularly useful ones:

• graves: a gravestone is spawned when you die, to keep your inventory safe until you come back for it.
• multiplayer sleep: anyone can trigger a night → day transition (please be considerate of other players who may be engaged in night-time activities).
• custom nether portals: create nether portals in any shape you like.
• xp bottling: store experience for later use.
• leash villager: put villagers on a leash.

See vanillatweaks.net for more information about each datapack.

Minor ways in which the server differs from vanilla. If something doesn't work as expected, one of these is probably to blame.

• use-faster-eigencraft-redstone: true (default false)
  • faster redstone; semantically equivalent to vanilla in theory
• optimize-explosions: true (default false)
  • faster explosions; morally equivalent to vanilla
• max-auto-save-chunks-per-tick: 12 (default 24)
  • improved IO performance
• per-player-mob-spawns: true (default false)
  • prevents mob farms from hogging all spawns
• max-entity-collisions: 4 (default 8)
  • improved cow farm performance
• bed-search-radius: 2 (default 1)
  • make it harder to accidentally obstruct your bed
• container-update-tick-rate: 4 (default 1)
  • refresh player view of container contents 5 times per second instead of 20; reduces network traffic and CPU load
• non-player-arrow-despawn-rate: 200 (default: no despawning)
  • despawn skeleton/pillager arrows after 10 seconds; improves memory use and CPU load
• mob-spawner-tick-rate: 2 (default 1)
  • halve spawn frequency from spawners for lighter CPU load
• disable-chest-cat-detection: true (default false)
  • cats don't prevent chests from opening, for less irritation and lighter CPU load
• hopper.cooldown-when-full: true (default true)
  • reduce CPU load by not constantly trying to pull items into a full hopper
• Cobblestone and netherrack despawn in 15 seconds.
  • reduce CPU load, memory usage, and inventory clutter when mining

Build or pull the docker image, docker-compose up, done. Though you may want to change the config in docker-compose.yml first.

If you want to add or remove any plugins, edit plugins.json or source-plugins.json before building.

The builder image comes with Maven and Gradle installed. If a source plugin needs any other build tools, you'll need to add those to the dockerfile.

• Environment variables

  • OPS: space-separated list of users with op privileges.

    The effective list of ops is the union of this list and any users you have previously op'd, either by adding them to this list or by using /op in-game.

    This means that you can only add ops by changing this variable; to de-op someone, you need to remove them from this list and de-op them in-game.

    You should probably have at least one name on this list, or managing your server is going to be a bit hard.

  • ALLOW: space-separated list of users who are allowed to connect to the server.

    The effective list of allowed users is the union of this list, the OPS list (no need do add ops to both lists) and any users you have previously allowlisted, either by adding them to this list or from within Minecraft using /whitelist add.

    This means that you can only add users to the allow list by changing this variable; to remove someone from the allow list, you need to remove them from this list and remove them from the list in-game using /whitelist remove.

  • HEAP: amount of heap space to allocate. Defaults to 2G if unset.

• Build-time config files
  • plugins.json: plugins to be downloaded on image build.
  • source-plugins.json: plugins to be built from source on image build.
  • datapacks: datapacks to include in image.
  • conf: configuration files for the Paper Minecraft server; reapplied on each container restart.
  • plugin-conf: per-plugin configuration; reapplied on each container restart.
• Volumes
  • /data: your Minecraft world is stored on this volume. You may want to back it up every now and then.
• Exposed ports
  • 25565: the default Minecraft port.
• Build-time arguments

  • VERSION: Minecraft version to build image for. Defaults to 1.21.

    The latest Paper build for the given version will be used for the image.