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 doctorbutton (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_dataandmodel, the pack getsassets/minecraft/items/<material>.jsonwith arange_dispatchon custom model data in front of the material's own definition. Legacyoverridesare 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 anditems/*.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) intoitems/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/*.jsoncustom model data entries,atlases/*.jsonsources,lang/*.jsonkeys 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,
.pngin texture names, upper case file names and broken JSON./tessera pack doctorshows the full report. item_modelfor items (1.21.4+):item_model: ns:idplusmodel: ns:item/pathwritesassets/<ns>/items/<id>.jsonand 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.ymlso it never changes) and the pack shows the model throughblockstates/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: lifesteallist form from the config examples works too. hardnesssets how long a custom block takes to break, with tool tiers forrequired_tool; a negative hardness makes it unbreakable.light_levellights 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.protectionpermission. - 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 ownupdate_interval.hud.enabledandhud.update_interval_ticksare read. BLOCK_DISPLAYfurniture shows a block (block:key, or the item's material).SMITHINGrecipes withtemplate,baseandaddition.- GitHub Actions: tests, plugin and site build on every push, and a release with the jar for every
v*tag. /tessera pack doctoroffers to fix what it found ([YES]/[NO], or/tessera pack doctor fix). After a backup intobackups/, it renames upper case files and namespaces and updates every reference, cuts.pngfrom 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_hoursTessera looks for a newer release for the server's Minecraft version and puts it intoplugins/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 itsmodel. A template from an older import with the same id and CMD gets themodeladded. - The importer no longer creates blocks for the
minecraftnamespace or for models used by blockstates. A vanilla override pack produced hundreds of junk blocks from door and stair variants. pause_banneris 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_formatis 84 (26.1).pack.mcmetadeclares 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 reloaddid not re-readconfig.yml.- An item removed from its YAML stayed registered until a restart.
Removed
- The top bossbar banner:
hud.top_banner, thetop_bannerglyph 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. Thehud.top_bannersection 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_bannerglyph in all 142 client languages. Existing lang files in the pack folder are merged, not replaced. Toggle:hud.pause_banner. top_bannerglyph, 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_minutesis now read. Per-IP download counters reset after the window.
Changed
tessera_banneris now ascent 11, height 16, so it fits the first line of an item tooltip.pause_banneris 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.titleis<white>:top_banner:</white>. - Pack messages are read from
messages.pack, whereconfig.ymldefines them.pack.messagesstill works for older configs. - The pack format is read from
pack.meta.pack_format, whereconfig.ymldefines it. - ProGuard reads the Java 21 toolchain modules, so
gradlew buildworks when Gradle runs on a newer JDK.
Fixed
- Security: the pack importer wrote zip entries such as
../../plugins/x.jaroutside its temp folder (Zip Slip). A pack dropped intoimports/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, includinglocalhostand the local network. Internal addresses are now refused, also after a redirect. - Security:
/tessera pack import ../../file.zipread zips outsideimports/and moved them toprocessed/. Only files insideimports/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 hatdeleted 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
.partuntil complete, and failed URL imports are logged to the console. - URL imports have a 200 MB limit.
/tessera sitplaced 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 soundUI_TOAST_CHALLENGE_COMPLETEwas 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 cleartempdid not remove them.
Upgrading from 1.0.0
Existing files are not overwritten, so update them by hand:
- Delete
plugins/Tessera/glyphs/default_glyphs.yml. It still has the old banner sizes and is recreated on the next start. - In
config.yml, sethud.top_banner.titleto"<white>:top_banner:</white>". - 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
/tesseracommand, alias/t, with over thirty subcommands. - Language files for en, uk, de and es.