Minecraft Server

Purpur 26.2 on desktop (10.100.0.2), routed through Traefik on server (mc.yhkze.net:25565). Offline-mode with AuthMe for password auth and SkinsRestorer for Mojang skin fetching.

Prism Launcher Setup

  1. Instance — Minecraft 26.2, Fabric loader recommended
  2. Server — Add Server → mc.yhkze.net
  3. Account — use your Minecraft username (offline-mode)
Purpose Mods
Performance Sodium, Lithium
Shaders Iris
Custom mob models (CEM) EMF + ETF
Connected textures (CTM) Continuity
Custom item textures (CIT) CIT Resewn Continuation
Server pack reordering Server Pack Unlocker

Resource Pack

The server suggests Yuushya Townscape 0.20.0 + Foliage Addon 1.3 on join (accept/decline prompt). Accept it, then load Gray’s Mob Overhaul above it in your pack list via Server Pack Unlocker.

Recommended shaders: Photon or Complementary Unbounded.

First-Time Login

  1. Connect to mc.yhkze.net
  2. Run /register <password> <password>, then /login <password> (30 s timeout before kick)
  3. Premium (paid) players: run /premium once to skip password on future joins — Mojang verification is handled cryptographically via PacketEvents

Console

sudo tmux -S /run/minecraft/purpur.sock attach # Ctrl+b d to detach
sudo tmux -S /run/minecraft/purpur.sock send-keys "/command" Enter

Commands

Teleportation

Command Description
/data get entity <player> Pos Print player coordinates
/tp <player> <x> <y> <z> Teleport player to coordinates
/tp <player> <target> Teleport player to another player
/tp @a <x> <y> <z> Teleport all players
/tp @e[type=minecraft:pig] <x> <y> <z> Teleport all entities of a type

Selectors: @a all players, @p nearest, @r random, @e[type=...] entities by type.

Time & Weather

Command Description
/time set day Jump to dawn (t=0)
/time set 6000 Jump to noon; 12000 = dusk, 18000 = midnight
/weather clear Clear weather
/weather thunder Thunderstorm

Gamemode & Gear

Command Description
/gamemode creative\|survival\|spectator <player> Change gamemode
/give <player> <item>[<components>] Give item, optionally with NBT components
/clear <player> Remove all items from player

Example with enchantment components:

/give DesertRush minecraft:diamond_sword[enchantments={levels:{'minecraft:sharpness':5}}]

World

Command Description
/seed Print world seed
/setworldspawn <x> <y> <z> Set global spawn point
/difficulty peaceful\|easy\|normal\|hard Set difficulty
/summon minecraft:lightning_bolt <x> <y> <z> Summon lightning at coordinates
/execute at <player> run summon minecraft:lightning_bolt Summon lightning at player

Players

Command Description
/list List online players
/whitelist add\|remove <player> Manage whitelist
/kick <player> <reason> Kick player

Gamerules

Rule Value Effect
keepInventory true Items kept on death
maxEntityCramming 100 Reduces suffocation in crowds
playersSleepingPercentage 1 One player is enough to skip night

Apply: /gamerule <rule> <value>. Names are camelCase.

AuthMe & Skins

Command Description
/register <pass> <pass> Register on first join
/login <pass> Log in (required within 30 s)
/premium Opt in to Mojang verification, skip password on future joins
/freemium Revert to password auth
/authme premium <player> Admin: enrol player in premium
/authme freemium <player> Admin: remove player from premium
/skin <username> Fetch and apply Mojang skin (SkinsRestorer)

Imperative Config

/srv/minecraft/purpur/plugins/AuthMe/config.yml — not managed by Nix, edit manually:

Setting Value Reason
enablePremium true Enables Mojang verification via PacketEvents
minPasswordLength 1 Default of 5 was too restrictive
dialog.preJoin.enable false Prevents “Connecting…” hang on wrong password

Apply changes: edit file → /authme reload in console.

Backups

Daily at 3 AM to Backblaze B2. Trigger manually:

sudo systemctl start restic-backups-b2.service

Reference Backups for restore procedure.

Domain

mc.yhkze.net must be DNS-only in Cloudflare — Minecraft uses raw TCP on port 25565, not HTTP. The record is already configured in Cloudflare DNS. If rebuilding from scratch, add a CNAME mc.yhkze.net → yhkze.net with proxy disabled.

Traefik routes mc.yhkze.net:25565 → desktop at 10.100.0.2:25565 (TCP passthrough, no TLS termination).

References