Back to mods
librarianroller project artwork

CurseForge · Minecraft mod

librarianroller

a pure client-side mod that automates breaking and placing lecterns, causing librarian villagers to continuously refresh their trades for efficient farming of specific enchanted books.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which librarianroller release should I use?

Updated yesterday
beta file v1.2.2-forge+mc[1.20.1]
Game version 1.20.1
Loader Forge

librarianroller v1.2.2-forge+mc[1.20.1] targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 2 required mods have matching files.

Where it goes

Is librarianroller required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does librarianroller v1.2.2-forge+mc[1.20.1] need?

v1.2.2-forge+mc[1.20.1]. Change the file and its required mods may change too.

All 2 required mods have matching files

Install Cloth Config API (Fabric/Forge/NeoForge), Cloth Config API first. We found matching files for this game-version and loader setup.

Cloth Config API Needed by librarianroller v1.2.2-forge+mc[1.20.1]
required
Matching file found Matched file: 11.1.136+forge

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add librarianroller without breaking your instance.

Built for librarianroller v1.2.2-forge+mc[1.20.1]. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use v1.2.2-forge+mc[1.20.1]. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Cloth Config API (Fabric/Forge/NeoForge), Cloth Config API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside v1.2.2-forge+mc[1.20.1]. It opens that exact file at the source.

About this project

What does librarianroller add?

Features

  • 🧩 Pure Client - Runs entirely on the client side, does not modify server data, safe and reliable
  • 🔄 Automated Loop - Automatically breaks and re-places lecterns to refresh villager trades
  • 🎯 Enchantment Filtering - Specify desired enchantments and levels for precise targeting
  • 👥 Multi-Villager Support - Supports 1, 4, or 6 villagers simultaneously for faster farming
  • 🛡️ Durability Protection - Automatically stops when axe durability drops below threshold to prevent breakage
  • ⚙️ Flexible Configuration - All parameters adjustable via config file

Usage

V1 Mode (Recommended)

  1. Prepare a librarian villager and a lectern
  2. Configure the target enchantment list
  3. Face the lectern and villager (Player → Lectern → Villager)
  4. Press J (default) to start/stop the automation loop

V4 Mode

  1. Place librarian villagers and lecterns in the specific arrangement shown below
  2. Configure the target enchantment list
  3. Stand in the designated position
  4. Press J (default) to start/stop the automation loop

V6 Mode

  1. Place librarian villagers and lecterns in the specific arrangement shown below
  2. Configure the target enchantment list
  3. 👁 Player's line of sight must be parallel to the two rows of lecternsy
  4. Stand in the designated position
  5. Press J (default) to start/stop the automation loop

V4 & V6 Layout

  1. See images in the image gallery section
  2. Color Legend:
    • 🟧 Orange: Player
    • 🟩 Green: Villager
    • 🟥 Magma Block: Lectern

Configuration Options

Option Description
Auto-Buy Automatically purchases and locks the enchantment when found (Not yet implemented)
Prevent Axe Breaking Stops automation when axe durability falls below 10 to protect the tool
Legit Mode Makes player eyes follow the target lectern/villager (Not yet implemented, considering removal)
Villager Count Selects V1/V4/V6 mode as described above
Enchantment Entries List of enchantments to target (format: enchantment_name level, one per line)

Example:

Smite 5
Sharpness 5
Silk Touch

Enchantments without a specified level are excluded from the filter list.

Project description from CurseForge.

Pick your setup

librarianroller by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

14 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

librarianroller versions and loaders

27 of 27 releases match

Looking for an older file? The official CurseForge project page is in Resources.