start 04
Configuration
config.yml is created on first start. Content is not configured here: items, blocks, furniture,
recipes, glyphs and HUD elements live in their own folders. Reload with /tessera reload.
Sections
| Section | Purpose |
|---|---|
core | Prefix, language, debug and startup flags. |
pack | Pack metadata, the embedded HTTP server, protection, player protection, sounds, importer. |
welcome | First join and returning join sequences. |
items, blocks, furniture, recipes, glyphs, hud | Module folders and module defaults. |
gui | Catalog title, rows, border materials and sounds. |
hooks | Flags for WorldGuard, GriefPrevention, Towny, PlaceholderAPI, Vault and LuckPerms. |
performance | Async hashing, chunk cleanup, furniture caps, packet rate limit. |
messages | Message templates. |
Keys the plugin reads
This is the full list of config.yml keys read by the code in 2.0.0. Anything else in the file is
inert for now, including the whole of gui, hooks, performance, items, blocks, furniture,
recipes and glyphs.
core.language
pack.meta.pack_format
pack.server.enabled pack.server.host
pack.server.port pack.server.domain
pack.server.external_url pack.server.required
pack.server.kick_on_decline pack.server.kick_on_fail
pack.server.auto_apply.enabled
pack.server.auto_apply.delay_ticks
pack.server.rate_limit.enabled
pack.server.rate_limit.max_requests_per_ip
pack.server.rate_limit.cooldown_minutes
pack.protection.protect_from_unzip
pack.protection.level
pack.protect_player.enabled
pack.protect_player.lock_movement
pack.protect_player.blindness
pack.sounds.on_loaded
pack.importer.auto_watch
pack.importer.watch_interval_seconds
hud.enabled hud.update_interval_ticks
hud.separator
hud.pause_banner
hud.pause_menu.texts
hooks.*
messages.pack.prompt messages.pack.loading_title
messages.pack.loading_subtitle
messages.pack.loaded_actionbar
messages.pack.loaded_chat
messages.pack.kick_declined messages.pack.kick_failed
messages.pack.declined_warning
messages.pack.failed_warning
welcome.enabled welcome.delay_ticks
welcome.first_join.* welcome.regular_join.*
Older configs that put these under pack.pack_format and pack.messages still work.
core
core:
prefix: "<gradient:#00c6ff:#0072ff><bold>Tessera</bold></gradient> <dark_gray>»</dark_gray> "
language: "en" # en, uk, de, es, or your own file in lang/
debug: false
verbose_startup: true
version_check: true
metrics: true
io_timeout_ms: 5000
server_name: "Tessera Network"
core.language selects the file loaded from lang/. A missing file falls back to en.yml with a
warning. Command messages (no permission, players only, items given and so on) come from
messages.* in that file; a key missing from it falls back to the bundled English text.
updater
updater:
enabled: true
project: "3icQINIy" # modrinth.com/plugin/tessera-plugin
channel: release # release, beta or alpha
check_interval_hours: 6
auto_install: true
notify_admins: true
A minute after start and then every check_interval_hours, Tessera asks Modrinth for the newest
version built for the server's Minecraft version. A newer one is downloaded into plugins/update/
under the running jar's name, and Paper swaps it in on the next restart. The download is used only
when its SHA-512 matches Modrinth and its plugin.yml is Tessera's. With auto_install: false,
admins are only told, and /tessera update install fetches it.
pack
The long one. See Resource pack for what each part does.
pack:
meta:
description: "<gradient:#00c6ff:#0072ff>Official Tessera Server Resource Pack</gradient>"
pack_format: 84 # 26.1; pack.mcmeta also declares 34 to 99
auto_generate: true
compression_level: 6
server:
enabled: true
host: "0.0.0.0"
port: 8085
domain: "localhost:8085" # set this to a host players can reach
external_url: "" # non-empty: players download from here instead
required: true
kick_on_decline: true
kick_on_fail: false
auto_apply:
enabled: true
delay_ticks: 10
rate_limit:
enabled: true
max_requests_per_ip: 5
cooldown_minutes: 15
protection:
protect_from_unzip: true
level: 2 # 1, 2 or 3
protect_player:
enabled: true
lock_movement: true
blindness: true
sounds:
on_loaded: "ENTITY_PLAYER_LEVELUP"
importer:
folder: "imports"
auto_watch: true
watch_interval_seconds: 15
hud
hud:
enabled: true
update_interval_ticks: 2
folder: "hud"
pause_banner: true
pause_menu:
texts: {}
enabled, update_interval_ticks, separator, pause_banner and pause_menu.texts are read. Players toggle their own HUD with /tessera hud. See
Glyphs and HUD for the pause banner and pause menu text.
The old hud.top_banner section is no longer read and can be deleted.
hooks
hooks:
worldguard:
enabled: true
respect_build_flag: true
griefprevention:
enabled: true
towny:
enabled: true
placeholderapi:
enabled: true
vault:
enabled: true
luckperms:
enabled: true
| Hook | What it does |
|---|---|
worldguard | Furniture placing and breaking need build rights in the region (respect_build_flag); sitting needs the interact flag (respect_interact_flag). Players with the WorldGuard bypass pass. |
griefprevention | Furniture needs build trust in the claim (respect_claims). |
towny | Furniture needs Towny build, destroy or switch rights (respect_town_permissions). |
placeholderapi | %placeholders% in HUD (parse_in_hud) and welcome text (parse_in_welcome). |
vault, luckperms | Not used. |
The plugins are called through their APIs only when they are installed, so none of them is needed.
Custom blocks are placed and broken through normal block events, which every protection plugin
already guards. tessera.bypass.protection skips all region checks.
Language files
lang/ ships with en.yml, uk.yml, de.yml and es.yml. Add your own file and point
core.language at its name without the extension.