KineticArmory

By
XYAT

KineticArmory is the Kinetic armor-set and dynamic-condition mod for modpack authors and server administrators. It provides a complete workflow for armor-set definitions

Project separation: This mod is an independent gameplay add-on built on KineticCore. KineticCore is the shared base API and infrastructure layer; the actual gameplay content and feature implementation described in this README are provided by this project.

This add-on cannot be safely merged into KineticCore or another Kinetic project. It has its own feature scope, dependencies, configuration, release cycle, and user audience, so combining them would couple unrelated gameplay systems and make installation and maintenance less flexible.

Required dependency: KineticCore.

Overview

KineticArmory is the Kinetic armor-set and dynamic-condition mod for modpack authors and server administrators. It provides a complete workflow for armor-set definitions, conditional evaluation, effect execution, visual editing, and player-facing tooltips while using KineticCore's configuration, networking, and GUI APIs.

Key Features

Visual armor-set editor.
Multiple equipment variants per slot with NBT-aware matching.
Piece-count bonus tiers.
Dynamic predicates with ANY / ALL / MIN / NOT logic.
Attributes, potion effects, attack modifiers, immunities and damage conversion.
Commands triggered by armor-set activation/deactivation.
Global and per-set entity filtering.
Armor-set support for non-player living entities.
Auto-generated tooltips based on the real server configuration.
Server-authoritative armor evaluation and configuration persistence.
Optional KubeJS armor-set change events.

Configuration

config/kineticcore/armorsets.toml
config/kineticcore/armorsets_client.toml
config/kineticcore/armorsets/

Requirements

Java 17
KineticCore: required
Curios: required
KubeJS: optional

Feature Reference

Config Details

Item	Description
Armor Set Settings	Server-owned global armor set behavior. This page is available only for the local installation or an integrated server.
general	Controls armor-set detection, potion refresh frequency, and reload synchronization.
Armor Set Client Preferences	Local tooltip preferences for this client. These settings do not modify the connected server.
Armor Set Visual Editor	Manage armor-set JSON files and entity rules through the authenticated server editor.
Open Armor Set Editor	Requests the current server snapshot and opens the visual editor. Operator permission level 2 is required.
Enable Armor Sets	Enable or disable custom armor set detection and bonus logic.
Check Interval (Seconds)	Time between equipment-state checks, with a minimum of 0.05 seconds.
Force Sync	Whether to sync data to all online players when admin reloads.
Tip Shortcut Key	Default key held to show armor-set details: shift, ctrl, alt, or none.

GUI and Editors

Item	Description
Edit Set Commands	Tip: Start with / to execute command silently, without / to send as player chat
mode	Whitelist: only entities added on the left proceed to armor set checks. Blacklist: entities added on the left skip armor set checks.
set toggle	When enabled, this armor set only works for mobs added on the left. When disabled, entity type is unrestricted.
Entity Rules	Global Armor Set Entity Rules Current mode: %s Clicking first reads the current server config, then opens the entity menu. Players are always allowed and bypass the global entity filter.
Blacklist Mode	Filter Mode Blacklist: entities on the left cannot activate armor set effects; all other entities are allowed. Players are always allowed and ignore this list. Left Click: switch to Whitelist mode. Empty blacklist: no non-player entities are restricted.
Whitelist Mode	Filter Mode Whitelist: only entities on the left can activate armor set effects. Players are always allowed and do not need to be listed. Left Click: switch to Blacklist mode. Empty whitelist: blocks all non-player entities from activating armor sets.
enabled	Per-Set Entity Limit Enabled: this armor set only works for entities listed on the left. Players must still satisfy this set's player restriction and equipment requirements. Left Click: disable this set's entity limit. Empty list: this set will not work for any non-player entity.
disabled	Per-Set Entity Limit Disabled: this set does not perform an extra per-set entity-list check. It is still restricted by the master switch and global entity rules. Left Click: enable the limit and allow only entities listed on the left.
save global	Save Global Entity Rules Saves the current filter mode and entity list to the server config. The filter cache is rebuilt and synchronized immediately.
save set	Save Set Entity Rules Saves this set's entity-limit switch and allowed entity list. Per-set entity lists always use whitelist semantics.
back	Back Does not save unsaved changes made on this screen.
Remove All	Remove Current Results Removes only entities in the left panel's current search results. Entities not matched by the current search are unaffected.
Add All	Add Current Results Adds every entity in the right panel's current search results to the rule list. Useful with name, ID, @mod, or #tag searches for bulk selection.
Active Entities	Armor Set Active Entities Choose which entities this armor set can affect. When entity limiting is enabled, only entities on the left can use this set's effects. When disabled, no extra entity-type restriction is applied, but the master switch and global rules still apply.
Rotation Speed	Enter the model hover rotation speed percentage, from 0%-500%. 0% disables rotation.
direction	Click to switch the entity model rotation direction. The numeric field still controls rotation speed from 0%-500%.
mode	Click to toggle logical combinations: [Match ANY] Activates if at least 1 condition is met. [Match ALL] Activates only when ALL conditions are met. [Match MIN X] Activates when met conditions reach X. 💡 Advanced: Creating 'Disable Rules' with Inversions Combine with the [NOT] button for logical inversion! E.g. If you want: "Disable flight when Raining AND in Water" 1. Set Mode to: [Match ANY] 2. Add Condition: [NOT] Raining 3. Add Condition: [NOT] In Water (De Morgan's Laws: Flight stays active as long as it's NOT raining OR you are NOT in water)

Editable Options

Curio
Curio Slots (Extended)
Rejected Curios (Blocks set if worn)
Rejected Curio Slot
Helmet Slot
Chestplate Slot
Leggings Slot
Boots Slot
Main Hand
Off Hand
Match MIN %s
Match MIN
Whitelist Mode
Blacklist Mode
Blacklist
Whitelist
Filter Mode: Blacklist
Filter Mode: Whitelist
Match ALL
Match ANY
Attribute Range
Clear Weather
Climbing
Daytime
In Dimension
Exp Level Range
Falling
Food Range
Health Range
In Air
In Water
Moon Phase
Left Mouse Click
Left Mouse Hold
Right Mouse Click
Right Mouse Hold
Nighttime
On Block
On Fire
Potion Level Range
Raining
Rising
Sneaking
Speed Range
Game Stage
Thundering
Time Range
%s %s
Not selected

Config Defaults

Key	Default
`armorsets.defaultTipKey`	`"shift"`
`armorsets.enableSets`	`true`
`armorsets.entityFilterMode`	`"BLACKLIST"`
`armorsets.potionRefreshInterval`	`20`
`armorsets.syncOnReload`	`true`

Data Paths

Primary configuration/data paths:

config/kineticcore/armorsets.toml
config/kineticcore/armorsets/
config/kineticcore/armorsets_client.toml

Dependencies

Mod ID	Relationship
`kineticcore`	Required
`curios`	Required
`kubejs`	Optional

The KineticArmory Team

2
Projects
22
Downloads