4.1.0

Suppress Leashed Players Feature

Added a player-leash.suppress-leashed-player option in the config that, if enabled, will prevent leashed players from interacting with anything in any way.

For example: They cannot place blocks, hit players, interact with stuff, etc…

Thank you Jupi in my Discord for the suggestion!

4.0.0

Tether version 4.0.0 is now marked as stable.

For the full changelog, please see the changelogs for the previous 4.0.0 beta releases.

4.0.0-beta.3

v4.0.0-beta.3 - Continuation of Isolate Default Leashable Mobs Update

ℹ️ This is a BETA Release
This update includes significant changes. While extensive testing has been performed, some bugs may still be present.

Config Backwards Compatibility Improved with Safe Migration

For every key in config.yml, Tether will now check:
If it's a legacy key and its modern equivalent is not present, copy the value(s) from the legacy key to the modern one, then delete the legacy one.

Example

In this 4.0.0 update, blacklisted-mobs changed to entity-blacklist. Now, on startup, Tether will check if the user's config has the old blacklisted-mobs key. If it does, create the entity-blacklist key and copy over the values. Then delete blacklisted-mobs.

4.0.0-beta.2

v4.0.0-beta.2 - Continuation of Isolate Default Leashable Mobs Update

ℹ️ This is a BETA Release

This update includes significant changes. While extensive testing has been performed, some bugs may still be present.

❗ BREAKING CHANGE - Tether only supports Paper now (and direct forks)

As of this release, 4.0.0-beta.2, Tether has moved off of the Spigot API and over to the Paper API.
Development of this update uncovered the need to make this change.

What This Means For You

How you run Tether:

❗ Tether will no longer work on plain Spigot servers, and will only work on Paper (or Paper-based) servers (like Purpur).

How you find Tether:

New versions of Tether will now only be available on Modrinth or Hangar (or GitHub Releases), no longer the SpigotMC website.

Estimated affected audience:

Basically no one.
For years Paper has been the gold standard Minecraft server. No one really runs a plain Spigot server anymore anyways.

(See more below).

Why?

Paper has always been a direct superset of Spigot, meaning all Spigot plugins will work on Paper. However, in 2024 Paper officially stopped this commitment and moved away from relying on Spigot so that they may become independent and move more quickly.

Things still continued be compatible for a while though, until eventually certain plugins would run into a point where the differences
mattered. This was the case for Tether recently, as Paper changed things to do with leashing under the hood that no longer matched Spigot.

These situations leave developers like me with a few options:

• A. Stop supporting Paper and stick with Spigot. (Yeah, no way).
• B. Develop two streams of the plugin, one for plain Spigot and one for Paper.
• C. Abandon plain Spigot entirely and go all in on Paper and paper-based servers.

I of course chose option C. Option B, while valid, is too much work (for me at least). Especially considering the fact that the vast majority of Minecraft servers nowadays run Paper or some paper-based server (like Pupur). Almost no one is running a plain Spigot server. So that would be wasted effort.

Option C is the clear winner here.

Bug Fix: Non-mob Entities Are Ignored by Tether

Fixed a bug introduced in the 4.0.0 update where non-mob entities, like boats, would be ignored by tether.

Config Changes

Updated verbiage from “default leashable mobs” to “default leashable entities”.

Config changes:

• DEFAULT_LEASHABLE_MOBS value has been changed to DEFAULT_LEASHABLE_ENTITIES
  • Backwards compatibility has been added for this.
• blacklisted-mobs and whitelisted-mobs have changed to entity-blacklist and entity-whitelist.
  • Backwards compatibility has been added for this.

Thanks @ Ken in my Discord for pointing this out!

4.0.0-beta.1

v4.0.0-beta.1 - Isolate Default Leashable Mobs

ℹ️ This is a BETA Release

This update includes significant changes. While extensive testing has been performed, some bugs may still be present.

Overview

This update changes how Tether operates at its core when it comes to mob leashing.

Instead of treating every mob the same and completely overriding vanilla behaviours, Tether now deliberately distinguishes between mobs which are leashable by default in the game, and mobs which are not.

This allows Tether to better handle leashing mechanics, and to not get in the way of vanilla behaviours since Tether can decide to let the game handle vanilla leashing.

❗ Minimum Version of 26.2

This update only supports Minecraft version 26.2 and onwards!

🎉 New Feature: Target Default Leashable Mobs in the Blacklist/Whitelist

You can now write DEFAULT_LEASHABLE_MOBS in your blacklist/whitelist to target all mobs which are leashable by default.

This is helpful, for example, for server administrators who like to allow only default leashable mobs plus one or two others.

Thank you Ken and das_ in my discord for the suggestions!

⚙️ Bug Fix: When the Squad Hops into Town Achievement

"When the Squad Hops into Town" is an achievement which involves leashing all 3 types of frogs.

This didn’t work because the game didn’t recognize that the player had done this, since Tether previously overrode the game’s vanilla leashing. Because of this overhaul, this bug, and potentially others like it that are unknown, are fixed.

Thank you das_ in my discord for reporting it!

Tether ❤️ Kotlin

This version of Tether also introduces the use of the Kotlin programming language!

From this point on, Tether will prefer new contributions to be made in Kotlin where possible. Java is still completely welcome, and is necessary for maintenance of existing code.

Other

• This is Tether's first use of git tags and the Release feature on Github.