Installation

Mo’Afks needs Paper 26.3 or a fork of it, like Purpur, on Java 25. PlaceholderAPI, MiniPlaceholders, TAB, and Plan are optional: see Integrations.

With Docker (recommended)

If your server runs in itzg/minecraft-server, it fetches Mo’Afks itself.

1. Name it in MODRINTH_PROJECTS:

   services:
     minecraft:
       image: itzg/minecraft-server:java25
       environment:
         EULA: "TRUE"
         TYPE: PAPER
         VERSION: "26.3"
         MODRINTH_PROJECTS: |
           moafks
       ports: ["25565:25565"]
       volumes: ["./data:/data"]

2. Start the container: docker compose up -d.

moafks:2.2.1 pins a version. The optional plugins go on the same list, one per line: placeholderapi, tab-was-taken (TAB), plan.

To take Mo’Afks from GitHub instead, use PLUGINS: https://github.com/MairwunNx/moafks/releases/latest/download/moafks.jar.

By hand

1. Download the jar from Modrinth, Hangar, or GitHub.
2. Put it in plugins/.
3. Restart the server.

What the first start creates

• plugins/MoAfks/config.yml, the settings, described in Configuration.
• plugins/MoAfks/lang/, one file per language: English, Russian, Spanish, Portuguese, and German.
• plugins/MoAfks/geoip/, DB-IP’s free country database (about 4 MB), which picks each player’s language. See Languages.

Coming from 1.x

Your config.yml keeps working: its prevents and exit_triggers lists turn into the new switches. Its messages don’t carry over, so move your texts into the files in lang/. The 1.x permission moafks.reload still works.

Next: First steps