CarriageTracker
Carriages on the map for everyone, chat announcements when they set out, and automatic carriage starts in every act where players are online.
| Date uploaded | a week ago |
| Version | 1.0.21 |
| Download link | Bazarov-CarriageTracker-1.0.21.zip |
| Downloads | 42 |
| Dependency string | Bazarov-CarriageTracker-1.0.21 |
This mod requires the following mods to function
BepInEx-BepInExPack_V_Rising
BepInEx pack for V Rising. Preconfigured and includes Unity Base DLLs.
Preferred version: 1.733.2deca-VampireCommandFramework
Command framework for developers to easily create universal commands for their plugins.
Preferred version: 0.10.4README
CarriageTracker
Server-side mod for V Rising that turns carriages into something players actually find and fight over.
- On the map for everyone. Every carriage on the road gets a map icon that all players see on the whole map, without discovering the area first. So do carriages that stopped mid-route because nobody is near, and the loot left after a robbed carriage.
- Announced in chat. When a carriage sets out, players get a short message in their own language: which carriage, its act, how far and in which direction it is from them, and a command that puts a marker on it.
- Started where players are. In the base game a carriage only spawns when someone happens to pass its route. The mod starts carriages itself in every act that has players online, a few at a time, so there is always something to hunt.
- Loot that waits. The container of a robbed carriage stays 10 minutes instead of the game's 60 seconds, so a robber who died in the fight can come back for it.
Players don't install anything. Messages are in English and Russian, each player picks their own.
Installation
With a mod manager (r2modman, Thunderstore Mod Manager): pick your V Rising dedicated server profile, search for CarriageTracker, install. BepInExPack V Rising and VampireCommandFramework come with it.
By hand:
- Install BepInExPack V Rising on the server and put VampireCommandFramework into
BepInEx/plugins/. - Download
CarriageTracker.dllfrom the latest release and put it intoBepInEx/plugins/CarriageTracker/. - Start the server. The settings file
BepInEx/config/CarriageTracker.cfgis created on the first start.
The server log should then have CarriageTracker <version> loaded and, at the first check, game check passed. Works on a dedicated server; it isn't made for Host & Play.
How it plays out of the box
With the defaults nothing has to be set up:
- every 20 minutes, in each act where someone is online, the mod starts a carriage on a free route of that act (at most 2 per act and 6 on the server at once);
- every online player gets the announcement;
- the game keeps spawning carriages the vanilla way too, next to players.
The first start in each act comes one interval after the server starts (and after .cv auto <minutes> or .cv source), and only while someone is online. To see one at once, run .cv an as an admin. Admin commands need the game's admin rights: your SteamID in adminlist.txt and adminauth in the console.
The settings most servers change:
| Want | Setting |
|---|---|
| Carriages more or less often | IntervalMinutes (minutes between starts in one act) |
| Only the mod's carriages, none from the game | Source = Mod |
| Announcements only for the players a carriage is meant for | AnnounceTo = SameAct, or Nearby with AnnounceRadius |
| Acts by character level (Bloodcraft) instead of V Blood | PlayerAct = Level or Highest |
| A route never started by the mod | ExcludedRoutes, e.g. BanditPrisoners,ChurchLegion |
The interval, the source, the icon and the icon mode can also be changed in game, see the admin commands; the rest is read at server start.
Commands
For everyone:
| Command | What it does |
|---|---|
.cv l |
Carriages on the map, nearest first, with distance, direction and state |
.cv m [number] |
Map marker on a carriage from .cv l, the nearest by default |
.cv r |
All routes with region, level, act and state |
.cv rm <number> |
Map marker on a route from .cv r |
.cv a |
Your act, how it was found, and the routes you get |
.cv lang <en or ru> |
Your language of the mod's messages |
For admins:
| Command | What it does |
|---|---|
.cv start <number> |
Start a carriage on a route from .cv r right now |
.cv ss |
How the carriages started by the mod are doing |
.cv stop |
Stop looking after started carriages and give their routes the normal settings back (auto-start goes on; .cv auto 0 turns it off) |
.cv auto [minutes] |
Auto-start status; a number sets the interval, 0 turns it off |
.cv an |
Run auto-start now, ignoring the interval |
.cv source [mod, game or both] |
Who starts carriages; without a value shows it |
.cv icon <name or number> |
The map icon: merchant, unknown, vblood or a number from .cv icons |
.cv icons [filter] [page] |
The game's map icons with their numbers |
.cv mode <direct or proxy> |
Icon on the carriage itself, or on a separate marker that follows it |
.cv stats, .cv refresh |
Results of the last check, or a check right now |
.cv cleanup |
Before removing the mod, see Uninstalling |
.cv is short for .carriage.
Acts and routes
Acts are those of the game's V Blood menu (K).
- A player's act is by default the highest act of the V Blood they have drunk. The strongest V Blood of an act opens the next one at once: Quincey opens Act II, Octavian Act III, Cyril Act IV. With
PlayerAct = Levelit goes by character level instead (Bloodcraft's level when its leveling is on, otherwise gear level): up to 39 Act I, 40-59 Act II, 60-65 Act III, 66 and up Act IV.Highesttakes the higher of the two. - A route's act is the act of its region: Farbane I, Dunley II, Silverlight and Oakveil IV. A route the mod doesn't know (one a game update adds) gets its act from its guards' level.
- Act III has no carriages in the game (none in Gloomrot or the Cursed Forest). Players in Act III get the next act up by default (
EmptyAct = Higher);Lowergives the act below,Bothone of each. RouteActsassigns acts by hand, to a route or a whole region, one act or several joined by+:Silverlight=3+4gives Silverlight carriages to Act III and IV players.
| Region | Routes (keys as the game spells them) |
|---|---|
Farbane |
BanditAnimal (creature prison), BanditCopper, BanditPrisoners (villager prison), BanditPlank, BanditSulfur |
Dunley |
MilitiaCotton (two routes, east and west), MilitiaIron, MilitiaQuartz, ChurchLegion (Draculin prison) |
Silverlight |
ChuchSilver, ChurchMutants (mutant prison), ChuchGrape |
Oakveil |
BlackfangBastion (emery), BlackfangSouth (venom sap and oak) |
The Draculin prison carriage counts as Act II, as Dunley's hard one, even though its guards are the Silverlight church units. The two Oakveil routes have no end: their carriage circles until it is destroyed.
Configuration
BepInEx/config/CarriageTracker.cfg:
| Section | Setting | Default | Meaning |
|---|---|---|---|
| General | Language | en |
en or ru, for players who haven't picked their own |
| Map | Icon | merchant |
merchant, unknown, vblood or a map icon number (.cv icons) |
| Map | OldIcons | empty | Kept by .cv icon: icons used before, so their leftovers are removed. No need to edit |
| Map | GlobalIcons | true |
Icons visible to everyone on the whole map |
| Map | IconMode | direct |
direct (icon on the carriage) or proxy (on a separate marker) |
| Map | IconOnLoot | true |
Icon on the loot of a robbed carriage, while it has loot |
| Map | LootKeepMinutes | 10 |
How long that loot stays; 0 = the game's timers |
| Map | IconOnFrozen | true |
Icon on a carriage that stopped mid-route because nobody is near |
| Chat | Announce | true |
Announce carriages that set out |
| Chat | AnnounceTo | All |
All, SameAct (players who get that act's carriages) or Nearby |
| Chat | AnnounceRadius | 1500 |
Meters, for Nearby |
| Chat | AnnounceVanilla | true |
Also announce carriages the game spawned; false = only the mod's |
| Chat | RouteCommandsForAll | true |
.cv r and .cv rm for everyone; false = admins only |
| Chat | ShowOthersActs | true |
.cv a also lists every online player's act; false = admins only (on PvP servers it tells who is how far) |
| Chat | Welcome | true |
A line to a player entering the world: what the mod does and how to pick the language. A player who hasn't picked one gets it in English and in Russian |
| Chat | WelcomeEn, WelcomeRu | empty | Your own welcome lines; color tags work, about 450 bytes (a Russian letter is 2) |
| Chat | TitleColor, TextColor, CommandColor | #FFC83C, #FFFFFF, #7CFC7C |
Announcement colors, as #RRGGBB (names like yellow are ignored) |
| AutoStart | Source | Both |
Mod = only the mod starts carriages, the game no longer spawns them near players; Game = only the game; Both |
| AutoStart | IntervalMinutes | 20 |
Minutes between two starts in one act; 0 = auto-start off |
| AutoStart | Scope | AllOnlineActs |
AllOnlineActs, or Leader: only the act of the most advanced player online |
| AutoStart | MaxPerAct | 2 |
Carriages of the mod on the road at once in one act |
| AutoStart | MaxTotal | 6 |
The same for the whole server |
| AutoStart | RoutePick | Random |
Random (a free route, not the one started last) or Rotate (the one started longest ago) |
| AutoStart | ExcludedRoutes | empty | Routes the mod never starts |
| AutoStart | RouteActs | empty | Acts by hand, e.g. Silverlight=3+4,MilitiaIron=2; a route's own entry wins over its region's |
| AutoStart | PlayerAct | VBlood |
VBlood, Level or Highest |
| AutoStart | EmptyAct | Higher |
For players in an act without routes: Higher, Lower or Both |
| Start | SpawnTimeoutMinutes | 5 |
How long to wait for a started squad to appear |
| Start | ResetToStart | true |
A route left mid-way is put back to its first stop before a start |
| Start | MaxRunMinutes | 90 |
How long a started carriage is looked after |
| Start | MaxSquadSize | 20 |
Safety limit for a started squad |
| Timing | CheckSeconds | 30 |
How often carriages are searched |
| Timing | SafetyScanMinutes | 30 |
How often the whole world is searched as a safety net; 0 = off |
| Debug | VerboseLog | false |
Every check and every step of a start in the log |
| Debug | EnableDiagnostics | false |
Developer commands .cvdiag |
The limits count only carriages auto-start started that still have their cart; .cv start and the game's own carriages don't count. With Source = Mod and IntervalMinutes = 0 there are no carriages at all; the log warns about it. Each player's language is kept in BepInEx/config/CarriageTracker.languages.txt.
Edit the file while the server is stopped: admin commands that change a setting (.cv auto, .cv source, .cv icon, .cv mode) write the whole file back.
Compatibility
Runs without errors on the author's server together with these mods (acts there are counted by V Blood, the default PlayerAct):
| Mod | Version |
|---|---|
| AutoCloseDoors | 3.1.0 |
| BetterMissions | 2.2.0 |
| Bloodcraft | 1.13.26 |
| CoffinSleep | 2.0.4 |
| FasterCastleMovement | 1.0.0 |
| Faust | 0.16.5 |
| HookDOTS.API | 1.1.1 |
| KeepInventory | 1.0.0 |
| KindredCommands | 2.5.8 |
| KindredLogistics | 1.6.1 |
| KindredPortals | 1.1.3 |
| KindredSchematics | 1.5.6 |
| NightBloom | 1.0.0 |
| ScarletBrazier | 1.0.1 |
| ScarletCore | 1.3.11 |
| ScarletTrash | 1.0.1 |
| ServantForge | 0.1.10 |
| VampireCommandFramework | 0.11.0 |
Bloodcraft is not required. If you set PlayerAct = Level or Highest and Bloodcraft's leveling is on, the character level the mod reads is Bloodcraft's level; without it, the gear level.
With KindredPortals installed, icons of stopped carriages (and of all carriages with IconMode = proxy) are visible to everyone even with GlobalIcons = false: KindredPortals makes every icon on a marker object global, and those icons hang on such markers.
At the first check after the server starts, the mod checks every game field it relies on. If a game update has changed one it can't do without, the log says which, and starting carriages and Source = Mod are turned off while tracking, icons and announcements go on. If a less important one is missing, routes aren't put back to their first stop and stop numbers may be unknown.
Good to know
- The game has no carriage map icon, and a server mod can't send new pictures to players, so the icon is one of the game's own. Pick one with
.cv icon. - A route carries one carriage at a time. When the cart is destroyed, the animal and what is left of the squad walk on to the end of the route; until then that route is busy.
- A started carriage keeps going if everybody logs off (the mod looks after it up to
MaxRunMinutes) and is removed at the end of its route, as usual. - An Oakveil carriage that nobody robs keeps circling, as in the base game, and its route stays busy until it is destroyed.
Uninstalling
While it runs, the mod changes some route settings in the world (with Source = Mod it blocks the game's own spawning), and the save keeps them. Before removing it:
- Run
.cv cleanupin chat as an admin. It stops started carriages, gives every route the game's settings back and removes the mod's icons. - Stop the server the normal way, so the world is saved, delete
BepInEx/plugins/CarriageTracker, start the server.
Without the cleanup, routes blocked by Source = Mod would stay without carriages from the game, a route caught in the middle of a start could keep its start settings, and the mod's icons would stay on the map.
Problems and ideas
GitHub issues. The server log lines starting with CarriageTracker help a lot.
For developers
dotnet build -c Release builds the DLL and the Thunderstore package (dist/); reference assemblies come from NuGet. dotnet run --project tests runs the tests of the decision logic. The version lives only in CarriageTracker.csproj. A new version merged into main is released on GitHub and Thunderstore by GitHub Actions. How the mod works inside is in ARCHITECTURE.md.
Credits
- Making map icons global follows KindredPortals by odjit.
- Removing buffs follows KindredCommands and Bloodcraft.
- Acts follow the V Blood list; routes and regions follow the Carriage wiki page.
License: MIT.
По-русски
Серверный мод для V Rising: караваны (повозки) становятся тем, что игроки находят и за что дерутся.
- Видны на карте всем. У каждой повозки в пути есть значок на карте, его видят все игроки на всей карте, даже в неоткрытых местах. Так же отмечены повозки, остановившиеся посреди пути, потому что рядом никого нет, и добыча с разбитой повозки.
- Анонс в чате. Когда повозка выезжает, игрокам приходит сообщение на их языке: какой караван и какого акта, где он от игрока и команда, которая ставит на него метку.
- Запуск там, где игроки. В обычной игре повозка появляется, только если кто-то случайно проходит мимо маршрута. Мод сам запускает караваны в каждом акте, где есть игроки онлайн.
- Добыча ждёт. Сундук разбитой повозки стоит 10 минут вместо 60 секунд в игре, так что погибший в бою может за ним вернуться.
Игрокам ничего ставить не нужно.
Установка. Мод для выделенного сервера. Через r2modman или Thunderstore Mod Manager: найди CarriageTracker в профиле выделенного сервера и установи, зависимости поставятся сами. Вручную: нужны BepInExPack V Rising и VampireCommandFramework, а CarriageTracker.dll из последнего релиза кладётся в BepInEx/plugins/CarriageTracker/ на сервере. Настройки появятся в BepInEx/config/CarriageTracker.cfg после первого запуска.
Команды для всех.
| Команда | Что делает |
|---|---|
.cv l |
Повозки на карте, ближние первыми |
.cv m [номер] |
Метка на повозке, по умолчанию на ближней |
.cv r |
Все маршруты с регионом, уровнем, актом и состоянием |
.cv rm <номер> |
Метка на маршруте из .cv r |
.cv a |
Твой акт и маршруты, которые тебе достаются |
.cv lang <ru или en> |
Язык сообщений мода для тебя |
Команды админа, настройки и подробности про акты описаны выше, в английской части. Коротко: по умолчанию каждые 20 минут в каждом акте с игроками онлайн выходит караван; первый — через один интервал (по умолчанию 20 минут) после запуска сервера, сразу можно запустить командой админа .cv an. Акт игрока считается по выпитым V Blood, акт маршрута — по региону (Farbane I, Dunley II, Silverlight и Oakveil IV). Игроки III акта, где в игре повозок нет, получают караваны IV акта.
Удаление. Сначала выполни в чате .cv cleanup (админ): мод вернёт маршрутам настройки игры и уберёт свои значки. Потом останови сервер обычным способом, чтобы мир сохранился, удали BepInEx/plugins/CarriageTracker и запусти сервер. Без этого маршруты, заблокированные при Source = Mod, останутся без караванов игры, а значки мода — на карте.
Ошибки и идеи: GitHub issues.
CHANGELOG
Changelog
1.0.25
The memory watch says more. On 14.11 it caught the jump (game heap 67 to 1393 MB in 40 seconds, no new objects in the world, nothing in the log, the mod's own work 3 ms) before the server was killed, but not who took the memory. Nothing changes for players.
- The first 6 lines of an incident are written at every 10-second sample (before: one per 30 seconds, so only two lines made it).
- New in each line: how many times the game's collector ran in the interval and its mode; Unity's own numbers (native memory, the collector's heap); players online; the newest save file with its size and age, if the saves are in
save-data/Savesunder the server folder (a save being written at that moment shows); the longest time between two server frames. - Once per incident, at a line written with the game heap 300 MB over its quiet size, the watch runs one full collection and writes how much it freed. Freed: the memory was garbage made faster than the game collects it. Not freed by that one collection: most likely something holds it, but that answer is the weaker one. If the collector didn't run at all, the line says so. This is the only thing the watch does besides reporting.
1.0.24
A memory watch, after the server was killed for memory twice on 12.11 with nobody online (the cause isn't known yet), and developer commands that try out what the mod's own caravans will need. Nothing changes for players.
- Memory watch. Every 10 seconds the mod looks at the game heap, the process's memory and how many lines the game and all plugins wrote to the log. When the heap grows by 50 MB within a minute, the process by 100 MB within 10 seconds or 300 MB within a minute, or the log gets 500 lines in 10 seconds, it writes one line at once: memory now and before, how many objects the world holds compared with a quiet moment, who wrote to the log and the first warning or error of each, how many frames the server made and how long the mod's own work took. The line also goes to
BepInEx/CarriageTracker-memory.txt, which is written through right away, so it is still there after the server was killed. At most one line per 30 seconds and 20 per incident (an incident ends after 10 quiet minutes or an hour; the game heap is counted apart from the rest); nothing in the first 5 minutes after the world is loaded; the file stops at 1 MB with one warning. The watch only reports: it doesn't find the cause by itself and doesn't stop anything. - The 10-minute memory line also shows how many objects the world holds (all, from prefabs, networked).
- New developer commands (
EnableDiagnostics = true), not tried on a server before this release:.cvdiag trial <route number> [boss prefab or -] [ally,elite,stops=<route number>,keeptag]starts one trial caravan as a copy of a route's patrol, optionally with a strong unit (a Blood Soul,CHAR_..._GateBoss_Minor) in place of the first guard and with another route's stops..cvdiag trialloot <item prefab or clear> [amount]sets what replaces the loot of its container,.cvdiag trialinfotells what happened to it,.cvdiag trialcleanremoves it whole,.cvdiag trialfindwrites every carriage patrol to a file. If the game kept a copy in its save (more than its 15 carriage routes after a restart; the log warns),.cvdiag trialclean <index:version>removes the patrol named, nothing is removed by guessing..cv cleanupand unloading the mod remove the trial caravan too. Players see it like any started caravan (announcement, map icon,.cv l), so it is best tried while nobody else is online; it is not in.cv r, and auto-start andSourcedon't touch it..cvdiag stopswrites every stop of every patrol route with the 160 m square of the map it is in, and the exact place where a patrol was seen standing at it.
1.0.23
Tools for finding out how the game builds routes and squads (for the mod's own caravans later), and one fix found with them. Nothing changes for players.
- The values the mod writes back as a route's normal ones (spawn range, respawn timers) are now learned from the game: the range from the game's other patrols, which the mod never touches (all 189 had 90 m on 12.11), the respawn timers from what most carriage routes have. Since 1.0.19 they were meant to come from the route's prefab, but a route has no prefab (patrol dump of 12.11), so the mod's constants (90 m, 1000-2700 s) were used every time without a word in the log. The constants still stand in until both are learned; the log says once what was learned, or that it wasn't yet.
.cvdiag dumpreads buffers element by element. Before, a buffer (a patrol's stops, squad and groups) was read as one value and the file showed made-up numbers for it..cvdiag patrolswrites whole squads (up to 40 units, 10 groups, 30 active units; before 12, 6 and 6).- New developer commands (
EnableDiagnostics = true):.cvdiag prefabs <text> [full]writes every game prefab whose name contains the text, with its number, unit level and the components that tell what it is; withfullthe first 60 with all their data (drop tables, squads)..cvdiag types <text> [objects per type]writes every game component type whose name contains the text, how many objects have it and, for each object, where it is and what the component holds (BusStop: the stops of patrol routes). Both need at least 3 letters and stop at a fixed size (8000 prefabs; 60 types, 30000 lines). They read game data in ways the mod doesn't use elsewhere, so they are best run while nobody is in a fight.
1.0.22
Fixes from a code review of 11.11.
.cv l,.cv m,.cv stats, start replies and the last results in.cv autoare now always in the reader's language. Before, the caravan notes and stats were made at the check in the language of whoever caused it (usually the server's), so a player could get a line half in their language, half in another.- The two MilitiaCotton patrols keep their numbers: routes with the same key are ordered west to east (where their patrols stand at that moment, about 600 m apart). Before, their order could change between
.cv routesand.cv start Nwhen freeze tags came and went, so a start could take the other Cotton. - A route whose settings couldn't be given back after a start is repaired first when it is started next, and not started if that fails; auto-start skips it for an hour. A start of a route that still has a start's spawn range or zero respawn timers saves the route's normal values instead, so they can't stay for good.
- A failing announcement no longer stops the check (before, the same caravan was announced again every 30 seconds), and
.cv stop/.cv cleanupfinish every start even if one of them fails. .cv langsays when the choice couldn't be saved to the file yet. A wrongIconin the config is warned about once, not at every check.
1.0.21
After the architecture and memory audit of 07.11 (Nikolai). No change to what players see; the server log and the memory line say more, and the mod makes less garbage.
- Objects the mod hands to the game's destroy pipeline and the game doesn't remove are no longer invisible. The memory line shows how many are waiting, how many are older than a minute and how many were given up. One still there after 5 minutes is destroyed once more; one still there after 10 minutes is given up with one warning for all such objects of that check (before: one warning per object, then it was counted nowhere).
- The memory line shows why icons and markers were removed since the last line (
moved,unwanted,gone,kind,duplicate), so it is clear how many network objects the mod makes and removes and what for. The icon count no longer includes the game's own merchant icons on its markers. - The server world, the prefab system, component types and the entity queries of every check are looked up once and kept instead of being made again on every check (and every frame while a start runs). This removes a steady stream of IL2CPP wrappers that only the .NET finalizer frees and that made the game heap on the memory graph look like a slow leak.
- The decisions about icons and markers (which to keep, which to remove and why, which markers are the mod's, when a marker is made anew, when a destroyed object is tried again) moved to
Logic/IconLogic.csand are covered by 18 new tests (two of them check every combination against the 1.0.20 conditions) built on the cases of 02.11, 05.11 and 07.11. - A marker removed by someone else (the game, another mod, an admin) is forgotten by the mod at the next check.
- An error that repeats is written in full once per 10 minutes; the repeats in between are counted and the count goes into the next full line and the memory line. Before, an error at every check wrote a full stack trace every 30 seconds.
- Failing to write a spawner field a start can't be undone without (spawn range, respawn timers) stops that write instead of writing back a half-changed spawner.
Source = Modand.cv cleanupgo on with the other routes when one route fails. - New developer commands (
EnableDiagnostics = true):.cvdiag markerslists every map marker of the kind the mod uses, grouped by what spawned it, its icon and whether the mod takes it as its own, and every icon of the mod's kinds grouped by what it hangs on, to check that the mod never takes a game merchant marker for its own..cvdiag movemarkermoves the nearest of the mod's markers to you, to check whether a moved marker shows in the new place on the map (then markers could be moved instead of made anew).
1.0.20
- README rewritten for server owners installing the mod for the first time: what it does, installation with a mod manager or by hand, what the defaults do and which settings to change, commands, acts and routes, every setting, compatibility, uninstalling.
- The second announcement line names the direction first (
North-west, 234 m.) and uses the color namewhiteinstead of#FFFFFFfor the default text color. On 07.11 a player's chat filter maskedFFFFFF>234of<color=#FFFFFF>234 m, and the broken tag showed up as text. - A loot container the mod kept longer is removed about 60 seconds after it is emptied (plus up to one check), as the game would have it. Until now an empty container stayed for the whole
LootKeepMinutes.
1.0.19
After an outside code audit (07.11):
- A start that fails midway no longer leaves its route broken. A start removes the old squad and writes the start settings into the route step by step; an error in between used to leave the route with an endless spawn range and zero respawn timers until the server restarted. Now the route gets its normal settings back at once (if that fails too, every 5 seconds), auto-start skips it for an hour, and the player sees that the start failed. Auto-start also counts a start only when it really happened (before, a refused start still counted as this act's start).
- The values the mod writes back as a route's normal ones (spawn range, respawn timers) come from the route's own prefab. The mod's constants (90 m, 1000-2700 s) are used only when the prefab's values can't be read or look wrong, with a warning. A game update that changes the normal values no longer gets the old ones written back.
- At the first check after the server start the mod checks every game field and type it uses by name. If one that a start can't be undone without is missing (after a game update), starting caravans and
Source = Modare turned off with one clear error in the log, and routes blocked bySource = Modare opened again so the game spawns its caravans; tracking, icons and announcements go on. Before, such a field only gave a warning and the mod went on working halfway. - Icons on carriages are removed through the game's destroy pipeline with the same list as map markers (1.0.17), so an icon queued for removal isn't counted or removed again on the next check.
- Chat messages longer than a chat line holds (509 bytes; a Russian letter is 2) are cut on a whole character and not inside a color tag, with a warning in the log. Before, a long welcome line from the config could be cut inside a tag.
- New setting
Chat.ShowOthersActs(defaulttrue, as before):.cv actlists the act of every player online;falseshows that list only to admins, for PvP servers. - GitHub Actions are pinned by commit SHA, and
tools/deploy.shpins the .NET SDK image by digest like the git image. The README says why the mod targets .NET 6 and that it is out of support.
1.0.18
Follow-up to 1.0.17 after a second independent review (no blocking issues found):
- The sweep of stale icons (icons left on a map marker that no longer exists) removes only the mod's own icon kind: the current
IconandOldIcons. In 1.0.17 it also took the named presets (merchant, unknown, vblood) that the mod wasn't using. - An object the mod handed to the game's destroy pipeline stays skipped until the game has actually removed it (in 1.0.17: for 10 seconds). One the game still hasn't removed a minute later is written to the log once.
- Comments and ARCHITECTURE.md say where icons on markers are touched (only the sweep), and that in
Mode = proxya moving carriage's marker is still made anew at nearly every check, without the leak.
1.0.17
- Fixed rows of stale carriage icons on the map and a memory leak behind them. The icon of a frozen carriage hangs on a separate map marker, which the mod made anew whenever the carriage's route had moved 10 m, so almost at every check. The old markers and their icons were destroyed with
EntityManager.DestroyEntity, past the game's destroy pipeline: players kept seeing the old icons, and the game's records of these networked objects stayed in the server's memory. On 05.11 the server was killed for memory (6.3 GB limit). Now:- markers and their icons are destroyed through the game's
DestroyUtility, as units and carts already were; - a frozen carriage's marker is made anew only after 100 m and at most every 3 minutes (a moving one's in
Mode = proxyafter 30 m); - at every check, icons of the mod's kinds left on a marker that no longer exists are removed, also those left by earlier versions;
- a marker whose icon request the game has emptied is still recognised as the mod's after a restart.
- markers and their icons are destroyed through the game's
- Once every 10 minutes the log has a line
CarriageTracker memory:with the server process's memory, the game's and the plugins' heaps, and the mod's icons and markers: how many exist and how many were made and removed since the previous line. It shows whether memory grows with the mod's work or apart from it. - Reviewed for other leaks (every query and native array, static collections, event entities, per-frame code): none found.
1.0.16
- Removed the setting
Start.AnimalKeepsDamage(1.0.14) and its code. The game heals the animal to full every second while it is hitched to its cart, the mod set it back once a second, and in game its health bar jumped up and down all the time, which looked like a bug. The animal now heals as in the game. The spawn buff fix of 1.0.11 stays: the animal takes damage. The lineAnimalKeepsDamageleft in an existing config file does nothing. - Every loot container of a carriage on the map is written to the log when it appears (empty or with loot, and when the game would remove it), when it is emptied and when it is gone, with how long it stood. On 05.11 a robbed carriage left no line about its container at all.
1.0.15
- Fixed a doubled carriage. Players attacked a started squad before it had finished coming out, and with the start's zero respawn timers the game sent 126 replacement units in 54 seconds, among them a second animal with its own cart. The mod removed the units but not that cart, so a second cart stood on the road. Now the route gets its own timers back as soon as a member of the squad is killed, and a cart of a removed unit is removed with it.
- The loot container of a robbed carriage stays 10 minutes after it appeared while it still has loot (new setting
Map.LootKeepMinutes, 0 = the game's own timers). The game removes it 60 seconds after nobody is within 20 m and 60 seconds after something was taken (read with.cvdiag compson 04.11), so a robber who died lost it. - The log of
AnimalKeepsDamagetells only big heals (5% of the animal's health or more at once) and counts its regeneration (about 1 point a second) in the line of the finished run. Before, its first five lines all went to regeneration ticks. tools/deploy.shstops at once with a clear message when the server path has noBepInEx/core. A mistyped path made Docker create empty folders there and the build fail with hundreds of errors.
1.0.14
- The animal of a carriage started by the mod no longer heals. In a fight it breaks off from its cart, comes back, hitches up again and got full health from the game; now its health is set back to the lowest it had. New setting
Start.AnimalKeepsDamage, on by default. The log tells each time (the first five per carriage) and whether the animal was hitched to its cart at that moment.
1.0.13
.cvdiag compsalso shows the values of the components that remove an object by time (DestroyAfterDurationand its kin,LifeTime), in chat and in the server log. A loot container vanished about a minute after its cart was destroyed while no player was near (03.11); its timers come next.
1.0.12
- A route's act is now its region's (Farbane I, Dunley II, Silverlight and Oakveil IV) instead of its guards' level. The Draculin prison carriage of Dunley (
ChurchLegion, vampires guarded by the Church of Luminance) is an act II carriage now; by its guards' level it landed outside act II, with the Silverlight routes (in the 1.0.10 log act II had only the four militia routes). A route of an unknown region still goes by its guards' level.
1.0.11
- The mod is now called CarriageTracker, after the game's own name for caravans:
CarriageTracker.dllinBepInEx/plugins/CarriageTracker/, pluginCarriageTracker, repository Bazarov888/CarriageTracker.Bazarov.CaravanTracker.cfgand the players' languages file move to the new names on the first start. While the oldCaravanTracker.dllis still installed, the new mod writes an error to the log and does nothing;tools/deploy.shremoves the old folder. Commands stay.cv. English chat says "carriage". - Fixed the animal of a carriage that took no damage, also after its cart was destroyed. It happened to squads of routes woken at their last stop: the game's spawn buff
Buff_General_Spawn_Unitstayed on the animal. Such a buff still on a unit or cart of a start 10 seconds after it appeared is now removed, and the log says so. - A player's act moves on as soon as the strongest V Blood of their act is drunk (Quincey, Octavian, Cyril). Before, a player who had beaten act II still got act II carriages until they drank an act III V Blood.
- Act III has no carriages in the game (none in Gloomrot and the Cursed Forest). A player in an act without routes now gets the next act up, so act III players get the Silverlight and Oakveil carriages. New setting
EmptyAct:Higher(default),Lower(as before) orBoth. - New setting
PlayerAct:VBlood(default),Level(by the character's level; with Bloodcraft leveling that is the Bloodcraft level) orHighest. RouteActstakes regions (Farbane,Dunley,Silverlight,Oakveil) and several acts per entry, e.g.Silverlight=3+4,Oakveil=4..cv rshows each route's region;.cv ashows how the act was found and which routes you get.- Route names follow the wiki: Venom Blades emery and venom sap routes, the Draculin prison carriage; the two
MilitiaCottonroutes are told apart as east and west. - The two Oakveil routes have no end: they are no longer put back to the start and count as ready when a route is picked. The mod stops looking after a carriage there when its cart is destroyed, so what is left can freeze once nobody is near and the route is free again; before, the mod kept it awake and the route busy for up to
MaxRunMinutes. - A route woken at its last stop that doesn't go back to its first stop within 20 seconds is given up and skipped for an hour, instead of spawning its squad at the end of the route.
- A fight right at the start no longer removes the guards still on their way: a new unit after a loss is a replacement only once the squad has reached its size.
- Fixes from the code audit of 02.11:
- Markers of other mods (KindredPortals) are no longer removed; the mod touches only its own markers.
- The route's own settings count as restored only after they were written. A write that fails is tried again, also at the end of a start and at the server start.
- Unloading the mod at runtime stops its work and gives the world its settings back, as
.cv cleanupdoes. .cv land.cv mread the last check instead of running a search each time; they refresh it at most every 5 seconds.- With
GlobalIcons = falsenew markers no longer cause a search on every frame for 10 seconds. - The two
MilitiaCottonpatrols keep their own start history and failures. - A failed read of the languages file no longer loses the players' choices; the file is written through a temporary file and only when something changed.
- An object only the full search found stays in the list between full searches.
tools/deploy.shstops on local changes in the repository, prints the commit it installs and replaces the DLL in one step.
- Releases: a new version merged into
maingets a GitHub Release withCarriageTracker.dlland the Thunderstore package by itself. README's installation points there; the CI artifact, which needed a GitHub login, is no longer the way to get the mod.
1.0.10
- A route woken at its last stop now spawns its squad only after the game has finished removing the old one (spawner idle again) and the route has stood at its first stop for 3 seconds. In 1.0.8 the squad spawned one second after the reset: its animal took no damage, even after the cart was destroyed, and a squad that reached the end stayed there instead of being removed.
- An animal still immortal after its cart is lost is made mortal, so the rest of a robbed caravan can always be killed. The log says when this happens.
- A started squad that stands at the last stop for 2 minutes is removed by the mod (the game removes one there within seconds). Before, it stood there until
MaxRunMinutesand took a place in the auto-start limits. - The log shows the animal's state (immortal flag and buffs) when the squad is assembled and when its cart is lost, and the spawner state when a woken route is armed.
1.0.9
- Config descriptions of
RoutePickandResetToStartmatch how picking and putting back work since 1.0.8. - The Thunderstore package links to the GitHub repository.
- README and ARCHITECTURE brought up to date for review: installation before the Thunderstore release, what happens to a route whose squad was killed, facts seen in game on 01.11.
1.0.8
- A route standing at its last stop is now woken before its squad may spawn, so the game first returns it to its first stop and the caravan sets out from there. Before, the squad appeared at the end of the route. If the route doesn't go back within 20 seconds, the squad spawns where it stands, as before, and the log says so.
- Auto-start takes routes at their first stop and routes at their last stop as one group, and doesn't pick the route it started last while another one is free. Before, a route that had just finished stood at its first stop again and was picked over and over, while routes at their last stop waited.
- A caravan in a fight keeps its map icon even when its animal is more than 30 m from the cart. Before, the icon vanished during the attack and the log said "cart left without its animal".
- With
Source = Mod, routes standing at their last stop are blocked too, not only routes waiting for a new squad. A player walking near such a route wakes it, the game resets it and could spawn its own caravan before the next check. - The log tells how far from where the route stood the squad appeared. For a route put back to the start (
ResetToStart) it warns when the squad appeared where the route stood, i.e. the caravan first walks back to the first stop. - Each player picks their own language with
.cv lang enor.cv lang ru(no longer an admin command that switched it for everyone). Announcements, replies and start messages come in each player's language;Languagein the config is the default for players who haven't picked one. - A player who has just come into the world gets two lines, in English and Russian (or in their own language if they picked one): what the mod does and how to pick the language. Setting
Chat.Welcome, on by default;Chat.WelcomeEn/Chat.WelcomeRureplace the text with the server's own. - Long replies (
.cv sswith several started caravans,.cv auto,.cv a) are split into several lines. In Russian they could exceed the 512-byte chat limit and get cut or not arrive at all.
1.0.7
- Every decision of the mod (is a route free, which route to start, what to do with a started squad, why a caravan disappeared, what spawn range a route gets, what is announced) now lives in one place without game calls, and is covered by tests built from cases seen on the server. CI runs them before every build.
- The log no longer says "cart destroyed" about a caravan that reached the end of its route between two checks.
- Every log line of the mod starts with the server time. Start lines tell how many seconds the squad took to appear and to assemble, and how many minutes the run lasted.
- An auto-start log line tells which free routes there were (at the start, at the end, mid-way) and from which group the route was picked.
.cv ssno longer says "cart destroyed" twice.
1.0.6
.cv cleanup(admin): run it before removing the mod. It stops started caravans, gives every route the game's own spawn range, timers and freezing back, and removes the mod's icons and markers. Until the next restart the mod then changes nothing in the world.- With
Source = Mod, routes are checked for blocking every 5 seconds instead of everyCheckSeconds, so the game has less time to spawn its own caravan next to a player. - With
Source = ModandIntervalMinutes = 0no caravans appear at all; the server log at load and.cv autonow say so. - New setting
RouteCommandsForAll(section Chat, on by default):falsemakes.cv rand.cv rmadmin-only, since they show where every route is. - Map icons another mod puts on a caravan are no longer removed; the mod removes only icons of the kinds it uses.
- The version is written only in
CaravanTracker.csproj;MyPluginInfoand the Thunderstoremanifest.jsonare generated from it. tools/deploy.shcan't break whengit pullupdates the script itself, and runs a pinnedalpine/gitimage.- CI uses current versions of the GitHub actions.
- ARCHITECTURE.md describes how the mod works inside, for reviewers.
1.0.5
- Fixed a started caravan setting out without guards: the start settings now stay until the whole squad has appeared, not only the animal with the cart. With
Source = Modthe squad on the road also gets the game's normal spawn range back instead of the blocked one. - The server log tells how many units the squad of a started caravan has once it is assembled.
- With
Source = Mod, a route whose start has ended is blocked at once, so the game can't spawn its own caravan there before the next check. - A caravan is announced once: a cart that froze and woke up again, or was hidden for a moment, is no longer announced again.
- After a crash in the middle of a start, units and carts of the route get their freezing without players back on the next server start.
- An error in one started caravan no longer stops the others; a start that fails 10 times in a row is given up.
1.0.4
- Stops are shown the way players count them: "stop 1 of 7" at the start, "stop 7 of 7" at the last one.
.cv rtells apart a route whose cart was destroyed and only the animal walks on..cv rm <number>: map marker on the point of a route from.cv r.- A cart at the last stop of its route, or a cart left standing without its animal, is no longer listed or shown on the map.
- A start clears the respawn time the game scheduled after the previous squad was destroyed, so the new squad doesn't wait up to 45 minutes for it.
- The server log shows the
Sourcesetting at load and every change made with.cv source. - A route left mid-way by an earlier caravan is put back to the first stop of its path before the mod starts it, so the caravan drives the whole way. Setting
ResetToStart, on by default. - Auto-start takes routes at their last stop before routes left mid-way: the game returns those to the start by itself.
- A route whose start failed (no squad within
SpawnTimeoutMinutes) is skipped by auto-start for an hour. - The server log tells where the squad of a started caravan appeared, and warns if a route put back to the start set out from somewhere else.
1.0.2
- New setting
Sourceand command.cv source: caravans only from the mod (the game no longer spawns them when a player comes near a route), only from the game (auto-start off), or both. WithMod, a warning goes to the log if the game still spawns a caravan on a blocked route. - Auto-start prefers routes standing at the start of their path. A route left mid-way by an earlier caravan is used only when no route stands at the start, and then the one with the most stops left.
.cv l,.cv rand.cv ssshow how far along its path a caravan is..cv startsays when a route stands mid-way.- A started caravan whose cart is destroyed no longer counts in the auto-start limits; the horse still walks to the end of the route, where the game removes it.
- When a start ends by timeout or
.cv stop, units still alive may freeze without players again, as all units of the game do. - A robbed caravan's horse frozen mid-route no longer keeps its route busy for auto-start.
- Safety limit
MaxSquadSize: extra units of a squad started by the mod are removed at once. - New settings:
IconOnLoot,IconOnFrozen,AnnounceTo,AnnounceRadius,AnnounceVanilla,RoutePick,ExcludedRoutes,SpawnTimeoutMinutes,MaxRunMinutes,MaxSquadSize,VerboseLog. - The server log records every caravan that disappears from the map, with its last state and what its route is doing, and lists the caravans found at server start. Routine lines moved behind
VerboseLog. - The route list is kept between checks instead of being collected from the world every time;
RouteActsis parsed only when it changes.
1.0.1
- Fixed killed guards of a started caravan coming back over and over, which made the server run out of memory: replacements are removed, and the respawn time computed during the start is cleared.
- Routes left with start settings after a crash get their normal settings back on server start.
- A started caravan is checked once a second instead of every frame.
- Starting a route that stands at its last stop no longer ends right away: the mod waits until the game clears the old squad and returns the route to the start.
- A cart standing at the last stop of its route is no longer announced as setting out.
- Removed the horse icon preset: the game shows that icon only to the owner of the mount.
1.0.0
First public release.
- Caravans, frozen caravans and loot containers on the map, visible to every player on the whole map.
- Two-line chat announcement with distance, direction and the marker command for each player.
- Auto-start by act: per-act interval, MaxPerAct and MaxTotal limits, AllOnlineActs or Leader scope.
- Player act by V Blood drunk, route act by guard level, manual override with RouteActs.
- English and Russian chat messages.
- Map icon presets: merchant, unknown, vblood, or any icon number.
- Developer commands moved behind EnableDiagnostics.