世界构建器

世界构建器——游戏内预制体编辑器与模组开发工具包

将游戏中48,000多个预制体放置在世界任何地方，实时进行，无需离开游戏。火把、门、宝箱和所有其他机关都会活灵活现：它们通过游戏自身的生成路径生成。

Discord： 赤色沙漠模组制作 获取帮助、构建、功能请求以及关于本游戏模组制作的其他所有内容。

世界构建器是《红色沙漠》的游戏内编辑器。通过快捷键打开后，你可以浏览游戏内置的所有预制件（墙壁、废墟、家具、道具、机关、自然景物），将它们放置在你角色面前，环绕观察，使用键盘或 Blender 风格的鼠标操纵器进行移动、旋转、倾斜和缩放，将它们放到地面上，并将结果保存为项目，下次启动时重新加载。它还提供了一套小型 C API，让其他模组可以通过它生成和移动物体。

不会修改任何游戏文件，也不会写入游戏自身的存档数据。该模组放置的所有内容都保存在其自己的项目文件中。

快速开始

• 按下 插入 在游戏世界中。编辑器以编辑模式打开：鼠标由菜单控制，世界继续运行。
• 在搜索框中输入一个单词，选择一张卡片或一行，然后按 放置 （或双击）。
• 物体出现在角色前方，鼠标操纵器已激活。拖动箭头、圆环、中心点或缩放手柄来调整位置。使用放置HUD来放下、取消、调平或吸附到地面；放置/选择其他物体或双击空白处也可完成放置。
• 偏好小面板？点击 码头：窄侧窗可在浏览器、场景、NPC和时间和天气之间切换，并在您工作时保持打开。
• 主页 开关相机模式：编辑器保持打开时，切换至自由飞行相机（WASD移动，右键拖动视角，滚轮前推）。 插入 隐藏编辑器并将控制权交还给游戏。请在“项目”选项卡中保存你的构建。
  

功能

• 预制体浏览器：分类树、全文搜索（词序不限）、标签筛选、“仅网格”筛选、收藏夹以及自定义命名集合
• 列表或卡牌：比赛以列表或带预览图的图块形式显示；停靠栏每行显示一至四个，大小随窗口调整
• 纹理预览图像 对于每个预制体，都在你的机器上使用游戏自身的纹理进行渲染。该模组向游戏的资源加载器请求文件：没有档案代码，没有密钥，没有提取任何内容，也没有重新分发任何内容
• 放置模式：新放置或抓取的物体可直接用鼠标控制柄编辑；放置HUD提供放下、取消、层级、吸附和贴地操作
• 鼠标小工具：方向键沿物体坐标轴移动，中心点在地面上滑动，绿色圆环旋转，红色和蓝色圆环倾斜，立方体缩放
• 完全旋转通过gizmo和Scene选项卡控制偏航、俯仰和翻滚，并提供水平操作以消除倾斜
• 吸附：网格步长（0.1 至 2 米）和角度步长（5 至 90 度）适用于 Gizmo 的移动和旋转
• 对齐地面在放置抬头显示或场景标签中，“落地”会使用游戏自身的物理探测将物体放置到其下方的表面上
• 点击选择在编辑模式下，单击已放置的对象可将其选中，双击可将其抓取。选中的对象会显示轮廓。
• 场景标签页：每个已放置的物体及其位置和距离；多选（Ctrl / Shift + 单击），群组（Ctrl+G）作为可折叠行，撤销 / 重做（Ctrl+Z / Ctrl+Y），带方向复制 / 粘贴（Ctrl+C / Ctrl+V），复制、删除、贴地、抓取、移除重复项
• 时间和天气：设置视觉上的时间、冻结昼夜光照而不暂停游戏、恢复原始时间进程，并控制晴天、雨、雪、云和风。这些控制项也可在停靠栏中使用
• NPC生成：以直接输入的距离生成一个或多个NPC/生物，数量最高可达100,000，并支持线形、矩阵或圆形阵型，间距/半径可调；将一行或一张卡片拖入游戏视图，即可在标记的落点生成一个NPC；狭窄的NPC停靠栏中也提供相同的控件
• 直线和圆形工具：连续N份或在你面前呈环形排列的N份，成组交至放置模式
• 项目：保存和加载完整建筑（包含绝对世界坐标、分组和倾斜），导入他人分享的.cdproj文件，可选择在游戏启动时自动加载
• 简单操控：只有编辑器和摄像机模式的快捷键可以配置；对象放置由鼠标操控器处理，而不是单独的键盘控制方案
• 模组开发工具包cdk_spawn、cdk_move、cdk_remove、cdk_player_pos 及其他相关功能，可从任何其他 ASI 模组中调用
• 可交互对象：每一个机关预制体（火把、灯具、门、宝箱、营火、拉杆——共16591个）都通过游戏自身的生成路径生成，行为与真实物体一致：点燃火把、打开宝箱、推倒架子。可以像其他任何物体一样选择、拖动、旋转、撤销和保存它们。游戏会在加载后的几步内自行提供生成模板
• 容错更新游戏功能在启动时通过签名和类名定位。游戏更新后，模组要么正常运行，要么干净地禁用自身并告知原因。
  

控制

• 插入显示/隐藏编辑器
• 主页: 摄像机模式开/关（自由飞行摄像机，编辑器保持打开）
• 放置界面：丢弃 / 取消 / 到地面 / 水平 / 吸附
• 鼠标坐标轴：移动/旋转/倾斜/缩放携带的物体或选中项
• 放置或选择其他内容，或双击空白处：完成当前放置
• 场景标签页：Ctrl+A 全选，Ctrl+G 编组，Ctrl+Z / Ctrl+Y 撤销 / 重做，Ctrl+C / Ctrl+V 复制 / 粘贴，Delete 删除
  

需求

• 《红色沙漠》（Steam），已用 1.0.0.2850 和 1.0.0.2944 版本测试
• 终极ASI加载器 已安装为 bin64\winmm.dll（DMM 和 Vortex 用户通常已具备此文件）
  

安装

• 如果你没有安装 Ultimate ASI Loader，请先安装：下载 Ultimate-ASI-Loader_x64.zip，将其中包含的 dinput8.dll 复制到 <game>\bin64\，并将其重命名为 winmm.dll。
• 将本压缩包中的 cdmodkit.asi 和 cdmodkit 文件夹复制到 <game>\bin64\ 目录下。模组管理器（DMM、Vortex）同样适用：预制列表已内置于插件中，若该文件夹缺失则会自动生成。
• 通过Steam启动游戏。日志会写入 bin64\cdmodkit\cdmodkit.log（如果希望显示控制台窗口，请在 settings.txt 中将 console=1）。
  

首次启动时，模组会在后台为所有预制体渲染预览图像（低优先级，约需20分钟）。你选中的预制体总是最先渲染。

致模组作者

sdk\cdmodkit_api.h 记录了导出的函数。使用 GetModuleHandleA("cdmodkit.asi") 获取模块，并通过 GetProcAddress 解析函数。所有内容都已为你排队到游戏线程。

问题、请求、故障

加入 红色沙漠模组制作 Discord：欢迎在那里提出疑问、功能请求和错误报告，这里的评论也可以。

当出现问题时，所有内容都会记录在bin64\cdmodkit\cdmodkit.log中。请发布最后30行，尤其是包含“fault”、“imgui assert”或“RESOLVE FAILED”的行。

鸣谢与致谢

• dofo7777 感谢他们进行了大量测试、提供想法和视频。许多放置和输入方面的改进正是源于这些反馈。
• Shin234 献给Master Looter，本模组的虚拟光标输入层改编自他的作品，也感谢他指明了进入此引擎的道路。
• 良木 为追查DMM丢失的预制件列表， 阿尔杜因1991 用于挂载坐标报告，以及CrimsonRoute的作者提供的变换快照说明。
• 诺斯提克斯 对于 绯红天气：感谢你找到游戏时间和天气数据的偏移量和特征码，World Builder的昼夜与天气控制正是基于这些数据构建的（未使用任何代码），以及以下内容的作者： 绯红之路 感谢允许我们使用其叠加捕获代码。
• 整个 crimson desert 模组社区：为归档和网格格式研究而开展的 pycrimson 和 CDMW 项目，以及在公开场合分享发现的每一个人。
  

第三方代码：MinHook（BSD-2）、Dear ImGui（MIT）、stb_image / stb_image_write（公有领域）、输入层改编自 Master Looter 和 Trinity（MIT）。不包含任何游戏资源。