Thunderbrew:binana - Revision history

Phaneron at 19:37, 9 May 2026

2026-05-09T19:37:59Z

← Older revision		Revision as of 19:37, 9 May 2026
Line 2:		Line 2:
	{{Software		{{Software
	\|name = Binana		\|name = Binana
	\|type = Reverse-engineering ~~information~~		\|type = Reverse-engineering toolkit
	\|authors = Thunderbrew Developers		\|authors = Thunderbrew Developers
	\|license = The Unlicense		\|license = The Unlicense

Phaneron at 01:11, 9 May 2026

2026-05-09T01:11:41Z

← Older revision		Revision as of 01:11, 9 May 2026
Line 13:		Line 13:

	Over the years, many individuals have attempted to reverse engineer specific parts of the WoW client. These are usually siloed away into individual IDA Pro databases, making them difficult to locate, and thus more difficult to make use of for the purposes of game preservation.		Over the years, many individuals have attempted to reverse engineer specific parts of the WoW client. These are usually siloed away into individual IDA Pro databases, making them difficult to locate, and thus more difficult to make use of for the purposes of game preservation.

			Binana aims to avoid situations like this by storing RE work as machine-readable code in a public Git repository. This code can then be converted/parsed/encoded any way we like, usable in any tool you care to add support for!

	Binana is mainly targeted at version 3.3.5a of WoW. By reducing scope to a single version, the level of difficulty involved in implementing Whoa/Thunderbrew features is lowered significantly.		Binana is mainly targeted at version 3.3.5a of WoW. By reducing scope to a single version, the level of difficulty involved in implementing Whoa/Thunderbrew features is lowered significantly.

Phaneron at 01:04, 9 May 2026

2026-05-09T01:04:52Z

@@ Line 42: / Line 42: @@
 For Binana, the convention for the end address of a function is the address that's 1 byte after the last instruction.
 === C headers ===
 A profile also contains a tree of C headers, which are used to expose type information into IDA Pro or Ghidra.

Phaneron at 01:03, 9 May 2026

2026-05-09T01:03:08Z

← Older revision		Revision as of 01:03, 9 May 2026
Line 38:		Line 38:
	ClassName__MethodName 12345678 f end=23456789 type="void __thiscall func(ClassName* this, int32_t argument)"		ClassName__MethodName 12345678 f end=23456789 type="void __thiscall func(ClassName* this, int32_t argument)"
	</pre>		</pre>

			Our reverse-engineering tools cannot always detect the end address of a function (x64dbg cannot detect this at all!), so you should always give the end address of the function.

			For Binana, the convention for the end address of a function is the address that's 1 byte after the last instruction.

	=== C headers ===		=== C headers ===

	A profile also contains a tree of C headers, which are used to expose type information into IDA Pro or Ghidra.		A profile also contains a tree of C headers, which are used to expose type information into IDA Pro or Ghidra.

Phaneron at 00:55, 9 May 2026

2026-05-09T00:55:03Z

← Older revision		Revision as of 00:55, 9 May 2026
Line 24:		Line 24:
	=== Symbols ===		=== Symbols ===

	Each profile consists of a symbol database. This database is text-based, and organized as a root <code>symbol/<code> directory, and is filled with many subdirectories, which contain both <code>func.sym</code> and <code>label.sym</code> text files, pertaining to function symbols and data label symbols, respectively.		Each profile consists of a symbol database. This database is text-based, and organized as a root <code>symbol</code> directory, and is filled with many subdirectories, which contain both <code>func.sym</code> and <code>label.sym</code> text files, pertaining to function symbols and data label symbols, respectively.

	The structure of a line (or entry) in the database is formatted thus:		The structure of a line (or entry) in the database is formatted thus:

Phaneron at 00:54, 9 May 2026

2026-05-09T00:54:32Z

← Older revision		Revision as of 00:54, 9 May 2026
Line 8:		Line 8:
	}}		}}

	Binana is a centralized repository of reverse-engineering information.		Binana is a centralized repository of reverse-engineering information for various stripped binaries that are of interest to the [Thunderbrew] project.

			== Rationale ==

			Over the years, many individuals have attempted to reverse engineer specific parts of the WoW client. These are usually siloed away into individual IDA Pro databases, making them difficult to locate, and thus more difficult to make use of for the purposes of game preservation.

			Binana is mainly targeted at version 3.3.5a of WoW. By reducing scope to a single version, the level of difficulty involved in implementing Whoa/Thunderbrew features is lowered significantly.

	== Profiles ==		== Profiles ==

	~~Binana contents are split into profiles. Each~~ profile ~~contains information about~~ a ~~particular~~ binary.		A profile is a structured directory containing symbols and C headers that apply to a single binary sample.

	~~Currently~~, the ~~most fleshed-out profile is~~ <code>3.3.5a-windows-386</code>.		For instance, in the Binana repository, the <code>3.3.5a-windows-386</code> profile contains information for the i386 (x86) Windows version of the World of Warcraft client.

	=== Symbols ===		=== Symbols ===

	Each profile ~~contains~~ a ~~main.sym file~~. This ~~file~~ is ~~generated from various other~~ symbol files in the ~~profile~~.		Each profile consists of a symbol database. This database is text-based, and organized as a root <code>symbol/<code> directory, and is filled with many subdirectories, which contain both <code>func.sym</code> and <code>label.sym</code> text files, pertaining to function symbols and data label symbols, respectively.

			The structure of a line (or entry) in the database is formatted thus:

			<pre>
			LabelName <hexadecimal absolute address> <f or l for function/label> [ attributes, or optional values, e.g. key=value key="value with spaces" ]
			</pre>

			A function file looks like this:

			<pre>
			FunctionName1 11223344 f end=22334455 type="void __stdcall func()"
			ClassName__MethodName 12345678 f end=23456789 type="void __thiscall func(ClassName* this, int32_t argument)"
			</pre>

	=== C headers ===		=== C headers ===

	A profile also contains a tree of C headers, which are used to expose type information into IDA Pro or Ghidra.		A profile also contains a tree of C headers, which are used to expose type information into IDA Pro or Ghidra.

Phaneron: Phaneron moved page Thunderbrew:Binana to Thunderbrew:binana without leaving a redirect

2025-06-14T05:48:32Z

Phaneron moved page Thunderbrew:Binana to Thunderbrew:binana without leaving a redirect

← Older revision		Revision as of 05:48, 14 June 2025
(No difference)

Phaneron at 06:48, 12 June 2025

2025-06-12T06:48:43Z

← Older revision		Revision as of 06:48, 12 June 2025
Line 8:		Line 8:
	}}		}}

	Binana is a centralized repository ~~for~~ reverse-engineering information ~~for Whoa and Thunderbrew~~.		Binana is a centralized repository of reverse-engineering information.

	== Profiles ==		== Profiles ==

Phaneron at 06:46, 12 June 2025

2025-06-12T06:46:20Z

← Older revision		Revision as of 06:46, 12 June 2025
Line 7:		Line 7:
	\|repository = [https://github.com/thunderbrewhq/binana github.com/thunderbrewhq/binana]		\|repository = [https://github.com/thunderbrewhq/binana github.com/thunderbrewhq/binana]
	}}		}}

			Binana is a centralized repository for reverse-engineering information for Whoa and Thunderbrew.

	== Profiles ==		== Profiles ==

Phaneron at 06:39, 12 June 2025

2025-06-12T06:39:29Z

← Older revision		Revision as of 06:39, 12 June 2025
Line 1:		Line 1:
	Binana ~~is a repository for reverse~~ engineering information.		[[Category:Software]]
			{{Software
			\|name = Binana
			\|type = Reverse-engineering information
			\|authors = Thunderbrew Developers
			\|license = The Unlicense
			\|repository = [https://github.com/thunderbrewhq/binana github.com/thunderbrewhq/binana]
			}}

	== Profiles ==		== Profiles ==