Description

Ducky periodically sends update requests to DuckDNS using your configured domain and token. It is designed for servers hosted on dynamic IP connections that need regular DuckDNS update requests.

All requests run asynchronously to avoid blocking the Minecraft server thread, and updates can also be triggered manually for testing or immediate updates.

DuckDNS returns OK when a request is accepted, even if the IP address did not change.
Ducky reports request acceptance, not confirmed IP modification.

This project is not affiliated with DuckDNS.

Java 17 or higher is required

Features

• Automatic DuckDNS update requests

• Configurable update interval

• Fully asynchronous (non-blocking)

• Manual update command

• Lightweight and dependency-free

• Simple configuration

• Compatible with Bukkit, Spigot, Paper, and Purpur

Commands

• Sends a DuckDNS update request immediately

/ducky test	

Configuration

duckdns:
  domain: yourdomain
  token: yourtoken
  update-interval-minutes: 5