
调试绘制
看看你的模组在做什么。通过 redscript 或 CET 在世界中绘制线条、形状、文本和图表,显示碰撞、导航网格和触发体积,并用 X 光、变暗模式或自定义着色器为其设置样式。通过游戏自身的调试渲染器进行原生 C++(RED4ext)绘制:不使用 ink 小部件,专为数万条线条而构建。
查看大图[size=5][b]调试绘制[/b][/size]
[size=3]在你的模组中于游戏世界内绘制线条、形状、文本和图表,并看到引擎所看到的内容:碰撞体、导航网格和触发体积。[/size]
[size=4][b]描述[/b][/size]
Debug Draw 是一个面向模组作者的资源。它重新开启游戏自带的调试渲染器,并将其提供给 redscript 和 Cyber Engine Tweaks 使用,因此只需一行脚本就能在世界中放置线条、盒子、球体、箭头、标签或实时图表。用它来查看射线检测、AI 目标、生成半径、路径、车辆受力,或你的模组正在做的任何其他事情,且就显示在事情发生的位置。
它也可以独立使用:从其设置页面开启世界叠加层,即可看到 V 周围的碰撞体、导航网格和触发体积,无需编写脚本。
它是一个原生 C++ RED4ext 插件。形状直接送入引擎的调试渲染器,而非通过 ink 控件或生成的实体,因此每帧可轻松处理数万条线。(用引擎的话说:每个摄像机通常会被分配一个 NullDebugDrawer,它会丢弃一切。而本插件给它分配了一个真正的渲染器。)
[size=4][b]主要功能[/b][/size]
[list]
[][b]形状:[/b]线条、路径、箭头、盒子、定向盒子、球体、圆、圆盘、胶囊体、圆柱体、圆锥体、坐标轴辅助线、三角形和多边形,支持线框或填充(带透明度),并可选择线条粗细。[/]
[][b]文本和数据:[/b]带可读轮廓的世界文本、屏幕文本、跟随实体的标签,以及用于每帧变化数值的滚动图表(Plot)。[/]
[][b]辅助工具:[/b]Raycast 和 Trace 会绘制你投射的射线及其命中位置;Bounds 和 Velocity 绘制实体的包围盒和速度箭头;Heat 将数值转换为从蓝到红的颜色。[/]
[][b]计时和归属:[/b]绘制一帧或 N 秒;每个形状都属于一个通道,因此 Clear 只会移除你自己的形状。[/]
[][b]跟随对象:[/b]PushTransform 和 PushEntity 将形状放入局部空间;在实体下排队的形状会随实体移动而保持在它上面。[/]
[][b]清晰查看:[/b]叠加模式可穿墙绘制,X 光模式会淡显通道中被遮挡的形状,Dim 会调暗场景以使调试形状更突出。[/]
[][b]世界叠加层:[/b]物理形状的线框(静态为浅绿色,移动为橙色)、NPC 行走的导航网格,以及触发体积。可从设置页面在 V 周围开启它们,或从脚本在任何点周围绘制它们。移动中的物体会每帧更新,因此它们的线框会始终保持在汽车和 NPC 上。[/]
[][b]材质和自定义着色器:[/b]内置外观(光照、网格、全息、距离衰减、脉冲、扫描线、条纹),可从脚本更改的材质参数,以及通过随附编译器使用你自己的 HLSL 着色器。着色器可在游戏内重新加载,无需重启。[/]
[][b]设置[/b](配合 Mod Settings):显示或隐藏任何模组绘制的所有内容、文本大小、标签距离、调暗强度以及世界叠加层。[/]
[/list]
[size=4][b]快速开始[/b][/size]
在 redscript 中:
[code]DebugDraw.Line(a, b, DebugDraw.Rgba(255, 64, 0), 5.0); // 持续 5 秒
DebugDraw.Sphere(center, 2.0, DebugDraw.Rgba(0, 128, 255)); // 本帧
DebugDraw.Label(npc, "searching", DebugDraw.Rgba(255, 255, 255), 0.0, n"my_mod");
DebugDraw.Plot("speed", speed);
DebugDrawOverlays.ShowCollision(GetPlayer(game).GetWorldPosition(), 15.0);[/code]在 CET 模组或 CET 控制台中,相同的函数也可使用:
[code]DebugDraw.Sphere(Vector4.new(p.x, p.y, p.z + 2.5, 1), 0.5, DebugDraw.Rgba(255, 128, 0, 0))[/code]完整 API、常见用法示例集以及着色器指南都在下载包内的 readme 中。
[size=4][b]安装说明[/b][/size]
使用模组管理器安装,或手动安装:将压缩包解压到游戏文件夹(包含 bin、archive 和 r6 的那个文件夹),使文件落到 red4ext/plugins/debug_draw 和 archive/pc/mod 中。
验证是否正常工作:安装 Mod Settings 后,从暂停菜单打开 Mod Settings,开启 Debug Draw > World overlays > Show overlays around V,V 周围的碰撞体和导航网格应会出现。若未安装,请查看 red4ext/logs 中的 debug_draw 日志:正常安装会在加载存档时记录“Added the debug render nodes to the main render graph”。
[size=4][b]需求[/b][/size]
[list]
[][b]RED4ext[/b] 1.31.0 或更高版本[/]
[][b]Redscript[/b] 0.5.32 或更高版本[/]
[][b]Mod Settings[/b](可选)用于设置页面;未安装时使用默认值[/]
[][b]Cyber Engine Tweaks[/b](可选)用于从 CET 进行绘制[/]
[/list]基于游戏版本 3.0.88 构建。引擎函数通过哈希查找,因此其他版本也可能可用;如果某个函数未找到,日志会说明,模组不会绘制任何内容,而调用它的脚本仍可编译和运行。
[size=4][b]致模组作者[/b][/size]
[list]
[]使用你自己的通道名称(例如 n"my_mod"),这样你的形状、Clear 调用、材质和 X 光设置就永远不会影响其他模组。[/]
[]调试形状在游戏的光照之后绘制:它们永远不会获得游戏的阴影或灯光。lit、grid 和 hologram 材质会自行进行着色。[/]
[]玩家可以从设置页面隐藏所有调试绘制并更改文本大小,因此你可以保留调试绘制并让玩家自行关闭。[/]
[/list]
[size=4][b]致谢[/b][/size]
[list]
[]WopsS 及贡献者,感谢 RED4ext 和 RED4ext SDK,本插件基于它们构建。[/]
[]jekky 及贡献者,感谢 redscript。[/]
[]Cyber Engine Tweaks 团队。[/]
[]WolvenKit 团队:着色器编译器使用 WolvenKit 构建材质。[/]
[]CD PROJEKT RED,感谢在游戏中留下了如此完整的调试渲染器。[/]
[/list]
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。