Bibliotheca Wiki

Bibliotheca (Latin for "Library") is a foundational utility mod designed to streamline the development and performance of EwyBoy's various Minecraft projects. Rather than adding direct gameplay content like new ores or creatures, Bibliotheca serves as a shared code repository. It automates complex tasks such as block, item, and tile entity registration, ensuring that all dependent mods operate efficiently and maintain compatibility across different Minecraft versions, specifically focusing on 1.18.2 and 1.17.1.

As a library mod, it is a required dependency; without it, any mod built upon its framework will fail to load. It was originally conceived during the development of the Cultivated Tech mod and has since evolved into a universal tool for the author's entire portfolio.

Bibliotheca provides several backend mechanics that benefit both players (through stability) and developers (through ease of use):

• Automated Registration: Allows developers to register new content (blocks, items, tiles) with a single line of code, reducing the likelihood of registry errors.
• Shared Codebase: Consolidates common logic used across multiple mods, which reduces the overall file size of individual mods and lowers memory usage.
• Dynamic Config System: Provides a standardized configuration framework that dependent mods use to generate and manage their .toml or .json settings files.
• Cross-Version Compatibility: Simplifies the process of porting mods between versions like 1.17.1 and 1.18.2 by handling version-specific mapping changes internally.

Bibliotheca is required for the following mods to function. If you are using any of these, ensure Bibliotheca is installed in your mods folder:

While Bibliotheca does not add player-facing items, it does include internal debugging mechanics that can be accessed via the console or logs.

Registration Logs

When the game launches, Bibliotheca will output logs to the latest.log file detailing which items and blocks it has successfully registered for other mods. This is useful for troubleshooting mod conflicts.

Commands

Bibliotheca itself does not typically register unique player commands, but it provides the API that allows mods like Seed Drop or World Stripper to implement their own command systems. If a mod using Bibliotheca has commands, they will usually follow the syntax defined by the library's command handler.

Bibliotheca generates a global configuration file located in the .minecraft/config folder. While most settings are handled by the individual dependent mods, the library's own config often includes:

• Debug Mode: Can be toggled to provide more verbose logging in the console regarding registry events.
• Update Checker: A toggleable feature that checks if a newer version of the library or its dependent mods is available.

To edit these settings, open the bibliotheca-common.toml (or similar) file with any text editor while the game is closed.

To install Bibliotheca for versions 1.18.2 or 1.17.1, follow these steps:

1. Install Forge: Ensure you have the correct version of the Minecraft Forge mod loader installed.
2. Download the Jar: Obtain the Bibliotheca .jar file corresponding to your Minecraft version.
3. Place in Mods Folder: Navigate to your .minecraft directory and move the downloaded file into the mods folder.
4. Launch Game: Start Minecraft using the Forge profile. You can verify the installation by clicking the "Mods" button on the main menu; Bibliotheca should appear in the list.