systems 04

FAQ

Players cannot download the resource pack

pack.server.domain is almost always the cause. It ships as localhost:8085, which only works for a client on the same machine. Set it to a public IP or domain with the port, and open that port. Check what is being sent with /tessera pack, which prints the URL and the SHA-1.

If only some downloads fail, check the rate limit. Each IP gets max_requests_per_ip downloads per cooldown_minutes, and players behind one router share an IP. Raise the limit for a shared network or for local testing.

The banner does not show in the Escape menu

The top banner is part of the HUD, which the client blurs behind menus. The pause menu has its own banner: hud.pause_banner replaces the "Game Menu" title. If you updated from 1.0.0, delete glyphs/default_glyphs.yml so the banners get their new sizes, then run /tessera reload.

Custom items show as purple and black squares

The model or texture path in your pack does not match what the model file asks for. Paths are case sensitive on Linux. Confirm the item's custom_model_data matches the number your model file is registered under, and remember that Tessera does not write item models for you.

My glyph does not appear

Check three things: the PNG sits in pack/assets/tessera/textures/font/, the texture key points at it, and the player has the current pack. After adding a glyph run /tessera reload so the font provider list is rebuilt and the hash changes.

Where do I put my own models and textures?

Under plugins/Tessera/pack/assets/. Everything in the pack/ folder is zipped into tessera-pack.zip.

How do I reload without restarting?

/tessera reload. It reloads config.yml and every module folder, rebuilds the pack, rehashes it and restarts the pack server.

Does Tessera respect WorldGuard or GriefPrevention claims?

Not in 2.0.0. Those plugins are listed as soft dependencies and the hooks section exists in the config, but there is no integration code, so custom block and furniture placement is not checked against regions or claims.

Do PlaceholderAPI placeholders work in the HUD?

No. Use the built-in placeholders listed on Glyphs and HUD.

Only one of my HUD elements shows

That is how the ticker works: it sends the first element the player has permission for and stops. Give elements distinct permission values to choose between them.

Can I translate the plugin messages?

The language files in lang/ are loaded and core.language selects one, but command output in 2.0.0 is written into the code, so editing the files does not change what commands print yet.

Item mechanics: lifesteal, click actions, food, durability

Not implemented. The mechanics registry is empty. Those keys appear only in the config comments and on the Modrinth page. Adding them to an item file does nothing. See Items.

Does it work with Geyser or Bedrock clients?

Tessera generates a standard Java pack. Bedrock clients need a converted pack. Nothing in Tessera does that conversion.

Which Minecraft versions?

Paper or Purpur 1.21.x on Java 21 or newer. api-version is 1.21.