Перейти к содержимому
Mineforgian

Combat+ Core

The core library and compatibility layer for the Combat+ series.

117K загрузок56 подписчиковMITfabricquilt

Обновлён 23 декабря 2025 г. · опубликован 11 февраля 2024 г.

Скачать 4.0.1+1.21.11(289 КБ)

Combat+ Core

Combat+

This is the core library mod and compatibility layer that allows the Combat+ series to function with an extremely high level of inter-mod compatibility.

View the collection on Modrinth here.

API Information

The library adds a number of utility methods and interfaces that make it easier to add unique weapons and enchantments to the game.

Any mod that makes use of these will be compatible with the Combat+ series.

Interfaces

  • Melee Weapon
    • Used for any melee weapon.
    • Provides callbacks that trigger for fully charged attacks, critical attacks, and killing.
    • Must implement a damage value.
  • Dual Weapon
    • Inherit from Melee Weapon, used for weapons which could be wielded in either hand and may support game-changing offhand enchantments.
    • Additionally contains a method for offhand damage.
  • CPCEnchantment
    • Offers hooks for enchantments to perform actions for fully charged hits, critical hits, and killing.
    • Offers a more advanced version of damage, where an enchantment of any slot can contribute to the damage bonus.

Enchantment Types

An item can only have one enchantment of each category (not including offhand enchantments).

  • Additional Damage
    • A more advanced version of vanilla damage enchantments.
    • Any enchantment technically can increase damage, but this should mostly be done by Additional Damage enchantments unless there is a special circumstance.
    • Additionally incompatible with vanilla's Damage Enchantments.
  • Weapon Utility
    • Enchantments that add some additional utility function to a weapon, or otherwise enhance its existing effects.
    • Sweeping Edge would be a Weapon Utility.
  • Aspect
    • Enchantments that modify the state of the user or the target on hit.
    • Fire Aspect would (obviously) be an Aspect.
  • Offhand
    • A misc group that is intended to apply to offhanded weapons.
    • Largely incompatible with the other groups.

Datapack Information

To improve compatibility with mods outside of the Combat+ ecosystem, a series of datapack tags are available.
These tags are considered in various features of Combat+, such as eligibility for enchantments.

Item Tags

  • combat-plus:melee_weapon
    • These items are considered unimplemented Melee Weapons and will be eligible for enchantments that target Melee Weapons.
  • combat-plus:dual_weapon
    • This tag is included in the melee weapon tag.
    • These items will be considered unimplemented dual weapons and will be eligble for relevant enchantments.
  • combat-plus:breaks_shields
    • These items can break shields.

Enchantment Tags

There is a corresponding tag for each enchantment type. This can be used by other modders or modpack makers to categorise other enchantments into the four groups.

Combat+ enchantments will be incompatible with enchantments that are in the same tag as their group. For example a Weapon Utility enchantment is incompatible with any enchantment in the combat-plus:weapon_utility tag.

Game Rules

Combat+ Core adds two additional gamerules to modify vanilla weapon mechanics.

  • keepLoyaltyTridents
    • When true, loyalty tridents will not leave the inventory when thrown, nor can they be picked up or return to the thrower. Instead tridents will go on cooldown. Higher levels of loyalty will decrease the cooldown.
  • sweepingRequiresEnchantment
    • When true, the sweeping effect of a sword will only occur if the sword has the Sweeping Edge enchantment. This allows the player to decide whether sweeping should be considered a native property of the sword, or the product of an enchantment.
  • pvpEnchantmentModifier
    • Damaging enchantments can use the combat-plus:gamerule_damage component instead of vanilla's damage component. Damage of this type will be multiplied by this gamerule's value when dealt against players. This is for PvP balancing.
  • lethalPoison
    • When true, poison will be able to kill players and mobs instead of leaving them on half a heart.

Showcase Video

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
4.0.1+1.21.11Релиз1.21.11fabric, quilt23 декабря 2025 г.Скачать (289 КБ)
4.0.0+1.21.11Релиз1.21.11fabric, quilt20 декабря 2025 г.Скачать (289 КБ)
4.0.0+1.21.10Релиз1.21.9, 1.21.10fabric, quilt16 октября 2025 г.Скачать (288 КБ)
4.0.0+1.21.5Релиз1.21.5, 1.21.6, 1.21.7, 1.21.8fabric, quilt15 апреля 2025 г.Скачать (287 КБ)
3.2.0+1.21.4Релиз1.21.4fabric, quilt26 января 2025 г.Скачать (259 КБ)
3.2.0+1.21.3Релиз1.21.2, 1.21.3fabric, quilt26 января 2025 г.Скачать (258 КБ)
3.2.0+1.21Релиз1.21, 1.21.1fabric, quilt26 января 2025 г.Скачать (255 КБ)
3.1.0+1.21.4Релиз1.21.4fabric, quilt5 декабря 2024 г.Скачать (297 КБ)
3.1.0+1.21.3Релиз1.21.2, 1.21.3fabric, quilt30 ноября 2024 г.Скачать (246 КБ)
1.1.0+1.20.4Релиз1.20.3, 1.20.4fabric, quilt15 сентября 2024 г.Скачать (136 КБ)
1.1.0+1.20.1Релиз1.20, 1.20.1, 1.20.2fabric, quilt15 сентября 2024 г.Скачать (136 КБ)
3.1.0+1.21Релиз1.21, 1.21.1fabric, quilt25 июля 2024 г.Скачать (244 КБ)
3.0.0+1.21Релиз1.21fabric, quilt15 июля 2024 г.Скачать (228 КБ)
2.0.1+1.20.6Релиз1.20.5, 1.20.6fabric, quilt21 июня 2024 г.Скачать (89 КБ)
2.0.0+1.20.6Релиз1.20.5, 1.20.6fabric, quilt26 мая 2024 г.Скачать (79 КБ)

Показаны последние 15 из 17 версий.

Ченджлог

4.0.1+1.21.11Релиз1.21.11 · 23 декабря 2025 г.

Hotfix update to address a crash found in 1.21.11 after further testing.

Bugfixes

  • [LilyLib] Fixed crash caused by rendering FlatParticles.
4.0.0+1.21.11Релиз1.21.11 · 20 декабря 2025 г.
  • Updated to Minecraft 1.21.11
4.0.0+1.21.10Релиз1.21.9, 1.21.10 · 16 октября 2025 г.
  • Updated to 1.21.10
4.0.0+1.21.5Релиз1.21.6, 1.21.7, 1.21.8 · 15 апреля 2025 г.

Major update to make the library compatible with 1.21.5

Additions

  • New item data components:
    • combat-plus:melee_weapon
      • Holds two floats, weapon damage and offhand damage.
      • All Melee and Dual weapons are expected to use this data component.
      • Combat+ mods can use this component to acquire damage values for callbacks (interface values from MeleeWeapon should always be preferred).
    • combat-plus:cooldown_group
      • Takes an identifier and sets what group the item should use when on cooldown.
    • combat-plus:max_use_time
      • Determines how many ticks an item can be used for.
      • This component was moved from Dual Swords.
  • New enchantment component type: data component enchantment effects!
    • Enchantments can grant temporary data components to items.
    • The component is added when the item is enchanted and lost when the enchantment is removed.
    • Currently supports:
      • Cooldown Group
      • Max Use Time
      • Blocks Attacks
  • New attribute: Protection Effectiveness
    • Treated as a multiplier, this determines how effective protection enchantments are on the entity.
    • Default value of 1 (normal effectiveness).

Changes

  • Callbacks for blocking attacks now accept a damage source instead of the attacking entity.

Bugfixes

  • Tridents are no longer unbreakable with KeepLoyaltyTridents.
  • When using KeepLoyaltyTridents, only tridents with Loyalty will go on cooldown.
3.2.0+1.21.4Релиз1.21.4 · 26 января 2025 г.

Minor update to add the groundwork for a shield-related features.

Additions

  • Added new class for easily executing callbacks from an item.
  • Added new interface, BlockingItem.
    • Items with the ability to block attacks should implement this interface.
    • It contains methods that allow the item to configure the nature of its blocking.
      • Cooldown duration when disabled.
      • How many ticks the item must be used for until it is actively blocking attacks.
      • Callbacks
        • Damaging the shield.
        • Post-block actions.
  • Added enchantment callback for post-block actions.
  • Added enchantment context (for conditions) for post-block actions.
    • In this context, the target is the owner of the enchanted item, the one who blocked the attack.
  • Added debug shield item and debug blocking enchantment for developers.
  • [LilyLib] Enchantment descriptions now also generate a .description key as well as the existing .desc key.
3.2.0+1.21.3Релиз1.21.2, 1.21.3 · 26 января 2025 г.

Minor update to add the groundwork for a shield-related features.

Additions

  • Added new class for easily executing callbacks from an item.
  • Added new interface, BlockingItem.
    • Items with the ability to block attacks should implement this interface.
    • It contains methods that allow the item to configure the nature of its blocking.
      • Cooldown duration when disabled.
      • How many ticks the item must be used for until it is actively blocking attacks.
      • Callbacks
        • Damaging the shield.
        • Post-block actions.
  • Added enchantment callback for post-block actions.
  • Added enchantment context (for conditions) for post-block actions.
    • In this context, the target is the owner of the enchanted item, the one who blocked the attack.
  • Added debug shield item and debug blocking enchantment for developers.
  • [LilyLib] Enchantment descriptions now also generate a .description key as well as the existing .desc key.
3.2.0+1.21Релиз1.21, 1.21.1 · 26 января 2025 г.

Minor update to add the groundwork for a shield-related features.

Additions

  • Added new class for easily executing callbacks from an item.
  • Added new interface, BlockingItem.
    • Items with the ability to block attacks should implement this interface.
    • It contains methods that allow the item to configure the nature of its blocking.
      • Cooldown duration when disabled.
      • How many ticks the item must be used for until it is actively blocking attacks.
      • Callbacks
        • Damaging the shield.
        • Post-block actions.
  • Added enchantment callback for post-block actions.
  • Added enchantment context (for conditions) for post-block actions.
    • In this context, the target is the owner of the enchanted item, the one who blocked the attack.
  • Added debug shield item and debug blocking enchantment for developers.
  • [LilyLib] Enchantment descriptions now also generate a .description key as well as the existing .desc key.
3.1.0+1.21.4Релиз1.21.4 · 5 декабря 2024 г.

Changes

  • Updated to 1.21.4 Minecraft.

Комментарии

Загружаем…