Secure Plots

🛡 Secure Plots

Minecraft 1.21.1 — Fabric
Мод для защиты территории с меню, ролями, улучшениями, правами по рангам, атмосферными эффектами и полностью настраиваемой системой визуальных границ.

Требования

• Minecraft 1.21.1
• Fabric Loader ≥ 0.15.0
• Fabric API
• Java 21+

Установка

1. Закинь .jar в папку mods/ и на сервере, и на клиенте.
2. Запусти сервер один раз, чтобы сгенерировались конфиги в config/.
3. Отредактируй secure_plots.json (поведение сервера) и secure_plots_client.json (визуальные настройки).

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

Поставь Plot Block, чтобы занять эту область. Уровень блока определяет размер защищённой зоны. ПКМ по блоку или используй предмет Plot Blueprint, чтобы открыть меню управления.

Уровни участков (всё настраивается)

Команды

Все команды доступны как /sp или /secureplots.

Команды игрока

Аргумент plot: большинство команд с [plot] принимают имя участка, его номер из /sp list или all.

Команды администратора

Все команды /sp admin требуют OP-уровень ≥ adminOpLevel (по умолчанию: 2).

Роли и права

Роли

Глобальные флаги (/sp flag)

Глобальные флаги действуют на всех внутри участка, включая посетителей.

Индивидуальные права (/sp perm)

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

Строительство: BUILD BREAK PLACE

Взаимодействие: INTERACT CONTAINERS USE_BEDS USE_CRAFTING USE_ENCHANTING USE_ANVIL USE_FURNACE USE_BREWING

Сущности: ATTACK_MOBS ATTACK_ANIMALS PVP RIDE_ENTITIES INTERACT_MOBS LEASH_MOBS SHEAR_MOBS MILK_MOBS

Природа: CROP_TRAMPLING PICKUP_ITEMS DROP_ITEMS BREAK_CROPS PLANT_SEEDS USE_BONEMEAL BREAK_DECOR

Взрывчатка: DETONATE_TNT GRIEFING

Разное: TP FLY ENTER CHAT COMMAND_USE

Управление: MANAGE_MEMBERS MANAGE_PERMS MANAGE_FLAGS MANAGE_GROUPS

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

Ранги позволяют давать разным игрокам разные лимиты возможностей участка — не трогая индивидуальные права каждого игрока. Ранги используют ванильные теги команд, назначаемые через `/tag add `.

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

1. Определите ранги в secure_plots.json в разделе rankPerks.
2. Назначьте теги игрокам через `/tag add или сокращением/sp admin setrank `.
3. Игроки без тега ранга используют глобальные значения по умолчанию.
4. Если у игрока несколько тегов рангов, побеждает самое разрешающее значение каждого поля.
5. adminTag всегда обходит все ограничения рангов.

Поля ранга

Пример конфига рангов

"rankPerks": [
  {
    "tag": "basic",
    "maxPlots": 1,
    "maxTier": 0,
    "canSetMusic": false,
    "canSetParticles": false,
    "canSetWeather": false,
    "canSetTime": false,
    "canFly": false,
    "canUpgrade": false,
    "canGroups": false
  },
  {
    "tag": "vip",
    "maxPlots": 5,
    "maxTier": 3,
    "canSetMusic": true,
    "canSetParticles": true,
    "canFly": true,
    "canUpgrade": true
  },
  {
    "tag": "mvp",
    "maxPlots": 10,
    "maxTier": 4,
    "hasRankProtection": true
  }
]

Конфиг сервера — secure_plots.json

Переключатели функций

Общие

Настройки окружения

Истечение срока при неактивности

"inactivityExpiry": {
  "enabled": false,
  "baseDays": 45,
  "daysPerTier": 5
}

Когда включено, участок истекает, если владелец не заходил baseDays + (tier × daysPerTier) дней. Участки с hasRankProtection защищены от этого.

Конфигурация уровней

"tiers": [
  { "tier": 0, "displayName": "Bronze",    "radius": 15,  "luminance": 4, "hardness": 50, "blastResistance": 1200 },
  { "tier": 1, "displayName": "Gold",      "radius": 30,  "luminance": 5, "hardness": 50, "blastResistance": 1200 },
  { "tier": 2, "displayName": "Emerald",   "radius": 50,  "luminance": 6, "hardness": 50, "blastResistance": 1200 },
  { "tier": 3, "displayName": "Diamond",   "radius": 75,  "luminance": 7, "hardness": 50, "blastResistance": 1200 },
  { "tier": 4, "displayName": "Netherite", "radius": 100, "luminance": 8, "hardness": 50, "blastResistance": 1200 }
]

Стоимость улучшений

Каждое улучшение может требовать любое количество предметов из любого мода.

"upgradeCosts": [
  { "fromTier": 0, "toTier": 1, "items": [{ "itemId": "minecraft:gold_block", "amount": 15 }] },
  { "fromTier": 1, "toTier": 2, "items": [{ "itemId": "minecraft:emerald_block", "amount": 10 }] },
  { "fromTier": 2, "toTier": 3, "items": [{ "itemId": "minecraft:diamond", "amount": 64 }] },
  { "fromTier": 3, "toTier": 4, "items": [{ "itemId": "minecraft:netherite_block", "amount": 1 }] }
]

Разрешения ролей по умолчанию

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

"roleDefaults": {
  "admin":   ["BUILD", "INTERACT", "CONTAINERS", "PVP", "MANAGE_MEMBERS", "MANAGE_PERMS", "TP", "ENTER"],
  "member":  ["BUILD", "INTERACT", "CONTAINERS", "TP", "ENTER"],
  "visitor": ["INTERACT", "ENTER"]
}

### Флаги по умолчанию для новых участков

```json
"defaultFlags": ["ALLOW_TP", "GREETINGS"]

Рецепты крафта

Рецепты для блоков участков и предмета-чертежа. Каждый можно отключить отдельно ("disabled": true), тогда предмет можно получить только в креативе или через /sp admin.

"craftingRecipes": [
  {
    "result": "secure-plots:bronze_plot_block",
    "pattern": ["CBC", "BHB", "CBC"],
    "key": {
      "C": "minecraft:copper_block",
      "B": "minecraft:redstone_block",
      "H": "minecraft:heart_of_the_sea"
    }
  },
  {
    "result": "secure-plots:plot_blueprint",
    "pattern": ["SPS", "PCP", "SPS"],
    "key": {
      "S": "minecraft:amethyst_shard",
      "P": "minecraft:paper",
      "C": "minecraft:compass"
    }
  }
]

Клиентский визуальный конфиг — secure_plots_client.json

Этот файл лежит на сервере и автоматически синхронизируется с каждым клиентом при входе. Редактируй его на стороне сервера — изменения применяются мгновенно при следующем /sp admin reload.

Граница участка — толщина

Граница участка — анимация

Граница участка — цвета уровней

У каждого уровня 9 цветовых каналов (значения 0.0–1.0):

"tierColors": [
  {
    "tier": 0,
    "coreR": 1.0, "coreG": 0.55, "coreB": 0.05,
    "glowR": 0.7, "glowG": 0.28, "glowB": 0.0,
    "whiteR": 1.0, "whiteG": 0.88, "whiteB": 0.55
  }
]

Голограмма

Плавающая информационная панель, отображаемая над блоками участков.

Текстовые метки голограммы (все настраиваются)

Экран управления участком

Цвета панелей экрана (ARGB hex)

Локализация

В комплекте два языка: en_us (английский) и es_es (риоплатский испанский). Все 260+ ключей перевода охватывают команды, интерфейс, подсказки, сообщения HUD, названия прав и все строки, видимые игроку.

Чтобы добавить другой язык, создайте `assets/secure-plots/lang/.json` в ресурспаке, взяв за шаблон существующие файлы.

Краткая справка для админов сервера

Поддержка

Если Secure Plots пригодился вашему серверу, можете поддержать разработку:

Лицензия

GPL-3.0 — Copyright (C) 2025 TupacGodoy