Custom Item Animations - Revision history

Tmvkrpxl0 at 10:46, 4 September 2022

2022-09-04T10:46:09Z

Tmvkrpxl0 at 10:45, 4 September 2022

2022-09-04T10:45:54Z

Tmvkrpxl0 at 11:43, 3 September 2022

2022-09-03T11:43:06Z

Tmvkrpxl0: Created page with "{{Under construction}} Custom Item animation allows items to have both 3rd person and 1st person animation. This is done by consuming custom client extension with custom rende..."

2022-09-03T11:38:25Z

Created page with "{{Under construction}} Custom Item animation allows items to have both 3rd person and 1st person animation. This is done by consuming custom client extension with custom rende..."

New page

{{Under construction}}
Custom Item animation allows items to have both 3rd person and 1st person animation. This is done by consuming custom client extension with custom rendering logic in <code>Item#initializeClient</code>.

== Defining custom client extension ==
First, create a implementation of <code>IClientItemExtensions</code>. It can be either anonymous or named.

<syntaxhighlight lang="java">
IClientItemExtensions extension = new IClientItemExtensions() {
// .....
}
</syntaxhighlight>

An instance of it should be consumed in <code>Item#initializeClient</code> like this:

<syntaxhighlight lang="java">
@Override
public void initializeClient(Consumer<IClientItemExtensions> consumer) {
consumer.accept(extension);
}
</syntaxhighlight>

Or you can define and consume implementation at same time:

<syntaxhighlight lang="java">
@Override
public void initializeClient(Consumer<IClientItemExtensions> consumer) {
consumer.accept(new IClientItemExtensions() {
// .....
});
}
</syntaxhighlight>

== <tt>Implementing first person Item Animation</tt> ==
In order to implmement first person Item Animation in IClientItemExtensions, override <code>#applyForgeHandTransform</code>
<syntaxhighlight lang="java">
IClientItemExtensions extension = new IClientItemExtensions() {
@Override
public boolean applyForgeHandTransform(PoseStack poseStack, LocalPlayer player, HumanoidArm arm, ItemStack itemInHand, float partialTick, float equipProcess, float swingProcess) {
// Returning true in this method will prevent this item stack from being handled by vanilla rendering system.
}
}
</syntaxhighlight>
The <code>applyForgeHandTransform</code> method's parameters are for:
* <code><nowiki>PoseStack poseStack</nowiki></code>: For stacking matrix poses. You can translate, rotate, scale item with it.
* <code><nowiki>LocalPlayer player</nowiki></code>: Main client player holding the item.
* <code><nowiki>HumanoidArm arm</nowiki></code>: For distinguishing which arm is holding the item. It's either <code>#LEFT</code> or <code>#RIGHT</code>
* <code><nowiki>ItemStack itemInHand</nowiki></code>: <code>ItemStack</code> that player is holding. Its <code>Item</code> is always the custom <code>Item</code> that you're defining currently.
* <code><nowiki>float partialTick</nowiki></code>: Value ranging from 0.0 to 1.0 for telling how much time has passed since last tick. If it's close to 0.0, it means current tick just started. If it's close to 1.0, it means current tick is almost over.
* <code><nowiki>float equipProcess</nowiki></code>: Value ranging from 0.0 to 1.0. If it's close to 0.0, It's close to 0.0 when the sword gauge bar is full. It's close to 1.0, when sword gauge bar is low. [[File:That_short_gage_thing_under_cross.png]]
* <code><nowiki>float swingProcess</nowiki></code>: Value ranging from 0.0 to 1.0 for telling animation progress. If it's exactly at 0.0, the animation is not playing. If it's just close to 0.0, animation has just started playing. If it's close to 1.0, the animation is almost over.

Here's example implementation:
@Override
public void initializeClient(Consumer<IClientItemExtensions> consumer) {
consumer.accept(new IClientItemExtensions() {
@Override
public boolean applyForgeHandTransform(PoseStack poseStack, LocalPlayer player, HumanoidArm arm, ItemStack itemInHand, float partialTick, float equipProcess, float swingProcess) {
int i = arm == HumanoidArm.RIGHT ? 1 : -1;
poseStack.translate(i * 0.56F, -0.52F, -0.72F);
applyItemArmTransform(poseStack, arm);
if (player.getUseItem() != itemInHand) {
return true;
}
if (player.isUsingItem()) {
poseStack.translate(0.0, -0.05, 0.0);
}
return true;
}
});
}

[[Category:Items]]

← Older revision		Revision as of 10:46, 4 September 2022
Line 1:		Line 1:
−	~~{{Under construction}}~~
	Custom Item animation allows items to have both 3rd person and 1st person animation. This is done by consuming custom client extension with custom rendering logic in <code>Item#initializeClient</code>.		Custom Item animation allows items to have both 3rd person and 1st person animation. This is done by consuming custom client extension with custom rendering logic in <code>Item#initializeClient</code>.

@@ Line 32: / Line 32: @@
 == <tt>Implementing first person Item Animation</tt> ==
-In order to implmement first person Item Animation in IClientItemExtensions, override <code>#applyForgeHandTransform</code>
+In order to implmement first person Item Animation in <code>IClientItemExtensions</code>, override <code>#applyForgeHandTransform</code>
 <syntaxhighlight lang="java">
 IClientItemExtensions extension = new IClientItemExtensions() {
      @Override
      public boolean applyForgeHandTransform(PoseStack poseStack, LocalPlayer player, HumanoidArm arm, ItemStack itemInHand, float partialTick, float equipProcess, float swingProcess) {
-     // Returning true in this method will prevent this item stack from being handled by vanilla rendering system.
+     // Returning true in this method is recommended as it will prevent this item stack from being handled by vanilla rendering system, preventing additional unwanted transformations from being applied.
+     }
+}
 </syntaxhighlight>
 The <code>applyForgeHandTransform</code> method's parameters are for:
-* <code><nowiki>PoseStack poseStack</nowiki></code>: For stacking matrix poses. You can translate, rotate, scale item with it.
+* <code><nowiki>PoseStack poseStack</nowiki></code>: For stacking matrix poses. You can translate, rotate, scale item model with it.
 * <code><nowiki>LocalPlayer player</nowiki></code>: Main client player holding the item.
 * <code><nowiki>HumanoidArm arm</nowiki></code>: For distinguishing which arm is holding the item. It's either <code>#LEFT</code> or <code>#RIGHT</code>
-* <code><nowiki>ItemStack itemInHand</nowiki></code>: <code>ItemStack</code> that player is holding. Its <code>Item</code> is always the custom <code>Item</code> that you're defining currently.
+* <code><nowiki>ItemStack itemInHand</nowiki></code>: <code>ItemStack</code> that player is holding. Its <code>Item</code> is always the custom <code>Item</code> that you're implementing animation for.
 * <code><nowiki>float partialTick</nowiki></code>: Value ranging from 0.0 to 1.0 for telling how much time has passed since last tick. If it's close to 0.0, it means current tick just started. If it's close to 1.0, it means current tick is almost over.
-* <code><nowiki>float equipProcess</nowiki></code>: Value ranging from 0.0 to 1.0. If it's close to 0.0, It's close to 0.0 when the sword gauge bar is full. It's close to 1.0, when sword gauge bar is low. [[File:That_short_gage_thing_under_cross.png]]
+* <code><nowiki>float equipProcess</nowiki></code>: Value ranging from 0.0 to 1.0. It's close to 0.0 when the sword gauge bar is full. It's close to 1.0 when sword gauge bar is low. [[File:That_short_gage_thing_under_cross.png]]
 * <code><nowiki>float swingProcess</nowiki></code>: Value ranging from 0.0 to 1.0 for telling animation progress. If it's exactly at 0.0, the animation is not playing. If it's just close to 0.0, animation has just started playing. If it's close to 1.0, the animation is almost over.
@@ Line 59: / Line 59: @@
              int i = arm == HumanoidArm.RIGHT ? 1 : -1;
              poseStack.translate(i * 0.56F, -0.52F, -0.72F);
-            applyItemArmTransform(poseStack, arm);
+             if (player.getUseItem() == itemInHand && player.isUsingItem()) {
-            if (player.getUseItem() != itemInHand) {
+                 poseStack.translate(0.0, -0.05, 0.0);
+             }
-             if (player.isUsingItem()) {
+            return true;
                  poseStack.translate(0.0, -0.05, 0.0);
+             }

@@ Line 51: / Line 51: @@
 Here's example implementation:
 @Override
 public void initializeClient(Consumer<IClientItemExtensions> consumer) {
@@ Line 69: / Line 70: @@
      });
+}
 [[Category:Items]]