Multi Village Selector

Multi Village Selector (MVS)

Minecraft 1.21.1 | NeoForge & Fabric | MIT License

Multi Village Selector gives you control over village spawning in Minecraft. Instead of each village mod fighting for spawn slots, MVS intercepts village generation and selects from all your installed village mods using configurable weights.

The Problem MVS Solves

When you install multiple village mods (Cobblemon Additions, ChoiceTheorem's Overhauled Village, Towns & Towers, etc.), they compete for the same spawn locations. Some mods override others, some never spawn, and you have no control over the mix. MVS fixes this by:

• Intercepting vanilla village spawns before any mod processes them
• Selecting from all configured village structures using weighted random selection
• Respecting biome rules so desert villages spawn in deserts, snowy villages in snow, etc.
• Providing you control over village spawning and the mix/ratio of different village types

Download

• Modrinth: Multi Village Selector
• CurseForge: Multi Village Selector
• GitHub Releases: Latest Release

Requirements:

• Minecraft 1.21.1
• NeoForge 21.1.80+ or Fabric Loader 0.16.0+ with Fabric API
• Architectury API (required for both platforms)

Quick Start

1. Install MVS and Architectury API in your mods/ folder
2. Launch Minecraft and load a world
3. Run /mvs generate in-game to scan your installed mods
4. Review the generated config at local/mvs/multivillageselector.json5
5. Move the config to config/multivillageselector.json5
6. Restart Minecraft to apply changes

That's it! Villages from all your mods will now spawn with weighted representation -- but be sure to look over the weights, the generator makes some guesses and isn't perfect.

For detailed setup instructions, see the Getting Started Guide.

Configuration

MVS uses a JSON5 config file with four main sections:

{
  // Which structure sets MVS controls (usually just minecraft:villages)
  intercept_structure_sets: ["minecraft:villages"],

  // Your village structures with per-biome weights
  structure_pool: [
    { structure: "minecraft:village_plains", biomes: {"#minecraft:is_plains": 25} },
    { structure: "bca:village/default_mid", biomes: {"#bca:villages": 29} },  // Cobblemon Additions
    // ... more structures
  ],

  // Optional: Reduce spawn rate in specific biomes
  biome_frequency: {
    "#minecraft:is_ocean": 0.3,  // Only 30% of ocean spawn attempts proceed
  },

  // Optional: Control village density (vanilla defaults shown)
  placement: {
    "minecraft:villages": {
      spacing: 34,
      separation: 8,
    }
  }
}

See the Configuration Guide for complete documentation.

Commands

/mvs generate              # Scan mods and generate config
/mvs biome                 # Show current biome info
/mvs locate <structure>    # Find nearest structure with teleport links
/mvs structure biomes <id> # Show biome rules for a structure
/mvs structure pool        # List structures in MVS config pool
/mvs structure list        # Dump all game structures to file
/mvs structure nearby      # List structures near player
/mvs structure predict     # Predict what would spawn at current location
/mvs help                  # Show all commands

See the Commands Reference for full documentation.

Supported Mods

MVS works with mods that add new villages to structure sets:

• Vanilla Minecraft - All 5 village types
• Cobblemon Additions (BCA) - Cobblemon-themed villages
• ChoiceTheorem's Overhauled Village (CTOV)
• Towns & Towers
• Terralith
• And many more…

Some mods require disabling their own village spawning. See Mod Compatibility for setup instructions.

Tested Compatible Mods

These mods have been tested alongside MVS without issues:

• C2ME - Concurrent chunk generation works fine with MVS
• Explorer's Compass - Structure location still works
• Nature's Compass - Biome location still works
• Chunky - Pre-generation works correctly with MVS structures

What MVS Cannot Control

MVS intercepts structure selection, not jigsaw piece assembly. Mods that replace individual village pieces (buildings, paths) rather than adding whole village structures work differently:

• Better Villages - Replaces vanilla village jigsaw pieces
• Luki's Grand Capitals - Replaces/extends vanilla village pieces

These mods will still apply their changes to whatever village MVS selects, usually the vanilla villages. This is usually fine if you only use one - MVS picks which village type spawns, then the jigsaw replacer modifies its buildings. But MVS doesn't help you with fighting between those types of mods.

Documentation

Guide	Description
Getting Started	Installation and first-time setup
Configuration	Complete config reference
Mod Compatibility	Per-mod setup instructions
Commands	In-game command reference
Spacing Guide	Controlling village density
Troubleshooting	Common issues and solutions
Project Scope	Design philosophy and limitations

Known Issues

• Large mod structures may fail biome validation - Structures with large starter pieces (BCA, Terralith) can fail vanilla's biome check. Use relaxed_biome_validation: true in config.
• Terralith sky biomes - Terralith adds 3D biomes above ground level. Structures on tall terrain may sample a sky biome instead of the expected surface biome, causing biome validation failures.

See Troubleshooting for details and workarounds.

FAQ

Do I need village mods installed?

MVS works with vanilla, but you'll only see vanilla villages. Install village mods like Cobblemon Additions or Towns & Towers for variety.

Why aren't my villages spawning?

Check the Troubleshooting Guide. Common causes: mod conflicts, biome mismatches, or spacing settings.

Can MVS control other structures (temples, mansions)?

Currently, MVS focuses on villages. See Scope for design rationale. You can add any structure to MVS's pool, but it's designed for only one structure pool.

Fabric or NeoForge?

Both! MVS v0.3.0+ supports both platforms via Architectury.

Can I add this to my modpack?

Yes! Please file an issue if you have feature requests or find bugs. If it's outside the project scope, I'll likely say no.

Can you do this for all structures?

That's harder. Managing ALL structure pools this way is much more complex. I'm considering it, but honestly comprehensive datapacks are probably easier for that use case.

How do I make villages spawn more or less often?

Use the placement config section to adjust spacing and separation. See the Spacing Guide for details and recommendations.

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a Pull Request

For bug reports and feature requests, use GitHub Issues.

Authors

Project Design: RhettL

Implementation: As a career application developer in other languages, I (RhettL) don't write Java as fluently as I can think in code. The code in this repo was written almost entirely with Claude Code (Claude Sonnet 4.5), an AI coding assistant by Anthropic. I provided design, direction, corrective reasoning, testing, project management, and much more.

License

MIT License - see LICENSE for details.

Acknowledgments

• Village mod creators for their amazing structures
• Cobblemon Additions creators for encouragement and allowing me to tell people about this mod on their Discord
• Architectury for multi-loader support
• json5-java for config parsing
• NeoForge and Fabric teams
• Claude Code (Sonnet 4.5) for doing most of the work coding this at RhettL's direction