# ===============================
# XantamCollision – config.yml
# ===============================
# Purpose: Decide which entities can push / be pushed (collide).
# Works by placing entities into scoreboard "teams" with a collision rule.
#
# What “collision” means here (plain English):
#   - Collision = nudging and being nudged by hitboxes (body blocking).
#   - Rules are per-group (team). Every member of a group follows that rule.
#   - The four rules:
#       ALWAYS           -> Collide with EVERYONE (vanilla behavior).
#       NEVER            -> Collide with NO ONE (no push / no being pushed).
#       PUSH_OWN_TEAM    -> Collide ONLY with your own group.
#       PUSH_OTHER_TEAMS -> Collide with everyone EXCEPT your own group.
#
# Tips:
#   - Each entity type should appear in EXACTLY ONE group.
#   - If a type appears in multiple groups, the last one processed on reload wins.
#   - If a type appears in NONE, XantamCollision leaves it alone (vanilla behavior).
#   - Type names are Bukkit enum names (e.g., PLAYER, VILLAGER, ZOMBIE, IRON_GOLEM).

# Prefix added to all scoreboard team names created by this plugin.
# Change this if another plugin uses the same prefix.
team-prefix: "xc_"

# How often (in seconds) to re-assert team membership and collision rules
# for loaded entities. This repairs changes made by other plugins/commands.
# Set to 0 to disable the repair task entirely.
repair-interval-seconds: 10

# Worlds the plugin should completely ignore. No changes are made in these worlds.
# Example: ["lobby", "minigames"]
ignored-worlds: []

# When should rules be auto-applied?
apply-triggers:
  # When a player joins the server.
  on-player-join: true
  # When a new entity spawns (natural, spawner, breeding, commands, etc).
  on-entity-spawn: true
  # When a chunk becomes loaded (entities inside get processed).
  on-chunk-load: true

# -------------------------------
# Groups (scoreboard "teams")
# -------------------------------
# Define as many groups as you need. Each group has:
#   collision: one of [ALWAYS, NEVER, PUSH_OWN_TEAM, PUSH_OTHER_TEAMS]
#   include:   list of entity types that belong to this group
#
# IMPORTANT:
# - "PLAYER" refers to real players.
# - Keep each entity type in exactly one group for predictable results.

teams:
  # Example: players and villagers never nudge anything and aren’t nudged by anything.
  noclip:
    # NEVER = members DO NOT collide with anyone (no push / no being pushed).
    collision: NEVER
    include:
      - PLAYER
      - VILLAGER

  # Example: hostiles behave like vanilla (full collision with everyone).
  hostiles:
    # ALWAYS = members collide with everyone (vanilla behavior).
    collision: ALWAYS
    include:
      - ZOMBIE
      - SKELETON
      - CREEPER
      - SPIDER
      - ENDERMAN

  # Example (commented): members collide only with their own group.
  # squads:
  #   # PUSH_OWN_TEAM = collide only with same-group members.
  #   collision: PUSH_OWN_TEAM
  #   include:
  #     - IRON_GOLEM
  #     - SNOW_GOLEM

  # Example (commented): members collide with others, but NOT with teammates.
  # no-friend-bump:
  #   # PUSH_OTHER_TEAMS = collide with everyone EXCEPT same-group members.
  #   collision: PUSH_OTHER_TEAMS
  #   include:
  #     - WARDEN
  #     - WITHER
  #     - ENDER_DRAGON

# -------------------------------
# Admin command & permission
# -------------------------------
# Command: /xcr       -> reloads this file and re-applies rules immediately
# Permission: xantamcollision.reload  (default: op)
# -------------------------------

# FYI:
# - Paper has a global switch "enable-player-collisions". If disabled, players won’t
#   collide regardless of groups. XantamCollision will warn you on startup/reload.
# - After /xcr, all loaded players and nearby entities are re-processed immediately.