TESSERA

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

SectionPurpose
corePrefix, language, debug and startup flags.
packPack metadata, the embedded HTTP server, protection, player protection, sounds, importer.
welcomeFirst join and returning join sequences.
items, blocks, furniture, recipes, glyphs, hudModule folders and module defaults.
guiCatalog title, rows, border materials and sounds.
hooksFlags for WorldGuard, GriefPrevention, Towny, PlaceholderAPI, Vault and LuckPerms.
performanceAsync hashing, chunk cleanup, furniture caps, packet rate limit.
messagesMessage 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
HookWhat it does
worldguardFurniture 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.
griefpreventionFurniture needs build trust in the claim (respect_claims).
townyFurniture needs Towny build, destroy or switch rights (respect_town_permissions).
placeholderapi%placeholders% in HUD (parse_in_hud) and welcome text (parse_in_welcome).
vault, luckpermsNot 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.