Skip to content

bng-mc-project/ChibiEssentials

Repository files navigation

ChibiEssentials

Серверный essentials-мод для Minecraft 1.20.1 на Fabric и Forge.
Клиент не требуется — все сообщения и локализация обрабатываются на сервере.

Зависимости

Платформа Зависимость Версия
Общее Architectury API >= 9.2.14
Общее Minecraft 1.20.1
Общее Java 17+
Fabric Fabric Loader >= 0.19.3
Fabric Fabric API 0.92.9+1.20.1
Fabric fabric-permissions-api (LuckPerms и др.) 0.3.3 (встроен в jar)
Forge Forge >= 47.4.10

Сборка через Architectury Loom.

./gradlew build

Готовые jar: fabric/build/libs/ и forge/build/libs/.


Возможности

  • Телепорты — дома, спавн, варпы, /back с историей позиций
  • TPA — запросы на телепорт с кнопками «Принять / Отклонить»
  • Личные сообщения/msg, /m, /reply с настраиваемым форматом
  • Админ-команды — полёт, god, исцеление, vanish, gamemode, invsee, ec, head, whois
  • Warmup и cooldown — задержка перед телепортом и кулдаун после (настраивается в конфиге и через пермишены)
  • Локализация из конфига — тексты хранятся на сервере, клиентские lang-файлы не нужны
  • Пермишены — интеграция с LuckPerms (Fabric) и Forge Permission API

Конфигурация

При первом запуске создаётся папка config/chibiessentials/ с дефолтными файлами.

При загрузке проверяется полная структура config.json. Если не хватает полей, JSON повреждён или файл пустой:

  • текущий конфиг сохраняется как config.1.bkp, config.2.bkp и т.д.;
  • записывается новый config.json из шаблона мода.
config/chibiessentials/
  config.json       — настройки мода
  lang/
    en_us.json      — английские тексты
    ru_ru.json      — русские тексты

config.json

Параметр Описание
language Язык сообщений: en_us, ru_ru и т.д. (файл из lang/)
homes.defaultMax Лимит домов по умолчанию
homes.warmup / homes.cooldown Warmup и cooldown для /home (сек.)
back.maxHistory Глубина истории для /back
back.warmup / back.cooldown Warmup и cooldown для /back
back.onDeathOnly Записывать позицию в историю только при смерти
spawn.warmup / spawn.cooldown Warmup и cooldown для /spawn
warp.warmup / warp.cooldown Warmup и cooldown для /warp
tpa.warmup / tpa.cooldown Warmup и cooldown после принятия TPA
tpa.requestTimeoutSeconds Время жизни TPA-запроса
messages.format Формат текста ЛС ({message}, цвета через &; имя — в lang-ключах msg.to / msg.from)
chat.localRadius Радиус локального чата (блоки)
chat.globalPrefix Префикс для принудительного глобального сообщения (например !)
chat.defaultMode Режим чата по умолчанию: local или global
vanish.hideFromTab Скрывать vanished-игроков из таба
vanish.hideChat Скрывать сообщения vanished-игроков в чате

Перезагрузка: /chibiessentials reload.

Тексты сообщений редактируются в lang/<язык>.json. При обновлении мода добавляйте новые ключи в существующие lang-файлы вручную (или скопируйте из jar).


Команды

Телепорты

Команда Описание Пермишен
/back Вернуться на предыдущую позицию chibiessentials.back
/spawn Телепорт на спавн chibiessentials.spawn
/setspawn Установить точку спавна (также используется при смерти) chibiessentials.setspawn
/tppos <x> <y> <z> [yaw] [pitch] [world] Телепорт на координаты (мгновенно, без warmup) chibiessentials.tppos
/tphere <игрок> Телепортировать игрока к себе (мгновенно) chibiessentials.tphere

Для /tppos мир можно указать как overworld, nether, end или namespace:id (например minecraft:overworld). Без world — текущее измерение.

Дома

Команда Описание Пермишен
/sethome [имя] Сохранить дом chibiessentials.sethome
/home [имя] Телепорт домой chibiessentials.home
/delhome <имя> Удалить дом (при лимите > 1) chibiessentials.sethome
/listhomes Список домов (при лимите > 1) chibiessentials.home

При лимите домов = 1 имя не указывается (используется home).

Варпы

Команда Описание Пермишен
/warp <имя> Телепорт на варп chibiessentials.warp или chibiessentials.warp.<имя>
/warp create <имя> Создать / обновить варп chibiessentials.warp.create
/warp delete <имя> Удалить варп chibiessentials.warp.delete
/warp list Список варпов chibiessentials.warp.list

TPA

Команда Описание Пермишен
/tpa <игрок> Запрос: телепорт к игроку chibiessentials.tpa
/tpahere <игрок> Запрос: телепорт игрока к себе chibiessentials.tpa
/tpaccept [id] Принять запрос chibiessentials.tpaccept
/tpdeny [id] Отклонить запрос chibiessentials.tpdeny
/tpacancel Отменить свои исходящие запросы chibiessentials.tpacancel

Сообщения

Команда Описание Пермишен
/msg <игрок> <текст> Личное сообщение chibiessentials.msg
/m <игрок> <текст> Алиас /msg chibiessentials.msg
/tell <игрок> <текст> Алиас /m (заменяет ванильный /tell) chibiessentials.msg
/reply <текст> Ответ последнему собеседнику chibiessentials.reply
/r <текст> Алиас /reply chibiessentials.reply

Чат

Команда Описание Пермишен
/g [текст] Глобальный режим / отправить в глобальный чат chibiessentials.chat
/l [текст] Локальный режим / отправить в локальный чат chibiessentials.chat
/global [текст] Алиас /g chibiessentials.chat
/local [текст] Алиас /l chibiessentials.chat

Обычное сообщение в чате использует выбранный режим (/g или /l). Префикс из chat.globalPrefix (по умолчанию !) отправляет сообщение в глобальный чат.

Формат чата настраивается в lang/<язык>.json:

  • chibiessentials.chat.format.global / format.local — шаблон ({prefix}, {suffix}, {nick}, {player}, {message}, {world})
  • chibiessentials.chat.prefix.default / suffix.default / nick.default — значения по умолчанию

Персональные префикс, суффикс и ник — через мета-пермишены LuckPerms:

  • chibiessentials.chat.prefix
  • chibiessentials.chat.suffix
  • chibiessentials.chat.nick

Цветные коды & в тексте сообщения — пермишен chibiessentials.chat.color.

Читы и утилиты

Команда Описание Пермишен
/fly [игрок] Переключить полёт в survival (не влияет на creative/spectator) chibiessentials.fly
/god [игрок] Переключить неуязвимость — отмена урона, без изменения gamemode chibiessentials.god
/heal [игрок] Полное исцеление chibiessentials.heal
/feed [игрок] Восстановить голод и насыщение chibiessentials.feed
/invsee <игрок> Просмотр инвентаря игрока (редактирование — отдельное право) chibiessentials.invsee
/vanish [игрок] Режим невидимости (spectator) chibiessentials.vanish
/ec [игрок] Открыть эндер-сундук (чужой — только просмотр, редактирование отдельным правом) chibiessentials.ec / chibiessentials.ec.others
/head <игрок> Выдать голову игрока chibiessentials.head
/hat Надеть предмет из руки на голову chibiessentials.hat
/workbench Открыть верстак chibiessentials.workbench
/sit Сесть / встать chibiessentials.sit

Gamemode

Команда Описание Пермишен
/gm <0-3> [игрок] Сменить режим (0=survival, 1=creative, 2=adventure, 3=spectator) зависит от режима
/gmc [игрок] Creative chibiessentials.gamemode.creative
/gms [игрок] Survival chibiessentials.gamemode.survival
/gmsp [игрок] Spectator chibiessentials.gamemode.spectator

Для /gm 2 (adventure): chibiessentials.gamemode.adventure.

Администрирование

Команда Описание Пермишен
/whois <игрок> Показать IP игрока (кликабельная ссылка на 2ip.ru) chibiessentials.whois
/chibiessentials reload Перезагрузить конфиг и локали chibiessentials.reload

Пермишены

Все ноды имеют префикс chibiessentials..
Если пермишен-плагин не установлен, для всех команд используется fallback OP 2.

Основные

Пермишен Описание OP fallback
chibiessentials.back /back 2
chibiessentials.home /home, /listhomes 2
chibiessentials.sethome /sethome, /delhome 2
chibiessentials.spawn /spawn 2
chibiessentials.setspawn /setspawn 2
chibiessentials.tppos /tppos 2
chibiessentials.tphere /tphere 2
chibiessentials.warp Доступ ко всем варпам 2
chibiessentials.warp.<имя> Доступ к конкретному варпу 2
chibiessentials.warp.create /warp create 2
chibiessentials.warp.delete /warp delete 2
chibiessentials.warp.list /warp list 2
chibiessentials.tpa /tpa, /tpahere 2
chibiessentials.tpaccept /tpaccept 2
chibiessentials.tpdeny /tpdeny 2
chibiessentials.tpacancel /tpacancel 2
chibiessentials.msg /m, /msg, /tell 2
chibiessentials.reply /reply, /r 2
chibiessentials.chat Публичный чат 2
chibiessentials.chat.color Цветные коды & в чате и ЛС 2
chibiessentials.ec /ec (свой сундук) 2
chibiessentials.ec.others /ec <игрок> (только просмотр) 2
chibiessentials.ec.others.edit Редактирование чужого эндер-сундука 2
chibiessentials.head /head 2
chibiessentials.hat /hat 2
chibiessentials.workbench /workbench 2
chibiessentials.sit /sit 2
chibiessentials.fly /fly 2
chibiessentials.god /god 2
chibiessentials.heal /heal 2
chibiessentials.feed /feed 2
chibiessentials.invsee /invsee (только просмотр) 2
chibiessentials.invsee.edit Редактирование слотов в /invsee 2
chibiessentials.vanish /vanish 2
chibiessentials.vanish.see Видеть vanished-игроков 2
chibiessentials.whois /whois 2
chibiessentials.reload Перезагрузка конфига 2
chibiessentials.gamemode.creative Creative 2
chibiessentials.gamemode.survival Survival 2
chibiessentials.gamemode.adventure Adventure 2
chibiessentials.gamemode.spectator Spectator 2

Мета-пермишены (числовые значения)

Переопределяют значения из конфига для конкретного игрока.

Пермишен Описание
chibiessentials.home.max Максимум домов
chibiessentials.back.max Глубина истории /back
chibiessentials.chat.prefix Префикс в чате
chibiessentials.chat.suffix Суффикс в чате
chibiessentials.chat.nick Ник в чате
chibiessentials.back.cooldown Cooldown /back (сек.)
chibiessentials.back.warmup Warmup /back (сек.)
chibiessentials.spawn.cooldown Cooldown /spawn
chibiessentials.spawn.warmup Warmup /spawn
chibiessentials.home.cooldown Cooldown /home
chibiessentials.home.warmup Warmup /home
chibiessentials.warp.cooldown Cooldown /warp
chibiessentials.warp.warmup Warmup /warp
chibiessentials.tpa.cooldown Cooldown TPA
chibiessentials.tpa.warmup Warmup TPA

Пример (LuckPerms)

/lp group default permission set chibiessentials.home true
/lp group default permission set chibiessentials.spawn true
/lp group default permission set chibiessentials.back true
/lp group default permission set chibiessentials.tpa true
/lp group vip permission set chibiessentials.home.max 3
/lp group vip permission set chibiessentials.warp.shop true

Лицензия

MIT

About

Chibi Essentials

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages