IQHandFight 1.2.1

IQHandFight – Melee Combat System for RUST!

Add a new combat mechanic for your players!
Melee combat is a great addition to RUST, and your players will love it!

Plugin Installation:

When downloading the resource, you receive an archive containing the plugins and data folders.
- Move the file from the "data" folder strictly to the path as in the archive: oxide/data/IQSystem/IQHandFight.
- If any of these files are missing on your server, create them manually.
- Move IQHandFight.cs from the "plugins" folder strictly to the path as in the archive: oxide/plugins.

Note for users using the "Web File Editor" on hosting services:
Before transferring files, extract the archive to a convenient location on your device and then transfer the files from there.

Feature List:

Knockout:
The ability to knock out a player, causing them to fall to the ground!
This feature can be configured in the settings.

Damage System:
Random Damage Distribution: Each hit deals random damage within a specified range, adding dynamism and unpredictability to combat.
Reverse Damage: When attacking, the player also receives slight damage — punches cause minor self-inflicted damage.
Bleeding Effect: Each hit causes minor bleeding that accumulates over time, intensifying combat dynamics and adding an element of unpredictability.
Jump Attack: If a player strikes while jumping, they deal slightly increased damage.

Visual and Sound Effects:
Each hit is accompanied by a variety of visual and sound effects, enhancing the combat experience and making fights more immersive.

Stamina System:
Each attack consumes a certain amount of stamina. When fully depleted, the player cannot attack and must rest.
Stamina regenerates progressively — the less active the player is in combat, the faster it recovers.
The stamina system has three different UI placements, which can be adjusted in the configuration.

Who Can Be Attacked:
Players can land hits on: Players, NPCs, Animals, Barrels

Animal Harvesting:
The plugin supports harvesting animals with bare hands. While it provides only a small portion of resources, it still allows players to gather materials even without tools!

Weapon Disarm System:
This feature allows players to knock weapons out of the hands of opponents, including both other players and NPCs.
This mechanic introduces an element of surprise and opens up new tactical opportunities in combat.
The chance of disarming an opponent and the ability to enable or disable this feature are fully configurable.



Configuration : 
 

{
  "Use in-game chat notification to inform the player about melee combat [true - yes/false - no]": true,
  "Enable the ability to gather animals using hands [true - yes/false - no]": false,
  "Knockout settings": {
    "Enable knockout feature [true - yes/false - no] (Ragdolls must be enabled on the server)": true,
    "Chance to knock out the player": 10.0,
    "Minimum opponent HP required to activate knockout": 50
  },
  "Stamina settings for strikes": {
    "Enable `Stamina for strikes` [true - yes/false - no]": true,
    "Maximum stamina amount": 100,
    "Amount of stamina consumed per strike": 10,
    "Specify the UI type for `Stamina`. 0 - Above slots, 1 - Below `Satiety`, 2 - Below `Satiety` full width": 2
  },
  "Settings for disarming a player's weapon": {
    "Enable `Ability to disarm an opponent's weapon` [true - yes/false - no]": false,
    "Chance to disarm a weapon per strike": 5.5
  },
  "Settings for disarming an NPC's weapon": {
    "Enable `Ability to disarm an opponent's weapon` [true - yes/false - no]": false,
    "Chance to disarm a weapon per strike": 5.5
  },
  "Settings for integration with IQChat": {
    "IQChat: Prefix": "[<color=#1F6BA0>IQHandFight</color>]\n",
    "IQChat: Avatar [Steam64ID]": "0"
  },
  "Damage Setting": {
    "Additional damage while jumping": {
      "Minimum damage per hit": 0.5,
      "Maximum damage per hit": 2.5
    },
    "Damage when hitting a player": {
      "Minimum damage per hit": 1.0,
      "Maximum damage per hit": 10.0
    },
    "Damage when hitting an NPC": {
      "Minimum damage per hit": 5.0,
      "Maximum damage per hit": 20.0
    },
    "Damage when hitting animals": {
      "Minimum damage per hit": 5.0,
      "Maximum damage per hit": 20.0
    },
    "Damage when hitting barrels": {
      "Minimum damage per hit": 5.0,
      "Maximum damage per hit": 20.0
    },
    "Setting up counter damage per hit": {
      "Counter damage for a hit": {
        "Minimum damage per hit": 0.5,
        "Maximum damage per hit": 3.0
      },
      "Additional counter damage for a hit while jumping": {
        "Minimum damage per hit": 0.5,
        "Maximum damage per hit": 1.0
      }
    }
  }
}