Skip to main content
How can we help?
Table of Contents
< All Topics
Print

00 – Visiting Villagers — Official Wiki

Welcome to the official documentation for Visiting Villagers! This mod for Minecraft 1.21.1 (Forge) transforms static villages into living, dynamic settlements, introducing temporary visitors with professions and visual variants, playful children, and rare biome travelers.

Overview

Visiting Villagers expands the Minecraft village experience through an organic population system. Once a village reaches the minimum development and safety criteria, new visitors begin arriving during the day to interact with residents, use workstations, and perform exclusive trades.

Key Features

  • 3 Visitor Categories: Profession-carrying adults (VisitorEntity), babies (BabyVisitorEntity), and rare wanderers (WanderingVisitorEntity).
  • Intelligent Village AI: Movement guided by points of interest, daytime routine, and automatic dispersion at dusk.
  • JSON Trade System: Independent buy and sell catalogs per variant, with support for dynamic item families (family), random lists (one_of), and Data Components.
  • TOML Spawn Configuration: Precise control over population limits, check intervals, and village conditions.
  • Real-Time Reload: Apply changes to trade files instantly via the /visitors reloadtrades command, without restarting the game or server.

📚 Wiki Index

Access the detailed guides through the links below:

01. Mechanics and Entities

  1. Entity types, visual variants, and AI behaviors.
  2. Mod items (spawn eggs and inspection tools) and the creative tab.
  3. Visitor life cycle and night dispersion rules.

02. Spawn Configuration Guide (TOML)

  • Minimum village requirements (number of residents and iron golems).
  • Detailed reference for the config/visitingvillagers-common.toml file.
  • Diagnostic checklist to troubleshoot spawning issues.

03. Trade Configuration Guide (JSON)

  • Structure of the config/visitingvillagers/trades/ folder.
  • Syntax for fixed items, dynamic families (family), and random selections.
  • Configuration of enchantments, potions, and Data Components.

04. Compatibility and Commands

  1. 🛠️ 04. Compatibility and Commands
    • Environment requirements (Minecraft 1.21.1, Forge 52.1.0, Java 21).
    • Administration command reference (/visitors check, /visitors population, etc.).
    • Validation and fallback system against syntax errors.

Quick Start

  • For Players: Install the mod on the client or server. Develop a village until it has at least 6 villagers and 1 iron golem. Visitors will begin spawning during the daytime period.
  • For Modpack Creators: Navigate to the config/visitingvillagers/ folder to adjust spawn rates in the TOML file or customize each profession’s trade catalogs in the JSON files.