systems 05
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 and checks the pack and
rehashes it. The pack server keeps running unless its host or port changed.
Does Tessera respect WorldGuard or GriefPrevention claims?
Yes. Custom blocks go through normal block events, and furniture is checked against WorldGuard, GriefPrevention and Towny when they are installed. See Configuration.
Do PlaceholderAPI placeholders work in the HUD?
Yes, with PlaceholderAPI installed. The built-in placeholders on Glyphs and HUD work without it.
Can I translate the plugin messages?
Yes. core.language picks a file from lang/ (en, uk, de, es ship with the plugin) and
command messages are read from its messages section.
Item mechanics: lifesteal, click actions, food, durability
Lifesteal, lightning, explosions, potion effects, sounds, particles, commands and cooldowns work on hit and on right click; see Items. Food, durability and stat modifiers are not implemented.
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.