【2025年10月最新】マインクラフトサーバーパフォーマンス最適化完全ガイド

# spigot.yml（world-settings.default 抜粋）
world-settings:
  default:
    entity-activation-range:
      animals: 16
      monsters: 24
      raiders: 32
      misc: 8
      water: 12
      villagers: 16
      flying-monsters: 32

    entity-tracking-range:
      players: 48
      animals: 48
      monsters: 48
      misc: 32
      other: 64

    max-entity-collisions: 2
    merge-radius:
      item: 4.0
      exp: 6.0

    hopper-transfer: 8
    hopper-check: 1
    hopper-amount: 1

# bukkit.yml（無理のないスパン調整）
spawn-limits:
  monsters: 50
  animals: 10
  water-animals: 7
  water-ambient: 10
  ambient: 1

chunk-gc:
  period-in-ticks: 600
  load-threshold: 300

ticks-per:
  animal-spawns: 400
  monster-spawns: 1
  water-spawns: 1
  water-ambient-spawns: 1
  ambient-spawns: 1
  autosave: 6000

# discord_webhook_monitor.py（aiohttp + discord.py不要の純Webhook例）
import asyncio
import aiohttp
import datetime

WEBHOOK_URL = "YOUR_DISCORD_WEBHOOK"

async def send_alert(title: str, desc: str, color: int = 0xFF9900):
    payload = {
        "embeds": [{
            "title": title,
            "description": desc,
            "color": color,
            "timestamp": datetime.datetime.utcnow().isoformat()
        }]
    }
    async with aiohttp.ClientSession() as session:
        async with session.post(WEBHOOK_URL, json=payload, timeout=10) as resp:
            await resp.text()

async def main():
    # 例: TPSが18未満なら通知
    tps = 17.8
    if tps < 18:
        await send_alert("TPS低下警告", f"現在のTPS: {tps}")

if __name__ == "__main__":
    asyncio.run(main())

#!/bin/bash
# minecraft-backup.sh（運用例：必要に応じてsudo/screen部分を調整）

WORLD_PATH="/opt/minecraft/world"
PLUGINS_PATH="/opt/minecraft/plugins"
BACKUP_DIR="/tmp/mc-backup-$"
RCLONE_REMOTE="gdrive:minecraft-backups"
WEBHOOK="YOUR_DISCORD_WEBHOOK"

set -e
mkdir -p "$BACKUP_DIR"

# 通知関数
notify() { curl -H "Content-Type: application/json" -X POST -d "{\"content\":\"$1\"}" "$WEBHOOK" >/dev/null 2>&1 || true; }

notify "バックアップ開始"
screen -S minecraft -p 0 -X stuff "save-off^M"
screen -S minecraft -p 0 -X stuff "save-all flush^M"
sleep 10

tar --exclude='session.lock' -czf "$BACKUP_DIR/world.tar.gz" -C "$WORLD_PATH" .
tar -czf "$BACKUP_DIR/plugins.tar.gz" -C "$PLUGINS_PATH" .
cp server.properties spigot.yml paper-global.yml bukkit.yml "$BACKUP_DIR/" || true

rclone copy "$BACKUP_DIR/" "$RCLONE_REMOTE/" --progress
rclone check "$BACKUP_DIR/" "$RCLONE_REMOTE/" || { notify "バックアップ整合性NG"; exit 1; }

screen -S minecraft -p 0 -X stuff "save-on^M"
rm -rf "$BACKUP_DIR"
notify "バックアップ完了"

# /etc/my.cnf（MariaDB 10.6+ 例：現場で段階調整が前提）
[mysqld]
innodb_buffer_pool_size = 2G
innodb_log_file_size = 256M
innodb_log_buffer_size = 16M
innodb_flush_log_at_trx_commit = 2
innodb_file_per_table = 1
max_connections = 200
thread_cache_size = 64
table_open_cache = 2000
table_definition_cache = 1000
tmp_table_size = 128M
max_heap_table_size = 128M
slow_query_log = 1
long_query_time = 2
# 旧式のQuery Cacheは無効/検討（ワークロード次第）

# docker-compose.yml（最小構成例：値は環境で調整）
version: '3.8'
services:
  minecraft:
    image: eclipse-temurin:21-jre
    container_name: minecraft-server
    restart: unless-stopped
    ports: ["25565:25565"]
    volumes:
      - ./server:/opt/minecraft
    environment:
      - JAVA_OPTS=-Xmx8G -Xms8G -XX:+UseG1GC
    working_dir: /opt/minecraft
    command: sh -c "java ${JAVA_OPTS} -jar paper-1.21.x.jar nogui"