Differences

This shows you the differences between two versions of the page.

--- tutorial:mixin_glossary [2025/09/29 07:41] – Add preamble and contributing guidelines. Latter may be removed in final versions? gauntrecluse
+++ tutorial:mixin_glossary [2025/09/29 09:04] (current) – Creation of sections, along with many different definitions for injector and general terms. gauntrecluse
@@ Line 23: / Line 23: @@
 ----
-//TODO: Probably add subsections depending on the terms?//
+//TODO: Probably add subsections depending on the terms?//\\
+FIXME //This is under heavy construction and probably contains inaccuracies, likely redundancies, certainly inefficient definitions and most definitely is missing relatively important terms//
 ===== Definitions =====
-Mixin, Mixins:
+==== General/Misc. Terms ====
-  - A reference to the Mixin Subsystem, see [[tutorial:mixin_introduction|Introduction to Mixins (WIP)]]
-  - "a Mixin" or "a Mixin Class" means a class or, for the former especially, an interface that will be merged with a target by the Mixin system.
-Injector:
+== Mixin, Mixins ==
-  - Most of the time, references a "callback injector", or an annotated handler method that will be merged by a Mixin Class, with a callback to the merged method at a specified injection point. This most often does not include Redirectors, although they may also be considered injectors under technical definitions.
+  - When used as a single term in the form of a proper noun, references the Mixin Subsystem as a whole. Mixin is a subsystem with the primary purpose of allowing a developer to describe modifications to be made at runtime using code. See [[tutorial:mixin_introduction|Introduction to Mixins (WIP)]]
+  - "a Mixin" or "a Mixin Class" references instances of classes or interfaces that are annotated with ''@Mixin'', and will be merged with a target class as a means to modify it.
-Handler method:
-  - In the context of Mixins, a decorated method that will be merged and then called to in some way dependent on the annotation and its arguments.
+== MixinExtras ==
+  - A companion library for the Mixin subsystem primarily authored by Llamalad7. MixinExtras focuses on giving more versatile, precise and compatible injectors and general Mixin usage utility. MixinExtras is bundled with Fabric since Loader version 0.15; MixinExtras 0.5.0 has been bundled with Fabric since Loader version 0.17.0; See [[https://github.com/LlamaLad7/MixinExtras/wiki|the MixinExtras Wiki]].
+== To mix into, to Mixin to ==
+  - Expressions referring to using Mixin to modify a target. For instance, "mixing into ServerLevel" would mean using a Mixin to modify the ''ServerLevel'' class.
+== Bytecode as opposed to Source code ==
+  - Bytecode is a set of less readable, computer-oriented instructions, which code running on the Java Virtual Machine will be compiled into. Mixin works with bytecode as opposed to "Source" code, both for the Mixins to be applied and the code to target, "source" code being the decompiled/pre-compilation code, and as such, whilst source code can be used to infer bytecode, one should always prioritize bytecode for precise targeting or for certain targets which may not be reliably in the same position or order in the bytecode compared to a decompilation. See [[tutorial:reading_mc_code|Reading the Minecraft source]]'s relevant section on bytecode.
+----
+==== Injectors ====
+== Relevant external articles for this section ==
+Technical article on callback injectors, Mixin Wiki: [[https://github.com/SpongePowered/Mixin/wiki/Advanced-Mixin-Usage---Callback-Injectors|Advanced Mixin Usage; Callback Injectors]]\\
+MixinExtras Wiki: [[https://github.com/LlamaLad7/MixinExtras/wiki|MixinExtras Wiki Home Page]]
+----
+== Injector ==
+  - Most commonly, references a "callback injector", which consists of an annotated "handler" method that will be merged by a Mixin Class, with a callback to the merged method (known as the handler method) at a specified injection point defined within the handler method's annotation. This most often does not include Redirectors, as redirectors cannot chain with one another and do not preserve the original target code.
+== Handler method / Handler ==
+  - In the context of Mixins, a decorated method that will be merged and then invoked/called by a "callback" that will be injected based on the annotation's information. How this is done is highly dependent on the given injector.
+== Callback ==
+  - A series of injected instructions that will invoke the related handler method based on that method's injection point definition. The simplest injected callback is ''@Inject'''s callback who is mostly a plain method call at the injection point.
+== Injection Point ==
+  - An injection point is the primary value used by Mixin to determine where to insert the callback instructions for a given injector. Injection points are most often defined in the ''@At'' annotation's ''value'' field. Certain injection points are self-sufficient, such as ''"HEAD"'' (injects at the head of the target method), whilst others may necessitate more discriminators to have a specific target like ''"INVOKE"'' (injects before a method call, or targets the method call itself depending on the injector). Injection points are used to search for specific Bytecode operations within the boundaries of the target method.
+    - The injection point "reference" refers to the documentation of Mixin's built-in injection points. See [[https://github.com/SpongePowered/Mixin/wiki/Injection-Point-Reference|the Mixin Wiki's injection point reference page]].
+  - In some cases of common speech, injection point may refer to the specific point an injector's callback will be inserted, resulting both from an injection point and other discriminators.
+----