Flectone Logo FlectonePulse

/ban

Command to ban a player

command ban

🌍Localization

Path localizations → language.yml → command.ban
ban:
  null_player: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>This player does not exist"
  null_time: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Incorrect time"
  lower_weight_group: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>You cannot ban a player with equal or higher permissions"
  reasons:
    default: "You have been banned from this server"
  server: "<color:#ff7171>🔒 <fcolor:2><moderator> <fcolor:1>has banned <fcolor:2><player> <fcolor:1><hover:show_text:\"<fcolor:1>ID: <id><br>Date: <date><br>Time: <time><br>Remaining time: <time_left><br>Moderator: <moderator><br>Reason: <reason>\">[INFO]</hover>"
  person: "<color:#ff7171>🔒 BAN 🔒<fcolor:1><br><br>Date: <date><br><br>Time: <time><br><br>Remaining time: <time_left><br><br>Moderator: <moderator><br><br>Reason: <reason>"
  connection_attempt: "<color:#ff7171>🔒 Banned <fcolor:2><player> <fcolor:1>tried to log in <hover:show_text:\"<fcolor:1>ID: <id><br>Date: <date><br>Time: <time><br>Remaining time: <time_left><br>Moderator: <moderator><br>Reason: <reason>\">[INFO]</hover>"
ban:
  null_player: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Игрок не найден"
  null_time: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Невозможное время"
  lower_weight_group: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Ты не можешь забанить игрока с такими же или большими правами"
  reasons:
    default: "Ты заблокирован на этом сервере"
  server: "<color:#ff7171>🔒 <fcolor:2><moderator><fcolor:1> заблокировал игрока <fcolor:2><player> <fcolor:1><hover:show_text:\"<fcolor:1>Айди: <id><br>Дата: <date><br>Время: <time><br>Осталось: <time_left><br>Модератор: <moderator><br>Причина: <reason>\">[ПОДРОБНЕЕ]</hover>"
  person: "<color:#ff7171>🔒 БАН 🔒 <fcolor:1><br><br>Дата: <date><br><br>Время: <time><br><br>Осталось: <time_left><br><br>Модератор: <moderator><br><br>Причина: <reason>"
  connection_attempt: "<color:#ff7171>🔒 Заблокированный <fcolor:2><player><fcolor:1> попытался подключиться <fcolor:1><hover:show_text:\"<fcolor:1>Айди: <id><br>Дата: <date><br>Время: <time><br>Осталось: <time_left><br>Модератор: <moderator><br>Причина: <reason>\">[ПОДРОБНЕЕ]</hover>"

null_player

Message if the entered player is not found

null_time

Message if an impossible time is entered

lower_weight_group

Message if the command is executed by a player with a lower group weight than the player being moderated

reasons

A list with keys and values, where the key is a word and the value is a specific reason

You can add your own reasons, for example
random_kek: "Random reason"

Then if I type /ban player 1d random_kek, the reason will be Random reason

If no reason is specified, default will be used

server

Message for everyone

person

Message for the player

connection_attempt

Message if a banned player attempted to connect

⚙️Setting

Path command.yml → ban
ban:
  enable: true
  suggest_offline_players: true
  show_connection_attempts: true
  check_group_weight: true
  range: "PROXY"
  time_limits:
    0: -1
  aliases:
  - "ban"
  - "tempban"
  destination:
    type: "CHAT"
  cooldown:
    enable: false
  sound:
    enable: false

enable

Enables or disables the functionality of the module

suggest_offline_players

If enabled, suggests nicknames of all players who have been on the server; otherwise, only nicknames of players who are currently online.

Information

This only affects the text suggestion.

check_group_weight

Whether player groups will be checked. If the player being moderated has a higher role than the command sender, the command will not execute and the lower_weight_group error will occur

show_connection_attempts

If enabled, it will show a message that a banned player attempted to connect command ban connect

range

How far in blocks the message will be displayed

ValueExplanation
WORLD_TYPEThe message will be sent only to players who have the permission flectonepulse.world.type.dimension_name
WORLD_NAMEThe message will be sent only to players who have the permission flectonepulse.world.name.world_folder_name
PROXYThe message will be sent to all players on the server and on the Proxy
SERVERThe message will be sent to all players on the server
PLAYERThe message will be sent only to the sender
any number greater than 0, for example range: 100The message will be sent to players whose distance between them and the sender is less than this number. Players must also be in the same world as the sender

time_limits

Time limits depending on the sender's group. The key is the group weight, and the value is the maximum moderation time in milliseconds (1 second = 1000 milliseconds)

Example
time_limits:
20: 35000
50: 100000
  • If a player has a group weight of 10, the command will NOT be executed
  • If a player has a group weight of 20, the maximum amount of time will be 35000
  • If a player has a group weight of 40, the maximum amount of time will also be 35000
  • If a player has a group weight of 50 or higher, it will be 100000

For unlimited time, use the value -1

range

How far in blocks the message will be displayed

ValueExplanation
WORLD_TYPEThe message will be sent only to players who have the permission flectonepulse.world.type.dimension_name
WORLD_NAMEThe message will be sent only to players who have the permission flectonepulse.world.name.world_folder_name
PROXYThe message will be sent to all players on the server and on the Proxy
SERVERThe message will be sent to all players on the server
PLAYERThe message will be sent only to the sender
any number greater than 0, for example range: 100The message will be sent to players whose distance between them and the sender is less than this number. Players must also be in the same world as the sender

destination

Where the message will be sent

TypeExplanationRequires additional configuration?
ACTION_BARMessage above the player's inventoryYes
BOSS_BARMessage at the top of the screenYes
BRANDMessage in F3No
CHATMessage in chatNo
TEXT_SCREENMessage anywhere on the screenYes
TITLEFull-screen messageYes
SUBTITLEFull-screen message (bottom line)Yes
TAB_HEADERMessage in TAB (top)No
TAB_FOOTERMessage in TAB (bottom)No
TOASTMessage in the top right corner (achievement)Yes

To change this, replace the value type: here and restart FlectonePulse using the /flectonepulse reload command; additional settings will appear AUTOMATICALLY

Change

Replace the value type: here

Restart FlectonePulse using the /flectonepulse reload command

Additional parameters for delay settings will appear automatically

cooldown

Usage delay

Usage

Replace false with true

Restart FlectonePulse using the /flectonepulse reload command

Additional parameters for delay settings will appear automatically

cooldown:
  enable: true
  duration: 60

Parameters

FieldTypeExplanation
enablebooleanEnables the cooldown functionality
durationlongHow many ticks must pass between uses

sound

Sound playback

Usage

Replace false with true

Restart FlectonePulse using the command /flectonepulse reload

Additional parameters for sound configuration will appear automatically

sound:
  enable: true
  volume: 1.0
  pitch: 1.0
  category: "HOSTILE"
  name: "minecraft:entity.llama.spit"

Parameters

FieldTypeExplanation
enablebooleanEnables sound playback
volumefloatSound volume from 0 to 1.0
pitchfloatSound pitch from 0 to 1.0
categoryStringCategory from MASTER, MUSIC, RECORD, WEATHER, BLOCK, HOSTILE, NEUTRAL, PLAYER, AMBIENT, VOICE
nameStringSound name, for example minecraft:entity.llama.spit

🔐Permissions

Path permission.yml → command.ban
ban:
  name: "flectonepulse.module.command.ban"
  type: "OP"
  cooldown_bypass:
    name: "flectonepulse.module.command.ban.cooldown.bypass"
    type: "OP"
  sound:
    name: "flectonepulse.module.command.ban.sound"
    type: "TRUE"

name

Permission name

type

Permission type

TypeExplanation
TRUEAvailable to any player
FALSEAvailable to no one, must be granted separately (e.g., using LuckPerms)
OPAvailable to server operators
NOT_OPAvailable to NON-operators of the server

cooldown_bypass

Permission to ignore the cooldown between uses

sound

Permission to use the sound

Last updated on

Edit on GitHub

On this page

Authors of page