JPEssentials

# Used to add new options to this file after an update. Don't change it.
config-version: 1

# ╔══════════════════════════════════════════════════════════════════╗
# ║                  JPEssentials  ·  config.yml                     ║
# ╚══════════════════════════════════════════════════════════════════╝
# Everyday commands (fly, heal, gamemode, repair, invsee...), jails, AFK, nicknames
# and sitting. Apply changes with /jpess reload.
#
# The other files:
#   commands.yml         turn single commands on/off, and what happens when another
#                        plugin already has the same command  (restart to apply)
#   messages.yml         every text players see
#   texts.yml            MOTD, /rules and /help pages
#   custom-commands.yml  your own info commands like /discord, /website, /vote
#
# Overlaps with your other plugins are handled for you:
#   - A command another plugin already has (e.g. /vanish in JPStaff, /home in JPTeleport)
#     is left to that plugin. "/jpess commands" shows who handles what.
#   - "auto" features below are only done by JPEssentials while JPChat does not do them.
#
# Permissions: every command is jpessentials.<command> (e.g. jpessentials.fly), and
# jpessentials.<command>.others to use it on someone else. Players get /afk, /sit, /lay,
# /crawl, /list, /ping, /seen, /playtime, /rules, /motd, /help, /suicide, /getpos,
# /compass and /realname by default; everything else is for ops until you give it out,
# e.g.  /lp group vip permission set jpessentials.fly true

# Language of the messages: en (messages.yml), es, pt, fr or de (lang/<code>.yml).
# Your own language: copy a file in the lang folder to lang/<code>.yml, translate it
# and set its code here (for example it for lang/it.yml).
language: en

# Replace messages.yml with the new design when the plugin is updated.
# Your old file is kept as messages.old-vX.yml. false = never touch it.
auto-update-style: true

# ----------------------------------------------------------
# Features: true = on, false = off.
# "auto" = on, unless JPChat is installed and already does it.
# ----------------------------------------------------------
features:
  # Join and leave messages ([+] Player / [-] Player).
  join-quit-messages: auto
  # The welcome message for a player's very first join.
  first-join-message: auto
  # The MOTD (texts.yml) shown to players when they join.
  motd: auto
  # Automatic announcements (see "announcer" below).
  announcer: auto
  # Commands run when players join (see "join-commands" below).
  join-commands: true
  # /afk and automatic AFK. JPTab's [AFK] tag follows it when both are installed.
  afk: true
  # /nick. Nicknames show in JPChat and in the JPTab player list.
  nicknames: true
  # /jail and friends.
  jail: true
  # Keep items/levels on death with jpessentials.keepinventory / jpessentials.keepxp.
  keep-on-death: true
  # & colour codes on signs, anvils and books (needs jpessentials.color.sign/anvil/book).
  colour-codes: true
  # /sit, /lay, /crawl, sitting on stairs and on other players (settings below).
  # auto = off while the standalone JPSit plugin is installed (it does the same).
  sitting: auto
  # /powertool (bind a command to an item).
  powertools: true

hooks:
  # Fill %placeholders% in MOTD, rules, help, custom commands and announcements.
  placeholderapi: true
  # Ranks for /list and balances for /whois.
  vault: true

# How dates are written in /seen and /whois.
date-format: 'dd MMM yyyy HH:mm'

# ----------------------------------------------------------
# AFK
# ----------------------------------------------------------
afk:
  # Seconds without moving before a player is AFK. 0 = only with /afk.
  after-seconds: 300
  # Kick players who are AFK this long (seconds). 0 = never.
  # jpessentials.afk.kickexempt is never kicked.
  kick-after-seconds: 0
  # Tell everyone when someone goes AFK or comes back. false = only tell the player.
  announce: true
  # AFK players cannot be hurt.
  invulnerable: false

fly:
  # Players who were flying when they left are still allowed to fly when they come back.
  keep-on-join: true

god:
  # Players in god mode do not get hungry.
  no-hunger: true

# ----------------------------------------------------------
# Nicknames (/nick)
# ----------------------------------------------------------
nick:
  # Put in front of every nickname, e.g. '~' -> ~Steve. Empty = nothing.
  prefix: ''
  min-length: 3
  max-length: 16
  # Characters allowed in nicknames (a Java regex for ONE character).
  allowed-characters: '[A-Za-z0-9_]'

# ----------------------------------------------------------
# Limits for commands
# ----------------------------------------------------------
near:
  # /near without a number uses this radius; nobody can go above max-radius.
  default-radius: 200
  max-radius: 1000
jump:
  # How far /jump (and /smite) can reach.
  max-distance: 120
give:
  # Most items /give and /item hand out at once.
  max-amount: 2304
spawnmob:
  # Most mobs /spawnmob makes at once.
  max-amount: 50
butcher:
  # Radius of /butcher and /removeentities when no number is given.
  default-radius: 64

# ----------------------------------------------------------
# Jail
# ----------------------------------------------------------
# /setjail <name> where you stand, then /jail <player> [jail] [time] [reason].
# Times look like 30s, 10m, 2h, 1d, 1h30m. No time = until /unjail.
jail:
  # How far jailed players may walk from the jail point. 0 = no limit.
  radius: 25
  # The sentence keeps running while the player is offline.
  count-offline-time: true
  allow-building: false
  allow-interacting: false
  allow-fighting: false
  # Commands jailed players can still use (without the /).
  allowed-commands: [rules, msg, tell, r, reply, helpop, jails, login, l, register]

# ----------------------------------------------------------
# Commands run when players join
# ----------------------------------------------------------
# "console: ..." runs as the console, "player: ..." as the player. {player} = their name.
join-commands:
  first-join: []
  #  - 'console: give {player} bread 16'
  #  - 'player: spawn'
  every-join: []

# ----------------------------------------------------------
# Announcer (only while JPChat's announcer is off, see features.announcer)
# ----------------------------------------------------------
announcer:
  interval-seconds: 300
  # Skip announcements while fewer players are online.
  min-players: 1
  # false = in order, true = random.
  random: false
  sound: BLOCK_NOTE_BLOCK_CHIME
  # Each entry is one announcement, which can have several lines.
  messages:
    vote:
      - ''
      - '  <gradient:#F7971E:#FFD200><bold>ᴛɪᴘ</bold></gradient> &8» &7Vote for the server with &f/vote &7for rewards!'
      - ''
    discord:
      - ''
      - '  <gradient:#5865F2:#8EA1FF><bold>ᴅɪꜱᴄᴏʀᴅ</bold></gradient> &8» &7Join our Discord: &f/discord'
      - ''

# ----------------------------------------------------------
# Sitting, lying and crawling
# ----------------------------------------------------------
sitting:
  # Raise (+) or lower (-) where players sit, in blocks, if it looks off with your
  # resource pack. 0.0 = normal.
  height-adjust: 0.0
  # Right-click a stair, slab or carpet with an empty hand to sit on it.
  chairs:
    enabled: true
    # Only with an empty hand (so you can still place blocks on stairs).
    empty-hand: true
    # How close you must be, in blocks.
    max-distance: 3.0
    # Blocks that work as seats. *_STAIRS = every stair. Only the lower half of
    # stairs and slabs counts.
    blocks: ['*_STAIRS', '*_SLAB', '*_CARPET']
  # Right-click another player with an empty hand to sit on their head.
  # Players can turn this off for themselves with /sittoggle player.
  player-sit:
    enabled: true
    # The player below can sneak to throw the rider off.
    eject-on-sneak: true
  lay:
    enabled: true
  crawl:
    enabled: true