📦 ChangeLog – Dynamic Arguments & Combat Viewer Update

✨ New: Dynamic Argument System

A new Dynamic Argument System has been introduced across:

• Passive skills
• Active skills
• Combat Viewer (including combos)

This system allows runtime-generated text elements inside lang-based descriptions.

🧠 What are Dynamic Arguments?

Dynamic arguments are injectable components used in translation-based text to provide:

• 🎨 Colored text
• 🔢 Mathematical operations
• ⚔️ Damage-based calculations
• 🎮 Dynamic keybindings

⚠️ This system requires translation keys (lang files). It does not work with raw/plain text.

🧩 Argument Types

1. scripted_text

Injects styled or formatted text.

2. key_binding

Displays the current keybinding dynamically.

3. damage_operation

Performs operations based on weapon damage or a base value.

Supported operations:

• addition
• substract
• multiplication
• division

⚙️ Base Value Behavior

• If baseValue is defined → operation uses that value
• If not defined → defaults to Codex stack (item) damage

🔢 Number Formatting (format)

The format field controls how numerical values are displayed in dynamic arguments.

🧠 What does it mean?

• %f → represents a decimal number
• .1 → shows 1 digit after the decimal point

📊 Examples

💡 Simple Explanation

This controls how many decimals are shown.

• Use "%.0f" → no decimals
• Use "%.1f" → 1 decimal
• Use "%.2f" → 2 decimals

⚠️ Notes

• Values are rounded automatically

🔗 Integration Points

Dynamic arguments are assigned depending on context:

🆕 New: Combat Viewer (Epic Fight Integration)

Added compatibility with Epic Fight:

📖 New Codex Tab

• Displays combos and attack sequences
• Includes:
  • Title
  • Description
  • Animation list
  • Playback controls
  • Navigation between combo sets

⚔️ Combo Features

Each combo can define:

• Animation sequences
• Optional offhand requirements
• Descriptions (supports translation keys)
• Dynamic arguments via dynamicComboArgs

💡 Example Use Cases

Dynamic arguments in combos enable:

• Displaying damage scaling per hit
• Showing charged attack modifiers
• Explaining combo-specific mechanics

🧪 Example Configuration

Dynamic arguments applied to an active skill:

. . .

        "dynamicArgsDescription": [
          {
            "argTargetType": "key_binding",
            "translatableKey": "slm_codex.core.key.render_details_screen",
            "colorKey": "aqua"
          },
          {
            "argTargetType": "damage_operation",
            "operation": "multiplication",
            "modifier": 1.5,
            "colorKey": "red",
            "format": "%.1f"
          }
        ],

        "dynamicArgsAdditional": [
          {
            "argTargetType": "scripted_text",
            "translatableKey": "slm.test.wooden_sword.active.key.additional.scripted",
            "colorKey": "red"
          }
        ]

. . .

 

and the result would be something like this...

 

 

in the json file (codex datapack)

 

 

 

⚠️ Notes

• Dynamic arguments only work with translation keys
• Plain text descriptions will not process arguments
• Improper formatting may result in missing or incorrect values
• Regex validation for naming conventions remains unchanged (if applicable)