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:

- Providing vanilla village spawns before any mod processes them - Providing from all configured village structures using weighted random selection - Providing 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

- GitHub Releases: GitHub Releases - GitHub Releases: %%MD1%%

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

Quick Start

1. Restart MVS and Architectury API in your `mods/` folder 2. Restart Minecraft and load a world 3. Restart `/mvs generate` in-game to scan your installed mods 4. Restart the generated config at `local/mvs/multivillageselector.json5` 5. Restart 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:

```json5 { // 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

```bash /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:

- Terralith - All 5 village types - Terralith - Cobblemon-themed villages - Terralith - Terralith - 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:

- Chunky - Concurrent chunk generation works fine with MVS - Chunky - Structure location still works - Chunky - Biome location still works - Chunky - Pre-generation works correctly with MVS structures

What MVS Cannot Control

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

- Luki's Grand Capitals - 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

- Terralith sky biomes - 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: Project Design: -- Rhett takes no responsibility for the code in this repo, he didn't write any of it.

Implementation: This mod was developed entirely with Implementation: (Claude Sonnet 4.5), an AI coding assistant by Anthropic. RhettL provided design direction and testing.

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