Aluna's Villagers Plus

Aluna's Villagers+ — Villager Quality of Life, Perfected

Villagers+ is a lightweight, fully configurable quality-of-life mod that makes interacting with villagers less painful and more fun. Pick them up, lock in infinite trades, cycle for perfect offers, and protect them from accidental hits — all in one mod.

Every feature can be toggled on or off in-game. Press V to open the settings screen at any time.

---

⚡ Features

📦 Villager Pickup

• Shift + Right-Click any villager to pick them up as an item
• All data is preserved — profession, level, trades, custom name, XP
• Place the item to release the villager exactly as they were
• Tooltip shows profession, level, and custom name
• Cannot pick up a villager another player is trading with

♾️ Infinite Trading

• Trades never lock out — offers will never gray out or become unavailable
• Works on all villager professions
• Optionally extends to Wandering Traders (separate toggle)

🔄 Trade Cycling

• A small cycle icon button appears in the top-right corner of the trading UI
• Click it (or press C) to re-roll a villager's trades instantly
• Only works on villagers with 0 trade XP — no exploiting leveled villagers
• The trading screen stays open while cycling — no need to reopen

🛡️ Villager Hit Protection

• Prevents accidental melee damage to villagers and wandering traders
• Sneak-attack to bypass — hold Shift and hit to deal damage when you actually mean it
• No more accidentally punching your librarian while trying to trade

🎛️ In-Game Config

• Press V to open the settings screen
• Toggle each feature independently with color-coded ON/OFF buttons
• Tooltips explain what each option does
• Settings save to config/villagers-plus.json

---

⌨️ Keybinds

Key	Action
V	Open Villagers+ Settings
C	Cycle Trades (while trading screen is open)
Shift + Right-Click	Pick up a villager
Shift + Attack	Bypass hit protection

---

📋 Requirements

• Minecraft: 26.1.2
• Mod Loader: Fabric
• Fabric API: Required
• Java: 25+

---

🔧 Configuration

All features default to ON. Use the in-game menu (press V) or edit config/villagers-plus.json directly:

{
  "villagerPickupEnabled": true,
  "infiniteTradingEnabled": true,
  "tradeCyclingEnabled": true,
  "villagerHitProtection": true,
  "wanderingTraderInfinite": true
}

---

💡 Tips

• Pick up villagers before moving them long distances — no more boat chains or minecart rails
• Use trade cycling on a fresh villager near their workstation to get the perfect enchantment book
• Enable hit protection on multiplayer servers to keep your villager halls safe
• Wandering Trader infinite trades is a separate toggle — enable it if you want those trades to stick around too

---

Client + Server mod — install on both sides for full functionality. Villager pickup and trade cycling require the server to have the mod installed. Config UI and keybinds are client-side.