🎮 EasyCTF v2.0

⚙️ 管理者ガイド

このガイドでは、EasyCTFサーバーの管理者向けに、プラグインのセットアップ、設定、運用方法について説明します。

🚀 初期セットアップ

1. インストール

1. 最新版の easy_ctf-1.0-SNAPSHOT-all.jar をダウンロード
2. サーバーの plugins フォルダに配置
3. サーバーを起動
4. 自動生成された設定ファイルを確認

2. 基本設定

初回起動時に以下のファイルが自動生成されます：

• plugins/EasyCTF/config.yml - メイン設定ファイル
• plugins/EasyCTF/lang_ja.yml - 日本語メッセージ
• plugins/EasyCTF/lang_en.yml - 英語メッセージ

3. 言語設定

🗺️ マップ作成ガイド

方法1: 自動検出方式（推奨）

必要なブロック配置

手順

1. マップエリアの角に立つ
2. /ctf setpos1 <ゲーム名> を実行
3. 対角の角に移動
4. /ctf setpos2 <ゲーム名> を実行
5. /ctf savemap <ゲーム名> を実行して自動検出

方法2: 対話形式

1. /ctf create <ゲーム名> を実行
2. チャットの指示に従って各位置を設定
3. 視線の先のブロックを見て set と入力
4. 全項目設定後、自動保存

対話形式のコマンド

• set - 現在の視線先を設定
• skip - 現在の項目をスキップ（デフォルト値使用）
• cancel - 作成をキャンセル

📁 設定ファイル詳細

config.yml 主要設定

ゲーム基本設定

default-game:
  min-players: 2              # 最小プレイヤー数
  max-players-per-team: 10    # チーム最大人数
  respawn-delay-base: 0       # リスポーン遅延（秒）
  respawn-delay-per-death: 0  # 追加遅延
  respawn-delay-max: 0        # 最大遅延
  force-pvp: true             # PvP強制有効化

フェーズ設定

default-phases:
  build-duration: 120         # 建築フェーズ（秒）
  combat-duration: 120        # 戦闘フェーズ（秒）
  result-duration: 15         # 結果表示（秒）
  build-phase-gamemode: "ADVENTURE"  # 建築時のゲームモード

通貨設定

currency:
  name: "G"                   # 通貨名
  initial: 50                 # 初期通貨
  phase-end-bonus: 100        # フェーズ終了ボーナス
  kill-reward: 15             # キル報酬
  kill-assist-reward: 10      # キルアシスト報酬
  carrier-kill-reward: 25     # 旗キャリアキル報酬
  carrier-kill-assist-reward: 10  # 旗キャリアキルアシスト
  capture-reward: 50          # キャプチャ報酬
  capture-assist-reward: 20   # キャプチャアシスト報酬

シールドシステム

shield:
  enabled: true               # シールド有効化
  max-shield: 100.0           # 最大シールド値
  recovery-rate: 5.0          # 回復速度（自陣のみ）
  damage-rate: 2.0            # 敵陣でのダメージ速度

🎮 ゲーム管理

ゲーム開始

単一ゲーム

マッチモード（複数ゲーム）

5ゲームのマッチを開始。最多勝利チームが優勝。

ゲーム停止

実行中のゲームまたはマッチを強制停止します。

ゲーム状態確認

現在のゲーム状態、プレイヤー、スコアを表示。

ゲーム削除

🛠️ トラブルシューティング

🔐 権限管理

権限の付与方法

※LuckPermsなどの権限管理プラグイン使用時

📊 パフォーマンス最適化

推奨設定

• メモリ割り当て: 最低4GB、推奨8GB以上
• 同時ゲーム数: サーバースペックに応じて制限
• ワールド管理: テンポラリワールドは自動削除される

負荷軽減のヒント

• 不要なプラグインを無効化
• 表示距離を適切に設定
• エンティティ数を制限
• 定期的にサーバーを再起動

📝 バックアップ

重要なファイル

• plugins/EasyCTF/games/ - ゲーム設定
• plugins/EasyCTF/maps/ - マップデータ
• plugins/EasyCTF/config.yml - メイン設定

⚙️ Administrator Guide

This guide explains the setup, configuration, and operation of the EasyCTF plugin for server administrators.

🚀 Initial Setup

1. Installation

1. Download the latest easy_ctf-1.0-SNAPSHOT-all.jar
2. Place in server's plugins folder
3. Start the server
4. Check auto-generated configuration files

2. Basic Configuration

The following files are auto-generated on first startup:

• plugins/EasyCTF/config.yml - Main configuration
• plugins/EasyCTF/lang_ja.yml - Japanese messages
• plugins/EasyCTF/lang_en.yml - English messages

3. Language Settings

🗺️ Map Creation Guide

Method 1: Auto-Detection (Recommended)

Required Block Placement

Steps

1. Stand at corner of map area
2. Execute /ctf setpos1
3. Move to opposite corner
4. Execute /ctf setpos2
5. Execute /ctf savemap for auto-detection

Method 2: Interactive Setup

1. Execute /ctf create
2. Follow chat instructions to set each position
3. Look at target block and type set
4. Auto-saves after all items configured

Interactive Commands

• set - Set current line of sight
• skip - Skip current item (use default)
• cancel - Cancel creation

📁 Configuration Details

config.yml Main Settings

Game Basic Settings

default-game:
  min-players: 2              # Minimum players
  max-players-per-team: 10    # Max team size
  respawn-delay-base: 0       # Respawn delay (seconds)
  respawn-delay-per-death: 0  # Additional delay
  respawn-delay-max: 0        # Maximum delay
  force-pvp: true             # Force PvP enabled

Phase Settings

default-phases:
  build-duration: 120         # Build phase (seconds)
  combat-duration: 120        # Combat phase (seconds)
  result-duration: 15         # Result display (seconds)
  build-phase-gamemode: "ADVENTURE"  # Build phase game mode

Currency Settings

currency:
  name: "G"                   # Currency name
  initial: 50                 # Initial currency
  phase-end-bonus: 100        # Phase end bonus
  kill-reward: 15             # Kill reward
  kill-assist-reward: 10      # Kill assist reward
  carrier-kill-reward: 25     # Flag carrier kill reward
  carrier-kill-assist-reward: 10  # Flag carrier kill assist
  capture-reward: 50          # Capture reward
  capture-assist-reward: 20   # Capture assist reward

Shield System

shield:
  enabled: true               # Enable shields
  max-shield: 100.0           # Maximum shield value
  recovery-rate: 5.0          # Recovery speed (own territory only)
  damage-rate: 2.0            # Damage rate in enemy territory

🎮 Game Management

Starting Games

Single Game

Match Mode (Multiple Games)

Starts a 5-game match. Team with most wins is champion.

Stopping Games

Force stops running game or match.

Checking Game Status

Shows current game state, players, and scores.

Deleting Games

🛠️ Troubleshooting

🔐 Permission Management

Granting Permissions

※When using permission plugins like LuckPerms

📊 Performance Optimization

Recommended Settings

• Memory Allocation: Minimum 4GB, recommended 8GB+
• Concurrent Games: Limit based on server specs
• World Management: Temporary worlds auto-delete

Load Reduction Tips

• Disable unnecessary plugins
• Set appropriate view distance
• Limit entity counts
• Regular server restarts

📝 Backups

Important Files

• plugins/EasyCTF/games/ - Game configurations
• plugins/EasyCTF/maps/ - Map data
• plugins/EasyCTF/config.yml - Main configuration