The Peacock Project is a HITMAN World of Assassination Trilogy server replacement. The primary purpose is preservation of the game, but it also adds new features and content to the game, and allows for other enhancements to be made while in online mode.

Install Node.js. Use the Latest version, or the version specifically mentioned here: Version 22.9.0

Clone the repository where-ever you wish.

Open Windows terminal AS ADMINISTRATOR.

Install Yarn, by typing:

corepack enable

Then move to the folder where you cloned the repo to by using:

cd Folder/Path/Here

then install the dependencies by using:

yarn install

The project is bundled with a server running configuration. Run that when editing the project with the IDE of choice, and it should open.

We highly suggest you use WebStorm for development, which is free for non-commercial use. If you'd prefer, you can also use Visual Studio Code. WebStorm will provide a better experience for development, but VSCode will work just fine.

To contribute, you can use Pull Requests from your own fork. You can fix bugs reported in issues or add new features you think would be useful, new features not listed in issues would have to be discussed before merging.

The Peacock repository has an automated workflow to rebuild locale packages. All you need to do to update localisation files is:

1. Edit locale.json.
   • If you're adding new strings, make sure to add the English versions to all languages.
   • If you're translating existing strings, you only need to translate the ones that are in the language(s) you are translating.
2. Then push locale.json.
3. Then, make a Pull Request. When it is reviewed and merged, locale packages will automatically be rebuilt.

If you need to manually rebuild locale packages for whatever reason (testing or otherwise), follow steps 1 and 2 above, then do the following:

1. Make sure rpkg_cli.exe, HMLanguageTools.exe, and ResourceLib_*.dll are in the resources folder.
2. Then, from the root project folder, run yarn rebuild-locale.
3. These generated RPKGs should not be pushed or merged into Peacock as the automated workflow will take care of this for you.

Thank you to people who have contributed!

You may not contribute content generated, in part or in full, by large language models, chatbots or other generative AI tools. This policy covers code, documentation, pull requests, issues, comments, and any other contributions to the Peacock Project, including both this repository and any others under the Peacock Project organization.

In addition, you may not use this repository or any other repositories under the Peacock Project organization to train AI tools.

Peacock is under the AGPL-3.0 license, see the license file for more info.

Peacock started off as a fork of LocalGhost by grappigegovert, and has since been rewritten in TypeScript, and a whole host of new features have been added. The codebase has been relicensed to AGPL-3.0 with explicit permission from grappigegovert.

The game is owned by IO Interactive, and is not affiliated with this project in any way.