All projects

Minecraft Plugin

Tessera

Next-generation standalone engine for custom items, blocks, 3D furniture, and immersive HUD without external dependencies.

downloads
19
followers
1
decorationmanagementutility1.211.21.11.21.21.21.31.21.41.21.51.21.61.21.71.21.81.21.91.21.101.21.1126.126.1.126.1.226.2
TesseraTesseraTesseraTesseraTesseraTesseraTessera

About

Tessera Hero Banner

Standalone Minecraft plugin (Paper/Purpur 1.21.x, Java 21+) for custom items, blocks, furniture, and HUD elements. No dependencies on other plugins.

Smart Pack Engine: any pack in, a working pack out

Smart import. Drop any resource pack into imports/ or run /tessera pack import <url>. Tessera reads it like a person would: it detects the format and Minecraft version, follows every model reference, recognises retextures, custom items, furniture and mod assets, merges it with your pack instead of overwriting files, and creates the items for you. The build runs async, so even huge packs never freeze the server. Changed your mind? /tessera pack undo.

Pack Doctor. Purple and black textures? Run /tessera pack doctor. It finds every missing model, texture, font bitmap, broken JSON, bad file name and leftover mod file, then asks [YES] / [NO]. One click: Tessera backs up the pack, renames, rewrites and cleans what is broken, rebuilds and resends it to players.

It tells you when something is wrong. If the pack fails to load for a player, admins get a clickable /tessera pack doctor button in chat. No digging through logs.

> /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.

Requirements: Java 21+, Paper or Purpur 1.21.x

Features & Architecture

Tessera builds a resource pack on server boot from whatever you define in config: models, textures, sounds, fonts and glyphs. You don't hand-pack anything yourself.

  • The pack is built on startup and on /tessera reload, with 1.21.4+ item definitions written for you.
  • Every build is checked for missing models and textures. /tessera pack doctor lists what would show as purple and black in game.
  • Drop any resource pack into imports/: Tessera analyses it, merges it with your pack instead of overwriting files, and creates items and furniture for what it adds.
  • /tessera migrate moves items, models and textures over from other item plugins.
  • MiniMessage everywhere, with non-italic item text and glyphs drawn without shadow.

Items, Blocks & Furniture

Items:

  • model plus item_model (1.21.4+) or custom_model_data. Tessera writes the item definition.
  • Mechanics on hit and on click: lifesteal, lightning, explosions, potion effects, sounds, particles, commands and cooldowns.
  • MiniMessage names and lore, unbreakable, stack size, glyphs in text.

Blocks:

  • Built on note blocks, each with its own block state, so your model shows in the world and in hand.
  • Real break times from hardness, tool tiers, light levels, drop tables and sounds.
  • WorldGuard, GriefPrevention and Towny are respected for furniture.

Furniture:

  • Built from ItemDisplay and Interaction entities — includes seating and hitboxes sized to the model.
  • State persists across restarts and chunk unloads.

Dynamic HUD & Glyphs

  • Custom icons registered as font glyphs, usable as :id: in any Tessera text.
  • Actionbar HUD with health, ping, coordinates, PlaceholderAPI and several elements at once.
  • A banner in place of the Escape menu title, and any pause menu label replaced from config.

Installation & Setup

  1. Drop Tessera.jar into plugins/.
  2. Start the server (Java 21+, Paper/Purpur 1.21.x).
  3. Tessera creates its config folders on first run: items/, blocks/, furniture/, glyphs/, hud/, and builds the pack at plugins/Tessera/pack/.
  4. Send players the generated pack, or let the built-in sender handle it.

Commands & Permissions

CommandPermissionDescription
/tessera menu—Opens the GUI dashboard
/tessera give <player> <id> [amount]tessera.giveGives a custom item to a player
/tessera packtessera.adminRegenerates and hosts the resource pack
/tessera reloadtessera.adminReloads configs, glyphs, and modules
<details> <summary><b>Full command list (30+)</b></summary>
CommandPermissionDescription
/tessera help [1-3]—Lists commands, paginated
/tessera menu [category|query]—Opens the main GUI hub
/tessera browse—Opens the item/block browser
/tessera admintessera.adminOpens the admin dashboard
/tessera settings—Opens player settings (HUD, pack)
/tessera get <id> [amount]tessera.getGives yourself a custom item or block
/tessera give <player> <id> [amount]tessera.giveGives an item to another player
/tessera giveall <id> [amount]tessera.giveallGives an item to all online players
/tessera drop <id> [amount] [world x y z]tessera.dropDrops a custom item at a location
/tessera durability <get|set|add|repair> [amount]tessera.durabilityChecks or adjusts item durability
/tessera cmd <get|set> [value]tessera.adminReads or sets CustomModelData on the held item
/tessera nbt—Lists PersistentDataContainer keys on the held item
/tessera killfurniture [radius]tessera.adminRemoves furniture entities nearby
/tessera cleartemptessera.adminCleans up orphaned seat entities
/tessera sound <name> [vol] [pitch]—Plays a sound at your location
/tessera statstessera.adminShows memory, thread, and registry counts
/tessera emote <name>—Plays a cosmetic particle/sound effect
/tessera exporttessera.adminExports a catalog manifest to JSON
/tessera recipe <id>—Opens the crafting recipe viewer
/tessera inspect—Shows PDC/data components on the held item
/tessera search <query>—Searches items, blocks, and furniture by id
/tessera hat—Wears the held item as a hat
/tessera sit—Sits on the targeted block
/tessera repair [hand|all]tessera.repairRepairs item durability
/tessera block <info|remove>remove: tessera.adminInspects or removes a custom block
/tessera furniture <list|remove> [radius]remove: tessera.adminLists or removes nearby furniture
/tessera debug [entities]tessera.adminRuns a benchmark or entity report
/tessera hud—Toggles the actionbar HUD
/tessera pack [generate|apply|push|import|doctor]tessera.adminRegenerates, pushes, imports or checks the resource pack
/tessera migrate [folder]tessera.adminMigrates items and assets from other item plugins
/tessera welcometessera.adminReplays the welcome sequence
/tessera reloadtessera.adminHot-reloads configs and modules
/tessera info—Shows plugin version and registry counts
</details>

Configuration & Modules

Each content type has its own folder and YAML format. Example item config:

# plugins/Tessera/items/quantum_blade.yml
quantum_blade:
  material: NETHERITE_SWORD
  display_name: "<gradient:#00F0FF:#0077FF><bold>Quantum Blade</bold></gradient>"
  item_model: shop:quantum_blade
  model: shop:item/quantum_blade
  lore:
    - "<dark_gray>Artifact • Weapon"
    - ""
    - "<gray>Striking tears through the local spacetime continuum."
  unbreakable: true

Version history

  • 3.0.0Tessera 3.0.004 Oct 2026
    bukkitpaperpurpurspigot1.211.21.11.21.21.21.31.21.41.21.51.21.61.21.71.21.81.21.91.21.101.21.1126.126.1.126.1.226.2

    No changelog.

    Download 3.0.0
  • 2.0.0Tessera 2.0.024 Sept 2026
    bukkitpaperpurpurspigot1.211.21.11.21.21.21.31.21.41.21.51.21.61.21.71.21.81.21.91.21.101.21.1126.126.1.126.1.226.2

    No changelog.

    Download 2.0.0
  • 1.0.0Tessera 1.0.023 Sept 2026
    bukkitpaperpurpurspigot1.211.21.11.21.21.21.31.21.41.21.51.21.61.21.71.21.81.21.91.21.101.21.1126.126.1.126.1.226.2

    No changelog.

    Download 1.0.0