FAQ English

FAQ – English

Overview · Installation · Deutsch

Why are CMI holograms not visible on Linux?

CMI uses Java font functions to calculate text widths. These may require the HarfBuzz library, which can be missing on a Linux system. An affected server may report:

java.lang.UnsatisfiedLinkError: .../libfontmanager.so:
libharfbuzz.so.0: cannot open shared object file: No such file or directory

This occurred on a server running Debian GNU/Linux 13 (trixie): libharfbuzz0b was not installed. The offered package version was 10.2.0-1+deb13u1. This error concerns font calculations and can occur regardless of whether TrackTimer uses SQLite or MariaDB.

Solution for Debian/Ubuntu

Check the package status:

apt-cache policy libharfbuzz0b

If the package is missing, install it from the official package repositories:

sudo apt update
sudo apt install libharfbuzz0b

Then fully stop and restart the Minecraft server. Reloading holograms is insufficient after Java's font class has failed to initialize. Holograms stored in TrackTimer's database are loaded again at startup.

Other Linux distributions may use a different package name. This guidance is particularly relevant when the stack trace mentions libfontmanager.so, libharfbuzz.so.0 and CMI font functions; not every invisible hologram has this cause.