UltimaHacks 开源项目使用教程

UltimaHacks 开源项目使用教程

UltimaHacksPatches which add features to, and improve the usability of, the 1990s video games Ultima VII (BG and SI) and Ultima Underworld (I and II), along with a program to compile and apply these patches.项目地址:https://gitcode.com/gh_mirrors/ul/UltimaHacks

1. 项目的目录结构及介绍

UltimaHacks 项目的目录结构如下：

UltimaHacks/
├── README.md
├── LICENSE
├── u7bg/
│   ├── scripts/
│   │   └── patchFreshExe.sh
│   └── asm/
├── u7si/
│   └── asm/
├── uw1/
│   └── asm/
├── uw2/
│   └── asm/
└── patcher/
    ├── src/
    └── build/

目录结构介绍

• README.md: 项目的基本介绍和使用说明。
• LICENSE: 项目的开源许可证，通常为 MIT 许可证。
• u7bg/: 包含 Ultima VII: The Black Gate 的补丁文件和脚本。
  • scripts/: 包含用于构建和应用补丁的脚本，如 patchFreshExe.sh。
  • asm/: 包含用于生成补丁的汇编代码文件。
• u7si/: 包含 Ultima VII Part Two: Serpent Isle 的补丁文件。
  • asm/: 包含用于生成补丁的汇编代码文件。
• uw1/: 包含 Ultima Underworld: The Stygian Abyss 的补丁文件。
  • asm/: 包含用于生成补丁的汇编代码文件。
• uw2/: 包含 Ultima Underworld II: Labyrinth of Worlds 的补丁文件。
  • asm/: 包含用于生成补丁的汇编代码文件。
• patcher/: 包含用于编译和应用补丁的 Java 程序源代码。
  • src/: 包含 Java 源代码文件。
  • build/: 包含编译后的 Java 类文件。

2. 项目的启动文件介绍

UltimaHacks 项目的启动文件主要是 patchFreshExe.sh 脚本，位于 u7bg/scripts/ 目录下。该脚本用于构建和应用 Ultima VII: The Black Gate 的补丁。

启动文件介绍

• patchFreshExe.sh: 这是一个 Bash 脚本，用于编译和应用 Ultima VII: The Black Gate 的补丁。使用方法如下：

  cd u7bg/scripts/
  ./patchFreshExe.sh
  

  该脚本会自动编译汇编代码并生成补丁文件，然后将其应用到游戏的可执行文件中。

3. 项目的配置文件介绍

UltimaHacks 项目没有明确的配置文件，但可以通过修改汇编代码文件（.asm 文件）来定制补丁内容。

配置文件介绍

• asm/ 目录下的 .asm 文件: 这些文件包含了用于生成补丁的汇编代码。开发者可以通过修改这些文件来定制补丁的功能和行为。

  例如，在 u7bg/asm/ 目录下找到一个 .asm 文件，打开并编辑其中的代码，然后重新运行 patchFreshExe.sh 脚本以应用新的补丁。

---

通过以上步骤，您可以了解并使用 UltimaHacks 开源项目来为经典游戏 Ultima VII 和 Ultima Underworld 系列添加新功能和改进。

UltimaHacksPatches which add features to, and improve the usability of, the 1990s video games Ultima VII (BG and SI) and Ultima Underworld (I and II), along with a program to compile and apply these patches.项目地址:https://gitcode.com/gh_mirrors/ul/UltimaHacks