# 5分間の高精度CPUプロファイリング（2025年推奨設定）
/spark profiler –timeout 300 –thread “*”

# メモリ使用量の詳細調査
/spark heapdump

# 特定時間帯の継続監視（新機能）
/spark profiler –interval 1000 –timeout 1800

# サーバーヘルス情報の取得（TPS、CPU、メモリ統合）
/spark health

# Paper 2025年最適化設定
entities:
armor-stands:
do-collision-entity-lookups: false
tick: false
behavior:
baby-zombie-movement-modifier: 0.5
disable-chest-cat-detection: true
disable-player-crits: false
door-breaking-difficulty:
zombie: []
experience-merge-max-value: 100
mobs-can-always-pick-up-loot:
zombies: false
skeletons: false
nerf-pigmen-from-nether-portals: true
spawn-limits:
monster: 50
creature: 8
ambient: 15
axolotls: 3
underground_water_creature: 3
water_creature: 4
water_ambient: 8

chunks:
auto-save-interval: 6000
delay-chunk-unloads-by: 10s
entity-per-chunk-save-limit:
arrow: 8
ender_pearl: 8
fireball: 8
small_fireball: 8
snowball: 8
fixed-chunk-inhabited-time: -1
max-auto-save-chunks-per-tick: 4
prevent-moving-into-unloaded-chunks: true

collisions:
enable-player-collisions: true
send-full-pos-for-hard-colliding-entities: true

environment:
disable-explosion-knockback: false
disable-ice-and-snow: false
disable-teleportation-suffocation-check: false
disable-thunder: false
frosted-ice:
delay:
max: 80
min: 20
enabled: true
generate-flat-bedrock: false
nether-ceiling-void-damage-height: disabled
optimize-explosions: true
portal-create-radius: 16
portal-search-radius: 128
portal-search-vanilla-dimension-scaling: true
treasure-maps:
enabled: true
find-already-discovered:
loot-tables: default
villager-trade: false
water-over-lava-flow-speed: 5

hopper:
cooldown-when-full: true
disable-move-event: false
ignore-occluding-blocks: false

lootables:
auto-replenish: false
max-refills: -1
refresh-max: 2d
refresh-min: 12h
reset-seed-on-fill: true
restrict-player-reloot: true

maps:
item-frame-cursor-limit: 128
item-frame-cursor-update-interval: 10

max-growth-height:
bamboo:
max: 16
min: 11
cactus: 3
reeds: 3

misc:
disable-end-credits: false
disable-relative-projectile-velocity: false
disable-sprint-interruption-on-attack: false
light-queue-size: 20
max-leash-distance: 10.0
redstone-implementation: FAST
shield-blocking-delay: 5
show-sign-click-command-failure-msgs-to-player: false
update-pathfinding-on-block-update: true

scoreboards:
allow-non-player-entities-on-scoreboards: false
use-vanilla-world-scoreboard-name-coloring: false

spawn:
allow-using-signs-inside-spawn-protection: false
keep-spawn-loaded: true
keep-spawn-loaded-range: 8

tick-rates:
behavior:
villager:
validatenearbypoi: 60
acquirepoi: 120
container-update: 1
grass-spread: 4
mob-spawner: 2
sensor:
villager:
secondarypoisensor: 80
villagerbabiessensor: 40

# Spigot 2025年最適化設定
settings:
debug: false
save-user-cache-on-stop-only: false
moved-wrongly-threshold: 0.0625
moved-too-quickly-multiplier: 10.0
log-villager-deaths: true
log-named-deaths: true
timeout-time: 60
restart-on-crash: true
restart-script: ./start.sh
netty-threads: 4
attribute:
maxHealth:
max: 2048.0
movementSpeed:
max: 2048.0
attackDamage:
max: 2048.0

world-settings:
default:
verbose: false

# Mob Spawn Settings – 2025年推奨値
mob-spawn-range: 6
random-light-updates: true
save-structure-info: true

# Anti-Xray (2025年強化版)
anti-xray:
enabled: true
engine-mode: 2
max-block-height: 64
update-radius: 2
lava-obscures: false
use-permission: false
hidden-blocks:
– copper_ore
– deepslate_copper_ore
– gold_ore
– deepslate_gold_ore
– iron_ore
– deepslate_iron_ore
– coal_ore
– deepslate_coal_ore
– lapis_ore
– deepslate_lapis_ore
– mossy_cobblestone
– obsidian
– chest
– diamond_ore
– deepslate_diamond_ore
– redstone_ore
– deepslate_redstone_ore
– clay
– emerald_ore
– deepslate_emerald_ore
– ender_chest
replacement-blocks:
– stone
– oak_planks
– deepslate

# Entity Settings – 2025年最新調整
entity-activation-range:
animals: 16
monsters: 24
raiders: 40
misc: 8
water: 8
villagers: 16
flying-monsters: 24

# Ticks per Settings
entity-tracking-range:
players: 48
animals: 48
monsters: 48
misc: 32
other: 64

# Hopper Settings – 重要最適化
hopper-transfer: 8
hopper-check: 1
hopper-amount: 1
hopper-can-load-chunks: false

# Growth Settings
growth:
cactus-modifier: 25
cane-modifier: 25
melon-modifier: 25
mushroom-modifier: 25
pumpkin-modifier: 25
sapling-modifier: 25
beetroot-modifier: 25
carrot-modifier: 25
potato-modifier: 25
wheat-modifier: 25
netherwart-modifier: 25
vine-modifier: 25
cocoa-modifier: 25
bamboo-modifier: 25
sweetberry-modifier: 25
kelp-modifier: 25
twistingvines-modifier: 25
weepingvines-modifier: 25
cavevines-modifier: 25
glowberry-modifier: 25

# Merge Radius – アイテム統合最適化
merge-radius:
item: 4.0
exp: 6.0

# View Distance Settings
view-distance: default
simulation-distance: default

# Other optimizations
arrows-despawn-rate: 1200
trident-despawn-rate: 1200
zombie-aggressive-towards-villager: true
nerf-spawner-mobs: false
enable-zombie-pigmen-portal-spawns: true
wither-spawn-sound-radius: 0
hanging-tick-frequency: 100
item-despawn-rate: 6000
water-creatures-per-chunk: 2
monsters-per-chunk: 8

# 基本エンティティ制限（2025年最適値）
spawn-protection=16
max-players=50
online-mode=true
prevent-proxy-connections=false
server-ip=
server-port=25565
allow-nether=true
allow-flight=false
resource-pack=
sync-chunk-writes=true
enable-jmx-monitoring=false
enable-status=true
enable-command-block=false
entity-broadcast-range-percentage=100
function-permission-level=2
gamemode=survival
generate-structures=true
generator-settings={}
hardcore=false
level-name=world
level-seed=
level-type=minecraft\:normal
max-build-height=320
max-world-size=29999984
motd=A Minecraft Server
network-compression-threshold=256
op-permission-level=4
player-idle-timeout=0
pvp=true
query.enable=false
query.port=25565
rate-limit=0
rcon.enable=false
resource-pack-prompt=
resource-pack-sha1=
server-ip=
snooper-enabled=true
spawn-animals=true
spawn-monsters=true
spawn-npcs=true
view-distance=8
simulation-distance=8
white-list=false
enforce-whitelist=false

# 重要：エンティティ関連設定
difficulty=normal
spawn-protection=16
max-tick-time=60000

# 2025年新機能：負荷制限
max-chained-neighbor-updates=1000000

# 自動エンティティ管理スクリプト（Bash/Linux用）
#!/bin/bash

# エンティティ数監視と自動削除
check_entities() {
ENTITY_COUNT=$(rcon-cli “forge tps” | grep -o ‘[0-9]\+’ | head -n 1)

if [ “$ENTITY_COUNT” -gt 1000 ]; then
echo “High entity count detected: $ENTITY_COUNT”
rcon-cli “killall @e[type=!player,type=!armor_stand]”
echo “Entity cleanup completed”
fi
}

# 5分ごとに実行
while true; do
check_entities
sleep 300
done

# paper-world-defaults.yml – ホッパー最適化
hopper:
cooldown-when-full: true # フル時の処理停止
disable-move-event: false # moveイベント無効化
ignore-occluding-blocks: false # 遮蔽ブロック無視

# spigot.yml – 従来設定も重要
hopper-transfer: 8 # 転送間隔（tick）
hopper-check: 1 # チェック間隔
hopper-amount: 1 # 1回の転送量
hopper-can-load-chunks: false # チャンク読み込み無効

# スマートホッパー管理プラグイン設定例
# HopperOptimizer 2025.1版設定

smart-hopper:
enabled: true
max-hoppers-per-chunk: 8
auto-disable-when-full: true
batch-processing: true
batch-size: 64
processing-interval: 40 # 2秒間隔
priority-system:
– essential-farms
– storage-systems
– decoration-hoppers

#!/bin/bash
# 8GBメモリサーバー用 – Java 21最適化版

java -server \
-Xms8G -Xmx8G \
-XX:+UseG1GC \
-XX:+UnlockExperimentalVMOptions \
-XX:MaxGCPauseMillis=50 \
-XX:G1HeapRegionSize=32m \
-XX:G1NewSizePercent=40 \
-XX:G1MaxNewSizePercent=50 \
-XX:G1HeapWastePercent=5 \
-XX:G1MixedGCCountTarget=4 \
-XX:InitiatingHeapOccupancyPercent=15 \
-XX:G1MixedGCLiveThresholdPercent=90 \
-XX:G1RSetUpdatingPauseTimePercent=5 \
-XX:SurvivorRatio=32 \
-XX:+PerfDisableSharedMem \
-XX:MaxTenuringThreshold=1 \
-XX:+UseTransparentHugePages \
-XX:+AlwaysPreTouch \
-XX:+DisableExplicitGC \
-XX:-UseAdaptiveSizePolicy \
-XX:CompileThreshold=100 \
-XX:+UseFastUnorderedTimeStamps \
-Dusing.aikars.flags=https://mcflags.emc.gs \
-Daikars.new.flags=true \
-Dfile.encoding=UTF-8 \
-Djava.security.egd=file:/dev/urandom \
-Djava.awt.headless=true \
-jar paper-1.21.1-XXX.jar nogui

# 16GBメモリサーバー用 – 大規模サーバー対応

java -server \
-Xms16G -Xmx16G \
-XX:+UseZGC \
-XX:+UnlockExperimentalVMOptions \
-XX:+UseTransparentHugePages \
-XX:+AlwaysPreTouch \
-XX:+DisableExplicitGC \
-XX:+PerfDisableSharedMem \
-XX:CompileThreshold=100 \
-XX:+UseFastUnorderedTimeStamps \
-Dusing.aikars.flags=https://mcflags.emc.gs \
-Daikars.new.flags=true \
-Dfile.encoding=UTF-8 \
-Djava.security.egd=file:/dev/urandom \
-Djava.awt.headless=true \
-jar paper-1.21.1-XXX.jar nogui

# Prometheus + Grafana 設定例（Docker Compose）

version: ‘3.8’
services:
minecraft-exporter:
image: sladkoff/minecraft-prometheus-exporter:latest
ports:
– “9225:9225”
environment:
– MINECRAFT_SERVER=localhost:25565
– RCON_HOST=localhost
– RCON_PORT=25575
– RCON_PASSWORD=your_rcon_password
restart: unless-stopped

prometheus:
image: prom/prometheus:latest
ports:
– “9090:9090”
volumes:
– ./prometheus.yml:/etc/prometheus/prometheus.yml
restart: unless-stopped

grafana:
image: grafana/grafana:latest
ports:
– “3000:3000”
environment:
– GF_SECURITY_ADMIN_PASSWORD=admin
restart: unless-stopped

# prometheus.yml 設定
global:
scrape_interval: 15s

scrape_configs:
– job_name: ‘minecraft’
static_configs:
– targets: [‘minecraft-exporter:9225’]

# アラートスクリプト（Python 3.11対応）

import time
import requests
import subprocess
import json
from datetime import datetime

class MinecraftMonitor:
def __init__(self, server_host=”localhost”, rcon_port=25575, rcon_pass=”password”):
self.server_host = server_host
self.rcon_port = rcon_port
self.rcon_pass = rcon_pass
self.alert_history = []

def check_tps(self):
“””TPS監視（Sparkコマンド使用）”””
try:
result = subprocess.run([
‘mcrcon’, ‘-H’, self.server_host, ‘-P’, str(self.rcon_port),
‘-p’, self.rcon_pass, ‘spark tps’
], capture_output=True, text=True, timeout=10)

if result.returncode == 0:
# TPS値を抽出
tps_line = result.stdout.split(‘\n’)[0]
tps_value = float(tps_line.split()[2]) # “TPS: 19.85″ から19.85を抽出
return tps_value
except Exception as e:
print(f”TPS check failed: {e}”)
return None

def check_memory(self):
“””メモリ使用量監視”””
try:
result = subprocess.run([
‘mcrcon’, ‘-H’, self.server_host, ‘-P’, str(self.rcon_port),
‘-p’, self.rcon_pass, ‘spark health’
], capture_output=True, text=True, timeout=10)

if result.returncode == 0:
# メモリ使用率を抽出
for line in result.stdout.split(‘\n’):
if ‘Memory usage:’ in line:
memory_percent = float(line.split(‘%’)[0].split()[-1])
return memory_percent
except Exception as e:
print(f”Memory check failed: {e}”)
return None

def send_alert(self, message):
“””Discord Webhook経由でアラート送信”””
webhook_url = “YOUR_DISCORD_WEBHOOK_URL”

payload = {
“content”: f”⚠️ サーバーアラート: {message}”,
“username”: “Minecraft Monitor”,
“timestamp”: datetime.now().isoformat()
}

try:
response = requests.post(webhook_url, json=payload, timeout=5)
if response.status_code == 204:
print(f”Alert sent: {message}”)
except Exception as e:
print(f”Failed to send alert: {e}”)

def monitor_loop(self):
“””メイン監視ループ”””
print(“Minecraft monitoring started…”)

while True:
try:
# TPS監視
tps = self.check_tps()
if tps is not None:
if tps < 15.0: self.send_alert(f"低TPS検出: {tps:.2f} TPS") elif tps < 18.0: print(f"警告: TPS低下 ({tps:.2f})") # メモリ監視 memory_percent = self.check_memory() if memory_percent is not None: if memory_percent > 85.0:
self.send_alert(f”高メモリ使用率: {memory_percent:.1f}%”)
elif memory_percent > 75.0:
print(f”注意: メモリ使用率上昇 ({memory_percent:.1f}%)”)

time.sleep(60) # 1分間隔で監視

except KeyboardInterrupt:
print(“Monitoring stopped.”)
break
except Exception as e:
print(f”Monitor error: {e}”)
time.sleep(30)

# 実行
if __name__ == “__main__”:
monitor = MinecraftMonitor()
monitor.monitor_loop()

# 自動復旧スクリプト（Bash）

#!/bin/bash

LOG_FILE=”/var/log/minecraft-auto-recovery.log”
BACKUP_DIR=”/backup/minecraft”
SERVER_DIR=”/opt/minecraft”

log_message() {
echo “[$(date ‘+%Y-%m-%d %H:%M:%S’)] $1” | tee -a “$LOG_FILE”
}

emergency_recovery() {
log_message “🚨 緊急復旧プロセス開始”

# 1. 現在の状態をバックアップ
log_message “📦 緊急バックアップ作成中…”
tar -czf “$BACKUP_DIR/emergency-$(date +%s).tar.gz” -C “$SERVER_DIR” world world_nether world_the_end

# 2. サーバー停止
log_message “⏹️ サーバー停止中…”
screen -S minecraft -X stuff “stop\n”
sleep 30

# 3. 問題のあるチャンクファイル削除
log_message “🧹 問題チャンク削除中…”
find “$SERVER_DIR/world” -name “*.mca” -mtime -1 -size +50M -delete

# 4. エンティティデータクリア
log_message “👻 エンティティデータクリア中…”
find “$SERVER_DIR/world” -name “entities” -type d -exec rm -rf {} +

# 5. サーバー再起動
log_message “🔄 サーバー再起動中…”
cd “$SERVER_DIR”
screen -dmS minecraft java -jar paper.jar nogui

# 6. 復旧確認
sleep 60
TPS=$(mcrcon -H localhost -P 25575 -p password “spark tps” | grep -o ‘[0-9]\+\.[0-9]\+’ | head -n 1)

if (( $(echo “$TPS >= 18.0” | bc -l) )); then
log_message “✅ 復旧成功 – TPS: $TPS”
else
log_message “❌ 復旧失敗 – TPS: $TPS – 手動対応が必要”
fi
}

# メイン処理
if [ “$1” == “emergency” ]; then
emergency_recovery
else
echo “Usage: $0 emergency”
fi