DevilutionX暗黑破坏神 1在 Xbox One / Series 上的完整部署指南开发模式与零售模式安装、游戏数据与手柄键位全解【免费下载链接】DevilutionXDiablo build for modern operating systems项目地址: https://gitcode.com/gh_mirrors/de/DevilutionXDevilutionX 为现代操作系统重制了经典《暗黑破坏神 1》其 Xbox One / Xbox Series 版本以 UWP通用 Windows 平台应用的形式分发可运行于开启开发者模式或零售模式的主机之上。本指南以仓库文档 docs/manual/platforms/xbox-one.md 为骨架结合仓库中的 UWP 工程与构建配置完整讲解如何通过 Xbox Device Portal 部署devilutionX.appx、如何放入游戏数据文件diabdat.mpq以及一套针对 Xbox 手柄深度定制的完整键位方案。读完本文你将掌握在 Xbox One / Series 上从零安装到流畅游玩 DevilutionX 的全流程并理解该版本在源码层面的平台适配原理。一、先认清版本形态Xbox One/Series 版与初代 Xbox 版是两套构建在动手安装前需要先区分两个容易混淆的 Xbox 平台目标Xbox One / Series本文主题UWP 应用打包为.appx通过开发者模式Dev Mode或零售模式部署文档见 docs/manual/platforms/xbox-one.md。初代 Xbox原版主机基于 nxdk 工具链构建数据文件放在E:\UDATA\devilutionx\文档见 docs/manual/platforms/xbox.md。两者共享同一套手柄键位设计但安装路径完全不同。本文仅针对前者展开。从源码结构可以清晰看到 Xbox One/Series 版本的工程组织方式仓库根目录下的 uwp-project/ 目录包含了完整的 UWP 构建工程devilutionx.vcxproj 声明了ApplicationType为Windows Store、ApplicationTypeRevision为 8.2仅构建x64平台且AppxBundle设为Always始终生成.appx捆绑包目标平台最低版本为10.0.14393.0Windows 10 Anniversary Update即 Xbox One 可运行的 UWP 基线Package.appxmanifest 是应用包清单声明了应用显示名devilutionX、Logo 资源以及两项网络能力internetClient与internetClientServer后者用于支持联机对战时的服务器/客户端通信src/SDL_winrt_main_NonXAML.cpp 提供了 UWP 应用的WinMain入口基于 SDL2 的 WinRT 后端SDL_WinRTRunApp启动游戏主循环。构建配置方面CMake/platforms/uwp_lib.cmake 定义了 UWP 目标的编译选项关闭 Sanitizer 与测试、全部第三方库SDL2、SDL_image、SDL_audiolib、libsodium、libpng、bzip2、zlib 等静态链接并从源码构建、定义__UWP__1宏同时将DEVILUTIONX_GAMEPAD_TYPE设为Xbox见 uwp_lib.cmake这正是下文整套 Xbox 手柄键位在编译期就确定下来的原因。二、安装前准备理解diabdat.mpq的作用DevilutionX 本身不包含任何《暗黑破坏神 1》的游戏内容它只提供现代化的引擎与运行时。游戏的全部美术、音频、关卡数据都封装在原始游戏的数据文件diabdat.mpq中你需要从以下来源取得它正版《暗黑破坏神 1》光盘CDGOG 平台安装目录中的游戏文件。diabdat.mpq约数百 MB是整个游戏能否启动的关键。后续两种安装模式中它的存放目录都是游戏包内部的LocalState/diasurgical/devilution文件夹——这正是 DevilutionX 在 Xbox 上读取资产数据的位置约定与仓库中资产加载逻辑见 Source/engine/assets.cpp 与 Source/mpq/mpq_reader.cpp对应引擎启动时会到该数据目录查找并挂载 MPQ 档案。三、开发模式Dev Mode安装步骤开发模式允许 Xbox One / Series 主机运行未上架 Microsoft Store 的 UWP 应用适合大多数玩家自行部署 DevilutionX。前提是你的主机已启用开发者模式可通过 Xbox 商店安装 Xbox Dev Mode 应用开启并在电脑浏览器中打开 Xbox Device Portal 管理界面。下载并解压发布包从项目 Releases 页面下载最新版安装包devilutionx-xbox-one-series.zip解压后得到devilutionX.appx以及依赖文件Microsoft.VCLibs.appxVisual C 运行库UWP 应用运行所必需。打开 Xbox Device Portal在电脑浏览器中进入 Xbox Device Portal点击左侧Home/My games apps页面中的Add添加按钮。选择应用包在弹出的第一个对话框Deploy or Install Application部署或安装应用程序中选择刚才解压得到的devilutionX.appx点击Next下一步。选择依赖包在弹出的第二个对话框Choose any necessary dependencies选择必要的依赖项中选择Microsoft.VCLibs.appx点击Start开始完成部署。依赖项缺失会导致应用启动时报缺库错误——这是因为 devilutionx.vcxproj 的链接项中直接依赖了 SDL2、libpng、zlib、bzip2、libsodium、libzt 等静态库而 C/C 运行库本身以 VCLibs 形式由系统侧提供。放入游戏数据在电脑上打开与 Xbox 共享的WindowsApps共享文件夹找到 devilutionX 的文件夹路径形如/LOCALFOLDER/*Gamr13*DevilutionX*/LocalState/diasurgical/devilution将diabdat.mpq复制进去若该目录不存在则手动创建。切换应用类型在 Xbox 主机上选中 DevilutionX 图标按手柄View键呼出菜单选择Details详细信息将应用类型从App改为Game。这一步的目的是让 Xbox 主界面把 DevilutionX 当作游戏条目对待从而获得与游戏一致的系统行为。部署完成后即可在主机上启动 DevilutionX。若启动失败优先检查第 4 步依赖是否安装、第 5 步diabdat.mpq是否放置在正确的LocalState/diasurgical/devilution目录下。四、零售模式Retail Mode安装步骤零售模式适用于未开启开发者模式、但已经通过其他途径如已上架应用安装了 DevilutionX 的主机用于补充/更新游戏数据文件。其核心思路是通过 FTP 访问主机文件系统进入应用管理在 Xbox 主机上选中 DevilutionX按手柄View键呼出菜单选择Manage game and add-ons管理游戏与附加内容。获取完整包名进入File info文件信息页面记下FullName应用的完整包标识名。连接 FTP使用支持 FTP 的客户端如 Windows 资源管理器地址栏输入ftp://主机IP或 FileZilla 等工具连接到 Xbox进入目录/LOCALFOLDER/*FullName*/LocalState/diasurgical/devilution其中*FullName*即上一步记下的完整包名。传输数据文件将diabdat.mpq发送上传到该目录。零售模式与开发模式的核心差别在于数据文件的投放渠道开发模式通过 Device Portal 的部署流程走共享文件夹零售模式则直接经 FTP 写入包内目录两者最终的数据目录结构一致均为LocalState/diasurgical/devilution。五、两种安装模式对比速览对比项开发模式Dev Mode零售模式Retail Mode适用场景首次安装/完整部署应用已安装应用后补充数据文件部署入口Xbox Device Portal → Home/My games apps → Add主机应用管理 FTP需要上传的内容devilutionX.appxMicrosoft.VCLibs.appx仅diabdat.mpq数据文件位置WindowsApps共享文件夹 →/LOCALFOLDER/*Gamr13*DevilutionX*/LocalState/diasurgical/devilution/LOCALFOLDER/*FullName*/LocalState/diasurgical/devilution附加设置需将应用类型从 App 改为 Game无需六、手柄操作全览为 Xbox 控制器定制的完整键位DevilutionX 的 Xbox One/Series 版本针对 Xbox 手柄做了完整的操作映射。由于 CMake/platforms/uwp_lib.cmake 在编译期将DEVILUTIONX_GAMEPAD_TYPE设为Xbox代码库会采用 Xbox 布局解析手柄输入相关实现见 Source/controls/controller.cpp 与 Source/controls/plrctrls.cpp。完整键位如下左摇杆 / 十字键移动英雄A 键攻击附近敌人、与城镇居民和商人对话、拾取/放置背包物品主菜单中作“确定”B 键选择法术菜单中作“返回”X 键拾取物品、打开附近的箱子和门、使用背包中的物品Y 键施放法术主菜单中删除角色LB 键使用腰带中的生命药剂RB 键使用腰带中的法力药剂LT 键角色面板备选Menu LB 或 ← 方向键RT 键物品栏备选Menu RB 或 → 方向键左摇杆按下切换自动地图备选Menu ↓Menu View游戏菜单备选Menu ↑View A/B/X/Y法术快捷键将常用法术绑定到四个按键右摇杆移动自动地图或模拟鼠标指针移动右摇杆按下模拟鼠标左键点击备选View LBView 右摇杆按下模拟鼠标右键点击备选View RBView LT任务日志备选Menu YView RT法术书备选Menu B几点源码层面的设计细节值得注意B 键不会误退出游戏UWP 应用默认把系统“返回Back”手势映射为退出而这恰好对应 Xbox 手柄的 B 键。为避免玩家在游戏中按 B 直接退出uwp-project/src/SDL_winrt_main_NonXAML.cpp 通过OnBackRequested事件处理器将args-Handled置为true吞掉返回请求——这正是文档中 B 键只承担“选择法术 / 菜单返回”职责、而不会退出游戏的原因。Menu/View 组合键设计Xbox 手柄按键有限字符面板、物品栏、自动地图、任务日志、法术书等高频功能通过Menu、View与方向键/肩键组合实现同时保留单键直达的备选方案兼顾不同玩家的习惯。右摇杆模拟鼠标针对《暗黑破坏神》的点击式交互右摇杆可模拟鼠标移动与左右键点击含组合键用于在物品栏拖拽、商店交易等需要精确指针的场景。七、常见问题与排查要点部署时报依赖错误确认第 4 步选择了Microsoft.VCLibs.appx。这是 UWP 应用的 C/C 运行库依赖DevilutionX 的 uwp-project/devilutionx.vcxproj 链接了大量静态库sdl2、libpng、zlib、bzip2、libsodium、mpqfs、lua 等运行库由系统以依赖包形式提供。启动后提示缺少游戏数据检查diabdat.mpq是否完整、是否位于LocalState/diasurgical/devilution目录两种模式均为该路径。文件较大时请确认复制/上传过程没有中断。主界面把应用显示为 App 而非 Game按文档第 3 节第 6 步在Details中把类型改为Game以获得游戏条目应有的系统行为。需要联网功能应用清单 Package.appxmanifest 已声明internetClient与internetClientServer能力多人游戏网络功能基于仓库 Source/dvlnet/ 目录下的 TCP/ZeroTier 网络实现在 Xbox 上同样可用。八、更多参考资源本平台指南原文docs/manual/platforms/xbox-one.md初代 Xboxnxdk版本指南docs/manual/platforms/xbox.mdUWP 工程文件与清单uwp-project/devilutionx.vcxproj、uwp-project/Package.appxmanifestUWP 平台构建配置CMake/platforms/uwp_lib.cmake更多平台安装手册见 docs/manual/platforms/项目整体构建说明见 docs/building.md 与 README.md社区交流与项目发布信息可在仓库 README 中获取最新安装包从项目 Releases 页面下载即可。【免费下载链接】DevilutionXDiablo build for modern operating systems项目地址: https://gitcode.com/gh_mirrors/de/DevilutionX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考