InteractionTek

An interactions mod for modders who love interactions.

This mod adds a small-but-growing number of new interactions and extensible data types to Hytale. Each based around a theme or new feature.

Item Target

Interaction chains have the concept of a "held item" - this isn't necessarily a held item. In Equipped interactions, the "held item" is the item that was just equipped, for instance. However, the held item isn't intended to be changed and in many cases has a very specific meaning (for most Hypixel interactions that mess with items, there is an assumption that the held item will actually be the item in the User entity's active hotbar slot).

InteractionTek adds the concept of an "item target", to go with the block and entity target. At the beginning of a new interaction chain, the item target is always the held item. The target can be changed, though, and all of InteractionTek's interactions that mess with items will target the item target.

TekItemCondition

This interaction allow you to specify a list of item matchers to compare against the current item target. The interaction will fail if the matchers fail. InteractionTek has a large number of matcher types, with full in-asset-editor documentation. You can also create your own!

TekItemCondition Fields

ItemMatchType Values

• All
• Any

Available ItemMatcher Types

For more information, examine the types in the asset editor.

• Armor - Matches armor pieces
• AssetTag - Matches items with at least one provided asset tag
• Category - Matches items with at least one provided category
• DropOnDeath - Matches items that drop on death
• Durability - Matches items whose durability is more than or less than a value
• EmptySlot - Matches empty slots
• Glider - Matches gliders
• Group - Allows matchers to be grouped with a different ItemMatchType for complex logical operations
• Inventory - Matches items that belong to one of the specified inventory sections
• ItemState - Matches items that belong to one of the specified item states
• ItemType - Matches items that belong to one of the specified item types
• PortalKey - Matches portal keys. May optionally require a specified type
• Quantity - Matches items whose quantity is more or less than a value
• Resource - Matches items with at least one of the provided resources
• Slot - Compares the target item's slot against a Slot matcher
• Tool - Matches tools. May optionally require a provided spec
• Weapon - Matches weapons

Available Slot Types

You can make your own of these, too!

• ActiveHotbar - Matches the currently-active hotbar slot
• ActiveUtility - Matches the currently-active utility slot
• IndexedSlot - Matches slots with the provided slot index
• InteractionHeldItem - Matches the interaction chain's current held item
• TargetArmorSlot - If the target item is an armor piece, matches the armor's equipped slot
• TargetSlot - Will match the interaction chain's current target slot.
• AnyOtherSlot - Will match every slot except the interaction chain's current target item's slot

TekTargetFirstItem

This interaction will scan the User entity's inventory slots and compare each slot against a set of ItemMatchers. The first slot to succeed will be made the item target for the rest of the interaction chain. If no slots succeed, this interaction will fail.

TekTargetFirstItem Fields

TekModifyItem

This interaction applies a series of modifications to the current item target. The interaction will fail if any modifications fail. Once again, there are several modification types and you can create your own.

TekModifyItem Fields

GameMode Values

• Adventure
• Creative

Available ItemModification Types

For more information, examine the types in the asset editor.

• AdjustDurability - Make changes to the target item's durability, handle item breakage.
• AdjustQuantity - Make changes to the target item's quantity
• ChangeItem - Transition the target item to different item types and/or item states. Existing item states can be matched with wildcards
• Conditional - Execute a modification only if a set of ItemMatchers succeed
• Group - Execute a set of modifications. Great to use with Conditional or Singulate.
• RelocateItemModification - Move target item to an available slot and change the item target to its new location. Can be used for equipping and unequipping items and so much more.
• Singulate - If the target item has a quantity greater than 1, execute a modification on only one of them and place the rest back in the User entity's inventory

Flow Control

Assorted flow control interactions can be used to compose larger innovations.

TekInterruptSelf

This interaction cancels the current interaction chain and any active forked interaction chains like Hypixel's Interrupt interaction does for interactions running on targeted entities. Afterward, the interaction chain will escape to the root without running further interactions.

TekRandomBranch

This interaction will randomly select what interaction to run next from a list of possible branches. The selection will use a weighted random selection, allowing some options to be more likely than others.

TekRandomBranch Fields

Branch Fields

TekTransaction

This interaction will execute several transaction steps. If any fail, all actions taken so far will be rolled back. This interaction is ideal for paying several costs for an RPG-style ability. You can trigger multiple cooldowns, pay stat costs, and consume items from the entity's inventory and if any cost cannot be paid, none will be triggered.

TekTransaction Fields

TransactionStep Fields

Available TransactionStep Types

For more information, examine the types in the asset editor.

• ChangeStats - Apply a delta to one or more entity stats and potentially fail if the stat is fully consumed.
• ConsumeItems - Remove a quantity of items that match a set of ItemMatchers from the entity inventory. Fail if the full quantity cannot be consumed.
• ModifyItem - Find the first item slot that matches a set of ItemMatchers in the entity inventory and apply a set of ItemModifications. This step will fail if no matching slot can be found or an ItemModification fails.
• ProvideItems - Add a quantity of specified items to an entity inventory. Allows the possibility of failing if all items cannot fit.
• TriggerCooldown - Trigger a cooldown on the User entity with the specified properties. Fails if the cooldown is already active.

Utility

Connections to other modding systems.

TekRunCommand

This interaction executes a command as one of the interaction's entities, if possible. By default, players are the only entity type that can send commands, but if you have a mod that adds other capabilities, this interaction will be compatible.

This interaction will fail if the specified entity cannot run commands but will otherwise succeed, even if the command fails or if the syntax is invalid.

TekRunCommand Fields

InteractionTarget Values

• User
• Owner
• Target

TekRunProxiedCommand

This interaction will execute a command as one of the interaction's entities if possible, but proxied through a non-player structure with enhanced permissions. As a result, commands that require a player in order to function will require use of the --player flag. However, this command also allows use of @-variables, a bit like minecraft command blocks. Any @ symbol that isn't immediately followed by a valid variable name will be displayed normally. Double @ symbols will always be displayed as a single @ symbol and not perform variable processing.

Examples:

CommandText: say Hello, @player!<br /> Output: Hello, Canvoxtek!

CommandText: say @\@<br /> `Output`: @\@

CommandText: say No, @secrets is not a variable.<br /> Output: No, @secrets is not a variable.

CommandText: say To send the player's display name, use @@player!<br /> Output: To send the player's display name, use @player!

CommandText: say @@@@ @@\@@ @@@@<br /> `Output`: @@ @\@ @@

The following @-variables are currently implemented:

This interaction will fail if the specified entity cannot run commands with the provided permissions or if an invalid variable is used, but will otherwise succeed, even if the command fails or if the syntax is invalid.

TekRunProxiedCommand Fields

InteractionTarget Values

• User
• Owner
• Target