- Use LibrGetter while playing in singleplayer, on LAN worlds, on vanilla or modded servers, and even in Realms
- Supports all Minecraft versions from
1.17up to26.3, use the same JAR file for all supported Minecraft versions - Join the community on Discord to get help, report bugs, request features and get development insights
- LibrGetter is actively maintained and updated with new features and bug fixes
- Support me by downloading from Modrinth or making a donation through PayPal or GitHub Sponsors
Features
- Fully automatic and highly efficient
- Compatible with many other client-side mods for librarian villagers
- Very customizable process with many configuration options
- Stable against multiple lag types
- Configurable through client-side commands and in-game GUIs
- Works with Trade Halls and can cycle multiple villagers in a row
- Supports enchantments tags up from
1.19.3
Installation
Download LibrGetter from the Modrinth page
and place the downloaded JAR file in your Minecraft mods folder.
Make sure, you also have the following dependencies installed:
- Fabric API - required for communication between the mod and the game
- Version't Library - required for supporting multiple Minecraft versions with a single JAR file
Quick Guide
- Add enchantments to the goals list using
/librget add <enchantment> [level] [price]or by opening the goals list GUI using , (comma) - Change configs to your liking using the config GUI, open it by pressing K, however usually the default configs are sufficient
- Stand close to the librarian and his lectern and press J to start the process
- Stop the process by pressing J again
- ... or wait until the desired enchantment is found
- Enjoy your new enchantment!
Documentation
A more detailed explanation can be found in the documentation.
Localization
LibrGetter supports localization and currently implements the following languages:
- English 🇺🇸
- German 🇩🇪
- Russian 🇷🇺
- Vietnamese 🇻🇳 (thanks @ToanAnh312)
- Japanese 🇯🇵 (thanks @H1ggsK)
- Spanish 🇪🇸
- Turkish 🇹🇷 (thanks @EmirOven)
- Polish 🇵🇱 (thanks @Pulpasek)
- Hebrew 🇮🇱 (thanks @TheRealHSQ32)
You may request further languages or suggest improvements in the issues or the Discord Community
About Me
I am a computer science student in Germany and have a part-time job at a tech company. Apart from that, I enjoy my free time by spending it with friends, chatting online or gaming.
If you want to keep this project alive, found it helpful or just want to support and motivate me to go on, you could consider making a small ☕ donation.
All Versions
+ Add Version- Slightly improve path finding and particle spawning
- Remove client-side hand swinging and
noSwingconfig option
- Make Goals List per-world or per-server
- Add selection particles and
particlesconfig option - Implement new Trade Hall management system (see Wiki)
- Add
tradehallModeandtradehallScanconfig options - Add a per-world or per-server and per-dimension savefile
- Add new Trade Hall screen and keybind
- Implement automatic walking
- Add Trade Hall "auto-saver"
- Add conditions to description tooltip in config GUI
- Improve path finding
- Adjust internal worker design
- Fix crashes before
26.1 - Improve block breaking with anti-cheats
- Add hand swinging
- Add new
noSwingconfig option
- Add support for Minecraft 26.2
- Add new
originalPriceconfig toggle
- Add official support for 26.1.2
- Add translation for Hebrew (@TheRealHSQ32)
- Improve and split save-files into
config.jsonandgoals.json - Improve Neoforge support via Sinytra Connector
- Add new goals GUI and documentation
- Add Polish translation
- Fix certain features not working on Lunar Client (#66)
- Improve Mixin injection (removes unnecessary error logs)
- Turkish translation
- Fix certain crashes (#63)
- Fix message formatting (affected "New version released" message)
- Migrate to Version't
- Improve code quality and stability
- Improve internal config handling
- Add documentation
- support for 1.21.11
- improve updating of config menu contents
- fix crashes:
- autoTool < 1.21
- config menu navigation < 1.21.5
- config parsing < 1.19
- Fix startup error in specific versions
- Improve config
- Fix chat spam when using GUI
- Add categories with paging
- Change
matchMode ANYtomatchMode ATLEAST - Add
matchAtLeast - Remove
matchMode LIST - Change
matchMode ALLtomatchMode PERFECT
- Fix #44 - support for Lunar Client
- Fix #45 - add
matchModeconfig - Massive config overhaul
- Change
rotationconfig - Change
actionBartologMode - Gray-out ineffective configs
- Fix #42 - support for 1.21.10
- Fix #43 - update NBT parser
- Migrate to MultiVersion
- Rename base to
dev
- Slightly improve rotation setup
- Add support for 1.21.9
- Improve Vietnamese translations (thanks @ToanAnh312)
- Add Japanese (thanks @H1ggsK)
- Add Spanish
- Add support for up to 1.21.8
- Improve compatibility with TradeCycling (#39)
- Rework MultiVersion API
- Add
lookandrotationconfigs - Fix notifications with manual mode
- Make state switching more efficient
- Rework manual mode
- Fixed undefined behaviour for exitting a server while running
- Support for up to 1.21.5
- Explicit compatibility with "Trade Cycling"
- Add "Fallback" option and rework trade parsing
- Rework reflection structuring further
- Support for up to 1.21.4
- Add Vietnamese translation
- Improve safe checker
- Add config
timeout - Rename config options
- Fix multiple issues
- Improve manual mode
- Add
waitLoseconfig (#30) - Add
safeCheckerconfig - Fix undetected issues with notifications and inventory on 1.17
- Add
offhandconfig - Add
manualmode - Add GUI and a keybind
- Compatibility with OffersHUD
- Drop 1.16.x support completely (goodbye!)
- Version support is now from 1.17 up to 1.21.1 inclusive
Technical changes:
- Fix undetected issue with
Messages.sendError(context.getSource(), "librgetter.find_librarian"); - Change order of checking for profession loss
- Split multiversion utils in groups.
- Provide abstraction for Plugin parsing (easier to add support for new plugins)
- Bump java version to 17
Fixes #26, #27 and #28
Fixes #24
to easier add support for new plugins.
Also a first plugin was included: "Enchantment Solution"
Apart from that, custom enchantments support and a "warning" config option were added.
Please check the description of the project to get the newest data.
# Merge
All LibrGetter versions have been merged into a single one. This allows users from any version from
1.16.4 up to 1.20.4to use a single jar, and allows me to publish new updates easier. The stability of LibrGetter on snapshots was not tested.
This was achieved with help of Java Reflections and lots of research.
# Update checker
New functionality as well as a new config option were added. This will check if a new version of LibrGetter has been released
on github and notify you on your first world join.
### Further things
I will start investigating into uploading the mod on Modrinth soon