MyCommands

Documentação · v2.8.1

Instalação e início

Requisitos

Servidor Paper 1.20+ (ou derivado). Opcional: Vault (economia), PlaceholderAPI (placeholders), MyCore.

Instalação

  1. Descarregue MyCommands.jar
  2. Coloque o ficheiro em plugins/
  3. Reinicie o servidor
  4. Edite plugins/MyCommands/config.yml (idioma, cooldowns, atrasos, limites, mensagens, etc.)
Primeiros passos

Comandos básicos: /spawn, /home, /sethome, /warp, /warps, /tpa, /msg, /help. Admin: /gamemode, /heal, /feed, /setspawn, /setwarp. Recarregar config: /mycommands reload. Migrar dados (YAML ↔ MySQL): /mycommands migrate.

Comandos admin

Lista de comandos apenas para administradores, com uso, aliases e permissão.

ComandoUsoAliasPermissão
/gamemode<modo> [jogador]gmmycommands.gamemode
/fly[jogador]mycommands.fly
/heal[jogador] ou allmycommands.heal
/feed[jogador] ou allmycommands.feed
/god[jogador]mycommands.god
/vanishvmycommands.vanish
/tp<jogador> ou <x> <y> <z>teleportmycommands.tp
/tphere<jogador>smycommands.tphere
/give<jogador> <item> [quantidade]mycommands.give
/clear[jogador]cimycommands.clear
/invsee<jogador>invmycommands.invsee
/enderchest[jogador]ecmycommands.enderchest
/weather<clear/rain/thunder>mycommands.weather
/time<day/night/ticks>mycommands.time
/speed<1-10> [jogador]mycommands.speed
/broadcast<mensagem>bcmycommands.broadcast
/kick<jogador> [razão]mycommands.kick
/freeze<jogador>mycommands.freeze
/setspawn, /setwarp, /delwarpspawn e warpsmycommands.setspawn, mycommands.setwarp
/mycommandsreload, migratemycommands.reload, mycommands.migrate

Comandos jogador

Comandos disponíveis para jogadores (teletransporte, informação, ajuda).

ComandoUsoAliasPermissão
/spawnmycommands.spawn
/home[nome]mycommands.home
/sethome[nome]mycommands.sethome (+ mycommands.sethome.N)
/delhome<nome>mycommands.delhome
/homesmycommands.homes
/backmycommands.back
/tpa<jogador>callmycommands.tpa
/tpaccepttpyesmycommands.tpaccept
/tpdenytpnomycommands.tpdeny
/warp<nome>mycommands.warp
/warpsmycommands.warps
/me, /near, /realname, /seen, /listinfo jogadoresmycommands.me, etc.
/motd, /rules, /helpajudamycommands.motd, mycommands.help
/confirm, /cancelyes, nomycommands.confirm
/afkmycommands.afk

Mensagens e estendido

Mensagens privadas

ComandoUsoAliasPermissão
/msg<jogador> <mensagem>m, tell, whisper, wmycommands.msg
/reply<mensagem>rmycommands.reply
/ignore[jogador]mycommands.ignore
/socialspyspymycommands.socialspy (admin)

GUIs e estendido

/homegui (homesgui), /warpgui (warpsgui) — Interface para homes e warps. /nick (nickname) — Alterar nome exibido. /stats (statistics) — Estatísticas de teletransporte (próprio ou [jogador]). Permissões: mycommands.gui.homes, mycommands.gui.warps, mycommands.nick, mycommands.stats.

Permissões

Resumo das permissões principais.

  • mycommands.admin — Todos os comandos admin
  • mycommands.player — Comandos jogador (spawn, home, warp, tpa, msg, help, etc.)
  • mycommands.extended — GUIs, nick, stats
  • mycommands.sethome.N — Limite de N homes (ex. mycommands.sethome.5)
  • mycommands.sethome.unlimited — Homes ilimitados
  • mycommands.cooldown.bypass — Ignorar cooldowns
  • mycommands.teleportdelay.bypass — Ignorar atraso de teletransporte
  • mycommands.afk.bypass — Não ser marcado AFK automaticamente

Config — Cooldowns e teletransporte

Cooldowns

cooldowns.enabled, cooldowns.commands (home, spawn, warp, tpa, back, heal, feed, repair) em segundos. cooldowns.bypass-for-ops.

Atraso de teletransporte

teleport-delay.enabled, teleport-delay.delay por comando. teleport-delay.cancel-on-move, teleport-delay.bypass-for-ops.

Anti-abuso

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

Pré-visualização teletransporte

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

Config — Limites e warps

Limites

limits.max-homes, limits.tp-request-timeout, limits.max-ignored-players, limits.max-warps (-1 = ilimitado).

Warps

warps.enabled, warps.per-warp-permission (mycommands.warp.<nome> por warp).

Permissões (homes)

permissions.homes.default — Número de homes por defeito quando não há mycommands.sethome.N.

Config — Mensagens e join/quit

Geral

language — fr, en.

Mensagens

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

Mensagens privadas

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

Join / Quit

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

Confirmações e notificações

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

Config — Nick, GUIs, jail, spawn

Alcunhas

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

GUIs

guis.enabled, modern-design, items-glow, homes-gui-enabled, warps-gui-enabled, sounds, show-stats, opções homes/warps.

Freeze, Back, Jail

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

Spawn e efeitos

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

AFK e economia

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

Estatísticas e debug

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

Config — Armazenamento e migração

Armazenamento

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

Migração

migration.auto-detect, migration.prompt-on-startup, migration.backup-before-migrate. Use /mycommands migrate para migrar YAML para MySQL ou vice-versa.

Recursos

Teletransporte

Spawn (por mundo opcional), homes (limite por permissão), warps, TPA/TpAccept/TpDeny, back (posição anterior ou morte).

Admin

Gamemode, fly, heal/feed (próprio ou todos), god, vanish, tp/tphere/tpall, give, clear, invsee, enderchest, weather/time, ptime/pweather, speed, broadcast, kick, freeze, repair, enchant, tabelas virtuais, jail, setspawn, setwarp, socialspy, reload, migrate.

Jogador e social

spawn, home/sethome/delhome/homes, back, tpa/tpaccept/tpdeny, warp/warps, me, near, realname, seen, list, motd, rules, help, confirm, cancel, afk. Mensagens: msg, reply, ignore, socialspy (admin).

Estendido

homegui, warpgui, nick (cores opcionais), stats.

Dados e integrações

Armazenamento YAML ou MySQL, /mycommands migrate, /mycommands reload. Vault (custos), PlaceholderAPI (expansão MyCommands), MyCore. UX: atraso teletransporte (cancelar se movimento), cooldowns, confirmações, pré-visualização, partículas/sons, mensagens join/quit, webhooks Discord.