注意:本插件仍在开发中,可能包含漏洞。如果您遇到任何问题,或希望访问资源包服务器文件以自行托管资源包,请通过我们的 Discord 服务器联系我们。

Text Description
VortexPacks
VortexPacks 是一款适用于 Spigot/Paper Minecraft 服务器的服务端资源包管理与内容分发插件。它允许服务器管理员创建、编译并向玩家分发自定义方块、家具、物品、字形(glyphs)、自定义装备、自定义音效文件和光影,而无需安装任何客户端模组。
为什么选择 VortexPacks?
服务器主在引入自定义纹理、3D 模型或用户界面修改时,常面临以下挑战:
- 版本不匹配: 使用较旧或较新客户端加入服务器的玩家可能会因 Minecraft 不同版本的资源包格式变更而出现模型损坏或红色报错屏幕。VortexPacks 通过为每位玩家的客户端版本动态生成并提供定制的资源包来解决此问题(支持从 1.18.2 到 1.21.11+ 的版本)。
- 复杂的设置流程: 手动编辑 JSON 文件、管理图集(Atlases)、匹配 CustomModelData 或编写光影既耗时又容易出错。VortexPacks 基于简单的配置文件自动执行资源包编译过程(包括 Atlas 配置和精灵对齐)。
- 视觉一致性: 它包含实时数据包重写功能,可将现代物品组件转换回旧版 CustomModelData,确保所有连接版本间的视觉一致性。
主要功能
自定义内容生成
- 高级自定义方块: 使用未使用的音符盒状态定义自定义方块(支持破坏动画和自定义音效配置)。
- 自定义家具: 允许创建带有自定义碰撞箱、座位机制和碰撞障碍的装饰性物品。
- 现代装备资产 (1.21.2+): 原生支持 Minecraft 的新装备资产系统,自动生成自定义盔甲套装和纹理。
- 动态 3D 模型: 自动优化并将自定义 JSON 模型和纹理编译至服务器的资源包中。
- UI 与字形映射: 将自定义字体、表情符号和纹理烘焙到客户端界面和聊天显示中。
- 位置音频: 支持自定义
.ogg 音效文件,具备可配置的类别、字幕和 3D 空间定位功能。
兼容性与版本翻译
- 动态版本分支: 使用 ViaVersion 或 ProtocolLib 检测玩家的客户端版本,然后生成并提供具有匹配
pack_format 头部的资源包(支持从 1.18.2 到 1.21.11+ 的客户端格式)。
- 数据包重写 (Netty 拦截): 在运行时拦截传入/传出的网络数据包,将现代
item_model 组件重写为低于 1.21.4 版本玩家的旧版 CustomModelData。
- Atlas 规范化: 自动构建 Minecraft Atlases (
assets/minecraft/atlases/items.json 和 blocks.json),并在 1.21.6+ 客户端上处理分离的物品/方块图集,以防止重复加载精灵的错误。
- 旧版盔甲光影: 对于不支持现代装备系统的低于 1.21.2 版本的客户端,VortexPacks 会编译并捆绑光影,以便在皮革盔甲覆盖层上渲染自定义盔甲纹理和动画。
- 动态文本光影: 将映射到自定义颜色代码的文本光影 (
rendertype_text) 打包,以在游戏中应用动画(摆动、倾斜、发光)和渐变循环。
- 通用导入器: 提供内置的导入器命令,用于迁移来自 Oraxen 或其他旧版资源系统的现有资产和配置。
性能优化
- MSPT 优化处理: 专为 Paper 服务器优化,利用原生配置(如音符盒的
disable-interaction)来最小化方块右键处理的开销。
工作原理
玩家体验
- 当玩家加入服务器时,插件会检测其客户端版本。
- 插件提示玩家下载为其版本分支专门生成的资源包。
- 玩家可以原生看到自定义方块、家具、盔甲和 UI 元素,无需任何客户端模组。
管理员管理
- 配置: 在插件的配置文件夹中定义自定义物品、方块、盔甲和音频。
- 编译: 运行
/packs generate 以编译资产、注册字形、构建图集并更新生成的版本化资源包。
- 分发: 运行
/packs upload 将生成的 zip 文件复制到配置的资源包主机服务器。
- 重载: 运行
/packs reload 以重新加载服务器上的配置文件和缓存。
系统要求与依赖项
兼容性
- 服务器平台: Spigot、Paper 或兼容分支。
- Minecraft 版本: 1.18.2 及以上。
依赖项
- ProtocolLib(必需 - 用于玩家版本检测和数据包翻译)
- ViaVersion(可选 - 可选,用于更好的客户端版本检测)
Note: This plugin is still in development and may contain bugs. If you encounter any issues, or want to access the resource pack server file to self host your resource packs, please contact us on our Discord server.

Text Description
VortexPacks
VortexPacks is a server-side resource pack management and content distribution plugin for Spigot/Paper Minecraft servers. It allows server administrators to create, compile, and distribute custom blocks, furniture, items, glyphs, custom equipment, custom sound files, and shaders to players without requiring any client-side mods.
Why Choose VortexPacks?
Server owners often face challenges when introducing custom textures, 3D models, or user interface modifications:
- Version Mismatches: Players joining on older or newer clients may experience broken models or red error screens due to resource pack format changes across Minecraft versions. VortexPacks solves this by dynamically generating and serving tailored resource packs for each player's client version (from 1.18.2 to 1.21.11+).
- Complex Setup Processes: Manually editing JSON files, managing Atlases, matching CustomModelData, or writing shaders is time-consuming and error-prone. VortexPacks automates the pack compilation process (including Atlas configuration and sprite alignment) based on simple configuration files.
- Visual Consistency: It includes on-the-fly packet rewriting to translate modern item components back into legacy CustomModelData for older clients, ensuring visual consistency across all connected versions.
Key Features
Custom Content Generation
- Advanced Custom Blocks: Defines custom blocks using unused Note Block states (supporting break animations and custom sound profiles).
- Custom Furniture: Allows creation of decorative items with custom hitboxes, seat mechanics, and collision barriers.
- Modern Equipment Assets (1.21.2+): Natively supports Minecraft's new equipment asset system to automatically generate custom armor sets and textures.
- Dynamic 3D Models: Automatically optimizes and compiles custom JSON models and textures into the server's resource pack.
- UI & Glyph Mapping: Bakes custom fonts, emojis, and textures directly into client interfaces and chat displays.
- Positional Audio: Supports custom
.ogg sound files with configurable categories, subtitles, and 3D spatial positioning.
Compatibility & Version Translation
- Dynamic Version Branching: Detects the player's client version using ViaVersion or ProtocolLib, then generates and serves a resource pack with the matching
pack_format header (supporting client formats from 1.18.2 up to 1.21.11+).
- Packet Rewriting (Netty Interception): Intercepts incoming/outgoing network packets at runtime to rewrite modern
item_model components into legacy CustomModelData for players on versions below 1.21.4.
- Atlas Normalization: Automatically builds Minecraft Atlases (
assets/minecraft/atlases/items.json and blocks.json) and handles split item/block atlases on 1.21.6+ clients to prevent duplicate-sprite loading errors.
- Legacy Armor Shaders: For clients below 1.21.2 (which do not support the modern equipment system), VortexPacks compiles and bundles shaders to render custom armor textures and animations on leather armor overlays.
- Dynamic Text Shaders: Packages text shaders (
rendertype_text) mapped to custom color codes to apply animations (waving, skewing, glowing) and gradient cycles to in-game text.
- Universal Importer: Provides a built-in importer command to migrate existing assets and configurations from Oraxen or other legacy resource systems.
Performance Optimization
- MSPT-Optimized Handling: Specifically optimized for Paper servers by utilizing native configurations (like
disable-interaction for Note Blocks) to minimize block right-click processing overhead.
How It Works
Player Experience
- When a player joins the server, the plugin detects their client version.
- The plugin prompts the player to download the resource pack generated specifically for their version branch.
- The player sees custom blocks, furniture, armor, and UI elements natively, with no client-side mods needed.
Administrator Management
- Configuration: Define custom items, blocks, armor, and audio in the plugin's configuration folders.
- Compilation: Run
/packs generate to compile assets, register glyphs, build atlases, and update the generated versioned packs.
- Distribution: Run
/packs upload to copy the generated zip files to the configured pack host server.
- Reload: Run
/packs reload to reload configuration files and caches on the server.
System Requirements & Dependencies
Compatibility
- Server Platforms: Spigot, Paper, or compatible forks.
- Minecraft Versions: 1.18.2 and above.
Dependencies
- ProtocolLib (Required - for player version detection and packet translation)
- ViaVersion (Optional - Optional for better client version detection)
评论 0
登录后参与评分
还没有评论,来抢沙发吧