Guías · Archivos
config.yml
# ------------------------------------------------------------
# RoodyWhitelist · config.yml
# Discord is in discord.yml, the look of the menus in menus/ and every text (kick screens,
# MOTDs, messages) in lang/. After a change: /rwl reload
# Times are written like 30m, 12h, 7d or 1d12h ("" or 0 = never / no limit).
# ------------------------------------------------------------
# Language of the server: en, es or any lang/<code>.yml you add. Kick screens and the server
# list use it (the player's language is not known before they join).
language: en
# Each player sees messages and menus in their Minecraft language (when there is a file for it).
per-player-language: true
# More names for /roodywhitelist and for /invite.
command-aliases:
- rwl
- wl
invite-aliases: []
# /whitelist is this plugin too (add, remove, on, off, list... work as always, and much more).
# The vanilla command stays as /minecraft:whitelist.
override-vanilla-command: true
# The vanilla whitelist (server.properties white-list) is turned off on start: this plugin
# decides who gets in. Its players are imported once into the default list.
replace-vanilla-whitelist: true
# The name of this server in Discord messages and logs.
server-name: "Minecraft"
# Time zone for the schedule and the dates shown, like Europe/Madrid ("" = the server's).
timezone: ""
# How dates are written and read (/rwl schedule add 01/12/2026 18:00 open).
date-format: "dd/MM/yyyy HH:mm"
storage:
# sqlite = data.db in this folder. mysql = one whitelist for every server of a network.
type: sqlite
table-prefix: roodywl_
# MySQL only: every how many seconds to read what other servers changed.
sync-seconds: 15
mysql:
host: 127.0.0.1
port: 3306
database: roodywhitelist
user: root
password: ""
options: "useSSL=false&autoReconnect=true"
# ------------------------------------------------------------ lists
# Who is on the whitelist. A player can be on several lists, each one forever or for a time:
# /rwl add <player> [list] [time]
# Options of a list:
# default: true the list of /rwl add without a list (only one)
# icon item in the menus
# ip-lock: true only from the IPs of their first joins (max-ips): on offline-mode
# servers anybody can use any name, this stops that. /rwl unlock <player>
# premium-only: true only real Minecraft accounts (Mojang); Bedrock counts (see security)
# max-size: 100 how many players fit (0 = no limit), {slots_left} in the texts
# cleanup: true players who stop playing are taken off (see cleanup)
# The name each list shows is in lang (lists.<id>).
lists:
players:
default: true
icon: PLAYER_HEAD
cleanup: true
staff:
icon: DIAMOND_SWORD
ip-lock: true
max-ips: 3
beta:
icon: NETHER_STAR
max-size: 0
cleanup: true
# ------------------------------------------------------------ modes
# Which lists get in. Change with /rwl mode <mode> [for how long], from the menu or on a
# schedule. /rwl on = default-mode, /rwl off = open.
# lists: [staff, beta] who gets in ("*" = anyone on any list)
# everyone: true anybody gets in (the server is open)
# motd: true the server list shows this mode's MOTD (lang: modes.<id>.motd)
# kick-online: true on switching to it, players who cannot stay are kicked
# requests: true players who are not on a list can ask to get in by joining (see requests)
# on-start: actions run when it starts:
# [console] cmd, [broadcast] text, [title] title;subtitle, [sound] id volume pitch
# Kick screens and names are in lang (modes.<id>).
default-mode: whitelist
modes:
open:
everyone: true
motd: false
on-start:
- "[title] &a&lOPEN;&7Welcome to the server!"
- "[sound] ui.toast.challenge_complete 0.8 1"
whitelist:
lists: ["*"]
motd: true
kick-online: true
requests: true
beta:
lists: [staff, beta]
motd: true
kick-online: true
requests: true
maintenance:
lists: [staff]
motd: true
kick-online: true
requests: false
# ------------------------------------------------------------ who skips it
bypass:
# Operators always get in.
ops: true
# Players with roodywhitelist.bypass (any mode) or roodywhitelist.bypass.<mode> get in.
# Permissions are not known before a player joins, so this needs LuckPerms.
permission: true
# ------------------------------------------------------------ schedule
# Mode changes at a set time: /rwl schedule add 01/12/2026 18:00 open [daily|weekly]
# or in a while: /rwl schedule in 2h open. A mode set for a time (/rwl open 30m) goes back
# by itself.
schedule:
# Seconds before a change when everyone online is told.
warnings: [3600, 1800, 600, 300, 60, 30, 10, 5, 4, 3, 2, 1]
# A boss bar with the countdown during the last seconds (0 = none).
bossbar-seconds: 300
# The last seconds also show as a title.
title-seconds: 5
# Played with each warning ("" = none).
sound: "block.note_block.hat 0.8 1.2"
# ------------------------------------------------------------ timed access
expiry:
# Tell a player online this long before their access ends.
warn-before: [1d, 1h, 10m, 1m]
# Kick them when it ends (when the mode no longer lets them in).
kick: true
# ------------------------------------------------------------ join requests
# A player who is not on a list asks to get in just by trying to join. The staff gets
# [Accept] [Temporary] [Deny] in chat (and in Discord with the bot). Only in modes with
# requests: true.
requests:
enabled: true
# The list accepted players go to.
list: players
# How long a request waits before it is forgotten.
expire: 3d
# After a denial, how long until the player can ask again.
deny-cooldown: 1d
# The time of the [Temporary] button.
temporary: 1d
# Tell the staff online (roodywhitelist.requests), once per request.
notify-staff: true
notify-sound: "block.note_block.pling 0.6 1.6"
# ------------------------------------------------------------ invites
# Players on a list can bring friends: /invite <player>
invites:
enabled: true
# The list invited players go to.
list: players
# How many each player can have at once (more with roodywhitelist.invites.<n>).
amount: 2
# The inviter must have played here this long ("" = no minimum).
min-playtime: 1h
# Time between two invites of the same player.
cooldown: 30m
# The invited player gets in "on trial" for this long ("" = permanent from the start)...
trial: 7d
# ...and the access becomes permanent by itself when they have played this long here
# ("" = only when the staff confirms it with /rwl confirm <player>).
confirm-playtime: 3h
# Taking someone off the lists also takes off the players they invited who are still on trial.
remove-trial-invites: true
# ------------------------------------------------------------ codes
# /rwl code create [list] [uses] [valid for] [access for] → a code like K7P2-QX9M.
# Players redeem it in Discord (/redeem, with the bot) or, with addresses on, by joining
# through CODE.play.myserver.com (it needs a wildcard DNS record: *.play.myserver.com).
codes:
length: 8
address:
enabled: false
domain: "play.myserver.com"
# ------------------------------------------------------------ slots
# The first ones to join while the mode is one of these get a place on the list by
# themselves, until the list is full ("the first 100 get into the beta").
slots:
enabled: false
list: beta
amount: 100
modes: [beta]
# ------------------------------------------------------------ security
security:
# Failed joins allowed from one IP per minute; after that it has to wait (no requests,
# no codes) — stops bots from filling the requests.
max-attempts-per-minute: 6
# Tell the staff (roodywhitelist.alerts) when someone joins with the name of a player of
# an ip-lock list from another IP.
alert-ip-lock: true
# Bedrock players (Floodgate) count as real accounts on premium-only lists.
bedrock-premium: true
# ------------------------------------------------------------ worlds
# Worlds only for some lists (or roodywhitelist.world.<world>). Example:
# beta_world: [beta, staff]
worlds: {}
# ------------------------------------------------------------ server list
motd:
# The server list shows the mode's MOTD (modes with motd: true). Turn it off if another
# plugin handles the MOTD (the placeholders %roodywhitelist_...% work there).
enabled: true
# The mode's name instead of the player count (the client shows it in red).
version-text: true
# ------------------------------------------------------------ cleanup
cleanup:
# Take players off the lists with cleanup: true when they have not joined in this long.
inactive: 90d
# Take off (from those lists too) players who were added but never joined, after this long.
never-joined: 30d
# How long the history is kept.
history: 90d
# Tell the console and admins (permission roodywhitelist.update) when a new version is out
# on plugins.roody.es.
check-updates: true
# Every 30 minutes the plugin sends anonymous server statistics to plugins.roody.es:
# players online and maximum, Minecraft and Java version and the software (Paper,
# Purpur...). Nothing about your players. Set to false to turn them off.
metrics: true