建築 島テーマ イベント対応手順書

#イベントマニュアル
https://docs.google.com/spreadsheets/d/1zhwx4iYCV5dIjrwJf0ObZMS1S76Cog4GtvBIbsL3Vh0/edit#gid=712205183

建築イベントは2種類ある
1.イベント期間中の達成度合いで、終了後の報酬が豪華な建物になる「建築イベント」
2.島の背景を変更できるobjectが報酬になる「島テーマイベント」
ここでは 2 について

#イベントの流れ

1.メインページ左側にある建築用モーダルに追加されているイベント情報の中から「イベント建築をする」を行う
*建築予約を1つ以上あけておく必要がある
->2.建築を開始したイベント建物が建築完了になるまで待つ
  *快速/特急時計を使用して建築時間を短縮することができる(快速で4時間、特急で6時間)
  ->3.建築リストから建築完了をタップして、イベント建物の建築が完了します。
  	*建築完了をタップしてはじめて、建築が完了したことになります。　問い合わせでちょこちょこきます
  	->4. 1 ~ 3 を繰り返してイベント建物のlvをあげていき、所定のlvになると報酬が配布されます。(レベルアップ報酬、または、早期ボーナス)
  	  ->5.イベント建物がlv40の建築予約を行った時点(現在では)で、報酬の建物が配布されるようになります。
  	    *[建物が配布]は通常のアイテムやカードとは異なりプレゼントには入らず、直接建物リストに反映されます。
  	    	(建築ページ -> 「建物リスト」 -> 「イベント建物」 タブへ)

*レベルアップ報酬について
イベント建物が所定lvになった(建築が完了した)際に、配布されます
BuildEventItemConfig.class.phpで設定

*早期ボーナスについて
所定期間内までにイベント建物が所定lvになった(建築が完了した)際に、配布されます
define_y.incで設定

**早期ボーナスの期間内で、必要lvがレベルアップ報酬と同じ場合(例:早期ボーナスの指定lv25/レベルアップ報酬の指定lv25)
現在は [レベルアップ報酬] と [早期ボーナス] どちらも取得できるようになっています

以前は [早期ボーナス] のみ取得
また、早期ボーナス期間外になると [レベルアップ報酬] のみ取得 です

*砂時計について
イベント期間中に使用した時計や秘宝(建築時間短縮のもの)で砂が溜まっていきMAX100%になると建築時間を短縮することができる
このときの短縮時間は砂時計のRankによって決まる。また、砂時計のRankは砂時計を使用した回数で上がっていく(初期 C -> B -> A になる)
砂のたまり方は時計の使用で+10%、秘宝の使用で+1%になる(現在の)
砂は海賊団に所属しているなら、アイテム使用時に他の団員にも砂が増え、他の団員がアイテムを使用した場合も自身の砂が増える

*スペシャル効果(SP,SP効果)について
内容は様々ですが、イベント開始～指定時間まで継続するものになります	
集金額を3倍、住民&集金額&アイテムを3倍、集金時にぱんだまやガチャチケットがでるようにするなどあります

これらの効果を得るためには所定の期間内にイベント建物のlvをMAX(lv40)の予約を行う必要があります
所定の期間外になった場合は報酬の建物はSP効果がないものになります。
また、集金時にぱんだまやガチャチケットがもらえるものはSP効果の期間中は取り壊しできないようになっています

#基本設定周り
	基本設定は define_y.inc G 895 ~ 1077

	1.開催日時、イベントタイプ(1:建築,2島テーマ) を更新 
	->$_df['event_area_time']['start'] 
	->$_df['event_area_time']['end']

	->$_df['event_build_type']

	2. $_df['event_build_type'] = 2 のときは
	その時の仕様でフラグ等を変更&更新していく
	# 基本
	$_df['event_build_no'] = 
	$_df['event_build_max_lv'] = 
	$_df['event_build_event_name'] = 
	$_df['event_build_name'] = 

	# 早期bonusの有無でそれぞれ更新
	if($_df['event_build_early_bonus_object']['flg'] == 1){
		##変更
	}else if($_df['event_build_early_bonus_object']['flg'] == 2){
		##変更
	}

	3.告知番号を各更新
		予告
		概要
		報酬 を更新

	 島テーマイベントでは結果発表はない

	4. 島テーマで配布する建物番号をいれる
	$_df['event_build_present'] = 

	5.レベルアップ報酬の更新
	BuildEventItemConfig.class.phpにlv毎に記載
	$this->_config[2] //島テーマ
	$this->_config[1] //建築
	$this->_config[2][35] -> 35は建築達成lv
	$_df['event_build_item'] にはいる

	// 追加で対応が必要な場合
	6. 本家と報酬建物のステータスを変えたい(島テーマでは報酬建物はないので修正不要s)
	tool_jrce_status.php を変更 & 修正する

#DB関連
	1. イベント建物の建築時間&必要GOLDを更新(仕様書に合わせて、修正対象はevent_build_no)
	 ・master_object_data
	 ・master_object_data_detail
	 ・master_object_data_lv
	2. 報酬建物で変更箇所がある場合も、上記3点の変更対応
	※DB確認用というシートがあるのでこちらを利用
	

#必要画像
	毎回追加するものはありません。
	が、建物によっては背景や建物の画像がなかったりします。

#テストスクリプト
	現在確認用に tool/event/test_build_event.php を使用。必要箇所あれば変更&編集をして実行

	/**
	 * 建築イベントの設定を確認
	 *
	 * dockerから実行
	 * $ cd /home/web/jr-web/tool/event/
	 * $ ENVIRONMENT=develop PF=yamada HTTP_HOST=127.0.0.1 IS_DOCKER=true php test_build_event.php
	 */

#SP建物効果の表示周り
　　　　　SP建物の効果をこちらで新しく作ることがあり、また、開催回ごとに特に変わる部分で注意が必要。
　　　　　集金時の効果を返納した場合はメインページ→集金だけでなく、建築→集金情報 のページも修正する必要があ理。
　　　　　特に建築ページでの各表示は個別のtemplateになっているため全部が修正されたかの確認が必要。

　　　　　建物について全てを確認する場合は以下全て確認する必要がある。
        - マイページ表示
　　　　　- 建築予約
　　　　　- 建築完了
　　　　　- 集金情報
　　　　　- 建物リスト
　　　　　- 取り壊し
        - 倉庫

-新SP建物作成時について
　　　　 既存建物のデータをコピー
                     IDを2万台で割り振り