Code Monkey home page Code Monkey logo

bettercombat's Introduction

Better Combat

Java 17 Environment: Client & Server Discord

Easy, spectacular and fun melee combat system we know from Minecraft Dungeons.

Add unique behaviour to your weapon, or just reuse a preset, using data files (aka JSON API).

⭐️ Features

Primary features

  • Weapons have combos (each attack in the combo can be different in many ways)
  • Better weapon idle and attack animations
  • Upswing weapon before hitting for natural look and feel
  • No more pixel hunting for target in front, accurate weapon swing calculation (based on OBB+SAT)
  • Hitting multiple enemies with a single strike
  • Weapon attributes are synchronized (server sends to client)
  • Bundled resources: weapon animations, weapon sounds, weapon attribute presets
  • Integrate any weapon from any mod by just creating data files

Auxiliary features

  • Two-handed weapons ignore offhand slot
  • Movement speed reduction while attacking (Server configurable)
  • Attacking with dual wielded weapons (Server configurable)
  • Cancel attack during upswing (aka "feint") (Client configurable)
  • Hold attack key to spam attack (Client configurable)
  • Target in hitbox indication (Client configurable)
  • Swing thru grass (Client configurable)
  • Can disable mining with weapons (Client configurable)

Compatibility features

  • Dedicated compatibility (Add weapon attribute data files for individual items, to specify their animations and behaviour) aka JSON API
  • Fallback compatibility (Tries to automatically assign the correct type of weapon attributes to weapons without attribute file. Highly configurable)
  • NBT compatibility (Weapon attributes can be read from ItemStack NBT). For example:
/give @p minecraft:wooden_sword{weapon_attributes:'{"parent":"bettercombat:claymore"}'} 1

Future plans:

  • Weapon trail animation while hitting
  • Parry (under consideration)
  • Additional weapon attributes (for example: pushback)

🔧 Configuration

Client

Fabric

You can access the client side settings via the Mod Menu.

Forge

You can access the client side settings in Main Menu > Mods > Better Combat > Config.

Server

Fallback compatibility configuration can be found at: /config/bettercombat/fallback_compatibility.json

Use fallback compatibility configuration to add compatibility for any weapon on your server. All weapon attributes are synchronized with clients upon joining the server.

Server config can be found at: /config/bettercombat/server.json5

Server configuration is synchronized with clients upon joining the server.

🔨 Integrate your mod

The next steps describe how to add dedicated compatibility for any item.

Installation

Fabric

Download the latest release version of the mod with all of its dependencies, and put them into ./run/mods director.

Alternatively, if you would like to use the JAVA API provided by Better Combat. Install it via gradle:

repositories {
    maven { url 'https://api.modrinth.com/maven' }  
}

dependencies {
    [...]
    modImplementation "maven.modrinth:better-combat:VERSION-fabric"
}

(Note: JAVA API is only needed for special integration cases.)

Please note for both Forge and Fabric, Cloth Config and playerAnimator are required as well. Please see each link on how to add these to your dev environments.

Forge

repositories {
    maven { url 'https://api.modrinth.com/maven' }  
}

dependencies {
    [...]
    implementation fg.deobf('maven.modrinth:better-combat:VERSION-forge')
}

Please note for both Forge and Fabric, Cloth Config and playerAnimator are required as well. Please see each link on how to add these to your dev environments.

Prerequisite

Make sure to remove or disable all logic from your mod that is semantically conflicting with this mod:

  • Player animation and or model modifications
  • Attack range modifications
  • Attack timing or cooldown logic modifications
  • Custom attack sound playback
  • Attack/mining key handler modifications (of MinecraftClient)
  • Dual wielding logic
  • Custom item wielding appearance

(Note: Better Combat expects all items to be held like swords, it rotates them accordingly during animations. If you have a dagger that is facing backwards, you need to disable that, otherwise it will be facing backwards during attack animations too. Better Combat offers weapon specific poses for adjusting position and rotation of items while idling.)

Basics

Weapon attributes describe the behaviour of a weapon including: range, combos (list of attacks), animations and sounds, etc...

Assign weapon attributes to weapons of your mod, just by creating resource files. This is done similar to how you assign crafting recipes to an item. No need for any java dependency.

Weapon attributes can describe:

  • How the weapon is held (is two-handed, idle pose)
  • Attack range
  • List of attack moves (aka Combo), attacks have the following properties
    • Damage
    • Hitbox
    • Conditions
    • Animation
    • Sounds

Each mod should provide their own resources files for compatibility (preferably within their jar file) for the following reasons:

  • A single source of configuration files is difficult to maintain
  • More intuitive installation process for users
  • Every mod developer should decide how their weapon is meant to behave
  • Some mods may need to disable semantically conflicting features (mentioned at Prerequisite)

Let's see an example where we add attributes to a custom sword named "Big Sword" from your mod:

  • mod id is my-mod-id
  • id of the item is my-mod-id:big_sword

To assign weapon attributes to the Big Sword, create a new json file at the following location:

resources/data/my-mod-id/weapon_attributes/big_sword.json

The content of this json file should be the following:

Using a preset

Presets are out of the box collection of weapon attributes bundled with this mod, covering the common weapon types.

A fitting preset for a big two handed sword is the claymore from Better Combat, its identifier is: bettercombat:claymore. To use this preset add the following content to your JSON file:

{
  "parent": "bettercombat:claymore"
}

You can check out all available presets here.

You can check out how presets are used to add compatibility for Vanilla weapons here.

You can make and reference your own presets the same way.

Custom attributes

If you want unique behaviour for your weapon, you can create attributes from scratch.

The content of your weapon attributes JSON file is parsed into an AttributesContainer object. (Check out the inline java documentation of AttributesContainer for details.)

When no parent is specified, the value for "attributes" key must be a full json object that can be parsed into WeaponAttributes object.

{
  "attributes": { ... }
}

Check out the existing weapon presets to see practical examples of building from scratch.

Check out the available attack animations, bundled with Better Combat.

If you need more details, the java documentation of WeaponAttributes covers all the specifics.


When "parent" and "attributes" are both specified, you can customize attributes by partially (or fully) overriding the properties. Make sure the inheritance results in fully parsable WeaponAttributes object.

(Attributes are merged in parent -> child order. So parent properties are copied and overridden with child. The chain of inheritance can be any length.)

{
  "parent": "bettercombat:claymore",
  "attributes": {
    "attack_range": 3.5
    "attacks": [
      {
        "angle": 100
      },
      {
        "damageMultiplier": 0.1 
      },
      {
        "damageMultiplier": 0.3,
        "angle" = 90
      }
    ]
  }
}

You can create and use your own presets:

{
  "parent": "my-mod-id:longsword",
  "attributes": { ... }
}

Custom animations

Let's say you want to create a custom attack animation with the following name: big_sword_slash

Creating animation

Create keyframe animations using our Blender model, that includes an export script creating animation files.

Check out the Animation guide for details. Blender example

Adding animation

Add the created animation to the following location

resources/assets/my-mod-id/attack_animations/big_sword_slash.json

Using the animation

You can use your custom animation by referencing it, following the resource identifier pattern.

Make sure to specify a fitting upswing value next to your animation (to make it look and feel nice to use).

{
  // ...
  "attributes": {
    // ...
    "attacks": [
      {
        "animation": "my-mod-id:big_sword_slash",
        "upswing": 0.5
      },
      // ...
    ]
  }
}

📦 Using datapacks

You can create datapacks to add dedicated compatibility for any weapon.

⚠️ Caution! Some mods may have conflicting features, that causes incorrect appearance or behaviour of weapons, even if compatibility is added. In this case mod developers need to resolve incompatibilities. (Check mod compatibility section for potential source of problems.)

Steps:

  1. Create a datapack
  2. Add weapon attribute files based on our integration guide, the easiest way to use existing presets of Better Combat

For example, adding compatibility for an item with id fruits:banana_sword from Fruits mod, to make it act like a claymore, would look like the following.

File path:

DataPackName/data/fruits/weapon_attributes/banana_sword.json

Content:

{
  "parent": "bettercombat:claymore"
}

⛓ Mod compatibility

This mod has been created in the spirit of maximal compatibility. However since some core mechanics are overridden, mods trying to change the same thing will never be compatible.

Mods with one or more of these features are considered as a semantic incompatibility

  • Dual wielding implementation
  • Attack range modifications
  • Attack timing or attack cooldown logic modifications
  • Attack/mining key handler modifications (of MinecraftClient)
  • Player model modification

✍️ Contribution

Before committing yourself to implementing any change for the project, it is strongly suggested to check with us on Discord. The project has a strong vision for what technical solutions are accepted, and what features belong to the scope of the project.

Avoid creating pull requests with the following content:

  • huge code changes
  • feature that is out of scope
  • feature that already exist in some form

bettercombat's People

Contributors

azuredoom avatar bernie-g avatar chronosacaria avatar ejdarrow avatar fitfc avatar kosmx avatar lukegrahamlandry avatar skel39eek66 avatar vertexcubed avatar zsoltmolnarrr avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.