Space Walker: remove chapter about inner class attributes (and move them to the Nester page)

2025-08-12T12:52:46Z

remove chapter about inner class attributes (and move them to the Nester page)

← Older revision		Revision as of 12:52, 12 August 2025
Line 1:		Line 1:
	Nests are Ornithe's inner class patches. They are used to modify inner class attributes in Java class files.		Nests are Ornithe's inner class patches. They are used to modify inner class attributes in Java class files.

	See [[Nester]] for information on how these patches are applied.		See [[Nester]] for information on inner class attributes and how these patches are applied.

	~~=== Inner Class Attributes ===~~

	Inner class attributes are necessary for interactions with inner classes to work as expected. This is especially noticeable with non-static inner classes, and anonymous classes in particular. These inner classes can access fields, methods, or variables from their outer class or method, as well as the other way around.

	Obfuscators such as [https://www.guardsquare.com/proguard ProGuard] may remove these class file attributes. This is generally not a problem, since these attributes do not affect the runtime behavior of a Java application. However, if you wish to de-obfuscate and decompile a jar file, you will get better results when the inner class attributes are present.

	=== Relevance ===		=== Relevance ===

Space Walker: create Nests page

2025-07-31T16:00:51Z

create Nests page

New page

Nests are Ornithe's inner class patches. They are used to modify inner class attributes in Java class files.

See [[Nester]] for information on how these patches are applied.

=== Inner Class Attributes ===

Inner class attributes are necessary for interactions with inner classes to work as expected. This is especially noticeable with non-static inner classes, and anonymous classes in particular. These inner classes can access fields, methods, or variables from their outer class or method, as well as the other way around.

Obfuscators such as [https://www.guardsquare.com/proguard ProGuard] may remove these class file attributes. This is generally not a problem, since these attributes do not affect the runtime behavior of a Java application. However, if you wish to de-obfuscate and decompile a jar file, you will get better results when the inner class attributes are present.

=== Relevance ===

Most Minecraft versions before 1.8.2 Pre-release 5 had the inner class attributes stripped from the jar. Nests were created in an effort to reconstruct what the original inner classes would have been in the source code.

=== File Specification ===

<code>.nest</code> files are <code>UTF-8</code> encoded text files. Each line defines the relationship between a class and its outer class and, if applicable, outer method. A line has the following format.

<class name> <outer class name> <outer method name> <outer method descriptor> <inner name> <access>

* <code>class name</code>: the internal name of the class
* <code>outer class name</code>: the internal name of the outer class.
* <code>outer method name</code>: the name of the outer method (may be empty).
* <code>outer method descriptor</code>: the descriptor describing the type of the outer method (may be empty).
* <code>inner name</code>: the inner name of the class (may be empty).
* <code>access</code>: the access flags for the inner class.

==== Notes ====

The <code>inner name</code> component does not directly correspond to the inner name as defined in the inner class attribute. Rather, it is used to construct a new internal name of the class. The actual inner name is parsed from this component.

For regular inner classes, the <code>inner name</code> component corresponds directly to the inner name as defined in the inner class attribute. If the component is all digits, the inner class is assumed to be anonymous, and the actual inner name <code>null</code>. If the component starts with digits and transitions to text, the inner class is assumed to be local, and the inner name the text part of the component.

For example:
* <code>Example</code> - the class is assumed to be a regular inner class, with inner name <code>Example</code>.
* <code>1</code> - the class is assumed to be an anonymous class, with inner name <code>null</code>.
* <code>1Example</code> - the class is assumed to be a local class, with inner name <code>Example</code>.

[[category:Mod Development]]

Nests - Revision history

Space Walker: remove chapter about inner class attributes (and move them to the Nester page)

Space Walker: create Nests page