tutorial:mixin_tips
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
tutorial:mixin_tips [2023/08/18 09:19] – Removed apostrophe treeway7 | tutorial:mixin_tips [2023/12/18 02:06] (current) – solidblock | ||
---|---|---|---|
Line 5: | Line 5: | ||
This is a collection of different tips some might find useful. It's recommended to read the previous articles to understand the tips. | This is a collection of different tips some might find useful. It's recommended to read the previous articles to understand the tips. | ||
- | ==== Why make a class abstract? ==== | + | ===== Make abstract |
- | + | ||
- | **1. Prevent instantiation** | + | |
It's fair to say that you should never instantiate a mixin class, mainly because the class doesn' | It's fair to say that you should never instantiate a mixin class, mainly because the class doesn' | ||
Line 17: | Line 15: | ||
</ | </ | ||
- | + | ===== Make abstract | |
- | **2. Make more elegant | + | |
If you want to access a unaccessible method or field from your target class into your mixin class, you need to use '' | If you want to access a unaccessible method or field from your target class into your mixin class, you need to use '' | ||
Line 37: | Line 34: | ||
Note: this doesn' | Note: this doesn' | ||
+ | ===== Access the '' | ||
- | **3. Access the '' | + | In mixin, if you want to access the "'' |
- | + | ||
- | In mixin, if you want to access the " | + | |
<code java> | <code java> | ||
Line 50: | Line 46: | ||
Luckily, this can all be avoided by using an abstract class, in which case you don't have to implement methods and all problems are avoided. | Luckily, this can all be avoided by using an abstract class, in which case you don't have to implement methods and all problems are avoided. | ||
+ | ===== How to mixin inner classes ===== | ||
- | ==== How to mixin inner classes ==== | + | ==== 1. Normal inaccessible |
- | + | ||
- | **1. Normal inaccessible inner classes ** | + | |
Since this you can't directly access (and hence mention) these classes from outside, you need to use the " | Since this you can't directly access (and hence mention) these classes from outside, you need to use the " | ||
Line 76: | Line 71: | ||
@Mixin(targets = " | @Mixin(targets = " | ||
public class MyMixin { | public class MyMixin { | ||
- | @Inject(method = " | + | @Inject(method = " |
private void injected(CallbackInfo ci) { | private void injected(CallbackInfo ci) { | ||
// your code here | // your code here | ||
Line 86: | Line 81: | ||
<code java> | <code java> | ||
- | @Inject(method = "< | + | @Inject(method = "< |
private void injected(CallbackInfo ci) { | private void injected(CallbackInfo ci) { | ||
// your code here | // your code here | ||
Line 93: | Line 88: | ||
- | **2. Static inaccessible inner classes** | + | ==== 2. Static inaccessible inner classes |
These are the same as above, the only difference is that the constructor doesn' | These are the same as above, the only difference is that the constructor doesn' | ||
- | **3. Anonymous inner classes** | + | ==== 3. Anonymous inner classes |
These are the same as the static inaccessible inner classes, the only difference is that since they don't have a name, they are declared by appearance order, for example: the anonymous inner class if declared in our previous example class first would be named Outer$1, a second one would be named Outer$2, a third one Outer$3 and so on (the declaration order is on source level). | These are the same as the static inaccessible inner classes, the only difference is that since they don't have a name, they are declared by appearance order, for example: the anonymous inner class if declared in our previous example class first would be named Outer$1, a second one would be named Outer$2, a third one Outer$3 and so on (the declaration order is on source level). | ||
- | ** UNDER CONSTRUCTION ** | + | ===== How to mixin to lambdas ===== |
+ | Sometimes you want to mixin to lambdas. However, lambda do not have visible names. In this case, remember that **mixin is applied to bytecode instead of source**. Therefore, you can view the bytecode to view lambdas. | ||
+ | |||
+ | For example, we want to inject the lambda in '' | ||
+ | <code java> | ||
+ | public class EntitySelectorOptions { | ||
+ | public static void register() { | ||
+ | if (...) { | ||
+ | putOption(" | ||
+ | // Assume that you want to mixin to here | ||
+ | int i = reader.getReader().getCursor(); | ||
+ | // ... | ||
+ | } | ||
+ | // ... | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | If you directly injects to '' | ||
+ | <code java> | ||
+ | private static synthetic method_9982(Lnet/ | ||
+ | L0 | ||
+ | // ... | ||
+ | </ | ||
+ | |||
+ | Therefore, the method name of the lambda you want to mixin should be '' | ||
+ | |||
+ | ===== Mixin to those not remapped ===== | ||
+ | |||
+ | If you want to mixin to classes, methods or fields that are not remapped in yarn, such as '' | ||
+ | <code java> | ||
+ | @Mixin(value = StringReader.class, | ||
+ | public abstract class StringReaderMixin { ... } | ||
+ | </ | ||
+ | |||
+ | Another example is: | ||
+ | |||
+ | <code java> | ||
+ | @Mixin(EntitySelectorReader.class) | ||
+ | public abstract class EntitySelectorReaderMixin { | ||
+ | @Inject(method = " | ||
+ | // your injection method ... | ||
+ | } | ||
+ | </ |
tutorial/mixin_tips.txt · Last modified: 2023/12/18 02:06 by solidblock