Combat+ Core

This mod serves as the core library and compatibility layer that enables the entire Combat+ series to function seamlessly with maximum inter-mod compatibility.

API Information

The library provides numerous utility methods and interfaces that significantly simplify the process of adding unique weapons and enchantments to the game. Any mod utilizing these tools will be fully compatible with the Combat+ series.

Main Interfaces

Melee Weapon

• Applied to any close combat weapon
• Provides callbacks for fully charged attacks, critical strikes, and finishing blows
• Requires specification of damage value

Dual Weapon

• Inherits from melee weapon
• Used for weapons that can be wielded in either hand
• Supports game-changing enchantments for the offhand
• Includes method for calculating offhand damage

CPC Enchantments

• Offers hooks for performing actions on fully charged hits, critical attacks, and finishing blows
• Provides an enhanced version of the damage system
• Allows any enchantment in any slot to contribute to damage bonus

Enchantment Types

Each item can only have one enchantment of each category (excluding offhand enchantments).

Additional Damage

• Enhanced version of standard damage enchantments
• While technically any enchantment can increase damage, this is primarily the task of this category
• Incompatible with regular damage enchantments

Weapon Utility Enchantments

• Add additional utility functions to weapons or enhance existing effects
• For example, Sweeping Edge belongs to this category

Aspects

• Modify the state of the attacker or target on hit
• Fire Aspect is a classic example

Offhand Enchantments

• Miscellaneous group intended for weapons in the offhand
• Mostly incompatible with other categories

Datapack Information

To improve compatibility with mods outside the Combat+ ecosystem, a set of datapack tags is available. These tags are considered in various Combat+ features, including enchantment eligibility.

Item Tags

• combat-plus:melee_weapon - items are considered melee weapons and can receive appropriate enchantments
• combat-plus:dual_weapon - included in the melee weapon tag, items are considered dual weapons
• combat-plus:breaks_shields - items can break shields

Enchantment Tags

For each enchantment type, there is a corresponding tag. This allows other developers and modpack creators to classify enchantments into the four groups. Combat+ enchantments are incompatible with enchantments from the same tag as their group.

Game Rules

Combat+ Core adds several additional game rules to modify standard weapon mechanics.

• keepLoyaltyTridents - when enabled, tridents with loyalty don't leave inventory when thrown and cannot be picked up. Instead, they go on cooldown
• sweepingRequiresEnchantment - sweeping effect of swords only works with Sweeping Edge enchantment
• pvpEnchantmentModifier - damage from enchantments is multiplied by this rule's value when attacking players (for PvP balancing)
• lethalPoison - poison can kill players and mobs instead of leaving them at half a heart

Showcase Video