Skip to main content

policies.hopl

Defines optimization policies and target selectors. Hot-reloaded via /auroraoptimizer policy reload.

Selectors​

Selectors define logical groups of chunks or players. Multiple policies can reference the same selector. Selectors are evaluated lazily at policy execution time.

selectors:
  - id: hot_chunks
    type: chunk
    criteria:
      loaded: true
      has_players: true
      entity_count_min: 50

  - id: all_chunks
    type: chunk
    criteria:
      loaded: true

  - id: afk_players
    type: player
    criteria:
      ticks_since_last_move_min: 1200   # 60 seconds without moving

  - id: high_ping_players
    type: player
    criteria:
      ping_min: 200

Policies​

A policy binds a capability (action type) to a selector, with optional execution parameters. The orchestrator scores all enabled policies every cycle and selects the top-scoring proposals.

policies:
  - id: entity_cleanup_aggressive
    capability: remove_entities
    selector: hot_chunks
    enabled: true
    max_entities_per_chunk: 150
    entity_types: [DROPPED_ITEM, ARROW, EXPERIENCE_ORB]

  - id: redstone_throttle_heavy
    capability: throttle_redstone
    selector: all_chunks
    enabled: true
    max_updates_per_tick: 500

  - id: mob_ai_pause_hotspots
    capability: pause_mob_ai
    selector: hot_chunks
    enabled: true
    radius: 6
    exclude_pets: true