2 Game Engine

2 - Game Engine

Main file: plugins/Divinity/engine.yml

The engine applies globally. Change it before balancing individual items.

Configuration map

Section	Important keys
packets	enabled, glow-color, reduce-damage-particles
compatibility	player-level, player-class, and mob-level integrations
performance	evaluator mode and entity stat update interval
attributes	durability, mobs, off-hand, unmet requirements, hidden flags
combat	legacy formula, shields, sweep attack, ranged/melee behavior, target distance
lore	colors, separators, durability, charges, requirements, enchantments

Practical tuning

• Set compatibility plugin names to software that is actually installed.
• Keep bonus-update-interval at 20 ticks or higher unless testing shows a need for faster updates.
• effective-in-offhand: false prevents off-hand bonuses from applying.
• allow-hold-items-you-cant-use only changes whether a player can hold the item; requirements still block its attributes.
• disable-vanilla-sweep-attack: true is useful when AOE_DAMAGE already supplies area damage.

Administrator notes

• Back up engine.yml before changing combat formulas or vanilla-only behavior; these options affect every item and entity.
• Compatibility provider names must match installed plugins. Remove stale provider selections before removing an integration plugin.
• Change performance intervals in small steps and measure timings under realistic combat load.
• Treat packet features as compatibility-sensitive. If glow, health display, or particles behave incorrectly, test with packet-related plugins disabled on staging.
• Restart after engine changes. Then test PvE, PvP, projectiles, shields, off-hand items, durability, death, and reconnect persistence.

engine.yml — packet, compatibility, performance, and combat example

packets:
  enabled: true
  modules:
    glow-color: true
    reduce-damage-particles: true

compatibility:
  player-level-plugin: 'Fabled'
  player-class-plugin: 'Fabled'
  mob-level-plugin: 'MythicMobs'

performance:
  evaluator-engine: 1
  entity-stats:
    bonus-update-interval: 50

attributes:
  effective-for-mobs: true
  effective-in-offhand: false
  allow-hold-items-you-cant-use: false
  hide-flags: true

combat:
  legacy-combat: false
  disable-vanilla-sweep-attack: true
  fishing-hook-do-damage: true
  bows-do-full-melee-damage: false
  damage-modifier-for-cooldown: 1.0
  max-get-target-distance: 30.0

vanilla-only:
  # When enabled, Divinity will not replace vanilla entity-stat handling.
  entity-stats: false
  # When enabled, Divinity will not add generated vanilla item attributes.
  item-stats: false
  # When enabled, Divinity leaves damage events to Minecraft's vanilla handling.
  damage-handling: false

The full lore formatter, including durability bars and requirement placeholders, remains in the generated engine.yml and is intentionally kept expandable in the source resource.