Skip to content

KmDDNS

Automatically keeps your KmDDNS record updated with your Minecraft server's IP and port.

FabricNeoForge
Loaders
FabricNeoForge
Downloads on Modrinth
234
Followers on Modrinth
0
versions
8
Updated
March 15, 2026Mar 15
Published
in 2026

At a glance

Runs on Fabric and NeoForge
For Minecraft 1.21.1–1.21.11
Server only — players don't need to install it
Latest version — 1.0.0-Neoforge-1.21.11 from March 15, 2026
License MIT — free
Where it's needed
In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.21.1–1.21.11

Automatically keeps your KmDDNS record up to date so players can always find your server — even when your IP changes.

No router config. No static IP. Just install and run.


What it does

KmDDNS gives your Minecraft server a permanent address like myserver.ddns.kmathers.co.uk. Whenever your server starts, the mod checks your current public IP and updates the DNS record automatically. Players always connect to the same address.

Tunnel mode takes this further — if you can't or don't want to forward ports, the mod connects to a relay that routes player traffic through KmDDNS infrastructure. No port forwarding required at all.


Features

  • Keeps your subdomain pointing at your current IP automatically
  • Sends your server's MOTD and player count to the KmDDNS API (shown on the lookup page)
  • Tunnel mode — no port forwarding needed, traffic is proxied through a relay
  • In-game setup wizard — register or configure everything without leaving the game
  • /kmddns status to see your current address, IP, and connection state at a glance
  • Configurable heartbeat interval, port, and tags

Setup

1. Get a subdomain

Run /kmddns setup in-game to open the wizard. You can:

  • Register a new subdomain — pick a name and get a token on the spot
  • Use an existing token — if you already have a KmDDNS account

The wizard walks you through port detection, update interval, and whether to use tunnel mode. When you confirm, it saves the config and starts immediately.

2. That's it

Your server will now appear at yourname.ddns.kmathers.co.uk. Players connect using that address.


Tunnel mode

If you're behind CGNAT, a strict firewall, or just don't want to mess with port forwarding, enable tunnel mode during setup.

In tunnel mode:

  • The mod keeps a WebSocket connection open to KmDDNS
  • When a player connects to your subdomain, the relay routes them through to your server
  • Your server doesn't need to be reachable from the internet directly

Enable it during /kmddns setup, or set tunnel = true in the config and toggle it on via the API.


Commands

CommandDescription
/kmddns statusShow current IP, subdomain, tunnel state, and last update time
/kmddns setupOpen the interactive setup wizard
`/kmddns setup token `Configure with an existing token
/kmddns setup newRegister a new subdomain

Config

The config file is created automatically at config/kmddns.toml on first launch.

[kmddns]
enabled = true
token = "your-token-here"
api_base = "https://ddns.kmathers.co.uk/v1"
port = 0                  # 0 = auto-detect from server.properties
update_interval = 300     # seconds between heartbeats (minimum 30)
tags = ["minecraft"]
metadata_motd = true      # send server MOTD to the API
metadata_player_count = true
log_updates = true
tunnel = false            # set true to use tunnel mode

Requirements

  • Server-side only — players do not need this mod
  • Fabric or NeoForge
  • Minecraft 1.21.1, 1.21.4, 1.21.5, or 1.21.11
  • A KmDDNS account (free, created via /kmddns setup new)

A quick note

I build these tools for fun and for the community. Keeping everything running does have real maintenance costs, and even $1 goes a long way.

If you enjoy the tools and want to give back, you can support me here: Buy me a coffee. No pressure either way — thanks for being here.

FAQ

How to install KmDDNS?

Install Fabric for your Minecraft version, download KmDDNS for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does KmDDNS support?

KmDDNS has builds for Minecraft 1.21.1–1.21.11.

Is KmDDNS needed on the server?

Server only — players don't need to install it

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More