Custom Watermark

Custom Watermark

Adds a customisable text watermark to the game that you can edit using the built-in GUI

by
528 Downloads
fabricgame-mechanicstechnologyutility
Rent Server with this Mod

Screenshots

New colours added in version 1.1
An example of the custom-watermark GUI
An example of the fps and hp displays
a cropped in photo of the time mode of the watermark

About this Mod

Custom-watermark

This mod adds a customisable watermark to your client that you can modify and edit using the built-in GUI

Keybinds

watermark.gui - Opens the custom-watermark gui (set to the V key by default)

watermark.cycle - Cycles the watermark colour without opening the GUI (set to the / key by default, if it doesn't work please check if / is already bound to something)


Colour options

Here are the colour options currently implemented in the mod, more will be implemented soon...

white

blue

red

blue

green

yellow

orange

pink

pastel red

pastel blue

pastel green

pastel yellow

pastel pink



Custom tags

Custom-watermark has some tags that use in game data to allow for a more customisable gui, here they are:

{fps} - shows the current frames-per-second (fps)

{health} - shows your current player health (including decimal places)

{time} - shows the current time (systemclock)

{date} - shows the current date

{username} - displays your username

{x} - displays your x coordinates

{y} - displays your y coordinates

{z} - displays your z coordinates

{moonphase} - This tag shows the current Moon phase in text form (for example "Full Moon")

{moon} - This tag is basically the same as the {moonphase} tag, but instead displays it as an integer (such as "1" for a full Moon, see the Minecraft wiki here for the full list)

Tag aliases:

{hp} - alias of {health}
{player} - alias of {username}

To show the data, put the tags (with the brackets) in any part of your watermark text. Here is an example:

fps={fps}, health={health}

This will show up as:

fps=144, health=18
The 144 fps and 18 health are just example numbers

Json config

Custom-watermark includes a JSON config file, which can be found in the .minecraft/config folder. This config file is used to store preference data, but can also be used to directly modify the watermark configuration, as an alternative to the GUI


custom-watermark.json
{
"x":10,
"y":10,
"scale":1.0,
"txt":"FPS: {fps}",
"colour":"literal{white}"
}

How to temporarily disable the watermark

To temporarily disable the watermark, remove all of the text from the watermark text bar and press the "apply changes" button

Please feel free to make a Github issue for feature requests

1.0 Notice

To anyone running version 1.0, please note that the mod may come up with the name "pumpkin", as 1.0's mod id wasn't refractored from the original id that came from what this project was initially meant to be (a halloween mod)

Modpack usage notice

You may use this mod for any modpacks, as long as the modpack follows terms of the GPL v3 License this mod uses.

Available Versions

Custom Watermark 1.4+1.21.7release
MC 1.21.7fabric
August 16, 2025
Custom Watermark 1.4+1.21.6release
MC 1.21.6fabric
August 16, 2025
Custom Watermark 1.4+1.21.8release
MC 1.21.8fabric
August 16, 2025
Custom Watermark 1.3release
MC 1.21.5fabric
May 16, 2025
Custom Watermark 1.2release
MC 1.21.5fabric
April 5, 2025

How to Install Custom Watermark on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).

3

Install Mod

Open the mod browser in the dashboard and search for "Custom Watermark". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.8, 1.21.7, 1.21.6 (+2 more)

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Custom Watermark server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.8). You can switch loaders with one click in the panel.

Is Custom Watermark compatible with fabric?

Custom Watermark officially supports fabric for Minecraft 1.21.8, 1.21.7, 1.21.6. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Custom Watermark – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Custom Watermark consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Custom Watermark with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU General Public License v3.0 only
Server-side
Unsupported

Supported Versions

1.21.81.21.71.21.61.21.51.21.4