Mods / TOPGS Patches

Description
Files
Homepage

Tags: #Other #Utility
Author: Elocrypt
Side: Both
Created: Jul 31st at 9:09 PM
Last modified: Nov 11th at 3:57 PM
Downloads: 2769
Follow Unfollow 2

Recommended download (for Vintage Story 1.21.0 - 1.21.5):
topgsPatches_VS1.21.5_v1.2.0.zip 1-click install

TOPGS Patches

QoL + moderation + livestock & ballistics suite for Vintage Story 1.21.5

Claim-Gated Flight Jail/Ban/Mute/Kick Welcome & Patches Livestock & Dairy Projectiles & Arrows Compat Patch

TOPGS Patches bundles moderation, onboarding, chat UX and a tuned flight experience designed for persistent servers. Works on Vintage Story 1.21.1 - 1.21.5 (client+server).

Flight System

Enable only inside permitted land claims; auto disables after a grace timer when you leave.
Satiety & Stability drains with thresholds; toggle cooldown.
F1 / F2 to adjust speed; diagnostics & live config (/flycfg).

Moderation

Jail, Ban / TempBan, Mute / TempMute, Kick.
Jail / Stable / Impound zones with spawn; inventory snapshot+restore; optional role swap.
Scheduler for timed actions; reason catalog & staff notes.

Onboarding & Chat

Welcome dialog (Welcome / What’s New / VIP / Commands) + “Remind Later”.
Chat linkifier with confirm dialog & copy link.
Anti-spam guard: repeat damping + caps mitigation.

Livestock & Dairy

24/7 server parity: all animal lactation timers updated to behave correctly on always-online servers.
Increased milk yields for applicable species.
Breeding tiers T0–T3 to clarify progression and improve husbandry planning.
Bigger containers: barrel & bucket capacities increased to match dairy output.

Weapons & Projectiles

WeaponPackAlpha rebalanced: crafting costs adjusted; throwable damage tuned.
Arrow damage scaling smoothed for early → late game consistency.
Break-on-chance values refined for thrown/shot projectiles.

Agriculture & Compatibility

BerryBush Harmony patch safely overrides grape behavior when present.
Graceful fallback when the grape library is absent (keeps stacks stable).

Key Commands

Command	Description
`/fly [on\|off]`	Toggle flight for yourself (inside claims).
`/flycfg show`	Show current flight configuration.
`/flycfg set <key> <value>`	Update flight drains/thresholds/cooldowns.
`/punish jail\|ban\|mute\|kick ...`	Staff actions (temp variants supported).
`/jail zone ...`	Create/inspect jail zones and spawn points.
`/stable zone ...`	Create/inspect stable zones and spawn points.
`/impound zone ...`	Create/inspect impound zones and spawn points.
`.welcome`	Open the Welcome Message dialog

Note: Livestock, projectile, and compatibility features are passive—no commands required.

Install

Drop the ZIP into your VintagestoryData/Mods folder.
Restart server and/or client.

Works on Vintage Story 1.21.1 - 1.21.5 (client+server).

Play on our Servers

Jump in and meet the community. A multiplayer haven designed for busy gamers who enjoy a relaxed, low-stress survival experience in Vintage Story.

Forever Server

Our flagship persistent world.

IP: 40.160.1.149:48932

1.21 Experimental

Try upcoming features early.

IP: 40.160.1.149:48936

Seasonal Server

Fresh starts & events.

IP: 40.160.1.149:48937

Join our Discord

FAQ

Q: Flight won’t enable.
A: Enable inside a permitted claim. Newly created claims must age before flight is allowed.

Q: Why did flight disable?
A: Leaving a claim starts a countdown; also disables on AFK, death, or low resources.

Q: Can staff customize drains?
A: Yes — /flycfg set <key> <value>.

Mod Version For Game version Downloads Released Changelog Download 1-click mod install*

1.2.0

1.21.0 - 1.21.5

360

Nov 11th at 3:56 PM

Show

topgsPatches_VS1.21.5_v1.2.0.zip

1-click install

TOPGS Patches — Livestock & Ballistics Update

Merged PR highlights focused on 24/7 servers, livestock balance, projectile tuning, and container QoL.

Livestock Balance Projectiles Compatibility

Release date: 11 Nov 2025

Livestock (24/7 Runtime)

All animal lactation timers updated to behave correctly on always-online servers.
Milk yields increased across applicable species.
Introduced breeding tiers T0–T3 to gate yield and progression in a clearer path.

Agriculture & Compatibility

Added BerryBush Harmony patch to cleanly override grape DLL behavior when present.
Focus on safe interop and graceful fallback when the grape library is absent.

Weapons & Crafting

WeaponPackAlpha rebalanced: recipe costs adjusted and throwable damage tuned.
Updated arrow damage scaling for a saner curve from early to late game.
Refined break-on-chance values for thrown/shot projectiles.

Containers & QoL

Barrel & bucket capacities increased to match the new dairy output.
Fluid handling feels less clicky during bulk milking and crafting.

Why this matters

24/7 parity: Animal production stays consistent on continuously running servers.
Progress clarity: T0–T3 tiers make husbandry goals and upgrades easier to plan.
Combat pacing: Reworked arrow scaling and throwable balance smooth early spikes and late troughs.
Less tedium: Bigger container volumes reduce churn when processing milk-heavy recipes.
Safer mod stacks: BerryBush patch avoids DLL stomping and keeps grape content stable.

Upgrade Notes

No manual steps expected for existing worlds; livestock changes apply to ongoing play.
If you run grape content, keep this patch enabled to ensure the safe override remains in effect.
Container volume increases are immediate; adjust automations/workflows as needed.

Built for Vintage Story servers powered by TOPGS Patches.

1.1.0

1.21.0 1.21.1

1180

Oct 2nd at 3:09 PM

Show

topgsPatches_VS1.21.1_v1.1.0.zip

1-click install

- Updated from NET 7 to NET 8 for VS 1.21.1 (Stable)

1.0.4

1.20.12

527

Aug 19th at 5:25 AM

Show

topgsPatches_VS1.20.12_v1.0.4.zip

1-click install

TOPGS Patches — Release Changelog

Quality-of-life, moderation, onboarding, and zone systems update.

New Systems Moderation UX & Infra

Welcome GUI & Infra

Welcome GUI shown to joining players; toggle via config.
TopgsPaths for consistent file paths + CSV/JSON I/O.
TopgsChat helpers (segmented color output: success/warn/error).
Audit + Discord moderation hooks (single callsite per action).

Zones & Vehicles

Jail zones with role swap, inventory snapshot, timers.
Stable (creature mounts): AABB + spawn + auto-stabling.
Impound (non-creature vehicles): land/water kinds, auto-impound, safe release.

Hardening & Logs

Hard-cancel entity interaction while jailed; force unmount.
Close foreign containers every jailed tick; GUI hard-close.
CSV audit trail (moderation.csv) for key events.
HUD coords in admin outputs + CSVs everywhere it matters.

Punish Command Tree & Aliases

New root: /punish (aliases: p, pun).

Subcommand	Alias	Notes
`kick`	`k`	Immediate disconnect with reason
`ban`	`b`	Permanent ban
`tempban`	`tb`	Timed ban with scheduler
`unban`	`ub`	Lift ban & clean state
`mute`	`m`	Chat mute
`unmute`	`um`	Lift mute
`jail`	`j`	Teleport to jail zone (online-time timer)
`unjail`	`uj`	Restore role + inventory, return to spawn
`status`	`s`	Show active punishments + timers
`note`	`n`	Manage player notes (single)
`notes`	`ns`	Notes collection utilities

Reasons & Config

/punishreason (aliases: pr, punr) → add|remove|list (a|r|l).

/punishconfig (aliases: pc, punishcfg, pcfg, punishc) with contraband subtree: contraband list|additem|addentity|removeitem|removeentity (short aliases included).

Diagnostics

/punishdebug (aliases: pd, pdg, punishd, pdebug) helpers.

/punishdiagnostics who (aliases: pg, pdiag, pdiagnostics, punishdiag) shows active targets + timers.

Jail System

Role swap on jail with optional fallback to server default.
Inventory snapshot (mode preserved); armor/backpack stripping via config.
Teleport into jail zones (auto or named) with multi-zone support.
Timer-driven jail (online time) with scheduler for temp punishments.
Unjail restores role/inventory and teleports to spawn.
HUD coords used in zone messages (zonelist, setspawn, editstart/end).
/jail whoin lists occupants per zone (or all).
Entities cannot spawn inside jail zones (hard veto).

Stable System (Creature Mounts)

Manage pens with AABB & spawn point controls.

Commands: /stable zonestart|zoneend|zonecancel|zoneremove|zonelist|setspawn|whoin
Aliases: zs|ze|zc|zr|zl|ss|wi

Auto-stabling: if a jailed player is mounted, the creature is moved to Stable.
HUD coords in all outputs; /stable whoin shows mounts + owner (uid→name) + HUD coords.
Entities cannot spawn inside stable zones.

Impound System (Non-Creature Vehicles)

Zones with Kind = Land or Water and optional spawn.

Commands: /impound zonestart <name> <land|water>, zoneend, zonecancel, zoneremove, zonelist, setspawn, whoin
Aliases: zs|ze|zc|zr|zl|ss|wi

Auto-impound: boats/rafts/sailcraft → Water impound; carts/wagons/sleds → Land impound.
Creature mounts continue to go to Stable, not Impound.
Release: /impound release <entityId> [here | to x y z] (validates water for boats).
/impound releaseall <player> returns all to original positions.
HUD coords in chat + moderation.csv (plus a user-friendly column).
Entities cannot spawn inside impound zones.

Persistence & Logging

Stable/Impound models persisted correctly (fields → properties / IncludeFields), surviving restarts like jail zones.
Introduced moderation.csv via TopgsPaths.AppendCsv for actions: impound, impound-release (single/batch), deny-spawn, deny-equip (contraband), force-unmount, and more.
CSV columns: UTC, staff/player ids, action, entity code/id, zone, kind, raw XYZ + HUD coords.

Contraband & Slot-Guard

Configurable contraband item prefixes (e.g., summoning tools, temporal gears).
Active-slot guard denies equipping contraband while jailed and logs to CSV.
Spawn veto for contraband entity codes within protected zones.

Boats on Release (Land Safety)

Impounded boats are not recalled to spawn (avoid land placement).
When a jailed player had a water vehicle, ParkedMount is cleared at impound.
ReturnImpounded puts the boat back to origin, or staff choose a valid water tile.

“Jail Gains” Inventory Preservation

On Unjail: collect items acquired during jail, restore pre-jail snapshot, teleport to spawn, then re-grant gains (TryGiveItemstack) or drop at spawn.
Client resync for accurate UI.

HUD Everywhere + UX Polish

All admin messages and CSVs report positions with HUD coords alongside raw XYZ: Jail/Stable/Impound zonelist, setspawn, zoneend, whoin; Impound send/release; spawn/ equip denials; other moderation lines.
Human-friendly durations in broadcasts.
/punish status and /punishdiagnostics who show actives, role, and timers.
Audit lines + Discord webhooks on all key actions.

Behavior & Performance Notes

Guards run server-side per event; jailed tick performs a light container-close sweep (tiny inventory map; negligible cost).
Zone checks are O(1) AABB containment; whoin uses radius query + AABB filter with capped output.
All persistence via TopgsPaths; SaveStore() called only after mutating config/state.

Built for Vintage Story servers powered by TOPGS Patches.

1.0.3

1.20.12

429

Aug 7th at 10:55 PM

Show

topgsPatches_VS1.20.12_v1.0.3.zip

1-click install

Removed: Stackable attribute from modded bushes. (only need the vanilla smallberrybush to be patched)
Fixed: JSON patch loader errors from comment blocks. Patch files are now strict JSON (no /* */ / //).
Fixed: Dispose() NullReferenceException when server API wasn’t initialized. Now guards sapi != null, unregisters the tick listener, and detaches PlayerJoin safely. (minor bug, didn't break anything)

1.0.2

1.20.12

Aug 7th at 8:03 AM

Show

topgsPatches_VS1.20.12_v1.0.2.zip

1-click install

- Fixed: Some modded bushes not able to be placed or stacked due to added stackable patch

1.0.1

1.20.12

Aug 6th at 7:41 PM

Show

topgsPatches_VS1.20.12_v1.0.1.zip