TESSERA

Smart pack engine · Paper / Purpur 1.21-26.x · Java 21

TESSERA

Drop in any resource pack: Tessera reads it, merges it, fixes it and turns it into custom items, blocks and furniture.

( v2.0.0 )

00 smart pack engine

Any pack in. A working pack out.

( new )

Other plugins hand you a zip and wish you luck. Tessera understands the pack you give it, merges it into yours, turns its models into items and furniture, and repairs whatever would show up broken in game. On a separate thread, so the server never stalls.

A

Smart import

Drop any zip into imports/. Tessera reads it like the client does: pack format, legacy overrides, item definitions, blockstates and every model reference. It knows a retexture from a custom item pack and a mod pack from a server pack.

  • Merges with your pack instead of overwriting it
  • Creates items, item models and furniture from what it finds
  • Skips mod assets that only work with the mod installed
  • Undo any import with one command
B

Pack Doctor

Every build is checked for what the client would draw as a purple and black cube. /tessera pack doctor lists it file by file, then asks if it should fix it for you.

  • Renames bad file names and fixes every reference
  • Removes broken overrides so vanilla shows again
  • Backs up the pack before touching anything
  • Rebuilds and sends the fixed pack to players
> /tessera pack doctor
════ Pack Doctor ════
 » Kind: MIXED, pack_format 84
 » Models: 14935, textures: 5681, blockstates: 1468
✘ 203 problems (shown as missing textures in game):
 ! assets/minecraft/blockstates/polished_cut_diorite.json: there is no such block (+11 more)
 ! assets/minecraft/textures/block/wild_carrots_3D.png: file name the client does not accept
 ! assets/Actually3dBlocksAndItems: namespace the client does not accept
Fix these automatically? A backup of the pack is made first.
[YES]   [NO]

Renamed 41, updated 96 and removed 188 files.
✔ No broken references found.
1 clickpack repair with Pack Doctor
0manual zipping or hashing
1.21-26.xPaper and Purpur
30+subcommands

01 modules

What it does

( 07 )
01

Items

One YAML file can hold many items. Each item sets a material, a MiniMessage name and lore, custom model data, an unbreakable flag and a stack size. Tessera tags every stack it builds in the PDC, so it can recognise the item later.

02

Blocks

A custom block sits on a base material, a note block by default. You set the tool and tier needed to break it, its sounds and a drop table with chances. Placed blocks are recorded in the chunk PDC.

03

Furniture

Each piece is a display entity with an Interaction entity as its hitbox. You can scale and offset the model, snap it to four directions and make it a seat players can sit on.

04

Recipes

Shaped, shapeless and cooking recipes registered with the server. Custom items work as both result and ingredient through the tessera:<id> reference, with an optional permission gate.

05

Glyphs

Your PNGs become bitmap font characters in the generated pack. Write :ruby: or <glyph:ruby> in any Tessera text and the icon appears in its place.

06

HUD

Actionbar lines are defined in YAML and can show health, ping, coordinates and other player values. Players turn their HUD on and off with /tessera hud. The pause menu title and button labels can be replaced too.

07

Resource pack

The pack is assembled on boot and on reload, with item definitions for 1.21.4+ and a check for missing models and textures. Imported zips are analysed and merged, not copied over each other, and an embedded HTTP server hands the result to joining players.

02 config

Plain YAML

( items/ruby.yml )

Content lives in per-module folders under plugins/Tessera/. The top-level key of each block is the id you use in commands, recipes and drop tables. This file ships with the plugin.

# plugins/Tessera/items/ruby.yml
ruby:
  material: EMERALD
  display_name: "<gradient:#ff416c:#ff4b2b><bold>Ruby</bold></gradient>"
  lore:
    - "<gray>A precious crimson gemstone"
    - "<dark_gray>Common Material"
  custom_model_data: 10001
  max_stack_size: 64

ruby_sword:
  material: DIAMOND_SWORD
  display_name: "<gradient:#ff416c:#ff4b2b><bold>Ruby Sword</bold></gradient>"
  lore:
    - "<gray>Forged from crystallized ruby"
  custom_model_data: 10002
  unbreakable: true

03 start

Set it up

( 4 steps )

Drop the jar in plugins/, start the server on Java 21, edit the YAML files Tessera writes on first run, then /tessera reload. The resource pack is rebuilt and re-hashed every time.