nwnxee/unified Docker 镜像 - 轩辕镜像

NWNX:EE (build 8193.34 - v86)

![]([]

• 最新版本：build8193.34-HEAD - 更新日志
• Docker标签：nwnxee/unified:latest
• nwserver-linux md5：1d17b4cc7680fc4defbd36dcc5bd9e9b

什么是NWNX:EE？

NWNX:EE全称是Neverwinter Nights Extender: Enhanced Edition（无冬之夜扩展器：增强版）。简而言之，它是一个框架，开发者可通过它修改《无冬之夜：增强版》的现有硬编码规则，或注入全新功能。

使用NWNX:EE，开发者可创建插件实现多种功能，包括但不限于：

1. 创建全新脚本命令，如同游戏原生脚本API的一部分。
2. 将游戏脚本语言与外部工具、进程及数据库（如MySQL）集成。
3. 修改传统上难以或无法更改的现有机制，如核心战斗规则或寻路引擎。

NWNX:EE不仅面向插件开发者，模块创作者也可使用社区贡献的插件扩展其模块的脚本和系统功能。查看Awesome NWNX页面获取使用NWNX的项目列表。

支持的服务器版本

本文档顶部标注了支持的最新NWN:EE服务器版本。请注意，仅支持专用服务器包中的二进制文件，不支持Beamdog客户端或Steam客户端发布的二进制文件。不过，Steam和Beamdog的二进制文件通常与专用服务器包中的文件一致，本文档顶部提供了支持的二进制文件md5校验值。

我们会为每个新版本的专用服务器包至少发布一次更新，可在服务器下载包与Docker支持查看。

支持的平台

仅原生支持Linux。可通过Docker模拟Linux环境在Windows上运行，或在Windows 10上使用WSL/WSL2。目前暂无原生Windows支持计划。

如何使用？

首先需获取NWNX二进制文件。若需自行编译，参见下文编译部分；否则，可点击GitHub仓库页面右侧的Releases标题下载。

将NWNX:EE集成到模块

每个NWNX:EE发布版本均包含NWScript.zip文件（自行编译时位于Binaries文件夹），内含所有脚本文件。将脚本导入模块，即可像调用其他脚本函数一样使用。更新NWNX时需同步更新这些脚本，并重新编译模块中所有脚本。

运行服务器（原生）

获取二进制文件后，按以下步骤操作：

1. 将二进制文件复制到服务器可执行文件旁，通常位于/bin/linux-x86。
2. 创建启动脚本：

   bash
   #!/bin/sh
   export LD_PRELOAD="./NWNX_Core.so"
   ./nwserver-linux
   

3. 可通过环境变量配置插件（需查阅各插件文档获取具体变量，源码中Plugins/文件夹下的每个插件均有README.md说明）。
4. 启动前添加以下行可跳过特定插件：

   bash
   export NWNX_LUA_SKIP=true
   

5. 设置日志级别（1为最低 verbose，7为最高）：

   bash
   export NWNX_CORE_LOG_LEVEL=7 # 核心及所有插件的默认日志级别
   export NWNX_LUA_LOG_LEVEL=7 # LUA日志级别，覆盖默认值
   

也可使用Docker运行含预编译NWNX二进制文件的服务器，参见下文。

运行服务器（Docker）

nwnxee/unified支持以下标签：

• [commit-hash]（7个字符）
• latest
• [tag]（如build8193.20）

因Docker本地镜像缓存机制，建议使用[commit-hash]标签明确指定版本，避免latest标签因缓存导致使用旧版本。

运行方式与beamdog/nwserver镜像一致，有关nwserver的问题参考其README。

NWNX插件通过docker run传递的环境变量配置。除ServerLogRedirector外，所有插件默认跳过，需通过设置对应环境变量为n启用，例如：-e NWNX_ADMINISTRATION_SKIP=n。

部分插件需额外配置（如数据库插件），具体参见插件目录下的README。

建议使用docker-compose配置容器，参考：

• Docker Compose文档
• 示例compose文件：nwnxee-template

运行服务器（Windows 10 WSL1）

自NWN:EE Release 8193起，可在Windows 10的WSL上运行nwserver-linux和NWNX:EE，参见指南：NWNX:EE on WSL1, a brief guide。

编译NWNX:EE（原生）

需C++17兼容编译器（GCC 7.4+已验证，Clang 5.0+可能工作但不支持）。各插件可能有依赖项，需查阅对应CMakeLists.txt。

常规编译：

bash
./Scripts/buildnwnx.sh

手动编译：

bash
mkdir build-nwnx && cd build-nwnx && cmake .. && make

编译NWNX:EE（Docker）

Linux/MacOS/Docker-Toolbox：

bash
./Scripts/rundockerbuild.sh

• 脚本将拉取NWNX Linux构建镜像，执行./scripts/buildnwnx.sh
• 清理构建：./scripts/rundockerbuild.sh -c
• 多线程编译：./scripts/rundockerbuild.sh -j

Windows：

powershell
./Scripts/rundockerbuild.ps1

• 脚本拉取构建镜像并执行./scripts/buildnwnx.sh
• 清理构建：./scripts/rundockerbuild.ps1 -FORCECLEAN

贡献代码

欢迎所有贡献，参见CONTRIBUTING.md了解要求和风格指南。

报告bug

使用issue tracker报告bug，需提供运行时stdout输出（建议使用调试日志级别NWNX_CORE_LOG_LEVEL=7）。

关于开发者

NWNX:EE是开源项目，由社区成员利用业余时间免费创建和维护。

***支持

感谢支持，但建议将捐款用于公益事业。若想支持NWN，可考虑向Neverwinter Vault***以支付服务器费用。

联系我们

通过联系团队：[]