05. Advanced Swing Trails

The Models per Style system allows you to dynamically swap a weapon's visual model depending on the player's current combat style (stance).

💡 What's New in v2.2: I have completely deprecated the old, complex "Advanced Swing Trails" system. Now only a single configuration file is required, whereas previously two were used: one where the textures were declared, and one for item_skins for EF. This change making development significantly faster!

📁 File Location & Naming

Place your configuration files inside your resource pack or mod assets at:
assets/<any_modid>/advanced_swing_trails/*.json

✔️ Features

• Per-style swing trail configuration
• Custom textures
• Custom colors
• Custom particle types
• Custom trail positions
• Custom interpolation count
• Custom lifetime
• No item_skins file required

📄 JSON Structure & Schema

The following example configures different swing trails for the same weapon depending on its current Epic Fight style.

{
  "trails": [
    {
      "item": "epicfight:bokken",
      "default": "two_hand",
      "style_config": [
        {
          "style": "one_hand",
          "trail_data": {
            "color": [51, 235, 203],
            "begin_pos": [0.0, 0.0, -0.2],
            "end_pos": [0.0, -0.24, -1.8],
            "lifetime": 6,
            "interpolations": 4,
            "texture_path": "epicfight:textures/particle/swing_trail.png",
            "particle_type": "epicfight:swing_trail"
          }
        },
        {
          "style": "two_hand",
          "trail_data": {
            "color": [51, 235, 0],
            "begin_pos": [0.0, 0.0, -0.2],
            "end_pos": [0.0, -0.24, -1.8],
            "lifetime": 6,
            "interpolations": 4,
            "texture_path": "epicfight:textures/particle/swing_trail.png",
            "particle_type": "epicfight:swing_trail"
          }
        }
      ]
    }
  ]
}

---

📝 Root Properties

Property	Type	Description
trails	Array	List of weapon trail configurations.

🗡️ Trail Entry

Each entry inside the trails array defines the configuration for a specific item.

Property	Type	Description
item	String	Item registry name (modid:item_name).
default	String	Style used as fallback when the current style has no matching configuration.
style_config	Array	List of style-specific trail definitions.

⚔️ Style Configuration

Each style can define its own trail settings.

Property	Type	Description
style	String	Epic Fight style name.
trail_data	Object	Swing trail configuration for that style.

🎨 Trail Data

Property	Type	Description
color	Integer Array	RGB color values. Format: [R, G, B] (0-255).
begin_pos	Float Array	Trail start position. Format: [x, y, z].
end_pos	Float Array	Trail end position. Format: [x, y, z].
lifetime	Integer	Trail lifetime in ticks.
interpolations	Integer	Number of interpolation points used by the trail.
texture_path	String	Texture used by the trail.
particle_type	String	Particle registry name used by the trail.

🔄 Fallback Behavior

When a weapon's current style does not have a matching entry in style_config, the system attempts to use the style specified in the default field. Example:

{
  "item": "epicfight:bokken",
  "default": "two_hand"
}

If the current style is not configured, the trail assigned to two_hand will be used instead.

📌 Notes

• Styles must match valid Epic Fight style names.
• Colors use RGB values ranging from 0 to 255.
• Position values use the same coordinate system as Epic Fight swing trails.
• No additional item_skins configuration is required, so do not use an advanced swing trails and item_skin at the same time.
• This system can be used with both Epic Fight weapons and third-party weapons.

🎥 In-Game Showcase