SMP Utilities

SMP Utilities – Вики команд

Обзор

SMP Utilities — это мод, созданный для улучшения опыта создания и управления SMP (Survival Multiplayer) серверами в Minecraft.

Основная цель мода — ограничивать и контролировать предметы, блоки и даже целые моды, при этом позволяя администраторам создавать вайтлисты для конкретных игроков, чтобы они могли обходить эти ограничения.

Админские предметы

Absurd Damage Sword

Меч с чрезвычайно высоким уроном. По сути выполняет /kill на любом мобе, по которому попадает.

Ban Sword

Меч, который кикает или банит игроков при использовании против них.

• Атака без Mending → кикает игрока
• Атака с зачарованием Mending → навсегда банит игрока

Chapolin Colorado's Sledgehammer

Особое оружие с нулевым уроном, но экстремальным отбрасыванием. Удар по любой сущности отбрасывает её далеко без убийства. Имеет бесконечную прочность и устойчив к огню.

Little Poop

Метательный предмет. Никакого механического эффекта, кроме самого броска.

Realm Coin

Коллекционный/валютный предмет для серверной экономики или ивентов.

Mind Wrench

Особое оружие с нулевым уроном и бесконечной прочностью.

• ЛКМ (атака) по мобу → накладывает永久 Slowness 255 (невидимо, без частиц/иконки), фактически замораживая моба на месте.

• ПКМ (взаимодействие) по мобу → переключает ИИ моба:

  • Если ИИ сейчас включён → отключает его и помечает моба тегом MindWrenched.
  • Если ИИ сейчас отключён (ранее был отключён) → снова включает его и снимает тег.

Полезно для позирования или заморозки мобов для декора, ивентов или скриншотов.

Security Block

Неразрушимый блок, предназначенный для использования администраторами.

Содержание

1. Введение
2. Основные команды
3. Система разрешений
4. Типы ограничений
5. Подробные команды (idrestrict, idcontrol, idlock)
6. Управление вайтлистом
7. Практические примеры
8. Файлы конфигурации
9. Часто задаваемые вопросы
10. Кастомизация предметов (/lore и /rename)
11. /objective
12. Зелья и эффекты
13. Подавление Waystone

Введение

SMP Utilities предоставляет администраторам три основные системы контроля:

/idrestrict

Блокирует использование предметов, блоков или модов.

Игроки всё ещё могут держать предмет в инвентаре, но не могут его использовать.

/idcontrol

Блокирует владение предметами или модами.

Если у игрока есть предмет в инвентаре, он будет автоматически удалён.

/idlock

Объединяет обе системы.

Игроки не могут владеть предметом или использовать его.

Все команды требуют прав оператора (OP) или уровня разрешений 2.

Основные команды

Базовая структура

/command <action> <type> <id>

Доступные действия

• disable Банит предмет, блок или мод для всех игроков, кроме тех, у кого есть разрешение вайтлиста на этот предмет или его мод.

• enable Убирает предмет, блок или мод из бан-листа. Если мод-источник всё ещё забанен, игроки без индивидуального разрешения остаются ограничены.

• global disable / global enable global disable явно помечает предмет как индивидуально забаненный, переопределяя разрешения уровня мода из белого списка. global enable добавляет предмет как глобальное исключение — доступен всем игрокам, даже если его мод забанен.

• status Проверяет статус предмета, блока, мода или игрока.

• list Показывает все ограниченные предметы, блоки или моды.

• allow Добавляет игрока в белый список для предмета или мода. Игроки из белого списка могут использовать, держать, надевать и ставить предмет, даже если он глобально забанен или забанен его мод.

• deny Убирает игрока из белого списка.

• allowlist check Проверяет разрешения игрока.

• allowlist clear Убирает все разрешения у игрока.

Типы целей

Команды могут нацеливаться на четыре разных типа:

• item — Любой предмет в игре. Пример: minecraft:diamond
• block — Блоки в игре. Пример: minecraft:stone
• mod — Целый мод. Пример: thermal
• item-block — Что-то, что является и предметом, и блоком. Пример: minecraft:dirt

Система разрешений

Уровни ограничений

idrestrict

Игрок может иметь предмет, но не может его использовать.

idcontrol

Игрок не может иметь предмет. Он будет автоматически удалён из инвентаря.

idlock

Игрок не может ни иметь, ни использовать предмет.

Белый список игроков

Вы можете разрешить конкретным игрокам обходить ограничения.

Примеры:

/idrestrict allow player item minecraft:diamond
/idcontrol allow player mod thermal
/idlock allow player all

Типы белого списка

Есть четыре типа разрешений:

• item — Разрешает конкретный предмет.
• block — Разрешает конкретный блок.
• mod — Разрешает все предметы из мода.
• all — Разрешает все моды (доступно во всех трёх системах).

Правило приоритета

Индивидуальные баны всегда переопределяют разрешения белого списка игрока.

Если конкретный предмет забанен через disable item или global disable item, ни один игрок не может его использовать или иметь, даже если у него есть разрешение белого списка на весь мод.

Пример:

• Мод aether забанен
• Игрок ddogo в белом списке для мода aether
• Админ банит aether:some_item индивидуально
• Результат: ddogo не может использовать aether:some_item, несмотря на белый список мода

Типы ограничений

Ограничение предмета

/idrestrict disable item minecraft:diamond_sword

Игроки всё ещё могут иметь меч, но не могут его использовать.

Ограничение блока

/idcontrol disable block minecraft:tnt

Игроки не могут держать TNT в своём инвентаре.

Ограничение мода

/idlock disable mod thermal

Никто не может использовать или иметь предметы из этого мода.

Ограничение item-block

Используется для вещей, которые являются и предметами, и блоками.

/idlock disable item-block minecraft:dirt

Земля будет ограничена и как предмет, и как блок в мире.

Разрешение ВСЕХ модов

Позволяет игроку игнорировать все ограничения модов.

/idcontrol allow player all
/idlock allow player all

Глобальные исключения

Когда мод забанен глобально, вы можете разрешить конкретные предметы/блоки, оставив мод забаненным:

/idlock global enable item aether:golden_amber

Это добавляет aether:golden_amber как глобальное исключение — все могут его использовать, несмотря на бан мода.

Чтобы убрать исключение, забаньте предмет напрямую:

/idlock global disable item aether:golden_amber

---

# /idrestrict

Блокирует **использование** предметов, блоков и модов. Игроки **могут хранить предмет**, но **не могут взаимодействовать с ним**.

## Поведение disable / global disable / enable / global enable

| Команда | Эффект |
|---|---|
| `/idrestrict disable item <id>` | Запрещает предмет для всех игроков, кроме тех, кто в белом списке для этого предмета или его мода |
| `/idrestrict global disable item <id>` | То же самое — явно помечает предмет как индивидуально запрещённый, переопределяя белый список мода |
| `/idrestrict enable item <id>` | Убирает предмет из списка запрещённых. Если мод всё ещё запрещён, игроки без индивидуального разрешения остаются ограничены |
| `/idrestrict global enable item <id>` | Добавляет предмет как глобальное исключение — доступен всем игрокам, даже если его мод запрещён |

## Примеры использования

/idrestrict disable item minecraft:elytra /idrestrict disable block minecraft:enchanting_table /idrestrict disable mod twilightforest /idrestrict disable item-block minecraft:dirt /idrestrict global enable item twilightforest:some_item /idrestrict status item minecraft:diamond /idrestrict status player PlayerName /idrestrict list

---

## Что блокирует idrestrict

* Использование предметов
* Еду и питьё
* Установку блоков
* Ломание блоков
* Взаимодействие с блоками
* Атаку сущностей предметом
* Надевание брони
* Надевание аксессуаров Curios

---

## Что idrestrict НЕ блокирует

* Хранение предмета в инвентаре
* Подбор предмета с земли
* Крафт с предметом
* Обмен предметом в интерфейсах

---

# /idcontrol

Блокирует **владение предметами или модами**. Ограниченные предметы **автоматически удаляются из инвентаря**.

## Примеры

/idcontrol disable item minecraft:diamond /idcontrol disable mod create /idcontrol allow player all /idcontrol deny player all

---

## Что блокирует idcontrol

* Хранение предмета в инвентаре
* Подбор предмета с земли
* Надевание предмета
* Удержание предмета в любом слоте

---

## Особое поведение

Когда предмет ограничен через idcontrol:

1. Предмет удаляется из инвентаря игрока
2. Он выбрасывается на землю с тегом `smp_controlled_item`
3. Предметы с этим тегом нельзя подобрать снова
4. Проверка выполняется **каждый игровой тик**

---

# /idlock

Объединяет **idrestrict + idcontrol**. Это **самая строгая система**. Игроки **не могут использовать или иметь предмет**.

## Примеры

/idlock disable item minecraft:diamond_sword /idlock disable block minecraft:crafting_table /idlock disable mod mekanism /idlock allow player all /idlock global enable item mekanism:some_item /idlock status item minecraft:diamond /idlock list

---

## Что ограничивается

* Использование предметов
* Владение предметами
* Подбор предметов с земли
* Надевание предметов
* Установка блоков
* Ломание блоков
* Взаимодействие со связанными объектами

---

# Управление белым списком

Проверить разрешения игрока:

/idrestrict allowlist check PlayerName /idcontrol allowlist check PlayerName /idlock allowlist check PlayerName

Проверить разрешения всех игроков онлайн:

/idrestrict allowlist check /idcontrol allowlist check /idlock allowlist check

Убрать все разрешения:

/idrestrict allowlist clear PlayerName /idcontrol allowlist clear PlayerName /idlock allowlist clear PlayerName

---

# Практические примеры

## Сервер выживания с ограничениями

/idrestrict disable item minecraft:elytra /idrestrict disable item minecraft:totem_of_undying

/idcontrol disable block minecraft:tnt /idcontrol disable block minecraft:bedrock

Белый список для VIP:

/idrestrict allow VIP_Player item minecraft:elytra

---

## Тематический сервер (без магии)

/idlock disable mod ars_nouveau /idlock disable mod mana-and-artifice

---

## Обслуживание модов

Временно отключить мод:

/idcontrol disable mod problem_mod

Включить обратно позже:

/idcontrol enable mod problem_mod

---

## Ограничить мод, но разрешить конкретные предметы

/idlock global disable mod aether /idlock global enable item aether:golden_amber /idlock global enable item aether:zanite_gemstone

Оба предмета будут доступны всем, даже если остальная часть мода запрещена.

---

# Файлы конфигурации

Данные сохраняются в папке мира по пути `serverconfig/smp_utilities/`:

**idrestrict**

* `id_restrict_config.dat` — запрещённые предметы, блоки, моды
* `id_restrict_whitelist.dat` — вайтлисты для отдельных игроков
* `id_restrict_exceptions.dat` — глобальные исключения

**idcontrol**

* `id_control_config.dat` — отключённые предметы и моды
* `id_control_whitelist.dat` — вайтлисты для отдельных игроков
* `id_control_exceptions.dat` — глобальные исключения

**idlock**

* `id_lock_config.dat` — заблокированные предметы, блоки, моды
* `id_lock_whitelist.dat` — вайтлисты для отдельных игроков
* `id_lock_exceptions.dat` — глобальные исключения

**Подавление Waystone**

* `waystone_suppression_config.toml` — шаблоны подавляемых модов, запрещённые предметы и блоки

---

# Часто задаваемые вопросы

## В чём разница между командами?

**idrestrict** — игрок может иметь предмет, но не может его использовать.

**idcontrol** — игрок не может иметь предмет.

**idlock** — игрок не может ни иметь, ни использовать предмет.

---

## В чём разница между `disable` и `global disable`?

Обе команды запрещают предмет для всех игроков, у которых нет разрешения через вайтлист. Разница в приоритете: `global disable` явно помечает предмет как индивидуально запрещённый, гарантируя, что он перекрывает разрешения вайтлиста на уровне мода. Используй `global disable`, когда запрещаешь конкретный предмет из мода, который в остальном разрешён.

---

## В чём разница между `enable` и `global enable`?

`enable` убирает предмет из списка запрещённых. Если его мод всё ещё запрещён, игроки без индивидуального разрешения остаются ограничены.

`global enable` добавляет предмет как **глобальное исключение** — он становится доступен *всем*, независимо от того, запрещён ли мод.

---

## Можно ли комбинировать команды?

Да. Все системы независимы. Можно использовать idrestrict для лёгких ограничений, idcontrol для средних и idlock для строгих.

---

## Может ли вайтлист игрока обойти индивидуальный запрет предмета?

Нет. **Индивидуальные запреты предметов и блоков всегда имеют приоритет** над разрешениями вайтлиста на уровне мода. Даже если у игрока есть разрешение на мод, конкретный предмет, запрещённый через `disable item`, нельзя использовать или держать.

---

## Работает ли это с Curios?

Да. Мод интегрируется с **Curios API**. Запрещённые предметы обнаруживаются в слотах Curios, автоматически удаляются и не могут быть экипированы.

---

# /rename и /lore

Мод включает команды для **кастомизации предметов** с помощью расходуемых тикетов.

---

# /rename

Переименовывает предмет, который держит игрок. Требуется **Rename Ticket**.

/rename normal /rename /rename /rename

Примеры:

/rename red normal Fire Sword /rename gold bold Royal Shield /rename blue italic Magic Potion /rename dark_red strikethrough Cursed Item /rename green bold italic Lucky Amulet

Использование этой команды расходует **Rename Ticket**:

![Rename Ticket](https://cdn.modrinth.com/data/cached_images/037f02fafb857afdee0b38dea0235aafed0cde60.png)

---

# /lore

Добавляет описание (lore) предмету, который держит игрок. Требуется **Lore Ticket**.

/lore <color> normal <text>
/lore <color> <format> <text>
/lore <color> <format1> <format2> <text>

Примеры:

/lore dark_gray normal Очень редкий предмет.
/lore gold bold Выкован древними королями.
/lore blue italic Говорят, приносит удачу.
/lore dark_red strikethrough Запретный предмет.

Использование этой команды расходует Lore Ticket:

/objective

Показывает постоянное сообщение на панели действий игроков. Полезно для отображения целей, правил или событий во время игры.

Требует уровень разрешений 4 (оператор сервера).

Синтаксис

/objective global <color> <format> <text>
/objective player <player> <color> <format> <text>
/objective clear
/objective clear <player>

Примеры

/objective global gold bold Победите Ender Dragon!
/objective global red normal Не используйте Waystones сегодня.

/objective player Steve blue italic Найдите 5 алмазов.
/objective player Alex green bold italic Завершите своё задание!

/objective clear
/objective clear Steve

Поведение

• Цель отображается на панели действий (над хотбаром).
• Она отправляется каждый тик, чтобы оставаться видимой и не исчезать.
• Когда игрок заходит на сервер, его сохранённая цель автоматически показывается.
• Цели для конкретного игрока имеют приоритет над глобальной целью.
• Очистка глобальной цели не удаляет цели конкретных игроков.

Доступные цвета и форматы

Для /rename, /lore и /objective доступны следующие цвета и форматы:

Цвета:

black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white

Форматы:

normal, bold, italic, underlined, strikethrough

Комбинации:

bold italic, bold underlined, bold strikethrough, italic underlined, italic strikethrough, bold italic underlined, bold italic strikethrough

Зелья и эффекты

SMP Utilities добавляет два собственных эффекта зелий.

Подавление Waystone

Цвет эффекта: фиолетовый (#ae37d5)
Категория: полезный

Пока эффект активен, игрок не может использовать или взаимодействовать с предметами, блоками или модами, перечисленными в waystone_suppression_config.toml.

Создан для блокировки модов телепортации (таких как Waystones) в определённые игровые моменты или события.

Доступные зелья:

• Зелье подавления Waystone
• Взрывное зелье подавления Waystone
• Туманное зелье подавления Waystone
• Стрела подавления Waystone

Дисбаланс

Цвет эффекта: тёмно-пурпурный (#3b4c5b инвертированный)
Категория: полезный (но механически негативный)

Уменьшает сопротивление отбрасыванию игрока на -(amplifier + 1) за тик. При amplifier 0 (уровень I) убирает 1 единицу сопротивления отбрасыванию. На более высоких уровнях снижение масштабируется соответственно.

Создан, чтобы сделать игроков гораздо более уязвимыми к отбрасыванию, для использования с такими предметами, как кувалда Чаполина Колорадо.

Доступные зелья:

• Зелье дисбаланса
• Взрывное зелье дисбаланса
• Туманное зелье дисбаланса
• Стрела дисбаланса

Подавление Waystone

Система подавления Waystone ограничивает предметы и блоки телепортации и перемещения для игроков под эффектом подавления Waystone.

Файл конфигурации

Расположен по пути: serverconfig/smp_utilities/waystone_suppression_config.toml

[blacklist]
# disables teleport mods (blocks breaking, use of blocks and items, and/or equipping armor)
WaystoneSuppression = ["waystones:*", "balm:*", "endermanoverhaul:*"]

[banned_items]
# individual item IDs to ban (cannot equip in armor or curios slots; drops if equipped)
BannedItems = ["minecraft:ender_pearl", "minecraft:chorus_fruit", "all_in_one:enchiridion", "relics:chorus_inhibitor", "relics:enders_hand", "relics:spatial_sign"]

[banned_blocks]
# individual block IDs to ban (cannot place, break, or interact with) remove the '#' to enable it; minecraft:tnt is just an example, you can remove it
# BannedBlocks = ["minecraft:tnt"]

---

## Формат шаблонов

* `modid:*` — блокирует **все предметы и блоки** из этого мода
* `modid:item_id` — блокирует **конкретный предмет или блок**

---

## Что блокируется (пока эффект активен)

* Установка или разрушение блоков из запрещённых модов
* Использование запрещённых предметов
* Надевание запрещённых предметов как брони или в слоты Curios (предметы выпадают)
* Взаимодействие с запрещёнными блоками
* Атака запрещёнными предметами

---

## Заблокированный контент по умолчанию

По умолчанию блокируются следующие моды:

* `waystones:*` — весь контент мода Waystones
* `balm:*` — весь контент мода Balm (зависимость Waystones)
* `endermanoverhaul:*` — весь контент мода Enderman Overhaul

А эти отдельные предметы запрещены:

* `minecraft:ender_pearl`
* `minecraft:chorus_fruit`
* `all_in_one:enchiridion`
* `relics:chorus_inhibitor`
* `relics:enders_hand`
* `relics:spatial_sign`

---