features
What Tessera does
Everything on this page is implemented in the plugin, and the keys listed are the ones the parsers read. Anything not listed here does not exist yet.
00 smart pack engine
Smart import and Pack Doctor
Tessera reads the packs you give it the way the client does, merges them into yours and repairs what would show up broken. All of it runs off the main thread.
Pack format, legacy overrides, item definitions, blockstates and every model reference.
Item definitions, atlases, lang and blockstates of several packs are combined, not overwritten.
Custom model data entries and loose models become items, furniture-sized models become furniture.
Assets that only work with a mod installed are recognised and skipped.
Finds missing models and textures, bad file names and broken JSON, file by file.
[YES] renames, rewires and removes what is broken, after a backup, then sends the fixed pack.
When a player cannot load the pack, admins get a clickable /tessera pack doctor in chat.
/tessera pack undo removes everything an import created.
01 content
Items
Items are parsed from every YAML file in items/. One file can define any number of items. The top-level key is the id.
Any item material, PAPER when absent. A bad name skips only that item.
MiniMessage string used as the item name.
List of MiniMessage lines.
Applied when greater than zero.
The model to draw. Tessera writes the 1.21.4+ item definition for it.
Sets the unbreakable flag.
Applied when greater than zero.
On hit and on click: lifesteal, lightning, explosions, effects, sounds, particles, commands, cooldowns.
Built stacks carry the id in their PersistentDataContainer.
02 content
Blocks
A custom block is a vanilla block plus an id recorded in the chunk PersistentDataContainer, so it survives restarts and chunk unloads.
Base material, NOTE_BLOCK by default.
Note blocks get their own block state and show your model in the world and in hand.
Break time as for vanilla blocks, with tool tiers. Negative means unbreakable.
Lights the block through a light block above it.
Gate on the tool used to break the block.
place, break, step and hit sound names.
Entries of item, min, max and chance. Defaults to the block itself.
Break the block without dropping anything.
Piston moves and neighbour updates are cancelled. Explosions run the drop table.
03 content
Furniture
Placing a tagged item spawns a display entity plus an Interaction entity that carries the hitbox. Both entities keep the furniture id in their PDC.
ITEM_DISPLAY, BLOCK_DISPLAY (any block) or ARMOR_STAND.
WorldGuard, GriefPrevention and Towny are asked before placing, breaking or sitting.
Interaction width and height.
Transform applied to the display entity.
Spawns a temporary armour stand to sit on.
Snap placement to four directions.
What the furniture returns when broken.
04 systems
Recipes
Recipes are registered with the server on load and unregistered on reload. Custom items are referenced as tessera:<id> and matched exactly.
shape rows plus a character to ingredient map.
A flat list of ingredients.
source or ingredient, experience, cooking_time.
A plain id, or a section with item and amount.
Optional node checked before crafting.
05 systems
Glyphs and HUD
Glyphs become bitmap font providers in the generated pack. HUD elements are MiniMessage templates rendered to the actionbar.
Private use character, allocated automatically when omitted.
Font provider fields.
:id: and <glyph:id> are both replaced before parsing.
player, health, max_health, food, level, ping, world, x, y, z.
/tessera hud, stored per player in the player PDC.
Banner glyph as the Escape menu title, and any button label from hud.pause_menu.texts.
06 systems
Resource pack
The pack is generated on every boot and reload, then hashed and served. You never zip it yourself.
Font providers, pack.mcmeta, pack.png, glyph textures, item definitions and note block models.
Missing parents, textures and models found on every reload. /tessera pack doctor lists them.
Embedded HTTP server, port 8085 by default, with a SHA-1 hash.
Joining players are prompted after a configurable delay.
Anti-unzip levels 1 to 3 applied to the archive headers.
Optional movement lock and blindness while the pack loads.
Zips in imports/ are analysed, merged with the pack and turned into items and furniture.
/tessera migrate converts items and assets from other item plugins.
07 tools
Commands and GUIs
One command, /tessera, with an alias of /t. Everything is reachable from chat or from the menus.
menu, browse, search and an interactive recipe viewer.
get, give, giveall and drop, for items, blocks and furniture.
inspect, nbt, cmd, durability, block info, furniture list.
killfurniture, cleartemp, stats, debug, export, reload.
generate, apply, push, import and doctor, plus an importer screen in the admin menu.
Full key reference, defaults and examples live in the wiki.