Vintage Story Mod DB · Vintage Story mod

Antlers Harmonypatch

"Shed antlers should be picked up, not admired." Fixes antlers that are shed while a creature's chunk is loading. Without this fix, those antlers stay visible on the ground but can never be picked up, and they disappear after reloading the world. Features •

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Antlers Harmonypatch release should I use?

Updated yesterday

Latest stable file 1.0.0

Game version 1.22.0, 1.22.1, 1.22.2

Loader Built-in Vintage Story mod system

Antlers Harmonypatch 1.0.0 targets 1.22.0, 1.22.1, 1.22.2. Do not install it on the client. It must be installed on the dedicated server. No extra mods listed for this file.

Where it goes

Is Antlers Harmonypatch required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported

Dedicated server Required

Loader for this release Built-in Vintage Story mod system

Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This Vintage Story file is marked server-only.

Understand Vintage Story dependencies Read the Vintage Story installation guide

What else does Antlers Harmonypatch 1.0.0 need?

1.0.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Antlers Harmonypatch without breaking your instance.

Built for Antlers Harmonypatch 1.0.0. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use 1.0.0. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.
02
Bring the mods it needs

This file does not list any required mods. Do not add a library just because a different file uses it.
03
Put it on the correct side

Do not install it on the client. It must be installed on the dedicated server.
04
Pick the file you checked

Use the “Get this file” button beside 1.0.0. It opens that exact file at the source.

About this project

What does Antlers Harmonypatch add?

"Shed antlers should be picked up, not admired."

Fixes antlers that are shed while a creature's chunk is loading. Without this fix, those antlers stay visible on the ground but can never be picked up, and they disappear after reloading the world.

Features

Defers antler shedding from chunk loading to the creature's regular game tick, a few seconds later
Shed antlers can be picked up normally, even if nobody was nearby when the shedding season started
Lightweight and Vanilla friendly, no new items, blocks, settings or expensive calculations

Installation

In Multiplayer it is required for Server-side only. Clients do not need the mod to join.
In Singleplayer, simply install it like any other mod.

Compatibility

Vintage Story 1.22.x, tested on 1.22.7
Applies to every creature that calls the vanilla "antlergrowth" behavior, including modded deer that make use of it
If a game update renames the patched method, the mod falls back to vanilla behavior and writes a warning to the server log. A fix would be to find the new method name and patch that in case the bug still appears.

Known limitations

Antlers that already became unpickable before installing the mod are not restored. These item entities are not saved with the chunk and disappear when the world is reloaded (different causes are possible).
Once the bug is fixed in the base game, this mod can be removed
This fix only works for 1.22.x versions due to the required .NET version and game requirement setup. Comment me if you need a game version that is not included, I'll see what I can do.

Background

Bug report with reproduction steps: anegostudios/VintageStory-Issues#5746

Thanks to the Antlerutil mod dev for the inspiring previous workaround. You can still use both mods alongside each other! https://mods.vintagestory.at/antlerutilmod#tab-description (tested in Singleplayer)

Thanks to the people who reported this bug previously, reading the findings helped me narrow it down to this point, good job community!