VFXWeaver 为 Minecraft 增添了电影般的视觉层:60+ 种特效以帧后处理光影的形式渲染,涵盖摄像机运镜、世界与实体叠加层、屏幕图像以及音效。可以通过命令触发一种特效,在浏览器中打开的节点编辑器里构建你自己的特效,或通过数据包、服务器插件或你自己的模组来驱动它们。
仅客户端运行。无需在服务器上安装任何内容,也不需要资源包。
两分钟体验
- 将
vfxweaver-2.5.0+<minecraft>-<loader>.jar放入mods/目录(版本标签页可按游戏版本和加载器进行筛选)。 - 开启作弊启动一个世界,或在服务器上拥有 OP 权限。
/vfx list会列出所有特效 ID。然后:
| 命令 | 效果展示 |
|---|---|
/vfx play vfxweaver:datamosh |
画面融化:旧帧的像素沿运动方向拖拽,画面分裂成陈旧内容的色块。 |
/vfx play vfxweaver:torn_edge |
画面沿锯齿状线条撕裂,两侧在发光边缘下被拉开。 |
/vfx play vfxweaver:spectral |
七级棱镜渐变:双色调、色差涂抹或光谱环。 |
/vfx play vfxweaver:hex_grid |
三角晶格,其线条颜色随屏幕位置变化。 |
/vfx play vfxweaver:vhs |
磁带磨损效果:跟踪带干扰、色彩溢出、抖动。 |
/vfx play vfxweaver:heartbeat |
你设定节奏的心跳声。 |
/vfx play vfxweaver:vortex |
世界螺旋向中心收缩。 |
/vfx play vfxweaver:shockwave |
从一点向外扩散的环形冲击波。 |
/vfx play vfxweaver:camera_shake |
带有平滑包络线的撞击震动,而非随机抖动。 |
/vfx playentity vfxweaver:entity_outline @e[type=pig,limit=1] |
对选定实体应用纹理感知的轮廓线。 |
单次播放持续几秒:再次运行可重复播放,使用 /vfx stop <effect> 停止。任何参数均可就地覆盖,例如 /vfx play vfxweaver:vhs {[intensity:1.5]} 会产生相同但强度更高的效果。多个相同特效的播放会叠加而非相互替换。
在浏览器中构建你自己的特效
/vfxeditor 启动由游戏本身提供的小型节点编辑器,并在你的浏览器中打开。特效表现为节点图;每个参数可以接受常量、起始/结束渐变、关键帧或表达式。你在拖动节点时,画布会在游戏中实时预览时间线为每个动画参数提供单独轨道,导出 (Export) 会将结果写入标准的 data/<namespace>/vfx/<name>.json —— 这正是数据包所包含的内容格式,因此不存在仅限编辑器使用的格式,也无需安装额外组件。
URL 携带一次性令牌,桥接服务仅绑定到 127.0.0.1,关闭标签页不会留下任何后台进程。
内置内容
- 屏幕特效,40 种 — 色差、色彩分级、扭曲、凹陷、漩涡、冲击波、像素化、半调、漫画风格、墨水效果、海报化、渐变映射、色相隔离、反色、太阳化、切片偏移、重影、眼睑效果、虹膜擦除、数字故障、VHS、数据损坏、撕裂边缘、光谱、扫描线、胶片颗粒、运动模糊、模糊、泛光、景深、黑边、速度线、暗角、屏幕闪光、强调辉光、残影、定格动画、噪声扭曲、天空图案、表面图案。
- 摄像机特效,3 种 — 震动、荷兰角、视场角。
- 世界特效,7 种 — 方块着色、方块轮廓、光束、脉冲环、引导线、粒子、方块链。
- 实体特效,3 种 — 着色、基于 UUID 的轮廓和位移、纹理感知。
- 音频特效,4 种 — 心跳、嗡嗡声、噪声和音量压限,它们在独立的音频线程上合成,确保帧率不会影响声音。
- 图像和窗口 —
screen_image在帧上方绘制图片(来自资源包的 PNG,支持动画或非动画)。window_create在游戏运行时打开一个真正的无边框点击穿透桌面窗口,显示一张图片。 - 附加功能 — 雾效修改器、蒙版(屏幕、世界和实体体积,低至自定义 GLSL 插件)、集合(将多个特效组合为一个)、缓动曲线和全局关键帧。
数据包
定义文件是一个 JSON 文件:包含特效类型、时间轴、参数,以及对世界、摄像机或玩家的可选绑定。参数可以作为常量、start/end 渐变、带缓动的关键帧或 expr 表达式进行动画,并且可以读取玩家的位置、朝向或生命值。
JAR 包自带 73 个预置定义,每种特效类型一个,因此学习格式最快的方法是复制其中一个并修改数值。服务器可以通过 vfxweaver:vfx_trigger 触发特效,并通过 vfxweaver:vfx_sync 同步定义;数据包携带 PROTOCOL_VERSION,如果客户端检测到不兼容的版本,会静默忽略而不会影响你的世界。
用于录制文档网站演示视频的数据包是公开的:vfx-demos-showcase.zip。它搭建了一个舞台(/function vfx_demos:scene/setup)并为每种特效播放一个循环演示(例如 /vfx play vfx_demos:show_vhs),这是快速浏览所有内容的最快方式。
给模组开发者
dev.vfxweaver.api.VFXAPI 允许从服务器端播放、停止、实时调整和对玩家的特效设置关键帧,registerImage 让你的模组可以将自行绘制的图像交给渲染器。网络布局、定义注册表以及完整的调用接口详见 docs/API.md。
要求
| Minecraft | 26.2, 26.1.x, 1.21.11 |
| Loader | Fabric 0.18.4+(适用于 26.x),0.17.3+(适用于 1.21.11),或 NeoForge |
| Fabric API | Fabric 平台必需 |
| Java | 25+ |
| 运行侧 | 客户端;服务端为可选,仅承载数据包同步和触发功能 |
录制进 Flashback 回放中的特效会随回放一起播放,包括循环播放和持久性特效。
链接
- 指南 — 命令、所有特效及其参数、数据包格式、蒙版、编辑器:
- 源代码和问题反馈 —
- 更新日志 —
VFXWeaver puts a cinematic layer over Minecraft: 60+ effects rendered as post-processing shaders on top of the frame, camera moves, world and entity overlays, screen images and sound. Fire one from a command, build your own in a node editor that opens in your browser, or drive them from a datapack, a server plugin or your own mod.
Client-side only. Nothing to install on the server, no resource pack required.
Try it in two minutes
- Drop
vfxweaver-2.5.0+<minecraft>-<loader>.jarintomods/(the versions tab filters by game version and loader). - Launch a world with cheats on, or be op on a server.
/vfx listprints every effect id. Then:
| Command | What you see |
|---|---|
/vfx play vfxweaver:datamosh |
The picture melts: pixels of the old frame are dragged along the movement and the frame breaks into blocks of stale content. |
/vfx play vfxweaver:torn_edge |
The frame splits along a jagged line, the two sides pulled apart under a glowing edge. |
/vfx play vfxweaver:spectral |
A seven-stop prism ramp: a duotone, a chromatic smear or a spectral ring. |
/vfx play vfxweaver:hex_grid |
A triangular lattice whose lines take their colour from the screen position. |
/vfx play vfxweaver:vhs |
Tape wear: tracking bands, colour bleed, wobble. |
/vfx play vfxweaver:heartbeat |
A heartbeat in your ears, at a tempo you set. |
/vfx play vfxweaver:vortex |
The world spirals into the centre. |
/vfx play vfxweaver:shockwave |
A ring knocks the picture outward from a point. |
/vfx play vfxweaver:camera_shake |
An impact shake with a smooth envelope, not a jitter. |
/vfx playentity vfxweaver:entity_outline @e[type=pig,limit=1] |
A texture-aware outline on a chosen entity. |
A play lasts a few seconds: run it again to repeat, /vfx stop <effect> to cut it. Any param is overridable in place, so /vfx play vfxweaver:vhs {[intensity:1.5]} is the same effect, harder. Several plays of the same effect stack instead of replacing each other.
Build your own in the browser
/vfxeditor starts a small node editor served by the game itself and opens it in your browser. The effect is a node graph; every param takes a constant, a start/end ramp, keyframes or an expression. The canvas plays live in-game while you drag, the timeline gives one lane per animated param, and Export writes an ordinary data/<namespace>/vfx/<name>.json — exactly what a datapack would contain, so there is no editor-only format and nothing extra to install.
The URL carries a one-time token, the bridge binds to 127.0.0.1 only, and closing the tab does not leave anything running.
What is in the box
- Screen, 40 effects — chromatic aberration, colour grade, distortion, dent, vortex, shockwave, pixelate, halftone, comic, ink, posterize, gradient map, hue isolation, invert, solarize, slice shift, double vision, eyelids, iris wipe, digital glitch, VHS, datamosh, torn edge, spectral, hex grid, scanlines, film grain, motion blur, blur, bloom, depth of field, letterbox, speed lines, vignette, screen flash, accent glow, afterimage, stop motion, noise warp, sky pattern, surface pattern.
- Camera, 3 — shake, dutch roll, field of view.
- World, 7 — block tint, block outline, light beam, pulse ring, guide line, particles, block chain.
- Entity, 3 — tint, outline and displacement by UUID, texture-aware.
- Audio, 4 — heartbeat, hum, noise and volume duck, synthesised on their own audio thread so the frame rate never reaches the sound.
- Images and windows —
screen_imagedraws a picture over the frame (a resource-pack PNG, animated or not).window_createopens a real frameless click-through desktop window showing a picture while the game runs. - Extras — fog modifier, masks (screen, world and entity volumes, down to custom GLSL plugins), collections (several effects as one), easing curves and keyframes everywhere.
Datapacks
A definition is one JSON file: an effect type, a timeline, params, and optional bindings to the world, the camera or the player. Params animate as a constant, a start/end ramp, keyframes with easing, or an expr, and can read the player's position, look direction or health.
The jar ships 73 ready definitions, one per effect type, so the fastest way to learn the format is to copy one out and change a number. Servers can fire effects over vfxweaver:vfx_trigger and sync definitions over vfxweaver:vfx_sync; packets carry a PROTOCOL_VERSION, and a client silently ignores an incompatible one instead of touching your world.
The datapack used to record the clips on the docs site is public: vfx-demos-showcase.zip. It builds a stage (/function vfx_demos:scene/setup) and plays one looping demo per effect (/vfx play vfx_demos:show_vhs), which is the quickest tour of everything here.
For mod developers
dev.vfxweaver.api.VFXAPI plays, stops, live-tunes and keyframes effects on a player from the server side, and registerImage lets your mod hand the renderer an image it drew itself. The network layout, the definition registry and the full call surface are in docs/API.md.
Requirements
| Minecraft | 26.2, 26.1.x, 1.21.11 |
| Loader | Fabric 0.18.4+ on 26.x, 0.17.3+ on 1.21.11, or NeoForge |
| Fabric API | required on Fabric |
| Java | 25+ |
| Side | client; the server side is optional and only carries datapack sync and triggers |
Effects recorded into a Flashback replay play back with it, including looping and persistent ones.
Links
- Guide — commands, every effect and its params, the datapack format, masks, the editor:
- Source and issues —
- Changelog —
下载 VFXWeaver
下载 VFXWeaver
下载 VFXWeaver
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VFXWeaver
下载 VFXWeaver
下载 VFXWeaver
下载 VFXWeaver
下载 VFXWeaver
下载 VFXWeaver
下载 VFXWeaver
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- 编辑器编辑
text_overlay块并为其仅模式插槽添加徽章。 可视化节点编辑器现在在text_overlay节点上有一个 Text 面板——包含一个content文本域和由架构生成的mode/font/align/anchor/split选择器(基于structural.supportsText+ `structural.tex... text_overlay: HUD 路径现在在每个节点上注册,而不仅仅是 26.2 版本。mode: "flat"过去仅在 26.2 上绘制:Fabric 的HudElementRegistry元素和 NeoForge 的RenderGuiEvent.Post监听器都受到>=26.2守卫条件的限制,因此在 1.21.11 和 26.1.2 中,flat 块的布局会出现问题...text_overlay:gravity_angle改变下落方向,HUD 出口即世界主体。加速度不再是向下的标量:gravity_angle是一个以度为单位的方向,0= 向下,90= 向右,顺时针于屏幕,无边界限制(不会取模,因此450等同于90),并且加速...text_overlay:hold使字母落地后保持完整,fade_out: 0使其永久保留。过去,下落的字符一旦静止就开始淡出,因此要阅读已落地的单词,唯一的办法是延长淡出时间——但足够长的淡出会掩盖下落过程本身。text_overlay: 块的背面是镜像,而非第二个正面。two_sided孪生体过去是一个沿 Y 轴旋转 180 度的第二面显示屏,这形成了一个双面告示牌:两面均从左到右可读,因此字母的背面是可读的副本,而非其物理背面。text_overlay:through_blocks是同一图元的可选透视模式。通过 OR 操作将Display.TextDisplay.FLAG_SEE_THROUGH加入每个显示器的标志位中,紧邻阴影位,适用于每个单元及任何孪生体,从而从两侧绘制同一个图元——这是原版自带的透视模式,以及...text_overlay:two_sided显示固定块的背面。文本显示器在其单面图元上绘制字形——原版的DisplayRenderer$TextDisplayRenderer使用Font.DisplayMode.POLYGON_OFFSET提交它们,且未提供每实体开关——因此当块固定在 w...text_overlay:billboard选择块如何面向相机,brightness选择绘制时的光照强度。方向过去是隐式的:除非设置了rot_x/rot_y/rot_z中的任何一个,否则块会面向相机,这会将其固定在世界中,因此作者无法在不设置旋转的情况下指定“世界朝向”,也无法请求...text_overlay:split选择单个动画片段的划分方式——现在它在两种渲染器中具有相同含义。text块新增了结构字段split:char(默认)使每个单元保留一个字符,word使每个单词成为一个单元,block使整个文本成为一个单元。text_overlay: 可以在播放效果时选择行。过去文字仅存在于定义中,因此每个文件对应一个短语是唯一的方式。text_overlay: 两种过渡均可解码(scramble)。scramble(范围 0..1,是四个参数中唯一有界的一个)将揭示和退出转换为解码过程:当其值大于 0 时,位于scramble_band(值为 4)位置的字符会在揭示前沿之前绘制噪声...text_overlay: 世界块跟随效果的播放位置。过去,world块悬挂在其自身的绝对坐标pos_x/pos_y/pos_z上,忽略所有移动效果的因素,因此/vfx playat、运行时移动和实体锚点对它毫无影响。text_overlay: 2D 图层,绘制在 HUD 上。同一个 authored 块现在拥有第二条渲染路径:mode: "flat"使其叠加在帧上,而不是立于世界中,两种加载器为此都提供了钩子——Fabric 的HudElementRegistry元素附加在后...text_overlay: 字母脱离线条。text_overlay的退出现在是真实的,exit选择其表现形式:0 为淡出,1 为下落。text_overlay: 文本作为效果。一种新的效果类型可将 authored 文本放置在帧上或世界中。- 完全由数据包构建的组合:
compositions/rift,专为单帧设计。 一个由深板岩构成的 16 格圆盘,下方有一个岩石锥体,周围环绕八块石头,一座桥梁,上方覆盖夜空;岛屿上方悬挂着一个倒置的世界球体。
已修复
text_overlay:HUD 下落效果保留秒数,而非刻。 将flat退出逻辑移至VFXTextBody后,丢失了 HUD 下落效果原先调校所使用的1/8屏幕缩放,导致预设的gravity(每秒平方屏幕高度)在传入刻度积分器时仿佛被缩放了...text_overlay:HUD 下落效果真正下落,且着地的字母停止颤抖。 存在两个缺陷。text_overlay:flat模式的字母随下落向下掉落并旋转。 HUD 退出逻辑中存在两个缺陷。text_overlay:着地的字母停在地板上而不是悬浮在其上方,并且缓慢侧翻而不是翻转进入淡出状态。world退出逻辑中存在两个缺陷。text_overlay:着地的字母停止旋转并平躺下来。world刚体的角速度接触阻尼原本位于tumble分支内,因此当使用默认的tumble: 0—— 即展示演示以及所有仅设置spin_x/spin_z的定义所采用的默认值...text_overlay:永远无法着地的下落效果不再留下一个永生的、完全不透明的方块。world下落效果的hold+fade_out衰减曲线仅在刚体报告静止的那一刻开始触发,因此带有collision属性的物体永远不会静止——掉入虚空或设置了bounce: 1的物体会保持在透明度1...text_overlay:固定方块的背面是一个背对背粘合的第二显示器,而不是一个半透明的四边形。 原版游戏在单面四边形上绘制文本,而解决方案是 双面告示牌,这正是作者所要求的:two_sided再次 默认为开启,through_blocks默认为关闭 并保持原...text_overlay:稳定的world角色停留在表面上,字母散开而不是整体下落。 着陆逻辑过去会将字符自身的字体高度加到地面高度上(font line height * lines * 0.025 * scale),其假设是显示组件从实体位置向下绘制字形;实际上它是 向上绘制的...text_overlay:block模式现在与原版在线条断行位置、方块起始位置以及对齐方式上保持一致。 粗粒度分割中的四个缺陷:(1)block单元使用模组自带的包装器计算行数,该包装器从不拆分长单词且在wrap_width: 0时无效,而显示组件通过setLineWidth进行换行 (2)...text_overlay:world角色落在表面上而不是嵌入其中。 显示组件从实体位置向上绘制字形,因此如果将位置精确放置在一个埋在地下的方块上,会导致字母的下半部分被掩埋;幸存的部分是字形自身的高度才是下落逻辑所知的...text_overlay:world字母彼此相邻排列,移动平滑。 方块是按字体像素布局的,而这些像素被放置得仿佛每个像素都是一个世界单位,因此两个字母之间的间隙宽了大约四十倍(渲染器已经按照原版游戏的0.02...绘制每个字形)text_overlay:没有旋转的world方块面向摄像机,而不是边缘消失。 字符作为TextDisplay生成,并保留在显示组件默认的面板方向FIXED,因此每个字形都是方块自身平面内的一个单面四边形——而在玩家 XZ 平面上的方块会被看到侧面,从而...text_overlay:world角色在方块所在位置生成,而不是在原点。 每个TextDisplay都在客户端世界的0, 0, 0处添加到层级中,仅在下次放置传递时移动到实际位置,因此实体注册在世界原点——远离任何摄像机——导致方块从未...
已更改
- 文本面板的五个下拉菜单在页面中绘制,而非由浏览器原生渲染。 打开
text_overlay检查器中的mode/font/align/anchor/split并点击某一行时,即使缩放比例为 100% 且 DPI 为 96,应用到的也是点击行 下方 的那一行——原生<select>弹出框的命中区域并未... text_overlay在视觉编辑器中被分组,而不是作为一个包含 52 个端口的扁平列表。 该节点在编辑器的参数组表中没有对应的行,因此所有 52 个参数都落入默认组,检查器将它们绘制为一列未分隔的内容。text_overlay:world下落效果是每个字母一个廉价的独立刚体,每次只进行一次射线检测,而不是每刻解析一个与世界碰撞的刚性矩形。 盒子、八角接触测试、惯性和冲量求解器均已移除:一个文本方块最多可携带 256 个单元,而对每个单元每刻在每个角落调用getBlockCollisions对于单个字母来说代价过高...text_overlay:下落效果现在是物理模拟,而非封闭形式的自由落体。 分离后的world单元过去与flat单元遵循相同的解析曲线——分离时一次地面查询,一次撞击加单次反弹,每列查找一次地面——而现在它是一个 刚体:一个刚性矩形 s...- 展示数据包涵盖 2.5.0 的效果,其源代码位于仓库中。 发布的数据包(
vfx-demos-showcase.zip,链接自 指南)是在此版本之前构建的,因此它没有datamosh、torn_edge、spectral、hex_grid、heartbeat、`hu...
新增
-
hex_grid: 按屏幕位置着色的三角网格。 一个新的屏幕效果在帧上绘制一个三角形晶格——三条线方向(两条成 60 度角,一条垂直)以cell_size为单元大小(默认为 46 像素),锚定在屏幕中心——并使用由位置选择的棱镜渐变对线条进行着色(prism7(x * 0.6 + y * 0.4 + time * speed),每秒漂移 0.5):该颜色的 28% 绘制在接近黑色的背景(0.01, 0.008, 0.02)上,而画面的高光(比core更亮,默认为 0.68 - 绝对值而非局部值,因此在亮度阶跃处不会出现轮廓)则以白色显示;amount用于整体外观的交叉淡入淡出(默认1.0,中性值0.0以便fade_ticks进行淡化),且没有任何参数设有上限——仅有防止数学退化的下限保护(cell_size >= 1像素,width >= 0.0001)。增量更新:一种新的效果类型及其参数,未重命名任何现有数据包字段,UBO 布局无变更,PROTOCOL_VERSION保持不变。详见 指南。由scripts/check-vfx-schema.ps1、scripts/check-shader-identifiers.ps1和scripts/check-builtins-parse.ps1进行断言验证;在此无法在无头模式下验证 GLSL/像素数据。未在游戏中的实际运行中验证。 -
spectral: 覆盖整个帧的彩虹棱镜效果。 一个新的屏幕效果通过七段式棱镜渐变绘制画面——红色(1.0, 0.07, 0.1)、橙色(1.0, 0.42, 0.03)、黄色(1.0, 0.88, 0.06)、绿色(0.1, 0.95, 0.28)、蓝色(0.06, 0.48, 1.0)、紫色(0.28, 0.14, 1.0)、品红色(0.74, 0.16, 1.0)——受围绕center_x/center_y的角度、到中心的距离(每屏幕高度 0.9)以及时钟(每秒 0.7)的影响;mode选择变体:0 棱镜双色(帧根据其自身亮度被分为暗部和亮部,mid默认为 0.5 - 绝对值而非局部值,因此在亮度阶跃处不会出现轮廓;亮部采用棱镜颜色和高光,core为 0.68,变为白色),1 色散模糊(沿向外方向有七个采样点,间距由0.0035 + 0.004 * distance决定,每个采样点的边缘使用smoothstep(0.02, 0.30)并以其各自的棱镜渐变色绘制——这是一个宽泛的渐变,因此保持为模糊效果而非绘制的轮廓)以及 2 光谱环(亮度选择一个频段floor(luma * 6.999),距离选择一个环带floor(distance * 9 - time * 6),两者共同选择一个光谱渐变色,而高光(core为 0.68)变为白色;amount用于整体外观的交叉淡入淡出(默认1.0,中性值0.0以便fade_ticks进行淡化),mode是一个限制在 0..2 的枚举,且没有其他参数设有上限。增量更新:一种新的效果类型及其参数,未重命名任何现有数据包字段,UBO 布局无变更,PROTOCOL_VERSION保持不变。详见 指南。由scripts/check-vfx-schema.ps1、scripts/check-shader-identifiers.ps1和scripts/check-builtins-parse.ps1进行断言验证;在此无法在无头模式下验证 GLSL/像素数据。未在游戏中的实际运行中验证。 -
torn_edge: 带有发光线条的不规则撕裂效果。 一个新的屏幕效果沿一条穿过center_x/center_y的直线切割帧,其角度在每个节拍时重新随机生成(speed,默认为每秒 20 次):ragged(屏幕高度的 0.02,撕裂处跨越 38 个周期)的值噪声波纹使边缘产生游移,切割的两侧以相反的亮度绘制(比mid更亮的像素,默认为 0.5 - 分割是绝对的而非局部的,因此在亮度阶跃处不会出现轮廓),而撕裂本身是一条白线(glow的指数衰减,为屏幕高度的 0.0035,放大系数为 1.6);amount用于整体外观的交叉淡入淡出(默认1.0,中性值0.0以便fade_ticks进行淡化),且没有任何参数设有上限——仅有防止数学退化的下限保护(speed >= 0,glow >= 0.0005)。增量更新:一种新的效果类型及其参数,未重命名任何现有数据包字段,UBO 布局无变更,PROTOCOL_VERSION保持不变。详见 指南。由scripts/check-vfx-schema.ps1、scripts/check-shader-identifiers.ps1和scripts/check-builtins-parse.ps1进行断言验证;在此无法在无头模式下验证 GLSL/像素数据。未在游戏中的实际运行中验证。 -
datamosh:帧是相对于一个从未到达的参考帧进行解码的,且运动搜索在每个单元格上运行一次,而不是在每个像素上运行一次。 一种新的屏幕效果是反馈效果:它将上一帧产生的图像保留在帧的历史缓冲区中,该历史记录作为解码器获得的参考,而非关键帧。关键帧永远不会到达:历史记录仅通过下方的逐块 I 帧刷新,因此解码器会持续绘制半秒前的画面。运动估计的方式与编解码器在其参考帧中搜索匹配块的方式相同:实时图像与参考帧之间(参考帧的 alpha 通道携带前一帧实时图像的亮度)执行一步 Lucas-Kanade 计算以获取内容速度,并在 8、4、2 和 1 像素范围内进行贪婪搜索,找到最佳匹配的整数向量,其中没有移动的地方惩罚值为零。此搜索原先是按像素运行的(每个像素约需 174 次纹理读取,全分辨率passes帧率无法承受):由于块的每个像素都需要相同的向量,因此现在搜索在其自身的 passes 中以 1/8 分辨率运行——每 8x8 单元格一个纹理元素——然后更新 pass 读回结果。画面保持不变,开销约为每个像素 6.5 次读取,而非 174 次。随后,解码器直接保留这些像素(点采样,无滤波,无实时图像的残留),因此移动物体会拖拽旧背景的清晰像素;亮度按测得的向量取值,颜色则按其1 + chroma倍取值,就像 4:2:0 流在与错误的参考帧解码时颜色被涂抹一样——每种颜色都是画面本身的,没有随机噪声。块来自静态哈希四叉树(8 到 64 像素),因此相邻块大小不同且布局永不改变,并且每个块每隔iframe秒按其自身相位返回真实画面,因此不会出现全局闪烁。smear(1) 是向量乘数,chroma(0.5) 是颜色拉力;仅存在下限保护(chroma和amount限制在 0..1 之间,smear和iframe不为负),没有任何参数有上限。增量添加:新增一种效果类型及其参数,未重命名任何现有的数据包字段,未更改 UBO 布局,PROTOCOL_VERSION保持不变。诚实的限制,已在页面上声明:熔毁效果与afterimage共享同一历史缓冲区,因此当两者同时运行时它们会串联,且彼此覆盖对方所需的 alpha 通道;参考对象是屏幕自身的过去,而非其他镜头;运动需要画面中具有一定的结构,因此在平坦区域(天空、纯色墙壁)不会拖拽任何东西;并且运动场是每个 8x8 单元格一个纹理元素,因此低于 8 像素的运动无法解析。文档见 指南。由scripts/check-vfx-schema.ps1、scripts/check-shader-identifiers.ps1、scripts/check-post-fusion.ps1和scripts/check-builtins-parse.ps1断言验证;GLSL/像素在此处无法在无头模式下验证。未在游戏中的实际验证。 -
heartbeat:世界中的心跳。 一种新的音频效果,播放模组内附带的单次“咚-哒”录音(rate为节拍率,单位 bpm,默认值60;volume为线性增益0..1,中性值0.0以便fade_ticks对其进行淡入淡出;pitch为播放速度乘数,默认值1= 按录制时的速度播放),直接送入操作系统混音器——无需资源包,在所有 Minecraft 实例中保持一致。每次节拍都会重新启动录音,并且录音会根据节奏进行时间缩放:在 60 bpm 下,它按录制时的速度播放(1 秒节拍内的 0.85 秒),而在 140 bpm 下,它被压缩至约 0.36 秒(在 0.43 秒的节拍内),且“咚-哒”内部的停顿也以相同比例缩小。缩放保持音调不变,因此快速心跳是同音调的快速录音,而非更高的音调;pitch是一个独立的音调乘数,用于改变音调;节拍之间的停顿是录音留下的空闲部分,而非单独的重计时。切割式播放会在 5 毫秒内淡入,以确保重启时不会产生咔哒声,并且rate和pitch每刻都会重新读取,因此关键帧/expr/绑定可以实时跟随它们变化,并且相位按样本积分,因此速率变化会产生平滑过渡。定位、距离衰减(8 格内完全可听,48 格外无声)、时钟语义(暂停冻结,寻轨静默同步)、单停时的淡出以及立即stopAll/世界退出/客户端关闭时关闭所有镜像,均与hum/noise声音一致;相同的诚实限制同样适用(绕过原版混音器,无音频设备时保持静音并给出一次性警告)。增量添加:新增一种效果类型及其参数,未重命名任何现有的数据包字段,未更改 UBO 布局,PROTOCOL_VERSION保持不变,无新增依赖项。文档见 指南。由scripts/check-vfx-schema.ps1和scripts/check-builtins-parse.ps1断言验证;可听输出在此处无法在无头模式下验证。未在游戏中的实际验证。 -
volume_duck: 在生效时降低原版声音类别的音量。 一个新的全局(非位置性)音频效果会将某个游戏选项类别的音量级别设置为其“未受衰减前”的级别乘以volume(范围0..1,中性值为1.0,因此fade_ticks控制衰减的淡入和淡出)。通过channel参数选择该类别,使用不区分大小写的名称(master、music、records、weather、blocks、hostile、neutral、players、ambient、voice、ui)或历史遗留的SoundSource序号(0..10,用于向后兼容);如果名称未知,则仅警告一次并安全地无效操作,而不是错误地衰减了错误的类别。每一帧仅写入被衰减的通道(跨叠加的衰减,基础值与最后写入者获胜);当最后一个衰减结束时以及单独停止、重播寻址、stopAll、退出世界和客户端关闭时,捕获的级别会被恢复,并且永远不会向options.txt写入任何内容。诚实的限制已在页面上说明:选项滑块显示的是缩放后的级别,且在该通道上拖动中间衰减滑块会被覆盖,然后在恢复时丢失。增量添加:新增一种效果类型及其参数,未重命名现有数据包字段,未更改 UBO 布局,PROTOCOL_VERSION未变,无新依赖项。文档见 指南。由scripts/check-vfx-schema.ps1和scripts/check-builtins-parse.ps1断言验证;此处无法在无头模式下验证可听输出。未在游戏中的验证。 -
noise: 在世界中生成的白噪声。 一个新的音频效果为每个效果实例合成单声道白噪声(volume线性增益0..1,中性值为0.0,因此fade_ticks控制其淡入淡出;brightness清晰/柔和混合0..1,默认0.5;jitter随机游走步长,带有jitter_rate速度乘数以产生播放速率和音量的漂移;seed重新播种纹理),直接送入操作系统混音器——任何资源包中都没有音频文件,在所有 Minecraft 实例上均相同。定位、距离衰减(8 格内全音量,48 格外静音)、时钟语义(暂停冻结,寻址无声同步)、单独停止时的淡出以及立即执行stopAll/退出世界/客户端关闭时关闭所有声音,这些机制均镜像hum语音的特性;相同的诚实限制适用(绕过原版混音器,无音频设备的机器保持静音并有一次警告)。增量添加:新增一种效果类型及其参数,未重命名现有数据包字段,未更改 UBO 布局,PROTOCOL_VERSION未变,无新依赖项。文档见 指南。由scripts/check-vfx-schema.ps1和scripts/check-builtins-parse.ps1断言验证;此处无法在无头模式下验证可听输出。未在游戏中的验证。 -
hum: 在世界中生成的正弦波嗡嗡声。 一个新的音频效果为每个效果实例合成单声道正弦音调(frequency单位为 Hz,默认440;volume线性增益0..1,中性值为0.0,因此fade_ticks控制其淡入淡出),直接送入操作系统混音器——任何资源包中都没有音频文件,在所有 Minecraft 实例上均相同。该语音像世界覆盖物一样进行定位(移动位置、第一个静态positions条目、第一个实体锚点、作者提供的pos_x/y/z,否则使用本地玩家快照),并具有线性距离衰减(8 格内全音量,48 格外静音);它遵循共享的效果时钟,因此暂停会冻结它,重播寻址会无声同步。停止一个实例会使其淡出;stopAll/退出世界/客户端关闭会同时关闭所有语音。诚实的限制已在页面上说明:绕过原版混音器(音量滑块不适用——请使用volume),且没有音频设备的机器保持静音并有一次警告。增量添加:新增一种效果类型及其参数,未重命名现有数据包字段,未更改 UBO 布局,PROTOCOL_VERSION未变,无新依赖项。文档见 指南。由scripts/check-vfx-schema.ps1和scripts/check-builtins-parse.ps1断言验证;此处无法在无头模式下验证可听输出。未在游戏中的验证。
已修复
- 帧率不再泄漏到声音中:语音已移至独立的音频线程。
hum、noise和heartbeat语音原本在渲染线程上合成,每帧处理一个区块,导致帧率泄漏进声音:增益斜坡仅持续一帧,长帧可能导致线路缓冲区饥饿(即出现爆音),而heartbeat的时间缩放工作会导致帧率飙升。现在这些语音运行在专用的音频线程上,该线程使用自己的系统时钟生成固定的 5 毫秒数据块,并保持每条线路比播放头领先约 60 毫秒,因此慢帧、丢帧或窗口失去焦点都不会导致线路缓冲区饥饿或拉伸斜坡——30 fps 和 200 fps 下的声音表现一致。渲染线程仅发布参数和共享效果时钟;语音状态属于音频线程,因此无需加锁。暂停游戏(或暂停回放)仍是唯一能停止它的情况:共享效果时钟冻结,线程在时钟再次移动前渲染静音。heartbeat的时间缩放工作随其余部分一起移到了音频线程。未重命名任何参数,无连线、UBO 或 API 变更,PROTOCOL_VERSION保持不变。详见 hum、noise 和 heartbeat 页面。未在游戏中的验证。 - 合成语音不再出现爆音,心跳声会完整播放而非被截断。 三种点击源已被移除。在静音间隙(暂停、游戏卡顿、淡入淡出)后恢复的语音现在会在 5 毫秒内淡入,而不是以满幅度开始。效果结束的语音不再在播放头处被截断:
hum和noise会淡出,并在其线路排空后释放,因此停止是一个淡出过程而非突变。此外,心跳录音的最后 5 毫秒也会淡出,使节拍结束时无点击声。heartbeat的duration现在决定声音何时停止 重复:当实例结束时,砰击声立即停止重复,正在播放的节拍会播放至结束,而不是在中间被截断。未重命名任何参数,无连线、UBO 或 API 变更,PROTOCOL_VERSION保持不变。详见 heartbeat 页面。未在游戏中的验证。 - 慢帧下合成语音不再卡顿或爆音。
hum/noise/heartbeat语音原本从帧刻度中计数样本,因此窗口失去焦点(每秒几帧)会使每帧超过 4 个刻度的上限,导致语音不发出任何内容(区块间隙区块),并且每当游戏循环停滞时,0.25 秒的线路缓冲区就会欠载。现在每个语音都在自己稳定的系统时钟上计数样本,受效果时钟门控:慢帧和回放寻址会发出与线路空闲缓冲区大小匹配的“系统时钟债务”(写入不会阻塞帧),相位保持连续,从而消除突发或边界点击声,而暂停(或暂停的回放)仍像以前一样精确冻结合成。缓冲区增长至 0.5 秒。未重命名任何参数,无 UBO 或连线变更,PROTOCOL_VERSION保持不变。详见 hum、noise 和 heartbeat 页面;此处无法在无头模式下验证可听输出。未在游戏中的验证。 halftone、comic和accent_glow中几何体周围的局部对比度光晕——已移除局部平均。 8 抽头平均环使色调映射变成了事实上的边缘检测器:在任何亮度阶跃附近,局部均值发生偏移,色调饱和成平坦的纸色带且没有网点,表现为发光轮廓,对半调图案毫无用处。这三种效果现在改为映射绝对像素亮度(halftone保留其中灰周围可调的gain对比度,默认值2.5= 中性;comic获得可调的mid分割点,默认值0.5;accent_glow获得可调的mid/core阈值,默认值0.5/0.68),因此从构造上杜绝了光晕的形成——同时每个像素减少了 8 次纹理采样。网点网格从屏幕中心而非角落生长,因此更改cell_size会以画面中心为基准重新缩放。新增三个可选参数(comic上的mid;accent_glow上的mid、core),无 UBO 或连线变更,PROTOCOL_VERSION保持不变。未在游戏中的验证。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
评论 0
登录后参与评分
还没有评论,来抢沙发吧