TESSERA

changelog

Releases

( current v2.0.0 )

latest

3.0.0


Added

  • Pack Doctor in chat. When the pack fails to download or load for a player, and when an admin joins while the pack has problems, admins get a clickable /tessera pack doctor button (at most once a minute).
  • Pack Doctor handles mod assets. Namespaces of mods (they carry blockstates) that nothing else in the pack uses are reported as one line each and removed by /tessera pack doctor fix: without the mod their blocks and items do not exist, so a vanilla client never loads them.
  • Item definitions for 1.21.4+. For every material used by an item with custom_model_data and model, the pack gets assets/minecraft/items/<material>.json with a range_dispatch on custom model data in front of the material's own definition. Legacy overrides are ignored by the client since 1.21.4, so imported CMD items were invisible. Replaced definitions are restored when the items go.
  • Pack analyzer in the importer. It reads pack.mcmeta, counts legacy CMD overrides and items/*.json, follows every model reference (item definitions, blockstates, parents, overrides) and classifies the pack as retexture, custom items, mixed or assets only. The report goes to the console and to admins.
  • /tessera migrate [folder]. Converts the items of another item plugin (name, lore, material, custom model data, model) into items/migrated_<folder>.yml, copies its textures and models into the pack and generates models for items that only have textures. The format is recognised from the folder layout; without a folder, every plugin folder with item configs is migrated. &/§ color codes become MiniMessage.
  • Pack merging. Importing a pack no longer overwrites files another pack added: items/*.json custom model data entries, atlases/*.json sources, lang/*.json keys and blockstate variants are combined. Anything that still had to be replaced is listed as a conflict in the console and to admins.
  • Pack check. Every generated pack is scanned for what shows as a missing texture in game: missing parents, textures and models, font bitmaps that do not exist, .png in texture names, upper case file names and broken JSON. /tessera pack doctor shows the full report.
  • item_model for items (1.21.4+): item_model: ns:id plus model: ns:item/path writes assets/<ns>/items/<id>.json and needs no custom model data. Imported standalone models and migrated items without custom model data use it.
  • Custom block models. A note block with model: gets its own note block state (stored in .block-states.yml so it never changes) and the pack shows the model through blockstates/note_block.json. Its item shows the model too. Redstone and the block below no longer change a custom note block.
  • The importer offers furniture: models at least half a block wide and tall get a furniture/ entry with a hitbox from the model size, and a seat when the name says chair, stool, bench or sofa.
  • Item definitions that pick models by custom model data (1.21.4+ packs) are imported as items, like legacy overrides.
  • Importer screen in the admin menu: packs in imports/ with their analysis, import one or all, migrate items from other plugins, and the pack check.
  • Item mechanics, on hit and on right click: lifesteal, bonus damage, lightning, explosions, potion effects, sounds, particles, commands and messages, with chance and per-player cooldowns. The old - type: lifesteal list form from the config examples works too.
  • hardness sets how long a custom block takes to break, with tool tiers for required_tool; a negative hardness makes it unbreakable.
  • light_level lights custom blocks through a light block above them.
  • PlaceholderAPI placeholders in HUD and welcome text.
  • WorldGuard, GriefPrevention and Towny checks for placing, breaking and sitting on furniture, and the tessera.bypass.protection permission.
  • Command messages come from the language files (messages.*) in English, Ukrainian, German and Spanish.
  • All HUD elements a player may see are shown together, joined with hud.separator, each re-rendered at its own update_interval. hud.enabled and hud.update_interval_ticks are read.
  • BLOCK_DISPLAY furniture shows a block (block: key, or the item's material).
  • SMITHING recipes with template, base and addition.
  • GitHub Actions: tests, plugin and site build on every push, and a release with the jar for every v* tag.
  • /tessera pack doctor offers to fix what it found ([YES]/[NO], or /tessera pack doctor fix). After a backup into backups/, it renames upper case files and namespaces and updates every reference, cuts .png from texture names, and removes vanilla overrides that point to missing files and blockstates or item definitions for things that are not in the game, so the vanilla file is used again. Custom models and textures that are missing are listed, since only the files themselves can fix those.
  • /tessera pack undo <import> removes the items, blocks and furniture an import created.
  • Updates from Modrinth: every updater.check_interval_hours Tessera looks for a newer release for the server's Minecraft version and puts it into plugins/update/, where Paper installs it on the next restart. The download must match Modrinth's SHA-512 and be Tessera's own plugin.yml. Admins are told in chat. /tessera update [check|install] runs it by hand.
  • Tests for the pack analyzer, merger, checker and migrator (gradlew test).
  • hud.pause_menu.texts: any client translation key (pause menu buttons and so on) set from MiniMessage text, in every language. Keys removed from the config are removed from the pack.

Changed

  • The importer creates items only for legacy CMD overrides (material from the host model, such as paper.json) and for item models nothing refers to, each with its model. A template from an older import with the same id and CMD gets the model added.
  • The importer no longer creates blocks for the minecraft namespace or for models used by blockstates. A vanilla override pack produced hundreds of junk blocks from door and stair variants.
  • pause_banner is drawn at 1024x128 and shown at 320x40 (ascent 31), so it stays sharp at every GUI scale. The old 256x32 texture is replaced.
  • Default pack_format is 84 (26.1). pack.mcmeta declares formats 34 to 99 for old and new clients.
  • The default HUD no longer shows the Tessera badge and name.
  • The jar is no longer obfuscated; the ProGuard step is gone from the build.
  • A broken entry (unknown material, bad recipe) is skipped with a warning instead of stopping the rest of its folder from loading.
  • Reload no longer restarts the pack HTTP server when its host and port stay the same, and the pack hash is only computed when the file changed.
  • Imported zips are limited to 1 GB unpacked and 100,000 files (zip bombs).

Fixed

  • Importing a big pack froze the server until the watchdog stopped it: the pack was zipped, protected and hashed on the main thread after every import. The pack is now built in the background, the new archive replaces the old one only when it is complete, and imports in a row share one build.
  • Packs for mods (namespaces with blockstates or lang files, and namespaced models in pre-1.21.4 packs) no longer turn into hundreds of Tessera items and furniture.
  • The Tessera banner stayed on the actionbar for servers with an older hud/default_hud.yml. It is cut out of existing HUD files on load.
  • Hundreds of conflict lines in the console: the first ten are shown, the full list is saved to imports/processed/<pack>.conflicts.txt.
  • Items, blocks and furniture written by the importer only loaded after a restart: reloads used the YAML files cached at startup. Every reload now reads them from disk.
  • /tessera reload did not re-read config.yml.
  • An item removed from its YAML stayed registered until a restart.

Removed

  • The top bossbar banner: hud.top_banner, the top_banner glyph and its toggles in the settings and admin menus. Transparent boss bar sprites it left in the pack folder are deleted, so boss bars of other plugins show again. The hud.top_banner section can be removed from existing configs.

release

2.0.0


Added

  • Pause menu banner. The resource pack replaces the "Game Menu" title of the Escape menu with the pause_banner glyph in all 142 client languages. Existing lang files in the pack folder are merged, not replaced. Toggle: hud.pause_banner.
  • top_banner glyph, sized for the bossbar title at the top of the screen.
  • hud.top_banner.hide_bar. Makes the bar of the configured bossbar color transparent, so only the banner is visible. Bars of that color from other plugins become invisible too.
  • pack.server.rate_limit.cooldown_minutes is now read. Per-IP download counters reset after the window.

Changed

  • tessera_banner is now ascent 11, height 16, so it fits the first line of an item tooltip.
  • pause_banner is now ascent 16, height 28, sized for the pause menu title.
  • Glyphs in formatted text (item names, lore, HUD, bossbar) are drawn without text shadow. The shadow used to show as a dark double edge on banners.
  • Default hud.top_banner.title is <white>:top_banner:</white>.
  • Pack messages are read from messages.pack, where config.yml defines them. pack.messages still works for older configs.
  • The pack format is read from pack.meta.pack_format, where config.yml defines it.
  • ProGuard reads the Java 21 toolchain modules, so gradlew build works when Gradle runs on a newer JDK.

Fixed

  • Security: the pack importer wrote zip entries such as ../../plugins/x.jar outside its temp folder (Zip Slip). A pack dropped into imports/ or imported by URL could place a plugin jar on the server. Such entries are now skipped with a warning.
  • Security: /tessera pack import <url> fetched any address, including localhost and the local network. Internal addresses are now refused, also after a redirect.
  • Security: /tessera pack import ../../file.zip read zips outside imports/ and moved them to processed/. Only files inside imports/ are accepted.
  • Furniture could be placed in protected regions. Placement now asks region plugins through a block place check, and furniture is not placed inside solid blocks.
  • Two hits in the same tick on a piece of furniture dropped its item twice.
  • Players stayed invulnerable and frozen when the pack failed to reload, had an invalid URL, or the client never answered. The loading lock now ends on every status and after 60 seconds at most.
  • /tessera hat deleted the old helmet when the inventory was full, and took off helmets with Curse of Binding.
  • The imports folder watcher imported zips that were still being copied, retried a broken zip every 15 seconds, and could import the same file twice together with the command. URL downloads are written as .part until complete, and failed URL imports are logged to the console.
  • URL imports have a 200 MB limit.
  • /tessera sit placed the player inside the target block, so standing up could move them through a wall or window. The player now sits on top of the block (on the step for stairs), and blocks higher than a jump or without room above are refused.
  • A custom block replaced without breaking it, for example by WorldEdit or /setblock, left its data behind, and the new block at that spot dropped the custom item. Such entries are now cleared.
  • The top banner was cut off at the top of the screen and crossed by the empty bossbar.
  • The top banner disappeared for a player after relogging.
  • The pack server refused an IP after 5 downloads until the next restart. Players sharing an IP, and local testing, ended up with no resource pack.
  • Sound names from config with multi-word parts, such as BLOCK_NOTE_BLOCK_CHIME, played nothing. The default first join sound UI_TOAST_CHALLENGE_COMPLETE was affected.
  • Breaking a piece of furniture removed the seats of other furniture nearby.
  • Several players could sit on the same seat.
  • Furniture seats stayed in the world after a crash, and /tessera cleartemp did not remove them.

Upgrading from 1.0.0

Existing files are not overwritten, so update them by hand:

  1. Delete plugins/Tessera/glyphs/default_glyphs.yml. It still has the old banner sizes and is recreated on the next start.
  2. In config.yml, set hud.top_banner.title to "<white>:top_banner:</white>".
  3. Run /tessera reload. Players get the new pack automatically.

release

1.0.0


Initial release.

  • Custom items from YAML: material, MiniMessage name and lore, custom model data, unbreakable, stack size.
  • Custom blocks with tool and tier requirements, sounds and drop tables, stored in the chunk PDC.
  • Furniture built from display and interaction entities, with scale, translation, cardinal rotation and seats.
  • Shaped, shapeless, cooking and stonecutting recipes, with custom items as result and ingredient.
  • Glyph registry that generates bitmap font providers, with :id: and <glyph:id> substitution.
  • Actionbar HUD with player placeholders, permission gating and a per-player toggle, plus a bossbar banner.
  • Resource pack generator, SHA-1 hashing, embedded HTTP server on port 8085 and anti-unzip protection.
  • Pack importer that merges external zips from imports/.
  • Welcome sequence for first and returning joins.
  • GUI catalog, admin dashboard, player settings and a recipe viewer.
  • The /tessera command, alias /t, with over thirty subcommands.
  • Language files for en, uk, de and es.