feat: add frame time and frame interpolate in texture

Author: toxicity188

api/src/main/java/kr/toxicity/model/api/BetterModelConfig.java

@@ -109,12 +109,6 @@ public interface BetterModelConfig {
      */
     boolean followMobInvisibility();
 
-    /**
-     * Gets animation time in texture mcmeta
-     * @return animation time
-     */
-    int animatedTextureFrameTime();
-
     /**
      * Checks use Purpur afk.
      * @return use Purpur afk

api/src/main/java/kr/toxicity/model/api/data/blueprint/BlueprintTexture.java

@@ -26,6 +26,8 @@
  * @param uvWidth the UV width of the texture, if specified
  * @param uvHeight the UV height of the texture, if specified
  * @param canBeRendered whether this texture should be included in the resource pack
+ * @param frameTime the frame time of the texture
+ * @param frameInterpolate the interpolation flag of the texture
  * @since 1.15.2
  */
 public record BlueprintTexture(
@@ -35,7 +37,9 @@ public record BlueprintTexture(
     int height,
     int uvWidth,
     int uvHeight,
-    boolean canBeRendered
+    boolean canBeRendered,
+    int frameTime,
+    boolean frameInterpolate
 ) {
     /**
      * Checks if this texture is an animated texture (a texture atlas for animation).
@@ -62,8 +66,8 @@ public boolean isAnimatedTexture() {
     public @NotNull JsonObject toMcmeta() {
         return JsonObjectBuilder.builder()
             .jsonObject("animation", animation -> {
-                animation.property("interpolate", true);
-                animation.property("frametime", BetterModel.config().animatedTextureFrameTime());
+                animation.property("interpolate", frameInterpolate());
+                animation.property("frametime", frameTime());
             })
             .build();
     }

api/src/main/java/kr/toxicity/model/api/data/raw/ModelTexture.java

@@ -26,6 +26,8 @@
  * @param height the height of the texture in pixels
  * @param uvWidth the UV width of the texture
  * @param uvHeight the UV height of the texture
+ * @param frameTime the frame time of the texture
+ * @param frameInterpolate the interpolation flag of the texture
  * @since 1.15.2
  */
 @ApiStatus.Internal
@@ -35,7 +37,9 @@ public record ModelTexture(
     int width,
     int height,
     @SerializedName("uv_width") int uvWidth,
-    @SerializedName("uv_height") int uvHeight
+    @SerializedName("uv_height") int uvHeight,
+    @SerializedName("frame_time") int frameTime,
+    @SerializedName("frame_interpolate") boolean frameInterpolate
 ) {
 
     /**
@@ -57,7 +61,9 @@ public record ModelTexture(
             height(),
             uvWidth(),
             uvHeight(),
-            !name.startsWith("-")
+            !name.startsWith("-"),
+            frameTime(),
+            frameInterpolate()
         );
     }
 

core/src/main/kotlin/kr/toxicity/model/BetterModelConfigImpl.kt

@@ -55,7 +55,6 @@ class BetterModelConfigImpl(yaml: ConfigurationSection) : BetterModelConfig {
     } ?: BetterModelConfig.PackType.ZIP
     private val buildFolderLocation = (yaml.getString("build-folder-location") ?: "BetterModel/build").replace('/', File.separatorChar)
     private val followMobInvisibility = yaml.getBoolean("follow-mob-invisibility", true)
-    private val animatedTextureFrameTime = yaml.getInt("animated-texture-frame-time", 10)
     private val usePurpurAfk = yaml.getBoolean("use-purpur-afk", true)
     private val versionCheck = yaml.getBoolean("version-check", true)
     private val defaultMountController = when (yaml.getString("default-mount-controller")?.lowercase()) {
@@ -85,7 +84,6 @@ class BetterModelConfigImpl(yaml: ConfigurationSection) : BetterModelConfig {
     override fun packType(): BetterModelConfig.PackType = packType
     override fun buildFolderLocation(): String = buildFolderLocation
     override fun followMobInvisibility(): Boolean = followMobInvisibility
-    override fun animatedTextureFrameTime(): Int = animatedTextureFrameTime
     override fun usePurpurAfk(): Boolean = usePurpurAfk
     override fun versionCheck(): Boolean = versionCheck
     override fun defaultMountController(): MountController = defaultMountController

core/src/main/resources/config.yml

@@ -1,68 +1,104 @@
-#toggles debug option.
+# BetterModel Configuration
+#
+# This file contains all the configuration options for the BetterModel plugin.
+# For detailed information on each option, please refer to the official documentation.
+
+# Debugging options for development and troubleshooting.
+# Enable these only if you are diagnosing issues.
 debug:
-  #hitbox
+  # Toggles debug messages for hitbox creation and interaction.
   hitbox: false
-  #exception
+  # Toggles detailed stack traces for exceptions handled by the plugin.
   exception: false
-  #pack
+  # Toggles debug messages related to resource pack generation.
   pack: false
-  #tracker
+  # Toggles debug messages for model tracker lifecycle and updates.
   tracker: false
-#toggles indicator option.
+
+# Visual indicator settings.
 indicator:
-  #progress bar
+  # Shows a progress bar during resource pack generation.
   progress_bar: true
-#toggle BetterModel's feature you want
+
+# Core feature modules.
+# Disable modules you don't need to save resources.
 module:
-  #general entity model
+  # Enables general entity models.
   model: true
-  #player model
+  # Enables player-specific animations and models (e.g., custom limbs).
   player-animation: true
-#toggle resource pack generation
+
+# Resource pack generation settings.
 pack:
-  #generates modern resource pack (>=1.21.4)
+  # Generates models compatible with modern Minecraft versions (>=1.21.4).
   generate-modern-model: true
-  #generates legacy resource pack (<1.21.3)
+  # Generates models compatible with legacy Minecraft versions (<=1.21.3).
   generate-legacy-model: true
-  #should obfuscate this resource pack
+  # Obfuscates model and texture names in the resource pack to prevent easy extraction.
   use-obfuscation: false
-#toggles metrics in bStats (https://bstats.org/plugin/bukkit/BetterModel/24237)
+
+# Toggles metrics collection via bStats (https://bstats.org/plugin/bukkit/BetterModel/24237).
+# Disabling this helps us less to improve the plugin.
 metrics: true
-#enables sight-trace culling
+
+# Enables sight-trace culling: models are only rendered if there is a clear line of sight.
 sight-trace: true
-#should merging resource pack with external plugin.
+
+# Merges the generated resource pack with packs from other plugins.
 merge-with-external-resources: true
-#target item material about resource pack
+
+# The base item used for custom model data.
+# It's recommended to use an item that is not commonly used for other purposes.
 item: leather_horse_armor
-#item namespace
+
+# The namespace used for custom model items.
 item-namespace: bm_models
-#max distance about sending an animation packet
+
+# Maximum distance (in blocks) for sending animation packets. -1 for default server view distance.
 max-sight: -1
-#min distance about sending an animation packet
+# Minimum distance (in blocks) before animation packets are sent.
 min-sight: 5
-#resource pack namespace
+
+# The namespace used for resource pack assets (e.g., assets/bettermodel/...).
 namespace: "bettermodel"
-#resource pack type (folder, zip)
+
+# The format of the generated resource pack.
+# 'zip': A standard .zip file.
+# 'folder': A raw folder structure (useful for merging or debugging).
 pack-type: zip
-#resoruce pack location
+
+# The location where the resource pack file or folder will be generated, relative to the server root.
 build-folder-location: BetterModel/build
-#toggle following mob's invisibility
+
+# If enabled, models attached to invisible mobs will also be invisible.
 follow-mob-invisibility: true
-#default frame time of animated texture
-animated-texture-frame-time: 10
-#toggles using Purpur afk (https://purpurmc.org/)
+
+# If enabled, utilizes Purpur's AFK API to pause animations for AFK players.
 use-purpur-afk: true
-#toggles version update announcement
+
+# Checks for new plugin versions on startup and notifies admins.
 version-check: true
-#default mount controller (walk, fly)
+
+# The default movement controller for mountable models.
+# 'walk': Standard ground-based movement.
+# 'fly': Flying movement.
 default-mount-controller: walk
-#keyframe insertion tick time
+
+# The time in ticks between inserted keyframes for smooth interpolation (lerp).
+# Lower values result in smoother but potentially more resource-intensive animations.
 lerp-frame-time: 3
-#toggles canceling player hotbar swap if target player is disguised or in player animation
+
+# Prevents players from swapping hotbar slots if they have a custom player model or animation active.
 cancel-player-model-inventory: false
-#delay of applying hiding player entity
+
+# The delay in ticks before a player's original entity is hidden after a model is applied.
+# This can help prevent visual glitches.
 player-hide-delay: 3
-#packet bundling size
+
+# The number of packets to bundle together before sending.
+# Higher values can reduce network overhead but may increase perceived latency. 0 to disable.
 packet-bundling-size: 16
-#enable strict loading
-enable-strict-loading: false
+
+# Enables strict loading mode. If true, the plugin will fail to load models with unsupported features.
+# If false, it will attempt to load them by ignoring unsupported parts, which may cause visual issues.
+enable-strict-loading: false