docs - MyDevelopement

Установка и начало

Требования

Сервер Paper 1.20+ (или производный). Опционально: Vault (экономика), PlaceholderAPI (плейсхолдеры), MyCore.

Установка

Скачайте MyCommands.jar
Поместите файл в plugins/
Перезапустите сервер
Отредактируйте plugins/MyCommands/config.yml (язык, кулдауны, задержки, лимиты, сообщения и т.д.)

Первые шаги

Базовые команды: /spawn, /home, /sethome, /warp, /warps, /tpa, /msg, /help. Админ: /gamemode, /heal, /feed, /setspawn, /setwarp. Перезагрузка конфига: /mycommands reload. Миграция данных (YAML ↔ MySQL): /mycommands migrate.

Команды админа

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

Команда	Использование	Алиас	Разрешение
`/gamemode`	<режим> [игрок]	gm	mycommands.gamemode
`/fly`	[игрок]	—	mycommands.fly
`/heal`	[игрок] или all	—	mycommands.heal
`/feed`	[игрок] или all	—	mycommands.feed
`/god`	[игрок]	—	mycommands.god
`/vanish`	—	v	mycommands.vanish
`/tp`	<игрок> или <x> <y> <z>	teleport	mycommands.tp
`/tphere`	<игрок>	s	mycommands.tphere
`/give`	<игрок> <предмет> [кол-во]	—	mycommands.give
`/clear`	[игрок]	ci	mycommands.clear
`/invsee`	<игрок>	inv	mycommands.invsee
`/enderchest`	[игрок]	ec	mycommands.enderchest
`/weather`	<clear/rain/thunder>	—	mycommands.weather
`/time`	<day/night/ticks>	—	mycommands.time
`/speed`	<1-10> [игрок]	—	mycommands.speed
`/broadcast`	<сообщение>	bc	mycommands.broadcast
`/kick`	<игрок> [причина]	—	mycommands.kick
`/freeze`	<игрок>	—	mycommands.freeze
`/setspawn`, `/setwarp`, `/delwarp`	спавн и варпы	—	mycommands.setspawn, mycommands.setwarp
`/mycommands`	reload, migrate	—	mycommands.reload, mycommands.migrate

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

Команды для игроков (телепортация, информация, помощь).

Команда	Использование	Алиас	Разрешение
`/spawn`	—	—	mycommands.spawn
`/home`	[имя]	—	mycommands.home
`/sethome`	[имя]	—	mycommands.sethome (+ mycommands.sethome.N)
`/delhome`	<имя>	—	mycommands.delhome
`/homes`	—	—	mycommands.homes
`/back`	—	—	mycommands.back
`/tpa`	<игрок>	call	mycommands.tpa
`/tpaccept`	—	tpyes	mycommands.tpaccept
`/tpdeny`	—	tpno	mycommands.tpdeny
`/warp`	<имя>	—	mycommands.warp
`/warps`	—	—	mycommands.warps
`/me`, `/near`, `/realname`, `/seen`, `/list`	инфо игроков	—	mycommands.me и т.д.
`/motd`, `/rules`, `/help`	—	помощь	mycommands.motd, mycommands.help
`/confirm`, `/cancel`	—	yes, no	mycommands.confirm
`/afk`	—	—	mycommands.afk

Сообщения и расширенное

Личные сообщения

Команда	Использование	Алиас	Разрешение
`/msg`	<игрок> <сообщение>	m, tell, whisper, w	mycommands.msg
`/reply`	<сообщение>	r	mycommands.reply
`/ignore`	[игрок]	—	mycommands.ignore
`/socialspy`	—	spy	mycommands.socialspy (админ)

GUI и расширенное

/homegui (homesgui), /warpgui (warpsgui) — Интерфейс домов и варпов. /nick (nickname) — Сменить отображаемое имя. /stats (statistics) — Статистика телепортов (себя или [игрок]). Разрешения: mycommands.gui.homes, mycommands.gui.warps, mycommands.nick, mycommands.stats.

Разрешения

Основные разрешения.

mycommands.admin — Все админ-команды
mycommands.player — Команды игрока (spawn, home, warp, tpa, msg, help и т.д.)
mycommands.extended — GUI, nick, stats
mycommands.sethome.N — Лимит N домов (напр. mycommands.sethome.5)
mycommands.sethome.unlimited — Неограниченные дома
mycommands.cooldown.bypass — Игнор кулдаунов
mycommands.teleportdelay.bypass — Игнор задержки телепорта
mycommands.afk.bypass — Не помечать AFK автоматически

Настройка — Кулдауны и телепорт

Кулдауны

cooldowns.enabled, cooldowns.commands (home, spawn, warp, tpa, back, heal, feed, repair) в секундах. cooldowns.bypass-for-ops.

Задержка телепорта

teleport-delay.enabled, teleport-delay.delay по команде. teleport-delay.cancel-on-move, teleport-delay.bypass-for-ops.

Защита от злоупотреблений

anti-abuse.prevent-dangerous-teleports (check-lava, check-void, check-water).

Предпросмотр телепорта

teleport.preview (enabled, show-particles, show-compass, duration).

Настройка — Лимиты и варпы

Лимиты

limits.max-homes, limits.tp-request-timeout, limits.max-ignored-players, limits.max-warps (-1 = без лимита).

Варпы

warps.enabled, warps.per-warp-permission (mycommands.warp.<имя> на варп).

Разрешения (дома)

permissions.homes.default — Число домов по умолчанию при отсутствии mycommands.sethome.N.

Настройка — Сообщения и вход/выход

Общее

language — fr, en.

Сообщения

messages.me-format ({player}, {action}), messages.motd, messages.rules, messages.format (boxed, action-bar, progress-bars).

Личные сообщения

private-messages.enabled, private-messages.sound, private-messages.socialspy-on-join.

Вход / Выход

join-quit-messages (enabled, join, first-join, quit, welcome-message, join-title, join-action-bar, webhook Discord).

Подтверждения и уведомления

confirmations.enabled, confirmations.require-for. notifications.titles, notifications.toast.

Настройка — Ники, GUI, тюрьма, спавн

Ники

nicknames.enabled, min/max-length, allow-colors, save-nicknames, check-blacklist, check-similarity.

GUI

guis.enabled, modern-design, items-glow, homes-gui-enabled, warps-gui-enabled, sounds, show-stats, опции homes/warps.

Freeze, Back, Jail

freeze.allowed-commands, back.save-on-death, jail.enabled, jail.allowed-commands.

Спавн и эффекты

spawn.per-world, teleport-on-first-join/death/respawn. effects.particles, sounds. home.check-safe-location, warp.check-safe-location.

AFK и экономика

afk.enabled, timeout, display-format, kick, broadcast. economy.enabled, economy.costs (home-set, warp, spawn, back, nick-change и т.д.).

Статистика и отладка

statistics.enabled, debug.enabled, metrics.enabled (bStats).

Настройка — Хранение и миграция

Хранение

storage.type — yaml или mysql. storage.mysql (host, port, database, username, password, pool, table-prefix).

Миграция

migration.auto-detect, migration.prompt-on-startup, migration.backup-before-migrate. Команда /mycommands migrate для миграции YAML ↔ MySQL.

Функции

Телепортация

Спавн (по миру опционально), дома (лимит по разрешению), варпы, TPA/TpAccept/TpDeny, back (предыдущая позиция или смерть).

Админ

Gamemode, fly, heal/feed (себя или всех), god, vanish, tp/tphere/tpall, give, clear, invsee, enderchest, weather/time, ptime/pweather, speed, broadcast, kick, freeze, repair, enchant, виртуальные таблицы, jail, setspawn, setwarp, socialspy, reload, migrate.

Игрок и соц.

spawn, home/sethome/delhome/homes, back, tpa/tpaccept/tpdeny, warp/warps, me, near, realname, seen, list, motd, rules, help, confirm, cancel, afk. Сообщения: msg, reply, ignore, socialspy (админ).

Расширенное

homegui, warpgui, nick (цвета опционально), stats.

Данные и интеграции

Хранение YAML или MySQL, /mycommands migrate, /mycommands reload. Vault (стоимости), PlaceholderAPI (расширение MyCommands), MyCore. UX: задержка телепорта (отмена при движении), кулдауны, подтверждения, предпросмотр, частицы/звуки, сообщения входа/выхода, вебхуки Discord.