# Cobbleverse Environment Example
# Version: 1.0.0 (2025-11-01)
# Copy this file to .env and edit values.

# ToDo: Implement this to allow rotating worlds
# The Name of Your World.  If you use a name that hasn't been used already, it will create a new world upon restart
# SERVER_WORLDNAME="YOUR_WORLDNAME_SHOULD_BE_ONE_WORD"

# Enable this to have the container download and install the Cobbleverse pack on first run.
MODRINTH_MODPACK=https://cdn.modrinth.com/data/Jkb29YJU/versions/DrJAo7Hk/COBBLEVERSE%201.6.mrpack

# These map to server.properties via the itzg/minecraft-server image
# Name shown in the server list
SERVER_NAME="Cobbleverse"
# Message of the day (multiline with \n is allowed). If set, will map to MOTD.
SERVER_MOTD="Welcome to Cobbleverse!"
# Alternatively set MOTD directly; SERVER_MOTD takes precedence if both are set.
# MOTD=Welcome to Cobbleverse!
# Optional server icon. Provide a URL to your icon (ideally a 64x64 PNG).
# docker-compose maps SERVER_ICON -> ICON for the base itzg/minecraft-server image,
# which will fetch/convert and place /data/server-icon.png accordingly.
# Example PNG URL (64x64):
SERVER_ICON="https://files.catbox.moe/ks931g.png"

# Core gameplay/policy
ALLOW_FLIGHT=true
SPAWN_MONSTERS=false
DIFFICULTY="normal"            # peaceful|easy|normal|hard
VIEW_DISTANCE=10
SIMULATION_DISTANCE=10
ENABLE_COMMAND_BLOCK=false
ONLINE_MODE=true
WHITE_LIST="false"             # enables whitelist feature in server.properties
ENFORCE_WHITELIST="false"      # for newer versions that use enforce-whitelist
ENABLE_STATUS="true"           # allow status queries (server list pings)

# Ops and whitelist users (comma-separated player names). The image will populate ops.json/whitelist.json.
# Example: OPS=PlayerOne,PlayerTwo
OPS=
# Example: WHITELIST=FriendA,FriendB
WHITELIST=

# Recommended memory for Cobbleverse/Cobblemon packs: 6–8G depending on host capacity
MEMORY=8G
# Use Aikar's flags (enabled by default via docker-compose). To supply custom JVM opts instead,
# comment out USE_AIKAR_FLAGS in compose (or set false) and set JVM_OPTS below, e.g.:
# JVM_OPTS=-XX:+UseG1GC -XX:MaxGCPauseMillis=100 -XX:+UnlockExperimentalVMOptions -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=16M -XX:G1ReservePercent=20 -XX:InitiatingHeapOccupancyPercent=15 -XX:+ParallelRefProcEnabled
# Crash handling: Only enable after testing; some packs rely on max tick watchdog
# RESTART_ON_CRASH=true
# MAX_TICK_TIME=-1  # disables watchdog; use with caution
# Distances: tune down for more players. 2–5 players: VIEW_DISTANCE=8–10, SIMULATION_DISTANCE=6–10
# VIEW_DISTANCE=10
# SIMULATION_DISTANCE=10

# Optional: Run console commands at server startup (semicolon-separated)
# Example enables the datapack and keeps inventory on death:
# RCON_CMDS_STARTUP=/datapack enable "file/COBBLEVERSE-Sinnoh-DP.zip";/gamerule keepInventory true
#RCON_CMDS_STARTUP="/gamerule keepInventory true"

# Exclude client-only mods during Modrinth install to avoid server-side warnings/errors.
# Comma-separated list of modpack file patterns (relative to pack), e.g., mods/*.jar
# This prevents the need for an init-time cleanup that would otherwise run before the pack is installed.
MODRINTH_EXCLUDE_FILES=mods/modmenu-*.jar,mods/RoughlyEnoughItems-*.jar,mods/sound-physics-remastered-*-fabric-*.jar,mods/moreculling-fabric-*.jar,mods/infinite-music-*.jar,mods/MusicNotification-*.jar,mods/Ping-Wheel-*.jar,mods/particle-rain-*.jar,mods/paginatedadvancements-*.jar,mods/notenoughcrashes-*.jar,mods/respackopts-*.jar,mods/defaultoptions-*.jar

# Timezone for logs/backup timestamps
TZ=UTC
# Backups sidecar schedule and retention (handled by itzg/mc-backup)
# Format examples: 12h, 24h, 30m, 15m (minutes are supported)
BACKUP_INTERVAL=15m
# Days to retain backups (older pruned)
BACKUP_PRUNE_DAYS=14
# Maximum number of backups to retain in ./backups (0 disables count-based pruning)
BACKUP_MAX_BACKUPS=3
# Graceful stop: delay between announce and stop when using container-driven restarts/updates
STOP_SERVER_ANNOUNCE_DELAY=15
# RCON: Set a non-empty password to enable RCON on the mc server AND allow the backup sidecar to
# quiesce the world (save-off/save-all/save-on) around backups. If left empty, RCON is disabled and
# backups will proceed without pre/post RCON commands.
# The docker-compose maps the same RCON_PASSWORD into both services and sets RCON_HOST=mc for the backup.
# IMPORTANT: If you set this, ensure you keep it secret and strong.
RCON_PASSWORD=

# Run the containerized server as a non-root user. Set to a user/group that owns the repo directory on the host.
# On Linux, typical non-root UID/GID is 1000:1000 for the first user. On Windows/Mac, these are mapped by Docker and safe to leave.
UID=1000
GID=1000
# Ensure firewall/port forward exposes TCP/25565 from host to Internet if you want public access.
# For home networks, forward 25565/TCP on your router to the host's LAN IP. Consider using a DDNS hostname.
# RCON is powerful; expose only if needed and always set a strong RCON_PASSWORD.