Приветствие региона

Распространённый паттерн серверов: игрок заходит на спавн - и ему показывают приветственный экран с быстрыми кнопками (правила, хаб, кит). Активатор тут - regionJoin от WorldGuard, а не команда. Меню открывается само, когда игрок пересекает границу региона.

Что показывает пример

• Активатор regionJoin (и его собрат regionLeave)
• Интеграцию с WorldGuard через имена регионов
• Сочетание пассивного приветствия и кнопок быстрого перехода в другие меню

средний

Фичи: regionJoinopenMenuWorldGuard-integration

Требует: WorldGuard

Открыть: (вход в регион)

menu.conf

# Приветствие региона - встречаем игроков, входящих в регион WorldGuard
# Документация: https://abstractmenus.github.io/docs/ru/examples/world-integrations/region-welcome
# Открыть: автоматически при входе в регион "spawn"
# Требует: WorldGuard

include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))

title: "&6Добро пожаловать на спавн"
size: 3

activators {
  regionJoin: ["spawn"]
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "18-26" }

  # Приветственный баннер
  {
    slot: 4
    material: NETHER_STAR
    name: "&6&lДобро пожаловать на MyTestServer"
    lore: [
      "&7Вы вошли в регион &fSpawn&7."
      ""
      "&7Продолжайте с того места, где остановились."
    ]
  }

  # Быстрые ссылки
  {
    slot: 11
    material: COMPASS
    name: "&aОткрыть главный хаб"
    lore: ["&7Просмотреть все доступные меню."]
    click {
      openMenu: "ame_hub"
    }
  }
  {
    slot: 13
    material: WRITTEN_BOOK
    name: "&aПравила сервера"
    lore: ["&7Прочитайте правила перед игрой."]
    click {
      openMenu: "ame_rules"
    }
  }
  {
    slot: 15
    material: CHEST
    name: "&aПолучить стартовый кит"
    lore: ["&7Бесплатные предметы для новых игроков."]
    click {
      openMenu: "ame_kit"
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates (RU)
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/ru/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cУ вас недостаточно денег."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cНет прав."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cВы на кулдауне. Попробуйте позже."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cЗакрыть"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eНазад"
  lore: ["&7Вернуться в предыдущее меню"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eСледующая страница"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&eПредыдущая страница"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lМеню примера"
  lore: ["&7Добро пожаловать в пак примеров AbstractMenus"]
}

↓ menu.conf ↓ Бандл (.zip)

Бандл включает _shared/templates.conf и INSTALL.txt.

Как это работает

Блок активатора перечисляет один или несколько ID регионов:

activators {
  regionJoin: ["spawn"]
}

Когда игрок входит в регион spawn (определённый в WorldGuard), меню открывается у него. Можно перечислить несколько ID регионов; меню откроется при входе в любой из них.

В этом меню нет правил денег и действий покупки - это в чистом виде доска объявлений. Три плитки быстрых ссылок в среднем ряду через openMenu направляют игрока в другие примеры.

Настройка региона на сервере

Этот пример предполагает, что в WorldGuard существует регион с именем spawn. Создайте его командой:

/rg define spawn

Затем положите это меню в plugins/AbstractMenus/menus/example/world-integrations/01-region-welcome/menu.conf и выполните /am reload. Вход в регион запустит меню.

Похожие активаторы

• regionLeave - такой же по форме, срабатывает, когда игрок выходит из региона. Удобно для сценариев “попрощаться” или “предупредить перед PvP”.
• clickEntity / clickNPC / clickBlock - другие активаторы вида “мир триггерит меню”. Полный список см. в разделе Активаторы.

Попробовать

После установки пакета примеров:

1. Установите WorldGuard.
2. Создайте регион с именем spawn командой /rg define spawn.
3. Положите бандл в plugins/AbstractMenus/menus/example/.
4. /am reload.
5. Зайдите в регион.