Village Recruits Addon

Bug reports and feature requests. Minecraft 1.20.1 · Forge 47.x · an addon for the Recruits mod.

Report a bug Request a feature Browse open issues

Reporting requires a free GitHub account.

Search the existing issues first. Include closed ones — your problem may already be fixed in a newer build. A duplicate report with no version and no log is the one thing guaranteed not to lead to a fix.

Check these four things first

They account for most of what gets reported.

Update the addon to the latest version and try again.
Update Recruits and Villager Workers as well. Both are required, and both must be on their latest versions — Recruits 1.15.2 or newer, and Villager Workers 2.0.3 or newer. Running an older one produces bugs that look like they come from this addon, and those reports cannot be acted on.
Read the coloured status lines printed when you join a world — see below.
Run /vrversion and copy that exact string into your report.

The login status lines

Every time you join a world, the addon prints one coloured line for each optional mod it can integrate with. That line is usually the answer when a feature appears to be installed but does nothing at all.

Colour	Meaning
Green	Installed and working. Nothing to do.
Yellow	Installed but incomplete. The line names exactly what is missing — read it before reporting.
Red	Not installed. Those features are simply absent, which is not a bug.

The common yellow case is a gun mod without its Recruits compat mod. Soldiers will carry the guns and never fire them — that is the compat mod missing, not the addon misbehaving.

What makes a report usable

The exact version from /vrversion, e.g. 1.0.7.93TC-51. "Latest" is not a version.
Singleplayer or dedicated server, and whether other players were online.
Your full mod list, or at minimum every Recruits addon you have.
latest.log attached as a file — plus the crash report if it crashed. Please do not retype the error.
Steps to reproduce, written as a numbered list of what you actually did. "It broke" gives nothing to work from. "I found a village, waited one night, and the builder stopped placing blocks" can be tested and fixed.

Diagnostic commands worth pasting

Command	Tells you
`/vrversion`	Installed version, and whether a newer one exists
`/vrvillages`	Every known village, and whether it is online
`/vrcommanders`	Group, commander and soldier assignment
`/vrstock`	Materials and equipment a village has stockpiled
`/vrbuilddiag`	Why a village is or is not building

About this repository

This tracker is public so that anyone can file a report. The mod's source code is not hosted here and remains private; reporting a bug grants no right to redistribute, decompile or republish the mod or its assets.

Anything you post here is publicly visible, so check your log for anything you would rather not share — Windows logs contain your account name in file paths.