BlossomBridge API

BlossomBridge API

A small API for Tywrap Studios Mods, that adds a few minor things.

by
478 Downloads
fabricquiltlibrary
Rent Server with this Mod

Screenshots

icon

About this Mod

BlossomBridge

A small API for Tywrap Studios Mods, that adds a few minor things.


Since version 2.1.0 of BBAPI (which is currently only available as a master-SNAPSHOT), it is suggested to bundle the API with your project instead of depending on this mod, and depending on Fabric Language Kotlin instead. As such, the maximum downloadable version you will find on this page is 2.0.2. We will no longer release this as a mod jar to keep compatibility as high as possible.

For developers: please read our 2.1.0 update docs as soon as it becomes available for more information on how to update your BBAPI version correctly, then follow the update docs subsequently until you reach the latest version. Happy days!


Such As:

  • A fletched Config system utilizing Jankson and some logic magic.
  • A simple, yet niche Logging system, to maintain a consistent log format for all our mods.
  • Good JavaDocs, so you can actually properly understand the code.

For Devs:

Project Setup

Want to use this API in your mod?
Feel free to! But keep in mind that a lot of stuff in here is specific to our workflows, so it may not be applicable to your use case.
Plus, the code is pretty minimal the moment, so it's not really worth it half the time.

Gradle Setup

BlossomBridge can easily be depended on like any other Fabric mod.
Just add the following to your build.gradle file:

repositories {
    maven { url "https://jitpack.io" }
}

dependencies {
    // Other dependencies...
    
	modImplementation("com.github.Tywrap-Studios:BlossomBridge:${project.blossombridge_version}")
}

And you add this to your gradle.properties file:

blossombridge_version="1.1.1"
# Or whatever version you want to use :)

it is always recommended to use the latest STABLE version, so you don't get any unexpected hiccups of WIP features.
Last but not least, you need to add the following to your fabric.mod.json file:

{
    "depends": {
        "blossombridge": "1.1.1"
    }
}

Mod Setup

Once you've added the mod to your project, you can start using it!
All the code is well documented using JavaDoc, so you should be able to figure out how to use it.

But as a general line of thumb, you do the following: Make a Config class that extends AbstractConfig, and then you can make a new ConfigManager to load and use it. Alongside that, also construct a LoggingHandler and you're good to go!

Do not use the BlossomBridge class! Matter of fact, don't use anything from the main package!
ANYTHING IN THE main PACKAGE IS NOT PART OF THE API, AND IS INSTEAD FOR THE ACTUAL "MOD" PART OF THE CODE!
Everything that is api is inside the api package (of course)

As an example, I suggest taking a look at Constructra, which has a lot of this API's code implemented and used.

Available Versions

BlossomBridge 2.0.2release
MC 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8fabric, quilt
August 5, 2025
BlossomBridge 1.1.1release
MC 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8fabric, quilt
December 10, 2024
BlossomBridge 1.0.3release
MC 1.20.1fabric
November 29, 2024
BlossomBridge 1.0.2release
MC 1.20.1fabric
November 29, 2024
BlossomBridge 1.0.1release
MC 1.20.1fabric
November 29, 2024

How to Install BlossomBridge API on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).

3

Install Mod

Open the mod browser in the dashboard and search for "BlossomBridge API". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricquilt

Minecraft Versions

1.21.8, 1.21.7, 1.21.6 (+16 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

BlossomBridge API 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.21.8). You can switch loaders with one click in the panel.

Is BlossomBridge API compatible with fabric and quilt?

BlossomBridge API officially supports fabric, quilt for Minecraft 1.21.8, 1.21.7, 1.21.6. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with BlossomBridge API – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if BlossomBridge API 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.

Rent Modded Server

Install BlossomBridge API with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.81.21.71.21.61.21.51.21.41.21.31.21.21.21.11.211.20.6+9 more