Cranberry

Cranberry

In-game music playback on macOS

by
205 Downloads
fabricquiltdecorationmagicsocial
Rent Server with this Mod

Screenshots

Fighter — TALI
Rats — Ghost
Välikuolema — Käärijä
Europapa — Joost
Doomsday Blue — Bambie Thug
11:11 — Megara

About this Mod

Cranberry

In-game music playback on macOS

Cranberry allows you to control whatever music is playing on your computer from within Minecraft. If also installed on a server, others with the mod will be able to see what you're listening to (disableable).

Table of Contents

Images

an in-game image of fighter by tali playing

Visit the gallery for more examples.

Client Installation

Cranberry is currently only supported on macOS and will automatically disable itself on any other platform.

If installed only on the client, pressing the keybind (M by default) will open a screen that shows what music is currently being played and allows you to play/pause it. By default, the background of the screen is dynamically tinted with the dominant color from the image - this can be disabled in the configuration (see Configuration Options).

Server Installation

Installing the mod on the server allows clients to see each other's music statuses - clients may disable sending or receiving statuses in the configuration. Note that if this mod is installed on the server, owo-lib (a library mod that this mod depends on) must be installed on every connecting client, or they will not be able to connect due to registry mismatches. The mod itself is optional.

Configuration Options

You may edit configuration values in config/cranberry-client-config.json5. Alternatively, installing Mod Menu will allow you to change the following configuration options via a GUI:

  • Send music statuses (default: true; only takes effect when playing multiplayer)
  • Receive music statuses (default: true; only takes effect when playing multiplayer)
  • Dynamic background (default: true)

How Does It Work?

Magic.

Technical details Apple has a private framework on its platforms called `MediaRemote`, which allows for media playback information and control. Some Swift code is linked to this framework, built to a dynamic library, and called from Java using JNI.

Windows / Linux?

While this sort of thing would generally be easier on Windows and Linux (Windows has MediaPlayer and Linux has MPRIS/D-Bus, both of which are well-documented and intended for public consumption, as opposed to Apple's MediaRemote), I have absolutely no experience working with WinRT or D-Bus. So although I'm interested in adding support, I don't currently actually have plans to do it.

Available Versions

v1.0.0release
MC 1.21, 1.21.1fabric, quilt
September 12, 2024

How to Install Cranberry 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.1).

3

Install Mod

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

Compatibility

Mod Loaders

fabricquilt

Minecraft Versions

1.21.1, 1.21

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

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

Is Cranberry compatible with fabric and quilt?

Cranberry officially supports fabric, quilt for Minecraft 1.21.1, 1.21. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Cranberry – how to optimize performance?

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

Supported Versions

1.21.11.21