whatisgithub

What is aeternum-world?

coldzer0/aeternum-world — explained in plain English

Analysis updated 2026-05-18

13PythonAudience · researcherComplexity · 4/5LicenseSetup · moderate

In one sentence

A research project analyzing network packets and internal data structures of the online game New World: Aeternum, with helper tools for capturing and mapping that data.

Mindmap

mindmap
  root((repo))
    What it does
      Analyzes game network packets
      Maps internal type identifiers
      Documents findings
    Tech stack
      Python
      Related LuaDecompiler tool
      Related OodlePak tool
    Use cases
      Study how game client and server talk
      Capture live game network traffic
      Map internal object type identifiers
    Audience
      Researchers
      Game modders
    Status
      Ongoing personal research
      Targets specific game version
      AGPL v3 licensed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read documentation on how New World: Aeternum's network packets are structured.

USE CASE 2

Capture live game network traffic using the included packet capture tool.

USE CASE 3

Map the game's internal type identifiers using the catalog tool.

USE CASE 4

Combine this with the author's separate LuaDecompiler or OodlePak tools for deeper analysis.

What is it built with?

Python

How does it compare?

coldzer0/aeternum-world1lystore/awaekactashui/sjtu-ppt-template-skill
Stars131313
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity4/52/52/5
Audienceresearchervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Targets a specific game version and requires the related capture and decompiler tools for full use.

You can use and modify this freely, but if you run a modified version as a network service, you must share your source code under the same license.

So what is it?

Aeternum-World is a research project that analyzes the network behavior and internal data of New World: Aeternum, an online multiplayer game made by Amazon Games. The analysis targets a specific game version (v1.400.6031.40375) and the repository contains documentation and tools for people who want to understand how the game operates at a technical level. The main documentation covers how network packets work in the game. A network packet is a small bundle of data sent between a game client running on a player's computer and the company's servers. Understanding how these packets are structured can reveal information about how the game's features work, what data is transmitted during gameplay, and how the client and server communicate with each other. Helper tools in the repository include a network packet capture utility for recording live game traffic and a catalog tool for mapping the game's internal type identifiers. Type identifiers are labels the game uses internally to distinguish between different kinds of objects, such as items, characters, or abilities. The author also links to two external tools they maintain separately: a decompiler for reading the game's internal Lua scripting files, and a tool called OodlePak for extracting game assets from files that use the Oodle compression format. Oodle is a data compression library used by some games to reduce file sizes. The project additionally references nw-buddy, a community-built resource site for New World players. The README is brief and the project appears to be personal research that the author updates on an ongoing basis. The license is the GNU Affero General Public License version 3.

Copy-paste prompts

Prompt 1
Explain what this project's network packet documentation reveals about the game.
Prompt 2
Help me set up the packet capture tool included in this repository.
Prompt 3
What is the difference between the catalog tool and the packet capture tool here?
Prompt 4
Summarize how this project relates to the LuaDecompiler and OodlePak tools it links to.

Frequently asked questions

What is aeternum-world?

A research project analyzing network packets and internal data structures of the online game New World: Aeternum, with helper tools for capturing and mapping that data.

What language is aeternum-world written in?

Mainly Python. The stack also includes Python.

What license does aeternum-world use?

You can use and modify this freely, but if you run a modified version as a network service, you must share your source code under the same license.

How hard is aeternum-world to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is aeternum-world for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.