独立 Minecraft 插件(支持 Paper/Purpur 1.21.x,Java 21+),用于自定义物品、方块、家具和 HUD 元素。不依赖其他插件。
Smart Pack Engine:输入任意整合包,输出可用整合包
智能导入。 将任意资源包放入 imports/ 目录,或运行 /tessera pack import <url>。Tessera 会像人一样读取它:检测格式和 Minecraft 版本,追踪每一个模型引用,识别重贴图、自定义物品、家具及模组资产;它会将你的包与导入的包合并,而不是覆盖文件,并自动为你创建物品。构建过程在后台异步进行,因此即使是巨大的整合包也不会导致服务器卡顿。改变主意了?使用 /tessera pack undo 撤销即可。
整合包医生。 紫色和黑色的纹理?运行 /tessera pack doctor。它会查找每一个缺失的模型、纹理、字体位图、损坏的 JSON、错误的文件名以及残留的模组文件,然后询问 [YES] / [NO]。只需点击一次:Tessera 会备份整合包,重命名、重写并清理损坏部分,重新构建后将其发送给玩家。
当出现问题时它会告诉你。 如果某个整合包对玩家加载失败,管理员会在聊天窗口中收到一个可点击的 /tessera pack doctor 按钮。无需翻阅日志。
> /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.
要求: Java 21+,Paper 或 Purpur 1.21.x
Tessera 会在服务器启动时根据你在配置文件中定义的内容(模型、纹理、音效、字体和字形)构建资源包。你不需要手动打包任何东西。
- 整合包会在启动和
/tessera reload 时构建,并为 1.21.4+ 版本自动生成物品定义。
- 每次构建都会检查缺失的模型和纹理。
/tessera pack doctor 会列出游戏中显示为紫色和黑色的内容。
- 将任意资源包放入
imports/:Tessera 会分析它,将其与你的整合包合并而不是覆盖文件,并为其添加的物品和家具创建定义。
/tessera migrate 会从其他物品插件迁移物品、模型和纹理。
- 全面支持 MiniMessage,物品文本不使用斜体,且字形绘制时无阴影。
物品:
model 加上 item_model(1.21.4+)或 custom_model_data。Tessera 负责编写物品定义。
- 命中和点击时的机制:生命窃取、闪电、爆炸、药水效果、音效、粒子、命令和冷却时间。
- MiniMessage 名称和描述,不可破坏,堆叠数量,文本中包含字形。
方块:
- 基于音符盒构建,每个音符盒都有各自的状态,因此你的模型会显示在世界中和手中。
- 真实的破坏时间取决于
hardness(硬度)、工具等级、光照等级、掉落表和音效。
- 尊重 WorldGuard、GriefPrevention 和 Towny 对家具的保护设置。
家具:
-
由 ItemDisplay 和 Interaction 实体构建——包括座位和与模型大小匹配的碰撞箱。
-
状态在重启和区块卸载后保持不变。
-
注册为字体字形的自定义图标,可在任何 Tessera 文本中作为 :id: 使用。
-
动作栏 HUD,同时显示生命值、延迟、坐标、PlaceholderAPI 占位符等多种元素。
-
用横幅替代退出菜单标题,暂停菜单中的任何标签均可从配置文件替换。
- 将
Tessera.jar 放入 plugins/ 文件夹。
- 启动服务器(Java 21+,Paper/Purpur 1.21.x)。
- Tessera 在首次运行时创建其配置文件夹:
items/、blocks/、furniture/、glyphs/、hud/,并在 plugins/Tessera/pack/ 处构建整合包。
- 将生成的整合包发送给玩家,或由内置发送器处理。
| 命令 |
权限 |
描述 |
/tessera menu |
— |
打开 GUI 仪表板 |
/tessera give <player> <id> [amount] |
tessera.give |
给玩家一个自定义物品 |
/tessera pack |
tessera.admin |
重新生成并托管资源包 |
/tessera reload |
tessera.admin |
重载配置、字形和模块 |
完整命令列表(30+)
| 命令 |
权限 |
描述 |
/tessera help [1-3] |
— |
列出命令,分页显示 |
/tessera menu [category|query] |
— |
打开主 GUI 枢纽 |
/tessera browse |
— |
打开物品/方块浏览器 |
/tessera admin |
tessera.admin |
打开管理面板 |
/tessera settings |
— |
打开玩家设置(HUD、资源包) |
/tessera get <id> [amount] |
tessera.get |
给自己一个自定义物品或方块 |
/tessera give <player> <id> [amount] |
tessera.give |
给另一个玩家物品 |
/tessera giveall <id> [amount] |
tessera.giveall |
给所有在线玩家物品 |
/tessera drop <id> [amount] [world x y z] |
tessera.drop |
在指定位置掉落自定义物品 |
/tessera durability <get|set|add|repair> [amount] |
tessera.durability |
查看或调整物品耐久度 |
/tessera cmd <get|set> [value] |
tessera.admin |
读取或设置手中物品的 CustomModelData |
/tessera nbt |
— |
列出手中物品上的 PersistentDataContainer 键 |
/tessera killfurniture [radius] |
tessera.admin |
移除附近的家具实体 |
/tessera cleartemp |
tessera.admin |
清理孤立的座位实体 |
/tessera sound <name> [vol] [pitch] |
— |
在你所在位置播放声音 |
/tessera stats |
tessera.admin |
显示内存、线程和注册表计数 |
/tessera emote <name> |
— |
播放装饰性粒子/音效效果 |
/tessera export |
tessera.admin |
导出目录清单为 JSON |
/tessera recipe <id> |
— |
打开合成配方查看器 |
/tessera inspect |
— |
显示手中物品的 PDC/data 组件 |
/tessera search <query> |
— |
按 ID 搜索物品、方块和家具 |
/tessera hat |
— |
将手中物品作为帽子佩戴 |
/tessera sit |
— |
坐在目标方块上 |
/tessera repair [hand|all] |
tessera.repair |
修复物品耐久度 |
/tessera block <info|remove> |
remove: tessera.admin |
检查或移除自定义方块 |
/tessera furniture <list|remove> [radius] |
remove: tessera.admin |
列出或移除附近的家具 |
/tessera debug [entities] |
tessera.admin |
运行基准测试或实体报告 |
/tessera hud |
— |
切换动作栏 HUD |
/tessera pack [generate|apply|push|import|doctor] |
tessera.admin |
重新生成、推送、导入或检查资源包 |
/tessera migrate [folder] |
tessera.admin |
从其他物品插件迁移物品和资源 |
/tessera welcome |
tessera.admin |
重播欢迎序列 |
/tessera reload |
tessera.admin |
热重载配置和模块 |
/tessera info |
— |
显示插件版本和注册表计数 |
每种内容类型都有其自己的文件夹和 YAML 格式。示例物品配置:
# 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
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
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:
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.
-
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.
- Drop
Tessera.jar into plugins/.
- Start the server (Java 21+, Paper/Purpur 1.21.x).
- Tessera creates its config folders on first run:
items/, blocks/, furniture/, glyphs/, hud/, and builds the pack at plugins/Tessera/pack/.
- Send players the generated pack, or let the built-in sender handle it.
| Command |
Permission |
Description |
/tessera menu |
— |
Opens the GUI dashboard |
/tessera give <player> <id> [amount] |
tessera.give |
Gives a custom item to a player |
/tessera pack |
tessera.admin |
Regenerates and hosts the resource pack |
/tessera reload |
tessera.admin |
Reloads configs, glyphs, and modules |
Full command list (30+)
| Command |
Permission |
Description |
/tessera help [1-3] |
— |
Lists commands, paginated |
/tessera menu [category|query] |
— |
Opens the main GUI hub |
/tessera browse |
— |
Opens the item/block browser |
/tessera admin |
tessera.admin |
Opens the admin dashboard |
/tessera settings |
— |
Opens player settings (HUD, pack) |
/tessera get <id> [amount] |
tessera.get |
Gives yourself a custom item or block |
/tessera give <player> <id> [amount] |
tessera.give |
Gives an item to another player |
/tessera giveall <id> [amount] |
tessera.giveall |
Gives an item to all online players |
/tessera drop <id> [amount] [world x y z] |
tessera.drop |
Drops a custom item at a location |
/tessera durability <get|set|add|repair> [amount] |
tessera.durability |
Checks or adjusts item durability |
/tessera cmd <get|set> [value] |
tessera.admin |
Reads or sets CustomModelData on the held item |
/tessera nbt |
— |
Lists PersistentDataContainer keys on the held item |
/tessera killfurniture [radius] |
tessera.admin |
Removes furniture entities nearby |
/tessera cleartemp |
tessera.admin |
Cleans up orphaned seat entities |
/tessera sound <name> [vol] [pitch] |
— |
Plays a sound at your location |
/tessera stats |
tessera.admin |
Shows memory, thread, and registry counts |
/tessera emote <name> |
— |
Plays a cosmetic particle/sound effect |
/tessera export |
tessera.admin |
Exports 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.repair |
Repairs item durability |
/tessera block <info|remove> |
remove: tessera.admin |
Inspects or removes a custom block |
/tessera furniture <list|remove> [radius] |
remove: tessera.admin |
Lists or removes nearby furniture |
/tessera debug [entities] |
tessera.admin |
Runs a benchmark or entity report |
/tessera hud |
— |
Toggles the actionbar HUD |
/tessera pack [generate|apply|push|import|doctor] |
tessera.admin |
Regenerates, pushes, imports or checks the resource pack |
/tessera migrate [folder] |
tessera.admin |
Migrates items and assets from other item plugins |
/tessera welcome |
tessera.admin |
Replays the welcome sequence |
/tessera reload |
tessera.admin |
Hot-reloads configs and modules |
/tessera info |
— |
Shows plugin version and registry counts |
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧