
Chromosome Lib
Introduces genetic mechanisms for entities in Minecraft
About this Mod
Abstract
This is a library mod that introduces chromosome-based genetic mechanisms for entities, such as villagers, sheeps, cows, in Minecraft. It does not provide any actual functionality on its own, but serves as a powerful and compatible library that integrates traits and genetic systems for dependents.
For developers to create dependents of this mod, please read the following sections.
Architecture

Core capabilities
- Multi-loader support: Works seamlessly on both Fabric and (Neo)Forge.
- Five custom registries for chromosomes, gene loci, genes, traits, and trait types.
- Extensible trait system allowing developers to define custom observable characteristics.
Registration
Chromosomes, Gene Loci, Genes, Traits and Trait Types can be registered through this mod.
We also provide some built-in chromosomes for vanilla animals such as sheep, cows, polar bears, humans, to prevent conflicts between different mods by registering different chromosomes to the same entity.
Inheritance
Automatic chromosome inheritance, including gene recombination and mutation, default gene selectors, are reusable to any mobs, which is managed by chromosome lib. So there's no need for developers to understand how it's implemented - they can code in a really easy way.
Debug Commands
We also provide several commands for players to show and modify genes of entities easily, and reassign traits of them based on their genes.
Use Cases
This library is perfect for:
- Wildlife and animal husbandry mods wanting realistic breeding systems.
- RPG mods requiring hereditary traits and characteristics.
- Educational mods teaching genetics and biology concepts.
- Any mod that needs sophisticated inheritance mechanics.
Get Started
Add Viola Siemens's Maven to repository in your build.gradle.
repositories {
maven {
name = 'Maven from Viola Siemens'
url = "https://viola-siemens.github.io/pages/maven/"
}
}
Declare Chromosome Lib as your dependency.
Forge:
implementation fg.deobf("com.hexagram2021:chromosomelib-forge:${chromosomelib_version}")
Fabric:
modImplementation group: 'com.hexagram2021', name: 'chromosomelib-fabric', version: chromosomelib_version
NeoForge:
implementation group: 'com.hexagram2021', name: 'chromosomelib-neoforge', version: chromosomelib_version
MultiLoader:
// ^common/build\.gradle$
modImplementation group: 'com.hexagram2021', name: 'chromosomelib-common', version: chromosomelib_version
// ^forge/build\.gradle$
modImplementation group: 'com.hexagram2021', name: 'chromosomelib-forge', version: chromosomelib_version
// ^fabric/build\.gradle$
modImplementation group: 'com.hexagram2021', name: 'chromosomelib-fabric', version: chromosomelib_version
// ^neoforge/build\.gradle$
modImplementation group: 'com.hexagram2021', name: 'chromosomelib-neoforge', version: chromosomelib_version
Example Mods
Available Versions
How to Install Chromosome Lib on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "Chromosome Lib". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1, 1.20
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Chromosome Lib server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.
Is Chromosome Lib compatible with fabric and forge?
Chromosome Lib officially supports fabric, forge for Minecraft 1.20.1, 1.20. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Chromosome Lib – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Chromosome Lib consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Chromosome Lib with just one click on your server.