CombatEdit

CombatEdit

A server-side Fabric mod that brings back 1.8-style combat to modern versions of Minecraft! Can additionally configure default attributes for all entities and items and default item components.

Requirements

This mod does not require client-side installation or the Fabric API (necessary Fabric API modules are bundled with the mod), however, to configure attributes with a GUI, Mod Menu is required to open the configuration screen.

Features

The default settings of this mod bring back 1.8-style combat. Additionally (since version 2.1), the following options are configurable either via the options screen or the configuration file (see Configuration):

• Default entity attributes for living entities (max health,

attack damage, attack speed, movement speed, ...)

• Default item attribute modifiers for all item types (additional attack

damage, attack speed, ...)

• Default item components for all item types (durability, unbreakability,

enchantments, ...)

• Which attack sounds should be enabled or disabled
• Whether 1.8-style knockback should be enabled

Please note that although changing item and entity defaults while in a world is possible and I've tried my best to make it work as seamlessly as possible, it could potentially still lead to unexpected behaviour and (probably smaller) bugs.

Configuration

CombatEdit uses different concepts for configuring itself:

Settings file

This is the main way for players to configure the mod. Configurations made in the settings file take precedence over the base profile and profile extension configurations, and the settings file determines which base profile is to be used. For users, the main way to configure the settings is using the GUI screen accessible via ModMenu in the Mods list (by clicking on the gear button once CombatEdit is selected). The settings file is saved in config/combatedit/settings.json relative to the minecraft/server directory.

To configure these options on a server, you can create and save your configuration on the client using the configuration screen and then upload the config file (in config/combatedit/settings.json) to the same directory inside the server directory.

Base profiles

Base profiles determine the main configuration for entity and item attributes. CombatEdit includes two base profiles:

• the 1.8 Combat Profile (combatedit:1_8_combat), which is enabled by default and sets entity and item attributes values

to resemble a modern version of 1.8 Combat (using the same damage values as Bedrock Edition)

• the Vanilla profile (combatedit:vanilla), which leaves default entity and item attributes untouched.

Datapack creators can provide their own base profiles (see Datapacks) to create different base configurations.

Profile extensions

Profile extensions allow adjusting the configuration of a base profile (such as adding addition item modifiers or overriding others set in the base profile). They are aimed at mod developers who want to provide different item or entity settings for base profiles (for example by changing damage values for the 1.8 Combat profile on custom items to compensate for the lack of any Attack Cooldown as a balancing measure). See Mod developers for more information.

Datapacks

Both base profiles and profile extension can be included in a datapack. The following directory tree describes where to place base profile and profile extension files.

• data: the data directory within your datapack
• <your_namespace>: Your custom datapack namespace
• combatedit: All CombatEdit-related datapack files reside within here
• profile_extensions: Contains profile extensions.
• <profile_namespace>
• <profile_name>: Contains .json profile extension files extending the base profile

<profile_namespace>:<profile_name>

• base_profiles: Contains base profile .json files. A file named <your_profile>.json created here will create

a base profile with the ID <your_namespace>:<your_profile>.

Mod Developers

Mod developers can include base profiles in JSON format just like datapack creators by placing files inside their data resource directory using the same directory structure as mentioned above for datapacks. Additionally, it is possible to provide profile extensions programmatically: simply create a class implementing the CombatEditInitListener interface and specify this implementation as a new entrypoint with the name combatedit within your fabric.mod.json.

JSON Format specifications

This section explains the JSON formats of the various configuration types. Sample datapacks for base profile and profile extension creation can be found in the examples directory.

Base profiles

A base profile in JSON format is a JSON object containing the following keys:

• name: The display name of your base profile. Can be a text component or a simple string.
• description: The description of your base profile. Can be a text component or a simple string.
• configuration: The feature configuration for this base profile. See Feature configuration.

Profile extensions

A profile extension in JSON format is a JSON object containing the following keys:

• priority: An integer specifying the priority of this profile extension. A greater priority value results in this

profile extension having priority over other profile extensions if overrides within them clash with each other.

• configuration_overrides: A feature configuration specifying the overrides this extension makes. See

Feature configuration.