这是什么
Repack 是一个针对玩家所见所用的自定义套件:包含由 Blockbench 模型制作的自定义方块和物品、世界锚定的涟漪效果和屏幕震动、基于图片或光影的天空盒、动态文字颜色等(更多功能将在路标中陆续推出)。所有功能均整合为每个客户端版本一个资源包。
视觉特效
- 涟漪。 从世界中某一点扩散的冲击波,并使屏幕产生弯曲效果。
- 屏幕震动。 在爆炸、击中或其他情况下使玩家屏幕震动,并逐渐消散。
- 天空盒。 用全景图片或小型光影替换天空(Repack 自带星空、云层和渐变效果)。你可以选择每种效果的显示位置:按世界、维度或生物群系。
- 动态文字。 聊天栏、告示牌和物品名称中的特定颜色文字会闪烁、脉冲、波浪或呈现彩虹色。
自定义方块和物品
- 来自 Blockbench 模型的方块。 放入
.bbmodel文件即可将其制作成方块。挖掘时间、掉落物、工具、声音等均支持设置。 - 动画模型。 在 Blockbench 中制作的动画可在方块上播放;方块在被放置、闲置或破坏时可分别播放不同的动画。
- 自定义物品 拥有独立的名称、描述、模型和光泽效果。
这些方块在服务端不使用实体,随世界一起保存,并且兼容 WorldGuard 等保护插件。
所有内容均可通过游戏内的 /repack 命令进行设置(包括方块和物品的界面,以及服务器设置),也可通过编辑文件进行配置。服务器管理员:请阅读 指南。脚本编写者和插件开发者:dev.md 涵盖了 Skript 和 Java API 的相关内容。
每次对 main 分支的提交都会构建并发布到 RATR2/repack-nightly。
安装
你需要运行 1.21.4 或更高版本的 Paper(或 Purpur)服务器,并安装 PacketEvents 插件(Spigot jar 包,版本 2.14.0 或更高)。玩家可以以 1.21.4 至 26.3 之间的任意版本加入。ViaVersion 是可选的,允许非服务器版本的其他玩家也能加入。
- 将
repack.jar和 PacketEvents jar 包放入plugins/目录并启动服务器。 - 在
plugins/Repack/config.yml中,将resource-pack.public-host设置为你的服务器地址,以便玩家下载资源包。 - 加入游戏,运行
/repack give table获取示例方块。将其放置。 - 将你自己的模型添加到
plugins/Repack/models/目录,并在/repack> 方块构建器中将其制作成方块。
指南 解释了其余内容:构建和发送资源包、方块和物品选项、特效以及故障排除。
状态
开发中。已构建并通过单元测试,但可能存在粗糙之处。
- 模型支持立方体和骨骼。网格将被跳过。
- 某些特效依赖于玩家的图形设置或版本,指南 中列出了每个特效的相关信息。
许可
见 LICENSE。MIT 协议。模型解析和资源包生成功能改编自 BetterModel,同样采用 MIT 协议,详见 NOTICE。
感谢 R4T Out。
Repack
Rendering of Entities, Post-effects, & Advanced Customization Kit
If you find any issues, please report them here
What is this
Repack is a customization kit for what players see and use: custom blocks and items made from Blockbench models, world-anchored ripple effects and screen shake, skyboxes from pictures or shaders, animated text colors, and more to come (the roadmap is in the repository). Everything is built into one resource pack per client version.
Visual effects
- Ripples. A shockwave that spreads out from a spot in the world and bends the screen.
- Screen shake. Shake a player's screen for explosions, hits or anything else, and let it fade out.
- Skyboxes. Replace the sky with a panorama picture or a small shader (stars, clouds and a gradient come with Repack). Choose where each one shows: by world, dimension or biome.
- Animated text. Text in certain colors shines, pulses, waves or turns rainbow, in chat, signs and item names.
Custom blocks and items
- Blocks from Blockbench models. Drop in a
.bbmodeland make a block from it. Mining time, drops, tools, sounds and more are all settings. - Animated models. Animations made in Blockbench play on blocks, and a block can play one when it is placed, when it idles, and when it is broken.
- Custom items with their own name, lore, model and shine.
Blocks use no entities on the server, are saved with the world, and work with protection plugins like WorldGuard.
Everything is set up in the game with /repack (screens for blocks and items, and for the server settings) and in files you can edit. Server owners: read the guide. Scripters and plugin developers: dev.md covers Skript and the Java API.
Every commit on main is built and published to RATR2/repack-nightly.
Install
You need a Paper (or Purpur) server on 1.21.4 or newer, and the PacketEvents plugin (the Spigot jar, 2.14.0 or newer). Players can join on any version from 1.21.4 to 26.3. ViaVersion is optional, and lets players on versions other than the server's join too.
- Put
repack.jarand the PacketEvents jar inplugins/and start the server. - In
plugins/Repack/config.yml, setresource-pack.public-hostto your server's address, so players can download the pack. - Join, and run
/repack give tableto get the example block. Place it. - Add your own models to
plugins/Repack/models/and make blocks from them in/repack> Block builder.
The guide explains the rest: building and sending the pack, block and item options, effects, and troubleshooting.
Status
In development. Built and unit tested, but expect rough edges.
- Models support cubes and bones. Meshes are skipped.
- Some effects depend on the player's graphics settings or version, which the guide lists for each one.
License
See LICENSE. MIT. The model parsing and pack generation are adapted from BetterModel, also MIT, see NOTICE.
Thanks, R4T Out.
下载 Repack
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Repack
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Repack
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Repack
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Repack
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
版本 1.1.0
冲击帧、维度、文本规则,以及大量工作以保持众多自定义模组的低成本。
新增
- 冲击帧:一种黑白动漫风格的命中特效,在焦点位置带有形状,支持从文件、Skript 或 Java 中获取。
- 维度:Repack 从文件中生成的额外世界,使用自定义模组作为地形。
- 更快的自定义模组:渲染距离优化、实体合并以及模型剔除。
- 登录等待区:在玩家的整合包加载完成前,玩家会被隐藏且不受伤害。
- Repack 加入事件:当加入玩家的客户端拥有该整合包时触发一次。
- 文本规则:其他插件可以将特定颜色的标记文本移动到屏幕锚点。
- /repack 中的文本特效编辑器。
- 开发模式:整合包服务器上的文件上传器以及 /repack test 命令。
- 每种聊天通知的开关。
- Skript 语法已为文档工具提供文档说明。
更改
- 创建自定义物品现在接受一个物品类型(例如将基础物品绿宝石命名为“红宝石”),并替换具有相同 ID 的物品。
- 共享整合包服务器的插件会合并其设置,无论加载顺序如何。
- 在没有整合包服务器的情况下,不会发送任何整合包。
修复
- 掉落物(沙子、砾石)保持为自定义模组。
- 更改后的代理块会将放置的方块移动至该代理块。
- 构建器拒绝覆盖在打开状态下发生更改的文件。
已知问题:动画文本特效在文本显示器上不显示。
R4T, Out.
显示 Modrinth 错误
已添加
- 保存模型或方块文件后,整合包会在几秒内自动重新构建,且过程静默:不会向任何在线玩家发送通知。加入服务器的玩家将获取最新构建的版本(设置
resource-pack.join-latest-build: false时,他们仅获得上次推送的整合包)。 /repack push会将整合包发送给所有在线玩家,或使用/repack push <player>发送给指定的一名玩家。/repack reload现在会读取方块文件、构建整合包并将其推送给所有在线玩家。/repack build仅执行构建操作。- 当客户端加载 Repack 发送的整合包时,玩家最多会被限制 20 秒:在此期间他们无法受到伤害、移动、攻击或进行交互,看不到其他实体,周围的方块会显示为黑色混凝土。此状态在两次加载之间至少有 2 分钟的冷却时间。可通过
resource-pack.invulnerable-while-loading关闭无敌效果,通过resource-pack.black-blocks-while-loading关闭黑色方块效果,并通过resource-pack.loading-radius设置影响半径。 - 操作员在整合包构建期间会看到一个进度 Boss 栏(
workflow.progress-bar)。workflow.build-on-change可关闭自动重新构建功能。 - 转换后的模型缓存在
plugins/Repack/cache/models中,因此构建时仅转换发生更改的模型。使用/repack build fresh将忽略缓存。 - 提供了针对服务器管理员的
guide.md以及针对 Skript 和 Java API 的dev.md。 - 每次提交的夜间构建版本均发布至 RATR2/repack-nightly。
已修复
- 整合包下载支持并行传输,因此单个网速较慢的玩家不再阻塞其他玩家的下载。
- 格式错误的
.bbmodel文件仅被视为该文件的错误,而不会导致整个构建流程中断;若模型中的方块超出游戏加载范围,则该模型会被排除并记录错误。 - 名称包含非法 ID 字符(如空格、点号)的方块文件会被报告错误,而不是静默破坏已保存的方块。
- 整合包文件采用安全方式写入,损坏的文件将在下次构建时自动修复,旧的未使用整合包会在一天后删除。
/give命令现在显示实际发放的数量;/repack push仅统计成功接收整合包的玩家数量;当一个模型被多次展示时,不再重复生成多次。- 日志会在玩家将被提示从 localhost 下载整合包时发出警告。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧