Merge remote-tracking branch 'origin/devel' into compare/scenario-effects

test(compare): trace scenario action effects
test: isolate S100 inheritance browser logs
2026-07-30 18:38:44 +00:00 · 2026-07-30 18:38:35 +00:00 · 2026-07-29 08:51:51 +00:00 · 2026-07-29 08:42:38 +00:00 · 2026-07-29 07:29:43 +00:00 · 2026-07-29 06:36:33 +00:00
772 changed files with 168239 additions and 16133 deletions
@@ -1,15 +0,0 @@
 {
    "presets": [
        [
            "@babel/preset-env",
            {
                "useBuiltIns": "usage",
                "corejs": 3,
                "modules": false
            }
        ]
    ],
    "plugins": [
        "lodash"
    ]
 }
@@ -10,8 +10,10 @@
 *.log
 logs/*.txt
 api_log.db
 d_log/*.txt
 d_log/*.zip
 d_log/*.db
 sess_*
 */logs/*.txt
 */logs/*/*.txt
@@ -27,6 +29,7 @@ d_pic/*.jpg
 d_pic/*.gif
 d_pic/*.png
 d_pic/*.webp
 d_pic/*.avif
 d_pic/uploaded_image
 /dist_js
@@ -65,3 +68,7 @@ ingame/js/*
 ingame/css/*
 gateway/js/*
 gateway/css/*
 *.db-journal
 d_log/cachegrind.*
@@ -15,9 +15,8 @@ return [
    // Note that the **only** effect of choosing `'5.6'` is to infer
    // that functions removed in php 7.0 exist.
    // (See `backward_compatibility_checks` for additional options)
-    "target_php_version" => '8.1',
+    "target_php_version" => '8.2',
-    "minimum_target_php_version" => '8.1',
+    "minimum_target_php_version" => '8.2',
    'backward_compatibility_checks ' => true,
    'minimum_severity' => \Phan\Issue::SEVERITY_NORMAL,
    'file_list' => [
@@ -29,8 +28,6 @@ return [
        'hwe/_admin1_submit.php',
        'hwe/_admin2.php',
        'hwe/_admin2_submit.php',
        'hwe/_admin4.php',
        'hwe/_admin4_submit.php',
        'hwe/_admin5.php',
        'hwe/_admin5_submit.php',
        'hwe/_admin7.php',
@@ -98,12 +95,6 @@ return [
        'hwe/j_load_scenarios.php',
        'hwe/j_map.php',
        'hwe/j_map_recent.php',
        'hwe/j_msg_contact_list.php',
        'hwe/j_msg_decide_opt.php',
        'hwe/j_msg_delete.php',
        'hwe/j_msg_get_old.php',
        'hwe/j_msg_get_recent.php',
        'hwe/j_msg_submit.php',
        'hwe/j_myBossInfo.php',
        'hwe/j_raise_event.php',
        'hwe/j_select_npc.php',
@@ -112,7 +103,6 @@ return [
        'hwe/j_set_my_setting.php',
        'hwe/j_set_npc_control.php',
        'hwe/j_simulate_battle.php',
        'hwe/j_troop.php',
        'hwe/j_update_picked_general.php',
        'hwe/j_vacation.php',
        'hwe/lib.php',
@@ -29,5 +29,5 @@
        "josa",
        "sammo"
    ],
-    "editor.tabSize": 2
+    "editor.tabSize": 4
 }
@@ -2,6 +2,7 @@
 <html>
    <head>
        <meta charset="utf-8">
        <meta name="color-scheme" content="dark">
        <title>닫혀 있습니다.</title>
        <script>
            setTimeout(function(){
@@ -1,6 +1,6 @@
 The MIT License
-Copyright (c) 2022 Hide_D, 62che
+Copyright (c) 2023 Hide_D, 62che
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -8,26 +8,25 @@
    ],
    "config": {
        "platform": {
-            "php": "8.1"
+            "php": "8.3"
        }
    },
    "require": {
-        "brandonwamboldt/utilphp": "^1.1",
+        "sergeytsalkov/meekrodb": "^2.5",
-        "sergeytsalkov/meekrodb": "^2.3",
+        "league/plates": "^3.5",
        "league/plates": "^3.3",
        "vlucas/valitron": "^1.4",
-        "php-extended/php-tail": "^2.1",
+        "php-extended/php-tail": "^5.0",
-        "pguardiario/phpuri": "^1.0",
+        "symfony/lock": "^6.2",
        "symfony/lock": "^6.0",
        "ezyang/htmlpurifier": "^4.10",
        "xemlock/htmlpurifier-html5": "^0.1.7",
        "catfan/medoo": "^2.1",
-        "phan/phan": "^5.3",
+        "phan/phan": "^5.4",
-        "nette/caching": "^3.0",
+        "nette/caching": "^3.3",
-        "illuminate/database": "^9.12",
+        "illuminate/database": "^10.0",
-        "illuminate/events": "^9.12",
+        "illuminate/events": "^10.0",
-        "spatie/data-transfer-object": "^3.7",
+        "php-ds/php-ds": "^1.5",
-        "php-ds/php-ds": "^1.4"
+        "hided62/ldto": "^1.0",
        "league/uri": "^6.8"
    },
    "autoload": {
        "psr-4": {
@@ -48,6 +47,6 @@
        ]
    },
    "require-dev": {
-        "phpunit/phpunit": "^9.5"
+        "phpunit/phpunit": "^10.0"
    }
 }
@@ -99,7 +99,10 @@ function logError(string $err, string $errstr, string $errpath, array $trace)
    $err = str_replace(ROOT, '{ROOT}', $err);
    $errstr = str_replace(ROOT, '{ROOT}', $errstr);
    $errpath = str_replace(ROOT, '{ROOT}', $errpath);
-    $trace = array_map(function (string $text) {
+    $trace = array_map(function (string|array $text) {
        if (is_array($text)) {
            $text = Json::encode($text);
        }
        return str_replace(ROOT, '{ROOT}', $text);
    }, $trace);
@@ -10,6 +10,7 @@ require(__DIR__ . '/../vendor/autoload.php');
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>설치</title>
@@ -29,10 +30,10 @@ require(__DIR__ . '/../vendor/autoload.php');
 <body>
    <div class="container">
-        <h1 class="row justify-content-md-center">삼국지 모의전투 HiDCHe 설치</h1>
+        <h1 class="row justify-content-lg-center">삼국지 모의전투 HiDCHe 설치</h1>
-        <div class="row justify-content-md-center">
+        <div class="row justify-content-lg-center">
-            <div class="col col-12 col-md-10 col-lg-7">
+            <div class="col col-12 col-lg-10 col-lg-7">
                <div class="card" id="db_form_card" style="display:none">
                    <h3 class="card-header">
                        설치(DB 설정)
@@ -56,7 +56,7 @@ $rootDB->insert('member', [
    'token_valid_until' => '2999-01-01 00:00:00',
    'pw' => $finalPassword,
    'salt' => $userSalt,
-    'grade' => 6,
+    'grade' => 7,
    'name' => $nickname,
    'reg_date' => $nowDate
 ]);
@@ -17,18 +17,11 @@ if (!class_exists('\\sammo\\RootDB')) {
 $rootDB = RootDB::db();
-$rootDB->throw_exception_on_nonsql_error = false;
+$rootDB->addHook('run_failed', function ($params) {
 $rootDB->nonsql_error_handler = function ($params) {
    Json::die([
        'step' => 'conn_fail'
    ]);
 };
 $rootDB->error_handler = function ($params) {
    Json::die([
        'step' => 'sql_fail'
    ]);
-};
+});
 $memberCnt = $rootDB->queryFirstField('SELECT count(`NO`) from member');
 if ($memberCnt == 0) {
@@ -90,19 +90,19 @@ if (
    //기본 파일 생성
    if (!file_exists(AppConf::getUserIconPathFS())) {
-        mkdir(AppConf::getUserIconPathFS());
+        mkdir(AppConf::getUserIconPathFS(), 0775);
    }
    if (!file_exists(ROOT . '/d_log')) {
-        mkdir(ROOT . '/d_log');
+        mkdir(ROOT . '/d_log', 0775);
    }
    if (!file_exists(ROOT . '/d_setting')) {
-        mkdir(ROOT . '/d_setting');
+        mkdir(ROOT . '/d_setting', 0775);
    }
    if (!file_exists(ROOT . '/d_shared')) {
-        mkdir(ROOT . '/d_shared');
+        mkdir(ROOT . '/d_shared', 0775);
    }
 }
@@ -150,20 +150,12 @@ if (!file_exists(ROOT . '/d_setting/.htaccess')) {
 $rootDB = new \MeekroDB($host, $username, $password, $dbName, $port, 'utf8mb4');
 $rootDB->connect_options[MYSQLI_OPT_INT_AND_FLOAT_NATIVE] = true;
-$rootDB->throw_exception_on_nonsql_error = false;
+$rootDB->addHook('run_failed', function ($args) {
 $rootDB->nonsql_error_handler = function ($params) {
    Json::die([
        'result' => false,
-        'reason' => 'DB 접속에 실패했습니다.'
+        'reason' => '에러.'. $args['error']
    ]);
-};
+});
 $rootDB->error_handler = function ($params) {
    Json::die([
        'result' => false,
        'reason' => 'SQL을 제대로 실행하지 못했습니다. DB상태를 확인해 주세요.'
    ]);
 };
 $mysqli_obj = $rootDB->get(); //로그인에 실패할 경우 자동으로 dbConnFail()이 실행됨.
@@ -0,0 +1,17 @@
 CREATE TABLE IF NOT EXISTS "api_log" (
 	"id"	INTEGER NOT NULL,
 	"user_id"	INTEGER NOT NULL,
 	"ip"	TEXT NOT NULL,
 	"date"	TEXT NOT NULL,
 	"path"	TEXT NOT NULL,
 	"arg"	TEXT,
 	"aux"	TEXT,
 	PRIMARY KEY("id" AUTOINCREMENT)
 );
 CREATE INDEX IF NOT EXISTS "by_date" ON "api_log" (
 	"date"	DESC
 );
 CREATE INDEX IF NOT EXISTS "by_user" ON "api_log" (
 	"user_id"	ASC,
 	"date"	DESC
 );
@@ -92,4 +92,14 @@ CREATE TABLE `login_token` (
 	INDEX `by_date` (`user_id`, `expire_date`)
 )
 COLLATE='utf8mb4_general_ci'
-ENGINE=Aria;
+ENGINE=Aria;
 CREATE TABLE `banned_member` (
 	`no` INT NOT NULL AUTO_INCREMENT,
 	`hashed_email` VARCHAR(128) NOT NULL COLLATE 'utf8mb4_general_ci' COMMENT 'SHA512(salt | email | salt )',
 	`info` TEXT NULL COLLATE 'utf8mb4_general_ci' COMMENT '부가정보',
 	PRIMARY KEY (`no`),
 	UNIQUE INDEX `email` (`hashed_email`(128))
 )
 COLLATE='utf8mb4_general_ci'
 ENGINE = Aria;
@@ -61,11 +61,6 @@ class RootDB
        if (self::$uDB === null) {
            self::$uDB = new \MeekroDB(self::$host, self::$user, self::$password, self::$dbName, self::$port, self::$encoding);
            self::$uDB->connect_options[MYSQLI_OPT_INT_AND_FLOAT_NATIVE] = true;
            self::$uDB->error_handler = function () {
            };
            self::$uDB->throw_exception_on_error = true;
            self::$uDB->throw_exception_on_nonsql_error = true;
        }
        return self::$uDB;
    }
@@ -165,3 +165,61 @@
    background: url('_tK_gameImagePath_/map/pokemon_v1/back_pal8.png') no-repeat;
    background-size: 700px 500px;
 }
 /*CR 지도*/
 .map_theme_cr .map_bglayer1{
    background: url('_tK_gameImagePath_/map/cr/bg-fs8.png') no-repeat;
    background-size: 700px 500px;
 }
 .map_theme_cr.map_detail .city_base .city_bg {
    background-image: none !important;
    width: 39.5px !important;
    height: 39.5px !important;
    left: 1px !important;
    top: -4px !important;
    opacity: 0.5;
 }
 .map_theme_cr.map_detail.small_width_map .city_base .city_bg {
    background-image: none !important;
    width: 28.5px !important;
    height: 28.5px !important;
    left: 6px !important;
    top: 4px !important;
    opacity: 0.5;
 }
 .map_theme_cr.map_detail .city_bg.bFF0000 { background-color: #FF0000; }
 .map_theme_cr.map_detail .city_bg.b800000 { background-color: #800000; }
 .map_theme_cr.map_detail .city_bg.bA0522D { background-color: #A0522D; }
 .map_theme_cr.map_detail .city_bg.bFF6347 { background-color: #FF6347; }
 .map_theme_cr.map_detail .city_bg.bFFA500 { background-color: #FFA500; }
 .map_theme_cr.map_detail .city_bg.bFFDAB9 { background-color: #FFDAB9; }
 .map_theme_cr.map_detail .city_bg.bFFD700 { background-color: #FFD700; }
 .map_theme_cr.map_detail .city_bg.bFFFF00 { background-color: #FFFF00; }
 .map_theme_cr.map_detail .city_bg.b7CFC00 { background-color: #7CFC00; }
 .map_theme_cr.map_detail .city_bg.b00FF00 { background-color: #00FF00; }
 .map_theme_cr.map_detail .city_bg.b808000 { background-color: #808000; }
 .map_theme_cr.map_detail .city_bg.b008000 { background-color: #008000; }
 .map_theme_cr.map_detail .city_bg.b2E8B57 { background-color: #2E8B57; }
 .map_theme_cr.map_detail .city_bg.b008080 { background-color: #008080; }
 .map_theme_cr.map_detail .city_bg.b20B2AA { background-color: #20B2AA; }
 .map_theme_cr.map_detail .city_bg.b6495ED { background-color: #6495ED; }
 .map_theme_cr.map_detail .city_bg.b7FFFD4 { background-color: #7FFFD4; }
 .map_theme_cr.map_detail .city_bg.bAFEEEE { background-color: #AFEEEE; }
 .map_theme_cr.map_detail .city_bg.b87CEEB { background-color: #87CEEB; }
 .map_theme_cr.map_detail .city_bg.b00FFFF { background-color: #00FFFF; }
 .map_theme_cr.map_detail .city_bg.b00BFFF { background-color: #00BFFF; }
 .map_theme_cr.map_detail .city_bg.b0000FF { background-color: #0000FF; }
 .map_theme_cr.map_detail .city_bg.b000080 { background-color: #000080; }
 .map_theme_cr.map_detail .city_bg.b483D8B { background-color: #483D8B; }
 .map_theme_cr.map_detail .city_bg.b7B68EE { background-color: #7B68EE; }
 .map_theme_cr.map_detail .city_bg.bBA55D3 { background-color: #BA55D3; }
 .map_theme_cr.map_detail .city_bg.b800080 { background-color: #800080; }
 .map_theme_cr.map_detail .city_bg.bFF00FF { background-color: #FF00FF; }
 .map_theme_cr.map_detail .city_bg.bFFC0CB { background-color: #FFC0CB; }
 .map_theme_cr.map_detail .city_bg.bF5F5DC { background-color: #F5F5DC; }
 .map_theme_cr.map_detail .city_bg.bE0FFFF { background-color: #E0FFFF; }
 .map_theme_cr.map_detail .city_bg.bFFFFFF { background-color: #FFFFFF; }
 .map_theme_cr.map_detail .city_bg.bA9A9A9 { background-color: #A9A9A9; }
@@ -21,6 +21,7 @@ $plock = $db->queryFirstField('SELECT plock FROM plock WHERE `type` ="GAME"');
 <head>
 <title>삼국지 모의전투 HiDCHe</title>
 <meta charset="UTF-8">
 <meta name="color-scheme" content="dark">
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
 <meta name="viewport" content="width=1024" />
 <?=WebUtil::printCSS('../d_shared/common.css')?>
@@ -6,7 +6,7 @@ include "func.php";
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
-if($session->userGrade < 5) {
+if($session->userGrade < 6) {
    die(requireAdminPermissionHTML());
 }
@@ -19,6 +19,7 @@ $admin = getAdmin();
 <head>
 <title>게임관리</title>
 <meta charset="UTF-8">
 <meta name="color-scheme" content="dark">
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
 <meta name="viewport" content="width=1024" />
 <?=WebUtil::printCSS('../d_shared/common.css')?>
@@ -40,8 +41,6 @@ $admin = getAdmin();
    <tr>
        <td width=110 align=right>시작시간변경</td>
        <td width=285><input type=text size=20 maxlength=20 style=color:white;background-color:black;text-align:right; name=starttime value='<?=substr($admin['starttime'], 0, 19)?>'><input type=submit name=btn value=변경1></td>
        <td width=110 align=right>현재도시훈사</td>
        <td width=285><?=$admin['city_rate']?></td>
    </tr>
    <tr>
        <td width=110 align=right>최대 장수</td>
@@ -6,7 +6,7 @@ include "func.php";
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
-if ($session->userGrade < 5) {
+if ($session->userGrade < 6) {
    header('location:_admin1.php');
    die();
 }
@@ -74,28 +74,7 @@ switch ($btn) {
        case "120분턴": $turnterm = 120; break;
        default: throw new \Exception("알 수 없는 턴 기간");
        }
-        $oldunit = $admin['turnterm'] * 60;
+        ServerTool::changeServerTerm($turnterm);
        $unit = $turnterm * 60;
        $unitDiff = $unit / $oldunit;
        $servTurnTime = new \DateTimeImmutable($admin['turntime']);
        foreach ($db->query('SELECT no,turntime FROM general') as $gen) {
            $genTurnTime = new \DateTimeImmutable($gen['turntime']);
            $timeDiff = TimeUtil::DateIntervalToSeconds($genTurnTime->diff($servTurnTime));
            $timeDiff *= $unitDiff;
            $newGenTurnTime = $servTurnTime->add(TimeUtil::secondsToDateInterval($timeDiff));
            $db->update('general', [
                'turntime'=>$newGenTurnTime->format('Y-m-d H:i:s.u')
            ], 'no=%i', $gen['no']);
        }
        $turn = ($admin['year'] - $admin['startyear']) * 12 + $admin['month'] - 1;
        $starttime = $servTurnTime->sub(TimeUtil::secondsToDateInterval($turn * $unit))->format('Y-m-d H:i:s');
        $starttime = cutTurn($starttime, $turnterm, false);
        $gameStor->turnterm = $turnterm;
        $gameStor->starttime = $starttime;
        pushGlobalHistoryLog(["<R>★</>턴시간이 <C>$btn</>으로 변경됩니다."]);
        break;
 }
@@ -7,7 +7,7 @@ include "func.php";
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
-if ($session->userGrade < 5) {
+if ($session->userGrade < 6) {
    die(requireAdminPermissionHTML());
 }
@@ -20,6 +20,7 @@ $db = DB::db();
 <head>
    <title>회원관리</title>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <?= WebUtil::printCSS('../d_shared/common.css') ?>
@@ -2,6 +2,8 @@
 namespace sammo;
 use sammo\Enums\MessageType;
 include "lib.php";
 include "func.php";
@@ -13,7 +15,7 @@ $msg = Util::getPost('msg', 'string');
 //로그인 검사
 $session = Session::requireLogin()->loginGame()->setReadOnly();
-if ($session->userGrade < 5) {
+if ($session->userGrade < 6) {
    header('location:_admin2.php');
 }
@@ -31,18 +33,18 @@ $src = MessageTarget::buildQuick($session->generalID);
 $genObjList = [];
 $env = [];
 if ($genlist) {
-    $genObjList = General::createGeneralObjListFromDB($genlist);
+    $genObjList = General::createObjListFromDB($genlist);
    $env = $gameStor->cacheAll();
 }
 switch ($btn) {
    case "전체 접속허용":
-        $db->update('general', [
+        $db->update('general_access_log', [
-            'con' => 0
+            'refresh_score' => 0
        ], true);
        break;
    case "전체 접속제한":
-        $db->update('general', [
+        $db->update('general_access_log', [
-            'con' => 1000
+            'refresh_score' => 1000
        ], true);
        break;
    case "블럭 해제":
@@ -111,7 +113,7 @@ switch ($btn) {
    case "경험치1000":
        $text = $btn . " 지급!";
        foreach ($genlist as $generalID) {
-            $msg = new Message(Message::MSGTYPE_PRIVATE, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
+            $msg = new Message(MessageType::private, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
            $msg->send(true);
        }
        $db->update('general', [
@@ -122,7 +124,7 @@ switch ($btn) {
    case "공헌치1000":
        $text = $btn . " 지급!";
        foreach ($genlist as $generalID) {
-            $msg = new Message(Message::MSGTYPE_PRIVATE, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
+            $msg = new Message(MessageType::private, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
            $msg->send(true);
        }
        $db->update('general', [
@@ -133,7 +135,7 @@ switch ($btn) {
    case "보숙10000":
        $text = "보병숙련도+10000 지급!";
        foreach ($genlist as $generalID) {
-            $msg = new Message(Message::MSGTYPE_PRIVATE, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
+            $msg = new Message(MessageType::private, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
            $msg->send(true);
        }
        $db->update('general', [
@@ -143,7 +145,7 @@ switch ($btn) {
    case "궁숙10000":
        $text = "궁병숙련도+10000 지급!";
        foreach ($genlist as $generalID) {
-            $msg = new Message(Message::MSGTYPE_PRIVATE, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
+            $msg = new Message(MessageType::private, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
            $msg->send(true);
        }
        $db->update('general', [
@@ -154,7 +156,7 @@ switch ($btn) {
        $src = MessageTarget::buildQuick($session->generalID);
        $text = "기병숙련도+10000 지급!";
        foreach ($genlist as $generalID) {
-            $msg = new Message(Message::MSGTYPE_PRIVATE, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
+            $msg = new Message(MessageType::private, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
            $msg->send(true);
        }
        $db->update('general', [
@@ -165,7 +167,7 @@ switch ($btn) {
        $src = MessageTarget::buildQuick($session->generalID);
        $text = "귀병숙련도+10000 지급!";
        foreach ($genlist as $generalID) {
-            $msg = new Message(Message::MSGTYPE_PRIVATE, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
+            $msg = new Message(MessageType::private, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
            $msg->send(true);
        }
        $db->update('general', [
@@ -176,7 +178,7 @@ switch ($btn) {
        $src = MessageTarget::buildQuick($session->generalID);
        $text = "차병숙련도+10000 지급!";
        foreach ($genlist as $generalID) {
-            $msg = new Message(Message::MSGTYPE_PRIVATE, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
+            $msg = new Message(MessageType::private, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
            $msg->send(true);
        }
        $db->update('general', [
@@ -184,19 +186,19 @@ switch ($btn) {
        ], '`no` IN %li', $genlist);
        break;
    case "접속 허용":
-        $db->update('general', [
+        $db->update('general_access_log', [
-            'con' => 0
+            'refresh_score' => 0
-        ], '`no` IN %li', $genlist);
+        ], '`general_id` IN %li', $genlist);
        break;
    case "접속 제한":
-        $db->update('general', [
+        $db->update('general_access_log', [
-            'con' => 1000
+            'refresh_score' => 1000
-        ], '`no` IN %li', $genlist);
+        ], '`general_id` IN %li', $genlist);
        break;
    case "메세지 전달":
        $text = $msg ?? '';
        foreach ($genlist as $generalID) {
-            $msg = new Message(Message::MSGTYPE_PRIVATE, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
+            $msg = new Message(MessageType::private, $src, MessageTarget::buildQuick($generalID), $text, new \DateTime(), new \DateTime('9999-12-31'), []);
            $msg->send(true);
        }
        break;
@@ -1,132 +0,0 @@
 <?php
 namespace sammo;
 include "lib.php";
 include "func.php";
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
 if ($session->userGrade < 5) {
    die(requireAdminPermissionHTML());
 }
 $db = DB::db();
 $gameStor = KVStorage::getStorage($db, 'game_env');
 $conlimit = $gameStor->conlimit;
 $ipGroupList = Util::arrayGroupBy(
    $db->query(
        'SELECT name,ip,lastconnect,owner,block,substring_index(ip,".",3) as ip_c from general WHERE ip!="" and npc<2'
    ),
    'ip_c'
 );
 function colorBlockedName($general)
 {
    if (!$general['blocked']) {
        return $general['name'];
    }
    return "<span style='color:magenta;'>{$general['name']}</span>";
 }
 ?>
 <!DOCTYPE html>
 <html>
 <head>
    <title>멀티관리</title>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <?= WebUtil::printCSS('../d_shared/common.css') ?>
    <?= WebUtil::printDist('ts', 'common', true) ?>
    <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard/dist/web/static/pretendard.css" />
 </head>
 <body>
    <table align=center width=1000 class='tb_layout bg0'>
        <tr>
            <td>멀 티 관 리<br><?= backButton() ?></td>
        </tr>
    </table>
    <form name=form1 method=post action=_admin4_submit.php>
        <table align=center width=1000 class='tb_layout bg0'>
            <tr>
                <td width=80 align=center rowspan=3>회원선택<br><br>
                    <font color=cyan>NPC</font><br>
                    <font color=skyblue>NPC유저</font><br>
                    <font color=red>접속제한</font><br><b style=background-color:red;>블럭회원</b>
                </td>
                <td width=105 rowspan=3>
                    <?php
                    echo "
            <select name=genlist[] size=20 multiple style='color:white;background-color:black;font-size:14px'>";
                    foreach ($db->query('SELECT no,name,npc,block,con from general where ip!=\'\' order by npc,ip') as $general) {
                        $style = "style=;";
                        if ($general['block']         > 0) {
                            $style .= "background-color:red;";
                        }
                        $npcColor = getNPCColor($general['npc']);
                        if($npcColor !== null){
                            $style .= "color:{$npcColor};";
                        }
                        echo "
                <option value={$general['no']} $style>{$general['name']}</option>";
                    }
                    echo "
            </select>";
                    ?>
                </td>
                <td width=100 align=center>블럭</td>
                <td width=504>
                    <input type=submit name=btn value='블럭 해제'><input type=submit name=btn value='1단계 블럭'><input type=submit name=btn value='2단계 블럭'><input type=submit name=btn value='3단계 블럭'><input type=submit name=btn value='무한삭턴'><br>
                    1단계:발언권, 2단계:턴블럭
                </td>
            </tr>
            <tr>
                <td align=center>강제 사망</td>
                <td><input type=submit name=btn value='강제 사망'></td>
            </tr>
            <tr>
                <td align=center>메세지 전달</td>
                <td><input type=textarea size=60 maxlength=255 name=msg style=background-color:black;color:white;><input type=submit name=btn value='메세지 전달'></td>
            </tr>
        </table>
        <table align=center width=1000 class='tb_layout bg0'>
            <tr>
                <td align=center width=100>장수명</td>
                <td align=center width=180>최근로그인</td>
                <td align=center width=129>IP</td>
                <td align=center width=100>ID</td>
            </tr>
            <?php foreach ($ipGroupList as $ipGroupC => $users) : ?>
                <tr>
                    <td><?= join('<br>', array_map('\sammo\colorBlockedName', $users)) ?></td>
                    <td><?= join('<br>', array_column($users, 'lastconnect')) ?></td>
                    <td><?= join('<br>', array_column($users, 'ip')) ?></td>
                    <td><?= join('<br>', array_column($users, 'owner')) ?></td>
                </tr>
            <?php endforeach; ?>
        </table>
        <?php
        //NOTE: password의 md5 해시가 같은지 확인하는 방식으로는 앞으로 잡아낼 수 없다. 폐기
        ?>
    </form>
    <table align=center width=1000 class='tb_layout bg0'>
        <tr>
            <td><?= backButton() ?></td>
        </tr>
        <tr>
            <td><?= banner() ?> </td>
        </tr>
    </table>
 </body>
 </html>
@@ -1,84 +0,0 @@
 <?php
 namespace sammo;
 include "lib.php";
 include "func.php";
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
 if ($session->userGrade < 5) {
    header('location:_admin4.php');
    die();
 }
 $btn = Util::getPost('btn');
 $genlist = Util::getPost('genlist', 'array_int');
 $msg = Util::getPost('msg', 'string', '메시지');
 $db = DB::db();
 //NOTE: 왜 기능이 admin2와 admin4가 같이 있는가? 
 //NOTE: 왜 블럭 시 admin4에선 금쌀을 없애지 않는가?
 switch ($btn) {
    case "블럭 해제":
        DB::db()->query('update general set block=0 where no IN %li', $genlist);
        break;
    case "1단계 블럭":
        $date = TimeUtil::now();
        $db = DB::db();
        $db->query('update general set block=1,killturn=24 where no IN %li', $genlist);
        //FIXME: subquery로 하는게 더 빠를 듯.
        $uid = $db->queryFirstColumn('select owner from general where no IN %li', $genlist);
        RootDB::db()->query('update member set block_num=block_num+1,block_date=%s where id IN %ls', $date, $uid);
        break;
    case "2단계 블럭":
        $date = TimeUtil::now();
        $db = DB::db();
        $db->query('update general set block=2,killturn=24 where no IN %li', $genlist);
        $uid = $db->queryFirstColumn('select owner from general where no IN %li', $genlist);
        RootDB::db()->query('update member set block_num=block_num+1,block_date=%s where id IN %ls', $date, $uid);
        break;
    case "3단계 블럭":
        $date = TimeUtil::now();
        $db = DB::db();
        $db->query('update general set block=3,killturn=24 where no IN %li', $genlist);
        $uid = $db->queryFirstColumn('select owner from general where no IN %li', $genlist);
        RootDB::db()->query('update member set block_num=block_num+1,block_date=%s where id IN %ls', $date, $uid);
        break;
    case "무한삭턴":
        DB::db()->query('update general set killturn=8000 where no IN %li', $genlist);
        break;
    case "강제 사망":
        $date = TimeUtil::now(true);
        $db->update('general', [
            'killturn' => 0,
            'turntime' => $date,
        ], '`no` IN %li', $genlist);
        $db->update('general_turn', [
            'action' => '휴식',
            'arg' => '{}',
            'brief' => '휴식'
        ], 'general_id IN %li AND turn_idx = 0', $genlist);
        break;
    case "메세지 전달":
        $date = TimeUtil::now();
        $src = MessageTarget::buildQuick($session->generalID);
        foreach($genlist as $generalID){
            $msgObj = new Message(
                Message::MSGTYPE_PRIVATE,
                $src,
                MessageTarget::buildQuick($generalID),
                $msg,
                new \DateTime(),
                new \DateTime('9999-12-31'),
                []
            );
            if ($msgObj) {
                $msgObj->send(true);
            }
        }
        break;
 }
 header('location:_admin4.php');
@@ -20,7 +20,7 @@ if ($type2 < 0 || $type2 > 6) {
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
-if ($session->userGrade < 5) {
+if ($session->userGrade < 6) {
    die(requireAdminPermissionHTML());
 }
@@ -38,6 +38,7 @@ $sel2[$type2] = "selected";
 <head>
    <title>일제정보</title>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <?= WebUtil::printCSS('../d_shared/common.css') ?>
@@ -65,8 +66,6 @@ $sel2[$type2] = "selected";
                        <option <?= $sel[8] ?? '' ?> value=8>평무</option>
                        <option <?= $sel[9] ?? '' ?> value=9>평지</option>
                        <option <?= $sel[10] ?? '' ?> value=10>평Lv</option>
                        <option <?= $sel[11] ?? '' ?> value=11>접속률</option>
                        <option <?= $sel[12] ?? '' ?> value=12>단기접</option>
                        <option <?= $sel[13] ?? '' ?> value=13>보숙</option>
                        <option <?= $sel[14] ?? '' ?> value=14>궁숙</option>
                        <option <?= $sel[15] ?? '' ?> value=15>기숙</option>
@@ -104,8 +103,6 @@ $sel2[$type2] = "selected";
    <table align=center width=1600 class="tb_layout bg0">
        <tr class='bg1'>
            <td align=center>국명</td>
            <td align=center>접률</td>
            <td align=center>단접</td>
            <td align=center>국력</td>
            <td align=center>장수</td>
            <td align=center>속령</td>
@@ -146,8 +143,6 @@ SELECT
    A.gold,
    A.rice,
    COUNT(B.nation) AS gennum,
    ROUND(AVG(B.connect), 1) AS connect,
    ROUND(AVG(B.con), 1) AS con,
    ROUND(AVG(B.dex1)) AS dex1,
    ROUND(AVG(B.dex2)) AS dex2,
    ROUND(AVG(B.dex3)) AS dex3,
@@ -192,12 +187,6 @@ GROUP BY B.nation
            case 10:
                $query .= " order by avg(B.explevel) desc";
                break;
            case 11:
                $query .= " order by avg(B.connect) desc";
                break;
            case 12:
                $query .= " order by avg(B.con) desc";
                break;
            case 13:
                $query .= " order by avg(B.dex1) desc";
                break;
@@ -239,8 +228,6 @@ from city where nation=%i', $nation['nation']);
            echo "
    <tr>
        <td align=center style=background-color:{$nation['color']};color:" . newColor($nation['color']) . ";>{$nation['name']}</td>
        <td align=center>&nbsp;{$nation['connect']}&nbsp;</td>
        <td align=center>&nbsp;{$nation['con']}&nbsp;</td>
        <td align=center>&nbsp;{$nation['power']}&nbsp;</td>
        <td align=center>&nbsp;{$gen['cnt']}&nbsp;</td>
        <td align=center>&nbsp;{$city['cnt']}&nbsp;</td>
@@ -12,7 +12,7 @@ $nation = Util::getPost('nation', 'int');
 $session = Session::requireGameLogin()->setReadOnly();
 $userID = Session::getUserID();
-if ($session->userGrade < 5) {
+if ($session->userGrade < 6) {
    header('location:_admin5.php');
    die();
 }
@@ -2,6 +2,8 @@
 namespace sammo;
 use sammo\Enums\GeneralQueryMode;
 include "lib.php";
 include "func.php";
@@ -29,13 +31,13 @@ $queryMap = [
 ];
 if ($reqQueryType === null || !key_exists($reqQueryType, $queryMap)) {
-    $reqQueryType = Util::array_first_key($queryMap);
+    $reqQueryType = array_key_first($queryMap);
 }
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
-if ($session->userGrade < 5) {
+if ($session->userGrade < 6) {
    die(requireAdminPermissionHTML());
 }
@@ -74,7 +76,7 @@ if (!$gen) {
    $gen = $generalBasicList[0]['no'];
 }
-$generalObj = General::createGeneralObjFromDB($gen);
+$generalObj = General::createObjFromDB($gen, null, GeneralQueryMode::FullWithAccessLog);
 ?>
 <!DOCTYPE html>
@@ -83,6 +85,7 @@ $generalObj = General::createGeneralObjFromDB($gen);
 <head>
    <title>로그정보</title>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <?= WebUtil::printCSS('../d_shared/common.css') ?>
@@ -12,7 +12,7 @@ $type = 0;
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
-if ($session->userGrade < 5) {
+if ($session->userGrade < 6) {
    die(requireAdminPermissionHTML());
 }
@@ -30,6 +30,7 @@ $sel[$type] = "selected";
 <head>
    <title>외교정보</title>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <?= WebUtil::printCSS('../d_shared/common.css') ?>
@@ -7,7 +7,7 @@ include "func.php";
 //로그인 검사
 $session = Session::requireGameLogin()->setReadOnly();
-if ($session->userGrade < 5) {
+if ($session->userGrade < 6) {
    die('권한 부족');
 }
@@ -26,8 +26,7 @@ foreach ($db->queryFirstColumn(
 }
 $inheritPointManager = InheritancePointManager::getInstance();
-foreach(General::createGeneralObjListFromDB($db->queryFirstColumn('SELECT `no` FROM general WHERE npc = 0')) as $genObj){
+foreach(General::createObjListFromDB($db->queryFirstColumn('SELECT `no` FROM general WHERE npc = 0')) as $genObj){
-    $inheritPointManager->mergeTotalInheritancePoint($genObj, true);
+    $inheritPointManager->mergeTotalInheritancePoint($genObj);
    $inheritPointManager->applyInheritanceUser($genObj->getVar('owner'));
    $inheritPointManager->clearInheritancePoint($genObj);
 }
@@ -28,6 +28,7 @@ $templates = new \League\Plates\Engine(__DIR__ . '/templates');
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=500" />
    <title><?= UniqueConst::$serverName ?>: 명장일람</title>
@@ -242,11 +243,14 @@ $templates = new \League\Plates\Engine(__DIR__ . '/templates');
            "SELECT nation,no,name,owner_name as ownerName, owner, picture, imgsvr,
    experience, dedication,
    dex1, dex2, dex3, dex4, dex5,
-    horse, weapon, book, item
+    horse, weapon, book, item, aux
    FROM general WHERE %l",
            $btn == "NPC 보기" ? "npc>=2" : "npc<2"
        ) as $general) {
            $generalID = $general['no'];
            foreach (['dex1', 'dex2', 'dex3', 'dex4', 'dex5'] as $dexKey) {
                $general[$dexKey] = CentennialAllStarGrowthService::recordableRawValue($general, $dexKey);
            }
            $general['bgColor'] = $nationColor[$general['nation']] ?? GameConst::$basecolor4;
            $general['fgColor'] = newColor($general['bgColor']);
            $general['nationName'] = $nationName[$general['nation']];
@@ -426,4 +430,4 @@ $templates = new \League\Plates\Engine(__DIR__ . '/templates');
    </div>
 </body>
-</html>
+</html>
@@ -14,6 +14,7 @@ increaseRefresh("왕조일람", 1);
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 왕조일람</title>
@@ -24,6 +24,7 @@ $serverID = $emperior['server_id'] ?? ($emperior['serverID'] ?? null);
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 왕조일람</title>
@@ -16,10 +16,13 @@ $gameStor = KVStorage::getStorage($db, 'game_env');
 increaseRefresh("장수일람", 2);
-$me = $db->queryFirstRow('SELECT con,turntime FROM general WHERE owner = %i', $userID);
+$me = $db->queryFirstRow(
    'SELECT refresh_score,turntime FROM `general`
    LEFT JOIN general_access_log AS l ON `general`.no = l.general_id WHERE owner = %i', $userID
 );
-$con = checkLimit($me['con']);
+$limitState = checkLimit($me['refresh_score']);
-if ($con >= 2) {
+if ($limitState >= 2) {
    printLimitMsg($me['turntime']);
    exit();
 }
@@ -41,6 +44,7 @@ if ($gameStor->isunited) {
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 장수일람</title>
@@ -101,7 +105,7 @@ if ($gameStor->isunited) {
        6 => ['dedication', true],
        7 => ['officer_level', true],
        8 => ['killturn', false],
-        9 => ['connect', true],
+        9 => ['refresh_score_total', true],
        10 => ['experience', true],
        11 => ['personal', true],
        12 => ['special', true],
@@ -110,7 +114,12 @@ if ($gameStor->isunited) {
        15 => ['npc', true],
    ][$type];
-    $generalList = $db->query('SELECT owner,no,picture,imgsvr,npc,age,nation,special,special2,personal,name,injury,leadership,strength,intel,experience,dedication,officer_level,killturn,connect from general order by %b %l', $orderKey, $orderDesc ? 'desc' : '');
+    $generalList = $db->query(
        'SELECT owner,no,picture,imgsvr,npc,age,nation,special,special2,personal,name,injury,leadership,strength,intel,experience,dedication,officer_level,killturn,refresh_score_total
        FROM `general` LEFT JOIN `general_access_log` ON general.no = general_access_log.general_id order by %b %l',
        $orderKey,
        $orderDesc ? 'desc' : ''
    );
    echo "
 <table align=center width=1000 class='tb_layout bg0'>
@@ -162,7 +171,7 @@ if ($gameStor->isunited) {
            $name = $name . '<br><small>(' . $ownerNameList[$general['owner']] . ')</small>';
        }
-        $general['connect'] = Util::round($general['connect'], -1);
+        $general['refresh_score_total'] = Util::round($general['refresh_score_total'], -1);
        $imageTemp = GetImageURL($general['imgsvr']);
        echo "
@@ -191,8 +200,8 @@ if ($gameStor->isunited) {
        <td align=center>$strength</td>
        <td align=center>$intel</td>
        <td align=center>{$general['killturn']}</td>
-        <td align=center>{$general['connect']}";
+        <td align=center>" . $general['refresh_score_total'] ?? 0;
-        echo "<br>【" . getConnect($general['connect']) . "】</td>
+        echo "<br>【" . getRefreshScoreText($general['refresh_score_total'] ?? 0) . "】</td>
    </tr>";
    }
    echo "
@@ -43,6 +43,7 @@ if ($scenarioIdx && key_exists($scenarioIdx, $scenarioList[$seasonIdx] ?? [])) {
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=500" />
    <title><?= UniqueConst::$serverName ?>: 명예의 전당</title>
@@ -13,10 +13,13 @@ $gameStor = KVStorage::getStorage($db, 'game_env');
 $gameStor->cacheValues(['killturn', 'autorun_user', 'turnterm']);
 increaseRefresh("세력일람", 2);
-$me = $db->queryFirstRow('SELECT con, turntime FROM general WHERE owner=%i', $userID);
+$me = $db->queryFirstRow(
    'SELECT refresh_score, turntime FROM `general`
    LEFT JOIN general_access_log AS l ON `general`.no = l.general_id WHERE owner=%i', $userID
 );
-$con = checkLimit($me['con']);
+$limitState = checkLimit($me['refresh_score']);
-if ($con >= 2) {
+if ($limitState >= 2) {
    printLimitMsg($me['turntime']);
    exit();
 }
@@ -26,6 +29,7 @@ if ($con >= 2) {
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 세력일람</title>
@@ -24,6 +24,7 @@ $sel[$type] = "selected";
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 빙의일람</title>
@@ -2,36 +2,29 @@
 namespace sammo;
 use sammo\Enums\GeneralAccessLogColumn;
 include "lib.php";
 include "func.php";
 $db = DB::db();
 $gameStor = KVStorage::getStorage($db, 'game_env');
-increaseRefresh("갱신정보", 2);
+increaseRefresh("갱신정보", 1);
-$admin = $gameStor->getValues(['year', 'month', 'refresh', 'maxrefresh', 'maxonline']);
+$admin = $gameStor->getValues(['year', 'month', 'refresh', 'maxrefresh', 'maxonline', 'recentTraffic']);
-$log = getRawFileLogRecent(__DIR__ . '/logs/' . UniqueConst::$serverID . '/_traffic.txt', 11, 100);
+$recentTraffic = $admin['recentTraffic'] ?? [];
 $date = [];
 $year = [];
 $month = [];
 $refresh = [];
 $online = [];
 $curonline = getOnlineNum();
-foreach ($log as $i => $value) {
+
-    $parse = Json::decode($value);
+$recentTraffic[] = [
-    $date[$i]    = $parse[0];
+    'year'    => $admin['year'],
-    $year[$i]    = $parse[1];
+    'month'   => $admin['month'],
-    $month[$i]   = $parse[2];
+    'refresh' => $admin['refresh'],
-    $refresh[$i] = $parse[3];
+    'online'  => $curonline,
-    $online[$i]  = $parse[4];
+    'date' => TimeUtil::now()
-}
+];
 $year[] = $admin['year'];
 $month[] = $admin['month'];
 $date[] = TimeUtil::now();
 if ($admin['maxrefresh'] == 0) {
    $admin['maxrefresh'] = 1;
@@ -52,6 +45,7 @@ if ($admin['maxonline'] < $curonline) {
 <head>
    <title><?= UniqueConst::$serverName ?>: 트래픽정보</title>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <?= WebUtil::printCSS('../d_shared/common.css') ?>
@@ -104,13 +98,13 @@ if ($admin['maxonline'] < $curonline) {
                        </td>
                    </tr>
                    <?php
-                    $refresh[] = $admin['refresh'];
+                    foreach ($recentTraffic as $trafficItem) {
-                    foreach ($refresh as $i => $value) {
+                        $value = $trafficItem['refresh'];
                        $w = round($value / $admin['maxrefresh'] * 100, 1);
                        $color = getTrafficColor($w);
-                        $dt = substr($date[$i], 11, 5); ?>
+                        $dt = substr($trafficItem['date'], 11, 5); ?>
                        <tr height=30>
-                            <td width=100 align=center><?= $year[$i] ?>년 <?= $month[$i] ?>월</td>
+                            <td width=100 align=center><?= $trafficItem['year'] ?>년 <?= $trafficItem['month'] ?>월</td>
                            <td width=60 align=center class='bg2'><?= $dt ?></td>
                            <td width=2 align=center class='bg1'></td>
                            <td width=320>
@@ -145,13 +139,13 @@ if ($admin['maxonline'] < $curonline) {
                        </td>
                    </tr>
                    <?php
-                    $online[] = $curonline;
+                    foreach ($recentTraffic as $trafficItem) {
-                    foreach ($online as $i => $value) {
+                        $value = $trafficItem['online'];
                        $w = round($value / $admin['maxonline'] * 100, 1);
                        $color = getTrafficColor($w);
-                        $dt = substr($date[$i], 11, 5); ?>
+                        $dt = substr($trafficItem['date'], 11, 5); ?>
                        <tr height=30>
-                            <td width=100 align=center><?= $year[$i] ?>년 <?= $month[$i] ?>월</td>
+                            <td width=100 align=center><?= $trafficItem['year'] ?>년 <?= $trafficItem['month'] ?>월</td>
                            <td width=60 align=center class='bg2'><?= $dt ?></td>
                            <td width=2 align=center class='bg1'></td>
                            <td width=320>
@@ -186,19 +180,24 @@ if ($admin['maxonline'] < $curonline) {
            </td>
        </tr>
        <?php
-        $max_refresh = $db->queryFirstRow('SELECT sum(refresh) as refresh, sum(`connect`) as `connect` from general');
+        $totalRefresh = [
-        $max_refresh['name'] = '접속자 총합';
+            ...$db->queryFirstRow('SELECT sum(`refresh`) as `refresh`, sum(`refresh_score_total`) as `refresh_score_total` from general_access_log'),
            'name' => '접속자 총합'
        ];
-        $refresh_result = array_merge([$max_refresh], $db->query('SELECT `name`,refresh,`connect` FROM general ORDER BY refresh DESC LIMIT 5'));
+        $top5Refresh = $db->query(
            'SELECT `name`, `log`.`refresh`, `refresh_score_total` FROM `general_access_log` AS `log`
            INNER JOIN `general` ON `log`.`general_id` = `general`.`no` ORDER BY `log`.`refresh` DESC LIMIT 5'
        );
-        foreach ($refresh_result as $i => $user) {
+        foreach (array_merge([$totalRefresh], $top5Refresh) as $i => $user) {
-            $w = round($user['refresh'] / max(1, $max_refresh['refresh']) * 100, 1);
+            $w = round($user['refresh'] / max(1, $totalRefresh['refresh']) * 100, 1);
            $w2 = round(100 - $w, 1);
            $color = getTrafficColor($w);
        ?>
            <tr>
                <td width=98 align=center><?= $user['name'] ?></td>
-                <td width=98 align=center><?= $user['connect'] ?>(<?= $user['refresh'] ?>)</td>
+                <td width=98 align=center><?= $user['refresh_score_total'] ?>(<?= $user['refresh'] ?>)</td>
                <td width=798>
                    <?php if ($w == 0) : ?>
                    <?php elseif ($w < 10) : ?>
@@ -2,6 +2,8 @@
 namespace sammo;
 use sammo\Enums\GeneralLiteQueryMode;
 use sammo\Enums\GeneralQueryMode;
 use sammo\Enums\RankColumn;
 include "lib.php";
@@ -21,12 +23,15 @@ $generalID = $session->generalID;
-$me = $db->queryFirstRow('SELECT no,tournament,con,turntime from general where owner=%i', $userID);
+$me = $db->queryFirstRow(
    'SELECT no,tournament,refresh_score,turntime FROM `general`
    LEFT JOIN general_access_log AS l ON `general`.no = l.general_id where owner=%i', $userID
 );
 $admin = $gameStor->getValues(['tournament', 'phase', 'tnmt_type', 'turnterm', 'develcost']);
 $turnTerm = $admin['turnterm'];
-$con = checkLimit($me['con']);
+$limitState = checkLimit($me['refresh_score']);
-if ($con >= 2) {
+if ($limitState >= 2) {
    printLimitMsg($me['turntime']);
    exit();
 }
@@ -107,12 +112,13 @@ if ($str3) {
 ?>
 <!DOCTYPE html>
 <html>
-<?php if ($con == 1) {
+<?php if ($limitState == 1) {
    MessageBox("접속제한이 얼마 남지 않았습니다!");
 } ?>
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 베팅장</title>
@@ -501,28 +507,28 @@ if ($str3) {
            $tournamentType = [
                '전 력 전' => [
                    '종합',
-                    function (General $general) {
+                    function (GeneralLite $general) {
                        return $general->getVar('leadership') + $general->getVar('strength') + $general->getVar('intel');
                    },
                    'tt',
                ],
                '통 솔 전' => [
                    '통솔',
-                    function (General $general) {
+                    function (GeneralLite $general) {
                        return $general->getVar('leadership');
                    },
                    'tl',
                ],
                '일 기 토' => [
                    '무력',
-                    function (General $general) {
+                    function (GeneralLite $general) {
                        return $general->getVar('strength');
                    },
                    'ts',
                ],
                '설 전' => [
                    '지력',
-                    function (General $general) {
+                    function (GeneralLite $general) {
                        return $general->getVar('intel');
                    },
                    'ti',
@@ -559,12 +565,12 @@ if ($str3) {
                        $winColumn = RankColumn::from("{$rankColumn}w");
                        $drawColumn = RankColumn::from("{$rankColumn}d");
                        $loseColumn = RankColumn::from("{$rankColumn}l");
-                        $tournamentRankerList = General::createGeneralObjListFromDB(
+                        $tournamentRankerList = GeneralLite::createObjListFromDB(
                            $db->queryFirstColumn('SELECT general_id FROM rank_data WHERE `type`= %s ORDER BY value DESC LIMIT 40', $gameColumn->value),
                            [$prizeColumn->value, $gameColumn->value, $winColumn->value, $drawColumn->value, $loseColumn->value, 'leadership', 'strength', 'intel', 'no', 'npc', 'name'],
-                            0
+                            GeneralLiteQueryMode::Core
                        );
-                        usort($tournamentRankerList, function (General $lhs, General $rhs) use ($gameColumn, $winColumn, $drawColumn, $loseColumn) {
+                        usort($tournamentRankerList, function (GeneralLite $lhs, GeneralLite $rhs) use ($gameColumn, $winColumn, $drawColumn, $loseColumn) {
                            $result = - ($lhs->getRankVar($gameColumn) <=> $rhs->getRankVar($gameColumn));
                            if ($result !== 0) return $result;
                            $result = - (
@@ -34,6 +34,7 @@ $templates = new \League\Plates\Engine('templates');
 <head>
    <title><?= UniqueConst::$serverName ?>: 도시정보</title>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <?= WebUtil::printJS('../d_shared/common_path.js') ?>
@@ -176,7 +177,7 @@ $templates = new \League\Plates\Engine('templates');
                                $valid = 1;
                            }
-                            if ($userGrade >= 5) {
+                            if ($userGrade >= 6) {
                                $valid = true;
                                $showDetailedInfo = true;
                            }
@@ -210,7 +211,7 @@ $templates = new \League\Plates\Engine('templates');
                                $city['trade'] = "- ";
                            }
-                            $dbColumns = General::mergeQueryColumn(['npc', 'defence_train', 'no', 'picture', 'imgsvr', 'name', 'injury', 'leadership', 'strength', 'intel', 'officer_level', 'nation', 'crewtype', 'crew', 'train', 'atmos'], 2)[0];
+                            $dbColumns = General::mergeQueryColumn(['npc', 'defence_train', 'no', 'picture', 'imgsvr', 'name', 'injury', 'leadership', 'strength', 'intel', 'officer_level', 'nation', 'crewtype', 'crew', 'train', 'atmos'])[0];
                            if ($showDetailedInfo) {
                                $generals = $db->query(
                                    'SELECT %l from general where city=%i order by turntime',
@@ -274,7 +275,7 @@ $templates = new \League\Plates\Engine('templates');
                                    $ourGeneral = false;
                                }
-                                if ($userGrade == 6) {
+                                if ($userGrade == 7) {
                                    $ourGeneral = true;
                                }
@@ -326,8 +327,7 @@ $templates = new \League\Plates\Engine('templates');
                                if ($ourGeneral && !$isNPC) {
                                    $turnText = [];
-                                    $generalObj = new General($general, null, null, null, null, null, false);
+                                    foreach ($generalTurnList[$general['no']] as $turnRawIdx => $turn) {
                                    foreach ($generalTurnList[$generalObj->getID()] as $turnRawIdx => $turn) {
                                        $turnIdx = $turnRawIdx + 1;
                                        $turnText[] = "{$turnIdx} : $turn";
                                    }
@@ -19,12 +19,15 @@ $gameStor = KVStorage::getStorage($db, 'game_env');
 increaseRefresh("암행부", 1);
-$me = $db->queryFirstRow('SELECT no,nation,officer_level,con,turntime,belong,permission,penalty from general where owner=%i', $userID);
+$me = $db->queryFirstRow(
    'SELECT no,nation,officer_level,refresh_score,turntime,belong,permission,penalty FROM `general`
    LEFT JOIN general_access_log AS l ON `general`.no = l.general_id WHERE owner=%i', $userID
 );
 $nationLevel = $db->queryFirstField('SELECT level FROM nation WHERE nation=%i', $me['nation']);
-$con = checkLimit($me['con']);
+$limitState = checkLimit($me['refresh_score']);
-if ($con >= 2) {
+if ($limitState >= 2) {
    printLimitMsg($me['turntime']);
    exit();
 }
@@ -45,12 +48,13 @@ $templates = new \League\Plates\Engine('templates');
 ?>
 <!DOCTYPE html>
 <html>
-<?php if ($con == 1) {
+<?php if ($limitState == 1) {
    MessageBox("접속제한이 얼마 남지 않았습니다!");
 } ?>
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 암행부</title>
@@ -42,6 +42,7 @@ if ($meLevel >= 5) {
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 인사부</title>
@@ -33,6 +33,7 @@ $sel = [$type => "selected"];
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 세력도시</title>
@@ -42,6 +42,7 @@ if ($gameStor->isunited) {
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 세력장수</title>
@@ -96,7 +97,7 @@ if ($gameStor->isunited) {
        7 => ['gold', true],
        8 => ['rice', true],
        9 => ['crew', true],
-        10 => ['connect', true],
+        10 => ['refresh_score_total', true],
        11 => ['personal', true],
        12 => ['special', true],
        13 => ['special2', true],
@@ -104,7 +105,9 @@ if ($gameStor->isunited) {
        15 => ['npc', true],
    ][$type];
-    $generalList = $db->query('SELECT owner,no,picture,imgsvr,npc,age,nation,special,special2,personal,name,injury,leadership,strength,intel,experience,dedication,officer_level,killturn,connect,gold,rice,crew,belong from general where nation = %i order by %b %l', $me['nation'], $orderKey, $orderDesc ? 'desc' : '');
+    $generalList = $db->query(
        'SELECT owner,no,picture,imgsvr,npc,age,nation,special,special2,personal,name,injury,leadership,strength,intel,experience,dedication,officer_level,killturn,refresh_score_total,gold,rice,crew,belong
        FROM `general` LEFT JOIN `general_access_log` ON general.no = general_access_log.general_id where nation = %i order by %b %l', $me['nation'], $orderKey, $orderDesc ? 'desc' : '');
    echo "
 <table align=center class='tb_layout bg0'>
@@ -172,8 +175,8 @@ if ($gameStor->isunited) {
        <td align=center>" . displayCharInfo($general['personal']) . "</td>
        <td align=center>" . displaySpecialDomesticInfo($general['special']) . " / " . displaySpecialWarInfo($general['special2']) . "</td>
        <td align=center>{$general['belong']}</td>
-        <td align=center>{$general['connect']}";
+        <td align=center>". $general['refresh_score_total'] ?? 0;
-        echo "<br>(" . getConnect($general['connect']) . ")</td>
+        echo "<br>(" . getRefreshScoreText($general['refresh_score_total'] ?? 0) . ")</td>
    </tr>";
    }
    echo "
@@ -25,6 +25,7 @@ if ($nationID == 0) {
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 세력정보</title>
@@ -2,6 +2,10 @@
 namespace sammo;
 use sammo\Enums\GeneralAccessLogColumn;
 use sammo\Enums\GeneralQueryMode;
 use sammo\Enums\TableName;
 include "lib.php";
 include "func.php";
@@ -20,7 +24,7 @@ $gameStor->cacheValues(['turntime', 'opentime', 'autorun_user', 'npcmode']);
 increaseRefresh("내정보", 1);
-$me = General::createGeneralObjFromDB($generalID);
+$me = General::createObjFromDB($generalID, null, GeneralQueryMode::FullWithAccessLog);
 $myset = $me->getVar('myset');
 if ($myset > 0) {
@@ -29,7 +33,15 @@ if ($myset > 0) {
    $submit = 'hidden';
 }
-$targetTime = addTurn($me->getVar('lastrefresh'), $gameStor->turnterm, 2);
+$lastRefresh = $db->queryFirstField(
    'SELECT %b FROM %b WHERE %b = %i',
    GeneralAccessLogColumn::lastRefresh->value,
    TableName::generalAccessLog->value,
    GeneralAccessLogColumn::generalID->value,
    $generalID
 );
 $targetTime = addTurn($lastRefresh, $gameStor->turnterm, GameConst::$minTurnDieOnPrestart);
 if ($gameStor->turntime <= $gameStor->opentime) {
    //서버 가오픈시 할 수 있는 행동
    if ($me->getNPCType() == 0 && $me->getNationID() == 0) {
@@ -39,19 +51,26 @@ if ($gameStor->turntime <= $gameStor->opentime) {
        }
    }
-    if($me->getNationID() == 0){
+    if ($me->getNationID() == 0) {
        $showBuildNationCandidateBtn = true;
    }
 }
 $use_treatment = $me->getAuxVar('use_treatment') ?? 10;
 $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
 $changeDefence999Train = -3;
 $changeDefence999Atmos = -6;
 $changeDefence999Train = $me->onCalcDomestic('changeDefenceTrain', "train999", $changeDefence999Train);
 $changeDefence999Atmos = $me->onCalcDomestic('changeDefenceTrain', "atmos999", $changeDefence999Atmos);
 ?>
 <!DOCTYPE html>
 <html>
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=500" />
    <title><?= UniqueConst::$serverName ?>: 내정보</title>
@@ -80,13 +99,13 @@ $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
            <div class="col">내 정 보<br><?= backButton() ?></div>
        </div>
        <div class="row gx-0">
-            <div class="col col-12 col-md-6">
+            <div class="col col-12 col-lg-6">
                <div class="row">
                    <div class="col"><?php generalInfo($me); ?><?php generalInfo2($me); ?></div>
                </div>
            </div>
-            <div class="col col-12 col-md-6">
+            <div class="col col-12 col-lg-6">
                <div class="row mx-0 gx-0">
                    <div class="col" style='padding-left:2ch;'>
                        토너먼트 【
@@ -116,11 +135,22 @@ $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
                            <?php foreach ([90, 80, 60, 40] as $targetDefenceTrain) : ?>
                                <option value='<?= $targetDefenceTrain ?>' <?= $me->getVar('defence_train') == $targetDefenceTrain ? "selected" : ""; ?>><?= formatDefenceTrain($targetDefenceTrain) ?>(훈사<?= $targetDefenceTrain ?>)</option>
                            <?php endforeach; ?>
-                            <option value=999 <?= $me->getVar('defence_train') == 999 ? "selected" : ""; ?>><?= formatDefenceTrain(999) ?>[훈련, 사기 -3]</option>
+                            <option value=999 <?= $me->getVar('defence_train') == 999 ? "selected" : ""; ?>><?= formatDefenceTrain(999) ?>
                                <?php if ($changeDefence999Train != 0 || $changeDefence999Train != 0) :
                                ?>[<?= $changeDefence999Train != 0 ? "훈련 {$changeDefence999Train}," : '' ?><?= $changeDefence999Atmos != 0 ? "사기 {$changeDefence999Atmos}" : ''
                                                                                                ?>]<?php endif ?></option>
                        </select>
                        】<br><br>
                        <input type=<?= $submit ?> id='set_my_setting' name=btn style=background-color:<?= GameConst::$basecolor2 ?>;color:white;width:160px;height:30px;font-size:14px; value=설정저장><br>
                        ∞<span style='color:orange'>설정저장은 이달중 <?= $myset ?>회 남았습니다.</span><br><br>
                        <?php if ($me->getPenaltyList()->count()) : ?>
                            징계 목록(저장 시 갱신)<br>
                            <?php foreach ($me->getPenaltyList() as $penaltyKey => $penalty) : ?>
                                <span style='color:red'><?= $penaltyKey->getHelptext() ?> : <?= $penalty ?></span><br>
                            <?php endforeach; ?>
                            <br />
                        <?php endif; ?>
                        <?php if (!($gameStor->autorun_user['limit_minutes'] ?? false)) : ?>
                            휴 가 신 청<br>
                            <button type="button" id='vacation' style=background-color:<?= GameConst::$basecolor2 ?>;color:white;width:160px;height:30px;font-size:14px;>휴가 신청</button><br><br>
@@ -138,6 +168,11 @@ $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
                            <button type="button" id='buildNationCandidate' style=background-color:<?= GameConst::$basecolor2 ?>;color:white;width:160px;height:30px;font-size:14px;>사전 거병</button><br><br>
                        <?php endif; ?>
                        <?php if (GameConst::$availableInstantAction['instantRetreat'] ?? false) : ?>
                            거리 3칸 이내 아국 도시로 즉시 이동<br>
                            <button type="button" id='instantRetreat' style=background-color:<?= GameConst::$basecolor2 ?>;color:white;width:160px;height:30px;font-size:14px;>접경 귀환</button><br><br>
                        <?php endif; ?>
                        <?php if ($gameStor->npcmode == 2 && $me->getNPCType() == 0) : ?>
                            다른 장수 선택 (<?= substr($me->getAuxVar('next_change') ?? TimeUtil::now(), 0, 19) ?> 부터)<br>
                            <a href="select_general_from_pool.php" id='select_general_from_pool'><button type="button" style=background-color:<?= GameConst::$basecolor2 ?>;color:white;width:160px;height:30px;font-size:14px;>다른 장수 선택</button></a><br><br>
@@ -166,7 +201,7 @@ $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
                        <div class="row mx-1">
                            <div class="btn-group" role="group">
                                <?php foreach ($me->getItems() as $itemKey => $item) : ?>
-                                    <button type="button" data-item-type='<?=$itemKey?>' class="drop-item-btn btn btn-primary <?= $item->getName() == '-' ? 'disabled' : '' ?>"><?= $item->getName() ?></button>
+                                    <button type="button" data-item-type='<?= $itemKey ?>' class="drop-item-btn btn btn-primary <?= $item->getName() == '-' ? 'disabled' : '' ?>"><?= $item->getName() ?></button>
                                <?php endforeach; ?>
                            </div>
                        </div>
@@ -177,7 +212,7 @@ $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
                    </div>
                </div>
            </div>
-            <div class="col col-12 col-md-6">
+            <div class="col col-12 col-lg-6">
                <div class="row gx-0">
                    <div class="col bg1 text-center">
                        <h4 style='color:skyblue'>개인 기록</h4>
@@ -190,7 +225,7 @@ $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
                    <button type="button" class="load_old_log btn btn-secondary" data-log_type="generalAction">이전 로그 불러오기</button>
                </div>
            </div>
-            <div class="col col-12 col-md-6">
+            <div class="col col-12 col-lg-6">
                <div class="row gx-0">
                    <div class="col bg1 text-center">
                        <h4 style='color:orange'>전투 기록</h4>
@@ -204,7 +239,7 @@ $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
                </div>
            </div>
-            <div class="col col-12 col-md-6">
+            <div class="col col-12 col-lg-6">
                <div class="row gx-0">
                    <div class="col bg1 text-center">
                        <h4 style='color:skyblue'>장수 열전</h4>
@@ -214,7 +249,7 @@ $use_auto_nation_turn = $me->getAuxVar('use_auto_nation_turn') ?? 1;
                    <?= formatHistoryToHTML(getGeneralHistoryLogAll($generalID)) ?>
                </div>
            </div>
-            <div class="col col-12 col-md-6">
+            <div class="col col-12 col-lg-6">
                <div class="row gx-0">
                    <div class="col bg1 text-center">
                        <h4 style='color:orange'>전투 결과</h4>
@@ -14,14 +14,16 @@ $gameStor = KVStorage::getStorage($db, 'game_env');
 increaseRefresh("토너먼트", 1);
 TurnExecutionHelper::executeAllCommand();
-$me = $db->queryFirstRow('select no,tournament,con,turntime from general where owner=%i', $userID);
+$me = $db->queryFirstRow(
-$generalID = $session->generalID;
+    'SELECT no,tournament,refresh_score,turntime from `general`
-
+    LEFT JOIN general_access_log AS l ON `general`.no = l.general_id where owner=%i', $userID
 );
 $generalID = $me['no'];
 $admin = $gameStor->getValues(['tournament', 'phase', 'turnterm', 'tnmt_msg', 'tnmt_type', 'develcost', 'tnmt_trig']);
 $turnTerm = $admin['turnterm'];
-$con = checkLimit($me['con']);
+$limitState = checkLimit($me['refresh_score']);
-if ($con >= 2) {
+if ($limitState >= 2) {
    printLimitMsg($me['turntime']);
    exit();
 }
@@ -100,12 +102,13 @@ $globalBetTotal = array_sum($globalBet);
 ?>
 <!DOCTYPE html>
 <html>
-<?php if ($con == 1) {
+<?php if ($limitState == 1) {
    MessageBox("접속제한이 얼마 남지 않았습니다! 제한량이 모자라다면 참여를 해보세요^^");
 } ?>
 <head>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1024" />
    <title><?= UniqueConst::$serverName ?>: 토너먼트</title>
@@ -122,63 +125,7 @@ $globalBetTotal = array_sum($globalBet);
        </tr>
    </table>
    <table align=center class='tb_layout bg0'>
-        <?php if ($session->userGrade >= 5) : ?>
+        <?php if ($me['no'] > 0 && $me['tournament'] == 0 && $admin['tournament'] == 1) : ?>
            <form method=post action=c_tournament.php>
                <tr>
                    <td colspan=8><input type=textarea size=150 style=color:white;background-color:black; name=msg><input type=submit name=btn value='메시지'></td>
                </tr>
                <tr>
                    <td colspan=8>
                        <button type="button" class="btn btn-secondary" onclick='location.reload()'>갱신</button>
                        <?php if ($admin['tournament'] == 0) : ?>
                            <select name=auto size=1 style=color:white;background-color:black;>
                                <option style=color:white; value=0 <?= !$admin['tnmt_trig'] ? 'selected' : '' ?>>수동진행</option>
                                <option style=color:white; value=1 <?= $admin['tnmt_trig'] ? 'selected' : '' ?>>자동진행</option>
                            </select>
                            <input type=submit name=btn value='자동개최설정'>
                        <?php else : ?>
                            <input type=submit name=btn value='중단' onclick='return confirm("진짜 중단하시겠습니까?")'>
                        <?php endif; ?>
                        <?php switch ($admin['tournament']) {
                            case 1:
                                echo "<input type=submit name=btn value='랜덤투입'>";
                                echo "<input type=submit name=btn value='랜덤전부투입'>";
                                break;
                            case 2:
                                echo "<input type=submit name=btn value='예선'><input type=submit name=btn value='예선전부'>";
                                break;
                            case 3:
                                echo "<input type=submit name=btn value='추첨'><input type=submit name=btn value='추첨전부'>";
                                break;
                            case 4:
                                echo "<input type=submit name=btn value='본선'><input type=submit name=btn value='본선전부'>";
                                break;
                            case 5:
                                echo "<input type=submit name=btn value='배정'>";
                                break;
                            case 6:
                                echo "<input type=submit name=btn value='베팅마감'>";
                                break;
                            case 7:
                                echo "<input type=submit name=btn value='16강'>";
                                break;
                            case 8:
                                echo "<input type=submit name=btn value='8강'>";
                                break;
                            case 9:
                                echo "<input type=submit name=btn value='4강'>";
                                break;
                            case 10:
                                echo "<input type=submit name=btn value='결승'>";
                                break;
                        } ?>
                    </td>
                </tr>
            </form>
        <?php elseif ($me['no'] > 0 && $me['tournament'] == 0 && $admin['tournament'] == 1) : ?>
            <form method=post action=c_tournament.php>
                <tr>
                    <td colspan=8><button type="button" class="btn btn-secondary" onclick='location.reload()'>갱신</button><button type="submit" class="btn btn-sammo-base2" onclick='return confirm("참가비 금<?= $admin['develcost'] ?>이 필요합니다. 참가하시겠습니까?")'>참가</button><input type='hidden' name='btn' value='참가'/></td>
@@ -43,6 +43,7 @@ if ($nationID) {
 <head>
    <title><?= UniqueConst::$serverName ?>: 전투 시뮬레이터</title>
    <meta charset="UTF-8">
    <meta name="color-scheme" content="dark">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=1100" />
    <?= WebUtil::printCSS('../d_shared/common.css') ?>
@@ -65,8 +66,8 @@ if ($nationID) {
                전역 설정
            </div>
            <div class="card-body dragpad_battle">
-                <div class="row">
+                <div class="row gx-0">
-                    <div class="col-sm-6">
+                    <div class="col-sm-4">
                        <div class="input-group">
                            <input type="number" class="form-control" aria-describedby="text_year" value="<?= $startYear ?>" disabled>
                            <div class="input-group-text"> 년 시작 </div>
@@ -76,9 +77,13 @@ if ($nationID) {
                            <div class="input-group-text"> 월 </div>
                        </div>
                    </div>
-                    <div class="col-sm-6">
+                    <div class="col-sm-5 px-2">
                        <div class="btn-toolbar" role="toolbar">
                            <div class="input-group me-2" role="group">
                                <div class="input-group-text">
                                    시드
                                </div>
                                <input type="text" class="form-control" id="seed" aria-describedby="text_seed">
                                <div class="input-group-text">
                                    반복 횟수
                                </div>
@@ -87,6 +92,10 @@ if ($nationID) {
                                    <option value="1000">1000회 (요약 표기)</option>
                                </select>
                            </div>
                        </div>
                    </div>
                    <div class="col-sm-3">
                        <div class="btn-toolbar" role="toolbar">
                            <div class="btn-group me-2" role="group">
                                <button type="button" class="btn btn-danger btn-begin_battle">전투</button>
                            </div>
@@ -426,6 +435,25 @@ if ($nationID) {
                            </div>
                            <input type="number" class="form-control form_killcrew" value="0" step="1">
                        </div>
                        <div class="input-group mb-0">
                            <div class="input-group-text">자신</div>
                            <div class="input-group-text">회피 확률</div>
                            <input type="number" class="form-control form_war_avoid_ratio" value="0" step="1" min="0" max="5">
                            <div class="input-group-text">필살 확률</div>
                            <input type="number" class="form-control form_war_critical_ratio" value="0" step="1" min="0" max="5">
                            <div class="input-group-text">계략 시도 확률</div>
                            <input type="number" class="form-control form_war_magic_trial_prob" value="0" step="1" min="0" max="5">
                        </div>
                        <div class="input-group mb-1">
                            <div class="input-group-text">상대</div>
                            <div class="input-group-text">회피 확률</div>
                            <input type="number" class="form-control form_oppose_war_avoid_ratio" value="0" step="1" min="0" max="5">
                            <div class="input-group-text">필살 확률</div>
                            <input type="number" class="form-control form_oppose_war_critical_ratio" value="0" step="1" min="0" max="5">
                            <div class="input-group-text">계략 시도 확률</div>
                            <input type="number" class="form-control form_oppose_war_magic_trial_prob" value="0" step="1" min="0" max="5">
                        </div>
                    </div>
                </div>
@@ -0,0 +1,242 @@
 <?php
 declare(strict_types=1);
 namespace sammo;
 use Ds\Map;
 use sammo\Enums\RankColumn;
 if (PHP_SAPI !== 'cli') {
    http_response_code(404);
    exit;
 }
 chdir(dirname(__DIR__));
 require_once 'lib.php';
 require_once 'func.php';
 final class ComparisonTracingRNG implements RNG
 {
    private int $sequence = 0;
    /** @var array<int, array<string, mixed>> */
    public array $calls = [];
    public function __construct(private readonly RNG $inner)
    {
    }
    public static function getMaxInt(): int
    {
        return LiteHashDRBG::getMaxInt();
    }
    public function nextBytes(int $bytes): string
    {
        $value = $this->inner->nextBytes($bytes);
        $this->record('nextBytes', ['bytes' => $bytes], bin2hex($value));
        return $value;
    }
    public function nextBits(int $bits): string
    {
        $value = $this->inner->nextBits($bits);
        $this->record('nextBits', ['bits' => $bits], bin2hex($value));
        return $value;
    }
    public function nextInt(?int $max = null): int
    {
        $value = $this->inner->nextInt($max);
        $this->record('nextInt', ['maxInclusive' => $max], $value);
        return $value;
    }
    public function nextFloat1(): float
    {
        $value = $this->inner->nextFloat1();
        $this->record('nextFloat1', [], $value);
        return $value;
    }
    private function record(string $operation, array $arguments, mixed $result): void
    {
        $this->calls[] = [
            'seq' => $this->sequence++,
            'operation' => $operation,
            'arguments' => $arguments,
            'result' => $result,
        ];
    }
 }
 function comparisonExtractRankVar(array $raw): Map
 {
    $rankVars = new Map();
    foreach ($raw as $rawKey => $rawValue) {
        $key = RankColumn::tryFrom($rawKey);
        if ($key !== null) {
            $rankVars[$key] = $rawValue;
        }
    }
    return $rankVars;
 }
 function comparisonBuildGeneral(
    array $raw,
    array $city,
    array $nation,
    int $year,
    int $month,
    bool $defender = false,
 ): General {
    $aux = [];
    if (array_key_exists('inheritBuff', $raw)) {
        $aux['inheritBuff'] = $raw['inheritBuff'];
    }
    $raw['aux'] = Json::encode($aux);
    $raw['owner'] = 0;
    return new General(
        $raw,
        comparisonExtractRankVar($raw),
        null,
        $city,
        $nation,
        $year,
        $month,
        $defender,
    );
 }
 function comparisonRunBattle(array $fixture): array
 {
    $seed = (string)($fixture['seed'] ?? 'battle-differential');
    $year = (int)$fixture['year'];
    $month = (int)$fixture['month'];
    $startYear = (int)($fixture['startYear'] ?? 180);
    $rawAttacker = $fixture['attackerGeneral'];
    $rawAttackerCity = $fixture['attackerCity'];
    $rawAttackerNation = $fixture['attackerNation'];
    $rawDefenderCity = $fixture['defenderCity'];
    $rawDefenderNation = $fixture['defenderNation'];
    // 비교 fixture에 명시된 경우에만 ref runtime의 scenario action chain을
    // 활성화합니다. 일반 비교 fixture의 기존 동작은 그대로 유지합니다.
    $scenarioEffect = $fixture['scenarioEffect'] ?? null;
    if ($scenarioEffect === '' || $scenarioEffect === 'None') {
        $scenarioEffect = null;
    }
    if (
        $scenarioEffect !== null
        && (!is_string($scenarioEffect) || getScenarioEffectClass($scenarioEffect) === null)
    ) {
        throw new \InvalidArgumentException('scenarioEffect is invalid');
    }
    GameConst::$scenarioEffect = $scenarioEffect;
    $tracingRng = new ComparisonTracingRNG(new LiteHashDRBG($seed));
    $warRng = new RandUtil($tracingRng);
    $attacker = new WarUnitGeneral(
        $warRng,
        comparisonBuildGeneral($rawAttacker, $rawAttackerCity, $rawAttackerNation, $year, $month),
        $rawAttackerNation,
        true,
    );
    $city = new WarUnitCity($warRng, $rawDefenderCity, $rawDefenderNation, $year, $month, $startYear);
    $defenderList = [];
    foreach ($fixture['defenderGenerals'] as $rawDefender) {
        $defenderList[] = new WarUnitGeneral(
            $warRng,
            comparisonBuildGeneral($rawDefender, $rawDefenderCity, $rawDefenderNation, $year, $month, true),
            $rawDefenderNation,
            false,
        );
    }
    if (count($defenderList) && extractBattleOrder($city, $attacker) > 0) {
        $defenderList[] = $city;
    }
    usort(
        $defenderList,
        fn(WarUnit $lhs, WarUnit $rhs): int =>
            -(extractBattleOrder($lhs, $attacker) <=> extractBattleOrder($rhs, $attacker)),
    );
    $iterDefender = new \ArrayIterator($defenderList);
    $iterDefender->rewind();
    $finishedDefenders = [];
    $getNextDefender = function (?WarUnit $previous, bool $requestNext) use (
        $iterDefender,
        $attacker,
        &$finishedDefenders,
    ): ?WarUnit {
        if ($previous !== null) {
            $finishedDefenders[] = buildWarTraceUnitSnapshot($previous);
        }
        if (!$requestNext || !$iterDefender->valid()) {
            return null;
        }
        $next = $iterDefender->current();
        if (extractBattleOrder($next, $attacker) <= 0) {
            return null;
        }
        $iterDefender->next();
        return $next;
    };
    $events = [];
    $conquered = processWar_NG(
        $seed,
        $attacker,
        $getNextDefender,
        $city,
        static function (array $event) use (&$events): void {
            $events[] = $event;
        },
    );
    $attackerLogs = $attacker->getLogger()->rollback();
    $defenderLogs = [];
    foreach ($defenderList as $defenderUnit) {
        if (!($defenderUnit instanceof WarUnitGeneral)) {
            continue;
        }
        $snapshot = buildWarTraceUnitSnapshot($defenderUnit);
        $defenderLogs[(string)$snapshot['id']] = $defenderUnit->getLogger()->rollback();
    }
    $cityLogs = $city->getLogger()->rollback();
    return [
        'engine' => 'ref',
        'seed' => $seed,
        'conquered' => $conquered,
        'attacker' => buildWarTraceUnitSnapshot($attacker),
        'city' => buildWarTraceUnitSnapshot($city),
        'finishedDefenders' => $finishedDefenders,
        'events' => $events,
        'rng' => $tracingRng->calls,
        'logs' => [
            'attacker' => $attackerLogs,
            'defenders' => $defenderLogs,
            'city' => $cityLogs,
        ],
    ];
 }
 $fixturePath = $argv[1] ?? null;
 if ($fixturePath === null || ($fixturePath !== '-' && !is_file($fixturePath))) {
    fwrite(STDERR, "usage: php compare/battle_trace.php <fixture.json|->\n");
    exit(2);
 }
 try {
    $fixtureJson = $fixturePath === '-' ? stream_get_contents(STDIN) : file_get_contents($fixturePath);
    $fixture = json_decode((string)$fixtureJson, true, flags: JSON_THROW_ON_ERROR);
    echo json_encode(
        comparisonRunBattle($fixture),
        JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION,
    ), PHP_EOL;
 } catch (\Throwable $throwable) {
    fwrite(STDERR, $throwable::class . ': ' . $throwable->getMessage() . PHP_EOL);
    exit(1);
 }
@@ -0,0 +1,23 @@
 {
    "action": "AddGlobalBetray",
    "args": [2, 1],
    "setup": {
        "resetGenerals": true,
        "deleteOtherGenerals": true,
        "keepGeneralIds": [1, 2, 3],
        "general": [
            { "id": 1, "values": { "name": "배신0", "betray": 0 } },
            { "id": 2, "values": { "name": "배신1", "betray": 1 } },
            { "id": 3, "values": { "name": "배신2", "betray": 2 } }
        ]
    },
    "environment": {
        "year": 194,
        "month": 1,
        "startyear": 190
    },
    "observe": {
        "generalIds": [1, 2, 3]
    },
    "compactOutput": true
 }
@@ -0,0 +1,79 @@
 {
    "action": "AssignGeneralSpeciality",
    "setup": {
        "resetGenerals": true,
        "deleteOtherGenerals": true,
        "keepGeneralIds": [1, 2, 3],
        "general": [
            {
                "id": 1,
                "values": {
                    "name": "내정대상",
                    "nation": 1,
                    "age": 30,
                    "leadership": 40,
                    "strength": 45,
                    "intel": 80,
                    "special": "None",
                    "specage": 30,
                    "special2": "che_신산",
                    "specage2": 99,
                    "aux": {
                        "prev_types_special": ["che_경작"]
                    }
                }
            },
            {
                "id": 2,
                "values": {
                    "name": "전투대상",
                    "nation": 1,
                    "age": 30,
                    "leadership": 80,
                    "strength": 75,
                    "intel": 40,
                    "special": "che_인덕",
                    "specage": 99,
                    "special2": "None",
                    "specage2": 30,
                    "dex1": 200,
                    "dex2": 10,
                    "dex3": 10,
                    "dex4": 10,
                    "dex5": 10,
                    "aux": {
                        "prev_types_special2": ["che_돌격"]
                    }
                }
            },
            {
                "id": 3,
                "values": {
                    "name": "계승대상",
                    "nation": 2,
                    "age": 30,
                    "leadership": 50,
                    "strength": 50,
                    "intel": 50,
                    "special": "che_경작",
                    "specage": 99,
                    "special2": "None",
                    "specage2": 30,
                    "aux": {
                        "inheritSpecificSpecialWar": "che_의술",
                        "marker": 3
                    }
                }
            }
        ]
    },
    "environment": {
        "year": 200,
        "month": 1,
        "startyear": 190
    },
    "observe": {
        "generalIds": [1, 2, 3]
    },
    "compactOutput": true
 }
@@ -0,0 +1,54 @@
 {
  "action": "AutoDeleteInvader",
  "compactOutput": true,
  "args": [1],
  "setup": {
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1],
    "resetDiplomacy": true,
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "ⓞ남만족",
          "capital": 69,
          "gennum": 1,
          "tech": 100,
          "level": 2,
          "type": "che_병가"
        }
      }
    ],
    "general": [
      {
        "id": 1,
        "values": {
          "name": "ⓞ남만대왕",
          "nation": 1,
          "city": 69,
          "officer_level": 12,
          "npc": 9
        }
      }
    ],
    "event": [
      {
        "id": 990001,
        "action": [["AutoDeleteInvader", 1]]
      }
    ]
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190,
    "currentEventID": 990001
  },
  "observe": {
    "generalIds": [1]
  }
 }
@@ -0,0 +1,24 @@
 {
    "action": "BlockScoutAction",
    "args": [true],
    "setup": {
        "resetNations": true,
        "deleteOtherNations": true,
        "keepNationIds": [1, 2],
        "nation": [
            { "id": 1, "values": { "name": "위", "level": 2, "scout": 0 } },
            { "id": 2, "values": { "name": "촉", "level": 2, "scout": 0 } }
        ],
        "gameEnvironment": {
            "block_change_scout": false
        }
    },
    "environment": {
        "year": 200,
        "month": 1,
        "startyear": 190
    },
    "observe": {
        "nationIds": [1, 2]
    }
 }
@@ -0,0 +1,226 @@
 {
  "action": "MonthlyBoundary",
  "compactOutput": true,
  "environment": {
    "year": 190,
    "month": 12,
    "startyear": 190,
    "turnterm": 10,
    "starttime": "2026-07-25 00:00:00",
    "turntime": "2026-07-25 02:00:00"
  },
  "setup": {
    "syncEnvironment": true,
    "world": {
      "hiddenSeed": "monthly-boundary-core-catalog"
    },
    "gameEnvironment": {
      "isunited": 1,
      "refreshLimit": 3,
      "block_change_scout": false
    },
    "resetCities": true,
    "deleteOtherCities": true,
    "keepCityIds": [1, 2],
    "city": [
      {
        "id": 1,
        "values": {
          "name": "경계도시",
          "level": 1,
          "nation": 1,
          "pop": 10000,
          "pop_max": 20000,
          "agri": 1000,
          "agri_max": 2000,
          "comm": 1000,
          "comm_max": 2000,
          "secu": 1000,
          "secu_max": 2000,
          "trust": 50,
          "trade": 100,
          "def": 1000,
          "def_max": 2000,
          "wall": 1000,
          "wall_max": 2000,
          "officer_set": 1,
          "state": 31,
          "term": 1,
          "supply": 1,
          "front": 2,
          "conflict": {},
          "dead": 0
        }
      },
      {
        "id": 2,
        "values": {
          "name": "중립도시",
          "level": 8,
          "nation": 0,
          "pop": 12000,
          "pop_max": 22000,
          "agri": 1200,
          "agri_max": 2200,
          "comm": 1200,
          "comm_max": 2200,
          "secu": 1200,
          "secu_max": 2200,
          "trust": 55,
          "trade": 100,
          "def": 1200,
          "def_max": 2200,
          "wall": 1200,
          "wall_max": 2200,
          "officer_set": 1,
          "state": 0,
          "term": 0,
          "supply": 0,
          "front": 0,
          "conflict": {},
          "dead": 0
        }
      }
    ],
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2],
    "general": [
      {
        "id": 1,
        "values": {
          "name": "경계군주",
          "nation": 1,
          "city": 1,
          "officer_level": 12,
          "npc": 0,
          "age": 30,
          "belong": 3,
          "makelimit": 2,
          "gold": 1000,
          "rice": 1000,
          "crew": 100,
          "train": 80,
          "atmos": 70,
          "leadership": 50,
          "strength": 50,
          "intel": 50,
          "experience": 0,
          "dedication": 0,
          "dex1": 0,
          "dex2": 0,
          "dex3": 0,
          "dex4": 0,
          "dex5": 0,
          "personal": "None",
          "special": "None",
          "specage": 0,
          "special2": "None",
          "specage2": 0,
          "betray": 0,
          "bornyear": 160,
          "deadyear": 250
        }
      },
      {
        "id": 2,
        "values": {
          "name": "경계재야",
          "nation": 0,
          "city": 2,
          "officer_level": 0,
          "npc": 0,
          "age": 25,
          "belong": 4,
          "makelimit": 0,
          "gold": 500,
          "rice": 500,
          "crew": 50,
          "train": 60,
          "atmos": 50,
          "leadership": 40,
          "strength": 40,
          "intel": 40,
          "experience": 0,
          "dedication": 0,
          "dex1": 0,
          "dex2": 0,
          "dex3": 0,
          "dex4": 0,
          "dex5": 0,
          "personal": "None",
          "special": "None",
          "specage": 0,
          "special2": "None",
          "specage2": 0,
          "betray": 0,
          "bornyear": 165,
          "deadyear": 250
        }
      }
    ],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "경계국",
          "color": "#123456",
          "capital": 1,
          "gennum": 1,
          "gold": 10000,
          "rice": 20000,
          "tech": 100,
          "power": 10,
          "level": 2,
          "type": "che_유가",
          "bill": 100,
          "rate": 20,
          "rate_tmp": 10,
          "scout": 1,
          "chief_set": 1,
          "strategic_cmd_limit": 2,
          "surlimit": 1,
          "spy": "{}"
        }
      }
    ],
    "resetDiplomacy": true,
    "resetEvents": true,
    "event": [
      {
        "id": 991001,
        "target": "PRE_MONTH",
        "priority": 1000,
        "condition": true,
        "action": [
          ["NoticeToHistoryLog", "aggregate-pre", 6]
        ]
      },
      {
        "id": 991002,
        "target": "MONTH",
        "priority": 1000,
        "condition": true,
        "action": [
          ["ProcessIncome", "gold"],
          ["NewYear"],
          ["ResetOfficerLock"],
          ["RandomizeCityTradeRate"],
          ["ChangeCity", "all", {"pop": "+10", "trust": 60}],
          ["NoticeToHistoryLog", "aggregate-month", 6],
          ["DeleteEvent"]
        ]
      }
    ]
  },
  "observe": {
    "generalIds": [1, 2],
    "nationIds": [1],
    "cityIds": [1, 2],
    "eventIds": [991001, 991002],
    "accessGeneralIds": [1, 2]
  }
 }
@@ -0,0 +1,34 @@
 {
  "action": "NewYear",
  "environment": {
    "year": 191,
    "month": 1,
    "startyear": 190
  },
  "setup": {
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2],
    "general": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "age": 30,
          "belong": 3
        }
      },
      {
        "id": 2,
        "values": {
          "nation": 0,
          "age": 30,
          "belong": 4
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1, 2]
  }
 }
@@ -0,0 +1,11 @@
 {
  "action": "NoticeToHistoryLog",
  "args": ["<S>새해 알림</>", 6],
  "environment": {
    "year": 191,
    "month": 1,
    "startyear": 190
  },
  "setup": {},
  "observe": {}
 }
@@ -0,0 +1,75 @@
 {
  "action": "ProcessIncome",
  "args": ["gold"],
  "environment": {
    "year": 190,
    "month": 7,
    "startyear": 190
  },
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1],
    "general": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "city": 1,
          "officer_level": 5,
          "npc": 0,
          "gold": 1000,
          "rice": 1000,
          "dedication": 100
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "갑국",
          "capital": 1,
          "gold": 10000,
          "rice": 20000,
          "level": 1,
          "rate_tmp": 20
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "name": "갑성",
          "nation": 1,
          "level": 4,
          "supply": 1,
          "pop": 10000,
          "pop_max": 20000,
          "agri": 1000,
          "agri_max": 2000,
          "comm": 1000,
          "comm_max": 2000,
          "secu": 1000,
          "secu_max": 2000,
          "trust": 80,
          "def": 500,
          "def_max": 1000,
          "wall": 500,
          "wall_max": 1000
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1],
    "nationIds": [1],
    "cityIds": [1],
    "nationEnvironmentKeys": ["prev_income_gold", "prev_income_rice"]
  }
 }
@@ -0,0 +1,33 @@
 {
  "action": "ResetOfficerLock",
  "environment": {
    "year": 191,
    "month": 1,
    "startyear": 190
  },
  "setup": {
    "resetCities": true,
    "resetNations": true,
    "city": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "officer_set": 1
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "chief_set": 1
        }
      }
    ]
  },
  "observe": {
    "cityIds": [1],
    "nationIds": [1]
  }
 }
@@ -0,0 +1,9 @@
 {
  "action": "CreateAdminNPC",
  "environment": {
    "year": 193,
    "month": 12,
    "startyear": 190
  },
  "observe": {}
 }
@@ -0,0 +1,15 @@
 {
  "action": "CreateManyNPC",
  "args": [2, 0],
  "environment": {
    "year": 193,
    "month": 5,
    "startyear": 190,
    "turnterm": 10,
    "turntime": "0193-05-01 00:00:00"
  },
  "setup": {
    "resetGenerals": true
  },
  "observe": {}
 }
@@ -0,0 +1,69 @@
 {
    "action": "FinishNationBetting",
    "args": [1],
    "setup": {
        "clearBetting": true,
        "resetNations": true,
        "deleteOtherNations": true,
        "keepNationIds": [1, 2],
        "nation": [
            { "id": 1, "values": { "name": "위", "gennum": 1, "power": 100, "level": 2 } },
            { "id": 2, "values": { "name": "촉", "gennum": 1, "power": 300, "level": 0 } }
        ],
        "resetGenerals": true,
        "deleteOtherGenerals": true,
        "keepGeneralIds": [1, 2],
        "general": [
            { "id": 1, "values": { "name": "장수1", "nation": 1, "owner": 1, "npc": 0 } },
            { "id": 2, "values": { "name": "장수2", "nation": 2, "owner": 2, "npc": 0 } }
        ],
        "bettingInfo": [
            {
                "id": 1,
                "type": "bettingNation",
                "name": "천통국 예상",
                "finished": false,
                "selectCnt": 1,
                "isExclusive": null,
                "reqInheritancePoint": true,
                "openYearMonth": 2400,
                "closeYearMonth": 2424,
                "candidates": [
                    {
                        "title": "위",
                        "info": "국력: 100<br>장수 수: 1<br>도시 수: 1",
                        "isHtml": true,
                        "aux": { "nation": 1 }
                    },
                    {
                        "title": "촉",
                        "info": "국력: 300<br>장수 수: 1<br>도시 수: 1",
                        "isHtml": true,
                        "aux": { "nation": 2 }
                    }
                ],
                "winner": null
            }
        ],
        "bet": [
            { "betting_id": 1, "general_id": 0, "user_id": null, "betting_type": "[-1]", "amount": 100 },
            { "betting_id": 1, "general_id": 1, "user_id": 1, "betting_type": "[0]", "amount": 100 },
            { "betting_id": 1, "general_id": 2, "user_id": 2, "betting_type": "[1]", "amount": 100 }
        ],
        "inheritancePrevious": {
            "1": 900,
            "2": 900
        },
        "syncEnvironment": true
    },
    "environment": {
        "year": 202,
        "month": 1,
        "startyear": 190
    },
    "observe": {
        "generalIds": [1, 2],
        "nationIds": [1, 2],
        "ownerIds": [1, 2]
    }
 }
@@ -0,0 +1,40 @@
 {
  "action": "InvaderEnding",
  "compactOutput": true,
  "setup": {
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1],
    "setAllCitiesNation": 1,
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "기준국",
          "capital": 1,
          "gennum": 1,
          "tech": 100,
          "level": 2,
          "type": "che_유가"
        }
      }
    ],
    "gameEnvironment": {
      "isunited": 1,
      "refreshLimit": 3
    },
    "event": [
      {
        "id": 990002,
        "action": [["InvaderEnding"]]
      }
    ]
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190,
    "currentEventID": 990002
  },
  "observe": {}
 }
@@ -0,0 +1,108 @@
 {
  "action": "InvaderLifecycle",
  "args": [10, 150, 100, 20],
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1],
    "resetDiplomacy": true,
    "resetEvents": true,
    "city": [
      {
        "id": 1,
        "values": {
          "name": "기준도시",
          "level": 3,
          "nation": 1,
          "pop": 1000,
          "pop_max": 10000,
          "agri": 2000,
          "agri_max": 20000,
          "comm": 3000,
          "comm_max": 30000,
          "secu": 4000,
          "secu_max": 40000,
          "def": 5000,
          "def_max": 50000,
          "wall": 6000,
          "wall_max": 60000
        }
      },
      {
        "id": 48,
        "values": {
          "name": "남만",
          "level": 4,
          "nation": 0,
          "pop": 1000,
          "pop_max": 10000,
          "agri": 2000,
          "agri_max": 20000,
          "comm": 3000,
          "comm_max": 30000,
          "secu": 4000,
          "secu_max": 40000,
          "def": 5000,
          "def_max": 50000,
          "wall": 6000,
          "wall_max": 60000
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "기준국",
          "capital": 1,
          "gennum": 1,
          "tech": 100,
          "level": 2,
          "type": "che_유가"
        }
      }
    ],
    "general": [
      {
        "id": 1,
        "values": {
          "name": "군주",
          "nation": 1,
          "city": 1,
          "officer_level": 12,
          "npc": 0,
          "leadership": 50,
          "strength": 50,
          "intel": 50,
          "experience": 1000,
          "dedication": 1000,
          "dex1": 10,
          "dex2": 20,
          "dex3": 30,
          "dex4": 40,
          "dex5": 50,
          "turntime": "0200-01-01 00:05:00"
        }
      }
    ],
    "gameEnvironment": {
      "isunited": 0,
      "refreshLimit": 3
    },
    "syncEnvironment": true
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190,
    "turnterm": 10,
    "turntime": "0200-01-01 00:00:00",
    "show_img_level": 3,
    "fiction": [0]
  },
  "observe": {}
 }
@@ -0,0 +1,42 @@
 {
  "action": "LostUniqueItem",
  "args": [0.2],
  "environment": {
    "year": 210,
    "month": 1,
    "startyear": 180
  },
  "setup": {
    "syncEnvironment": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2],
    "general": [
      {
        "id": 1,
        "values": {
          "name": "갑",
          "npc": 0,
          "horse": "che_명마_12_옥란백용구",
          "weapon": "che_무기_15_의천검",
          "book": "che_서적_01_효경전",
          "item": "che_저지_삼황내문"
        }
      },
      {
        "id": 2,
        "values": {
          "name": "을",
          "npc": 1,
          "horse": "che_명마_12_사륜거",
          "weapon": "che_무기_01_단도",
          "book": "None",
          "item": "che_부적_태현청생부"
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1, 2]
  }
 }
@@ -0,0 +1,74 @@
 {
  "action": "MergeInheritPointRank",
  "environment": {
    "year": 210,
    "month": 1,
    "startyear": 180
  },
  "setup": {
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1],
    "clearInheritanceOwnerIds": [100],
    "gameEnvironment": {
      "isunited": 0
    },
    "general": [
      {
        "id": 1,
        "values": {
          "name": "갑",
          "nation": 1,
          "owner": 100,
          "npc": 0,
          "belong": 3,
          "dex1": 1000,
          "dex2": 0,
          "dex3": 0,
          "dex4": 0,
          "dex5": 0
        }
      }
    ],
    "inheritancePoints": [
      {"ownerId": 100, "key": "previous", "value": 999},
      {"ownerId": 100, "key": "lived_month", "value": 2},
      {"ownerId": 100, "key": "max_domestic_critical", "value": 4},
      {"ownerId": 100, "key": "active_action", "value": 15},
      {"ownerId": 100, "key": "unifier", "value": 6},
      {"ownerId": 100, "key": "tournament", "value": 7}
    ],
    "rankData": [
      {"generalId": 1, "type": "warnum", "value": 2},
      {"generalId": 1, "type": "firenum", "value": 1},
      {"generalId": 1, "type": "betwin", "value": 2},
      {"generalId": 1, "type": "betgold", "value": 4000},
      {"generalId": 1, "type": "betwingold", "value": 2000},
      {"generalId": 1, "type": "inherit_earned_dyn", "value": 999},
      {"generalId": 1, "type": "inherit_earned_act", "value": 11},
      {"generalId": 1, "type": "inherit_earned", "value": 999},
      {"generalId": 1, "type": "inherit_spent_dyn", "value": 9},
      {"generalId": 1, "type": "inherit_spent", "value": 999}
    ]
  },
  "observe": {
    "generalIds": [1],
    "ownerIds": [100],
    "inheritanceKeys": [
      "previous",
      "lived_month",
      "max_domestic_critical",
      "active_action",
      "unifier",
      "tournament"
    ],
    "rankGeneralIds": [1],
    "rankTypes": [
      "inherit_earned",
      "inherit_earned_act",
      "inherit_earned_dyn",
      "inherit_spent",
      "inherit_spent_dyn"
    ]
  }
 }
@@ -0,0 +1,75 @@
 {
  "action": "NationBettingLifecycle",
  "args": [1, 100],
  "bettorGeneralIds": [1, 2],
  "bettorOwnerIds": [1, 2],
  "setup": {
    "clearBetting": true,
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1, 2],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "위",
          "color": "#111111",
          "capital": 1,
          "gennum": 1,
          "gold": 1000,
          "rice": 2000,
          "tech": 100,
          "power": 100,
          "level": 2,
          "type": "che_유가"
        }
      },
      {
        "id": 2,
        "values": {
          "name": "촉",
          "color": "#222222",
          "capital": 2,
          "gennum": 1,
          "gold": 3000,
          "rice": 4000,
          "tech": 200,
          "power": 300,
          "level": 2,
          "type": "che_병가"
        }
      }
    ],
    "resetCities": true,
    "deleteOtherCities": true,
    "keepCityIds": [1, 2],
    "city": [
      { "id": 1, "values": { "name": "허창", "nation": 1, "level": 3 } },
      { "id": 2, "values": { "name": "성도", "nation": 2, "level": 3 } }
    ],
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2],
    "general": [
      { "id": 1, "values": { "name": "장수1", "nation": 1, "city": 1, "owner": 1, "npc": 0 } },
      { "id": 2, "values": { "name": "장수2", "nation": 2, "city": 2, "owner": 2, "npc": 0 } }
    ],
    "inheritancePrevious": {
      "1": 1000,
      "2": 1000
    },
    "rankData": [
      { "generalId": 1, "type": "inherit_spent_dyn", "value": 0 },
      { "generalId": 1, "type": "inherit_earned_act", "value": 0 },
      { "generalId": 2, "type": "inherit_spent_dyn", "value": 0 },
      { "generalId": 2, "type": "inherit_earned_act", "value": 0 }
    ],
    "syncEnvironment": true
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190
  },
  "observe": {}
 }
@@ -0,0 +1,77 @@
 {
  "action": "NpcNationLifecycle",
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "resetNations": true,
    "city": [
      {
        "id": 1,
        "values": {
          "name": "점유도시",
          "level": 5,
          "nation": 1,
          "pop": 10001,
          "pop_max": 50001,
          "agri": 1001,
          "agri_max": 5001,
          "comm": 2001,
          "comm_max": 6001,
          "secu": 3001,
          "secu_max": 7001,
          "def": 4001,
          "def_max": 8001,
          "wall": 5001,
          "wall_max": 9001
        }
      },
      {
        "id": 48,
        "values": {
          "name": "건국도시",
          "level": 5,
          "nation": 0,
          "pop": 10048,
          "pop_max": 50048,
          "agri": 1048,
          "agri_max": 5048,
          "comm": 2048,
          "comm_max": 6048,
          "secu": 3048,
          "secu_max": 7048,
          "def": 4048,
          "def_max": 8048,
          "wall": 5048,
          "wall_max": 9048
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "기준국",
          "capital": 1,
          "gennum": 0,
          "tech": 120,
          "level": 2,
          "type": "che_유가"
        }
      }
    ],
    "gameEnvironment": {
      "lastNPCTroopLeaderID": 40
    },
    "syncEnvironment": true
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190,
    "turnterm": 10,
    "turntime": "0200-01-01 00:00:00",
    "show_img_level": 3,
    "fiction": [0]
  },
  "observe": {}
 }
@@ -0,0 +1,65 @@
 {
    "action": "OpenNationBetting",
    "args": [1, 500],
    "setup": {
        "clearBetting": true,
        "resetNations": true,
        "deleteOtherNations": true,
        "keepNationIds": [1, 2],
        "nation": [
            {
                "id": 1,
                "values": {
                    "name": "위",
                    "color": "#111111",
                    "capital": 1,
                    "gennum": 1,
                    "gold": 1000,
                    "rice": 2000,
                    "tech": 100,
                    "power": 100,
                    "level": 2,
                    "type": "che_유가"
                }
            },
            {
                "id": 2,
                "values": {
                    "name": "촉",
                    "color": "#222222",
                    "capital": 2,
                    "gennum": 1,
                    "gold": 3000,
                    "rice": 4000,
                    "tech": 200,
                    "power": 300,
                    "level": 2,
                    "type": "che_병가"
                }
            }
        ],
        "resetCities": true,
        "city": [
            { "id": 1, "values": { "nation": 1, "level": 3 } },
            { "id": 2, "values": { "nation": 2, "level": 3 } }
        ],
        "resetGenerals": true,
        "deleteOtherGenerals": true,
        "keepGeneralIds": [1, 2],
        "general": [
            { "id": 1, "values": { "name": "장수1", "nation": 1, "city": 1, "owner": 1, "npc": 0 } },
            { "id": 2, "values": { "name": "장수2", "nation": 2, "city": 2, "owner": 2, "npc": 0 } }
        ],
        "syncEnvironment": true
    },
    "environment": {
        "year": 200,
        "month": 1,
        "startyear": 190
    },
    "observe": {
        "generalIds": [1, 2],
        "cityIds": [1, 2],
        "nationIds": [1, 2]
    }
 }
@@ -0,0 +1,178 @@
 {
  "action": "PostUpdateMonthly",
  "environment": {
    "year": 193,
    "month": 2,
    "startyear": 193,
    "seedYear": 193,
    "seedMonth": 1
  },
  "setup": {
    "world": {
      "hiddenSeed": "monthly-post-diplomacy-fixture"
    },
    "syncEnvironment": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2, 3, 4],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1, 2, 3, 4],
    "general": [
      {
        "id": 1,
        "values": {
          "name": "갑장",
          "nation": 1,
          "npc": 2,
          "crew": 0,
          "gold": 0,
          "rice": 0,
          "leadership": 10,
          "strength": 10,
          "intel": 10,
          "experience": 0,
          "dedication": 0
        }
      },
      {
        "id": 2,
        "values": {
          "name": "을장",
          "nation": 2,
          "npc": 2,
          "crew": 0,
          "gold": 0,
          "rice": 0,
          "leadership": 10,
          "strength": 10,
          "intel": 10,
          "experience": 0,
          "dedication": 0
        }
      },
      {
        "id": 3,
        "values": {
          "name": "병장",
          "nation": 3,
          "npc": 2,
          "crew": 0,
          "gold": 0,
          "rice": 0,
          "leadership": 10,
          "strength": 10,
          "intel": 10,
          "experience": 0,
          "dedication": 0
        }
      },
      {
        "id": 4,
        "values": {
          "name": "정장",
          "nation": 4,
          "npc": 2,
          "crew": 0,
          "gold": 0,
          "rice": 0,
          "leadership": 10,
          "strength": 10,
          "intel": 10,
          "experience": 0,
          "dedication": 0
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "갑국",
          "gennum": 2,
          "level": 1
        }
      },
      {
        "id": 2,
        "values": {
          "name": "을국",
          "gennum": 1,
          "level": 1
        }
      },
      {
        "id": 3,
        "values": {
          "name": "병국",
          "gennum": 1,
          "level": 1
        }
      },
      {
        "id": 4,
        "values": {
          "name": "정국",
          "gennum": 1,
          "level": 1
        }
      }
    ],
    "resetDiplomacy": true,
    "diplomacy": [
      {
        "fromNationId": 1,
        "toNationId": 2,
        "state": 1,
        "term": 1,
        "dead": 777
      },
      {
        "fromNationId": 2,
        "toNationId": 1,
        "state": 1,
        "term": 1,
        "dead": 888
      },
      {
        "fromNationId": 1,
        "toNationId": 3,
        "state": 0,
        "term": 5,
        "dead": 250
      },
      {
        "fromNationId": 3,
        "toNationId": 1,
        "state": 0,
        "term": 5,
        "dead": 50
      },
      {
        "fromNationId": 3,
        "toNationId": 4,
        "state": 0,
        "term": 1,
        "dead": 0
      },
      {
        "fromNationId": 4,
        "toNationId": 3,
        "state": 0,
        "term": 1,
        "dead": 0
      },
      {
        "fromNationId": 2,
        "toNationId": 4,
        "state": 7,
        "term": 1,
        "dead": 999
      }
    ]
  },
  "observe": {
    "generalIds": [1, 2, 3, 4],
    "nationIds": [1, 2, 3, 4]
  }
 }
@@ -0,0 +1,162 @@
 {
  "action": "PostUpdateMonthly",
  "environment": {
    "year": 193,
    "month": 2,
    "startyear": 193,
    "seedYear": 193,
    "seedMonth": 1
  },
  "setup": {
    "world": {
      "hiddenSeed": "monthly-post-nation-stats-fixture"
    },
    "syncEnvironment": true,
    "resetCities": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1, 2],
    "resetDiplomacy": true,
    "general": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "npc": 0,
          "gold": 1000,
          "rice": 2000,
          "crew": 100,
          "leadership": 50,
          "strength": 40,
          "intel": 30,
          "experience": 100,
          "dedication": 200,
          "dex1": 1000,
          "dex2": 0,
          "dex3": 0,
          "dex4": 0,
          "dex5": 0
        }
      },
      {
        "id": 2,
        "values": {
          "nation": 2,
          "npc": 2,
          "gold": 3000,
          "rice": 4000,
          "crew": 200,
          "leadership": 60,
          "strength": 50,
          "intel": 40,
          "experience": 300,
          "dedication": 400,
          "dex1": 2000,
          "dex2": 1000,
          "dex3": 0,
          "dex4": 0,
          "dex5": 0
        }
      }
    ],
    "rankData": [
      {"generalId": 1, "type": "killcrew_person", "value": 100},
      {"generalId": 1, "type": "deathcrew_person", "value": 0},
      {"generalId": 2, "type": "killcrew_person", "value": 0},
      {"generalId": 2, "type": "deathcrew_person", "value": 100}
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "갑국",
          "gold": 10000,
          "rice": 20000,
          "tech": 100,
          "level": 2,
          "gennum": 9,
          "power": 7
        }
      },
      {
        "id": 2,
        "values": {
          "name": "을국",
          "gold": 2000,
          "rice": 3000,
          "tech": 50,
          "level": 1,
          "gennum": 8,
          "power": 8
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "name": "갑성",
          "nation": 1,
          "level": 4,
          "supply": 1,
          "pop": 1000,
          "pop_max": 2000,
          "agri": 100,
          "agri_max": 200,
          "comm": 100,
          "comm_max": 200,
          "secu": 100,
          "secu_max": 200,
          "def": 100,
          "def_max": 200,
          "wall": 100,
          "wall_max": 200
        }
      },
      {
        "id": 2,
        "values": {
          "name": "을성",
          "nation": 2,
          "level": 4,
          "supply": 1,
          "pop": 2000,
          "pop_max": 4000,
          "agri": 200,
          "agri_max": 400,
          "comm": 200,
          "comm_max": 400,
          "secu": 200,
          "secu_max": 400,
          "def": 200,
          "def_max": 400,
          "wall": 200,
          "wall_max": 400
        }
      }
    ],
    "nationEnvironment": [
      {
        "nationId": 1,
        "key": "max_power",
        "value": {
          "maxPower": 999,
          "maxCrew": 50,
          "maxCities": ["옛도시", "옛도시2"]
        }
      },
      {"nationId": 1, "key": "available_war_setting_cnt", "value": 1}
    ]
  },
  "observe": {
    "generalIds": [1, 2],
    "nationIds": [1, 2],
    "cityIds": [1, 2],
    "rankGeneralIds": [1, 2],
    "rankTypes": ["killcrew_person", "deathcrew_person"],
    "nationEnvironmentKeys": ["max_power", "available_war_setting_cnt"]
  }
 }
@@ -0,0 +1,128 @@
 {
  "action": "PostUpdateMonthly",
  "environment": {
    "year": 193,
    "month": 2,
    "startyear": 193,
    "seedYear": 193,
    "seedMonth": 1
  },
  "setup": {
    "world": {
      "hiddenSeed": "monthly-post-tail-2"
    },
    "syncEnvironment": true,
    "clearNeutralAuctions": true,
    "resetCities": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1, 2],
    "resetDiplomacy": true,
    "gameEnvironment": {
      "tournament": 0,
      "tnmt_trig": true,
      "tnmt_pattern": [0, 1, 2, 3],
      "prev_winner": null
    },
    "general": [
      {
        "id": 1,
        "values": {
          "name": "갑장",
          "nation": 1,
          "city": 1,
          "officer_level": 12,
          "npc": 0,
          "gold": 5000,
          "rice": 7000,
          "crew": 100,
          "leadership": 50,
          "strength": 40,
          "intel": 30,
          "experience": 100,
          "dedication": 200
        }
      },
      {
        "id": 2,
        "values": {
          "name": "을장",
          "nation": 2,
          "city": 2,
          "officer_level": 12,
          "npc": 0,
          "gold": 6000,
          "rice": 8000,
          "crew": 200,
          "leadership": 60,
          "strength": 50,
          "intel": 40,
          "experience": 300,
          "dedication": 400
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "갑국",
          "capital": 1,
          "gold": 10000,
          "rice": 20000,
          "tech": 100,
          "level": 2,
          "gennum": 1,
          "power": 7
        }
      },
      {
        "id": 2,
        "values": {
          "name": "을국",
          "capital": 2,
          "gold": 2000,
          "rice": 3000,
          "tech": 50,
          "level": 1,
          "gennum": 1,
          "power": 8
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "name": "갑성",
          "nation": 1,
          "level": 4,
          "supply": 1,
          "front": 3,
          "pop": 1000,
          "pop_max": 2000
        }
      },
      {
        "id": 2,
        "values": {
          "name": "을성",
          "nation": 2,
          "level": 4,
          "supply": 1,
          "front": 3,
          "pop": 2000,
          "pop_max": 4000
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1, 2],
    "nationIds": [1, 2],
    "cityIds": [1, 2]
  }
 }
@@ -0,0 +1,143 @@
 {
  "action": "PostUpdateMonthly",
  "environment": {
    "year": 195,
    "month": 2,
    "startyear": 193,
    "seedYear": 195,
    "seedMonth": 1
  },
  "setup": {
    "world": {
      "hiddenSeed": "monthly-post-wander-fixture"
    },
    "syncEnvironment": true,
    "resetCities": true,
    "city": [
      {
        "id": 1,
        "values": {
          "name": "방랑성",
          "nation": 4,
          "level": 4,
          "front": 1
        }
      },
      {
        "id": 2,
        "values": {
          "name": "존속성",
          "nation": 1,
          "level": 4,
          "front": 1
        }
      }
    ],
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2, 3],
    "general": [
      {
        "id": 1,
        "values": {
          "name": "방랑주",
          "nation": 4,
          "city": 1,
          "officer_level": 12,
          "npc": 2,
          "gold": 2000,
          "rice": 3000,
          "crew": 100,
          "makelimit": 0,
          "belong": 7,
          "leadership": 50,
          "strength": 40,
          "intel": 30,
          "experience": 100,
          "dedication": 200
        }
      },
      {
        "id": 2,
        "values": {
          "name": "방랑객",
          "nation": 4,
          "city": 1,
          "officer_level": 1,
          "npc": 0,
          "gold": 1500,
          "rice": 4000,
          "crew": 200,
          "makelimit": 0,
          "belong": 5,
          "leadership": 60,
          "strength": 50,
          "intel": 40,
          "experience": 300,
          "dedication": 400
        }
      },
      {
        "id": 3,
        "values": {
          "name": "존속장",
          "nation": 1,
          "city": 2,
          "officer_level": 12,
          "npc": 2,
          "gold": 500,
          "rice": 500,
          "crew": 50,
          "leadership": 50,
          "strength": 50,
          "intel": 50,
          "experience": 0,
          "dedication": 0
        }
      }
    ],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1, 4],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "존속국",
          "gennum": 1,
          "level": 1
        }
      },
      {
        "id": 4,
        "values": {
          "name": "방랑국",
          "gennum": 2,
          "level": 0
        }
      }
    ],
    "resetDiplomacy": true,
    "diplomacy": [
      {
        "fromNationId": 1,
        "toNationId": 4,
        "state": 2,
        "term": 0,
        "dead": 0
      },
      {
        "fromNationId": 4,
        "toNationId": 1,
        "state": 2,
        "term": 0,
        "dead": 0
      }
    ]
  },
  "observe": {
    "generalIds": [1, 2, 3],
    "nationIds": [1, 4],
    "cityIds": [1, 2]
  }
 }
@@ -0,0 +1,49 @@
 {
  "action": "PreUpdateMonthly",
  "environment": {
    "year": 200,
    "month": 12,
    "startyear": 190
  },
  "setup": {
    "syncEnvironment": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1, 2],
    "general": [
      {"id": 1, "values": {"makelimit": 2}},
      {"id": 2, "values": {"makelimit": 0}}
    ],
    "generalAccessLog": [
      {"generalId": 1, "refreshScoreTotal": 101},
      {"generalId": 2, "refreshScoreTotal": 1}
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "rate": 35,
          "rate_tmp": 10,
          "strategic_cmd_limit": 2,
          "surlimit": 1,
          "spy": "{\"1\":1,\"2\":2}"
        }
      }
    ],
    "city": [
      {"id": 1, "values": {"state": 31, "term": 1, "conflict": {"1": 10}}},
      {"id": 2, "values": {"state": 32, "term": 2, "conflict": {"1": 20}}},
      {"id": 3, "values": {"state": 33, "term": 0, "conflict": {"1": 30}}},
      {"id": 4, "values": {"state": 34, "term": 3, "conflict": {"1": 40}}},
      {"id": 5, "values": {"state": 41, "term": 1, "conflict": {"1": 50}}},
      {"id": 6, "values": {"state": 42, "term": 2, "conflict": {"1": 60}}},
      {"id": 7, "values": {"state": 43, "term": 3, "conflict": {"1": 70}}}
    ]
  },
  "observe": {
    "generalIds": [1, 2],
    "nationIds": [1],
    "cityIds": [1, 2, 3, 4, 5, 6, 7],
    "accessGeneralIds": [1, 2]
  }
 }
@@ -0,0 +1,76 @@
 {
  "action": "ProcessIncome",
  "args": ["gold"],
  "environment": {
    "year": 190,
    "month": 7,
    "startyear": 190
  },
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1],
    "general": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "city": 1,
          "officer_level": 5,
          "npc": 0,
          "gold": 1000,
          "rice": 1000,
          "dedication": 100
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "갑국",
          "capital": 1,
          "gold": 10000,
          "rice": 20000,
          "level": 1,
          "rate": 35,
          "rate_tmp": 10
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "name": "갑성",
          "nation": 1,
          "level": 4,
          "supply": 1,
          "pop": 10000,
          "pop_max": 20000,
          "agri": 1000,
          "agri_max": 2000,
          "comm": 1000,
          "comm_max": 2000,
          "secu": 1000,
          "secu_max": 2000,
          "trust": 80,
          "def": 500,
          "def_max": 1000,
          "wall": 500,
          "wall_max": 1000
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1],
    "nationIds": [1],
    "cityIds": [1],
    "nationEnvironmentKeys": ["prev_income_gold", "prev_income_rice"]
  }
 }
@@ -0,0 +1,106 @@
 {
  "action": "ProcessSemiAnnual",
  "resource": "gold",
  "environment": {
    "year": 193,
    "month": 1,
    "startyear": 190
  },
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "반기검증국",
          "gold": 100001,
          "rice": 7777,
          "rate_tmp": 20,
          "type": "che_도가"
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "supply": 1,
          "pop": 10000,
          "pop_max": 50000,
          "agri": 1001,
          "agri_max": 5000,
          "comm": 1001,
          "comm_max": 5000,
          "secu": 1001,
          "secu_max": 2000,
          "trust": 55,
          "def": 1001,
          "def_max": 5000,
          "wall": 1001,
          "wall_max": 5000,
          "dead": 123
        }
      },
      {
        "id": 2,
        "values": {
          "nation": 1,
          "supply": 0,
          "pop": 10000,
          "pop_max": 50000,
          "agri": 1001,
          "agri_max": 5000,
          "comm": 1001,
          "comm_max": 5000,
          "secu": 1001,
          "secu_max": 2000,
          "trust": 55,
          "def": 1001,
          "def_max": 5000,
          "wall": 1001,
          "wall_max": 5000,
          "dead": 123
        }
      },
      {
        "id": 3,
        "values": {
          "nation": 0,
          "supply": 1,
          "pop": 10000,
          "pop_max": 50000,
          "agri": 1001,
          "agri_max": 5000,
          "comm": 1001,
          "comm_max": 5000,
          "secu": 1001,
          "secu_max": 2000,
          "trust": 55,
          "def": 1001,
          "def_max": 5000,
          "wall": 1001,
          "wall_max": 5000,
          "dead": 123
        }
      }
    ],
    "general": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "city": 1,
          "gold": 10001,
          "rice": 8888
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1],
    "cityIds": [1, 2, 3],
    "nationIds": [1]
  }
 }
@@ -0,0 +1,65 @@
 {
  "action": "ProcessSemiAnnual",
  "resource": "gold",
  "environment": {
    "year": 193,
    "month": 1,
    "startyear": 190
  },
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "반기검증국",
          "gold": 100001,
          "rice": 7777,
          "rate": 50,
          "rate_tmp": 20,
          "type": "che_중립"
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "supply": 1,
          "pop": 10000,
          "pop_max": 50000,
          "agri": 1001,
          "agri_max": 5000,
          "comm": 1001,
          "comm_max": 5000,
          "secu": 1001,
          "secu_max": 2000,
          "trust": 55,
          "def": 1001,
          "def_max": 5000,
          "wall": 1001,
          "wall_max": 5000,
          "dead": 123
        }
      }
    ],
    "general": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "city": 1,
          "gold": 10001,
          "rice": 8888
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1],
    "cityIds": [1],
    "nationIds": [1]
  }
 }
@@ -0,0 +1,96 @@
 {
  "action": "ProcessWarIncome",
  "environment": {
    "year": 193,
    "month": 1,
    "startyear": 190
  },
  "setup": {
    "resetCities": true,
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "전쟁수입국",
          "gold": 1000,
          "level": 1,
          "type": "che_중립"
        }
      },
      {
        "id": 2,
        "values": {
          "name": "비활성국",
          "gold": 2000,
          "level": 0,
          "type": "che_중립"
        }
      },
      {
        "id": 3,
        "values": {
          "name": "법가국",
          "gold": 3000,
          "level": 1,
          "type": "che_법가"
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "supply": 1,
          "pop": 1000,
          "pop_max": 2000,
          "dead": 101
        }
      },
      {
        "id": 2,
        "values": {
          "nation": 1,
          "supply": 0,
          "pop": 1000,
          "pop_max": 2000,
          "dead": 999
        }
      },
      {
        "id": 3,
        "values": {
          "nation": 2,
          "supply": 1,
          "pop": 1000,
          "pop_max": 2000,
          "dead": 1000
        }
      },
      {
        "id": 4,
        "values": {
          "nation": 3,
          "supply": 1,
          "pop": 1000,
          "pop_max": 2000,
          "dead": 105
        }
      },
      {
        "id": 5,
        "values": {
          "nation": 0,
          "supply": 1,
          "pop": 999,
          "pop_max": 1000,
          "dead": 10
        }
      }
    ]
  },
  "observe": {
    "cityIds": [1, 2, 3, 4, 5],
    "nationIds": [1, 2, 3]
  }
 }
@@ -0,0 +1,105 @@
 {
  "action": "RaiseInvader",
  "compactOutput": true,
  "args": [10, 150, 100, 20],
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "deleteOtherGenerals": true,
    "keepGeneralIds": [1],
    "resetNations": true,
    "deleteOtherNations": true,
    "keepNationIds": [1],
    "city": [
      {
        "id": 1,
        "values": {
          "level": 3,
          "nation": 1,
          "pop": 1000,
          "pop_max": 10000,
          "agri": 2000,
          "agri_max": 20000,
          "comm": 3000,
          "comm_max": 30000,
          "secu": 4000,
          "secu_max": 40000,
          "def": 5000,
          "def_max": 50000,
          "wall": 6000,
          "wall_max": 60000
        }
      },
      {
        "id": 48,
        "values": {
          "level": 4,
          "nation": 0,
          "pop": 1000,
          "pop_max": 10000,
          "agri": 2000,
          "agri_max": 20000,
          "comm": 3000,
          "comm_max": 30000,
          "secu": 4000,
          "secu_max": 40000,
          "def": 5000,
          "def_max": 50000,
          "wall": 6000,
          "wall_max": 60000
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "기준국",
          "capital": 1,
          "gennum": 1,
          "tech": 100,
          "level": 2,
          "type": "che_유가"
        }
      }
    ],
    "general": [
      {
        "id": 1,
        "values": {
          "name": "군주",
          "nation": 1,
          "city": 1,
          "officer_level": 12,
          "npc": 0,
          "leadership": 50,
          "strength": 50,
          "intel": 50,
          "experience": 1000,
          "dedication": 1000,
          "dex1": 10,
          "dex2": 20,
          "dex3": 30,
          "dex4": 40,
          "dex5": 50,
          "turntime": "0200-01-01 00:05:00"
        }
      }
    ],
    "syncEnvironment": true
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190,
    "turnterm": 10,
    "turntime": "0200-01-01 00:00:00",
    "show_img_level": 3,
    "fiction": [0]
  },
  "observe": {
    "generalIds": [1],
    "cityIds": [1, 48],
    "nationIds": [1]
  }
 }
@@ -0,0 +1,77 @@
 {
  "action": "RaiseNPCNation",
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "resetNations": true,
    "city": [
      {
        "id": 1,
        "values": {
          "name": "점유도시",
          "level": 5,
          "nation": 1,
          "pop": 10001,
          "pop_max": 50001,
          "agri": 1001,
          "agri_max": 5001,
          "comm": 2001,
          "comm_max": 6001,
          "secu": 3001,
          "secu_max": 7001,
          "def": 4001,
          "def_max": 8001,
          "wall": 5001,
          "wall_max": 9001
        }
      },
      {
        "id": 48,
        "values": {
          "name": "건국도시",
          "level": 5,
          "nation": 0,
          "pop": 10048,
          "pop_max": 50048,
          "agri": 1048,
          "agri_max": 5048,
          "comm": 2048,
          "comm_max": 6048,
          "secu": 3048,
          "secu_max": 7048,
          "def": 4048,
          "def_max": 8048,
          "wall": 5048,
          "wall_max": 9048
        }
      }
    ],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "기준국",
          "capital": 1,
          "gennum": 1,
          "tech": 120,
          "level": 2,
          "type": "che_유가"
        }
      }
    ],
    "syncEnvironment": true
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190,
    "turnterm": 10,
    "turntime": "0200-01-01 00:00:00",
    "show_img_level": 3,
    "fiction": [0]
  },
  "observe": {
    "cityIds": [1, 48],
    "nationIds": [1]
  }
 }
@@ -0,0 +1,35 @@
 {
  "action": "RegNeutralNPC",
  "args": [
    0,
    "등록재야",
    null,
    0,
    33,
    45,
    55,
    65,
    180,
    245,
    null,
    "무쌍",
    ""
  ],
  "setup": {
    "syncEnvironment": true
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190,
    "turnterm": 10,
    "turntime": "0200-01-01 00:00:00",
    "show_img_level": 3,
    "fiction": [0]
  },
  "observe": {
    "generalIds": [],
    "cityIds": [33],
    "nationIds": [1]
  }
 }
@@ -0,0 +1,36 @@
 {
  "action": "RegNPC",
  "args": [
    0,
    "등록장수",
    null,
    0,
    33,
    60,
    50,
    40,
    7,
    186,
    240,
    null,
    "인덕",
    "등록 대사"
  ],
  "setup": {
    "syncEnvironment": true
  },
  "environment": {
    "year": 200,
    "month": 1,
    "startyear": 190,
    "turnterm": 10,
    "turntime": "0200-01-01 00:00:00",
    "show_img_level": 3,
    "fiction": [0]
  },
  "observe": {
    "generalIds": [],
    "cityIds": [33],
    "nationIds": [1]
  }
 }
@@ -0,0 +1,24 @@
 {
    "action": "UnblockScoutAction",
    "args": [false],
    "setup": {
        "resetNations": true,
        "deleteOtherNations": true,
        "keepNationIds": [1, 2],
        "nation": [
            { "id": 1, "values": { "name": "위", "level": 2, "scout": 1 } },
            { "id": 2, "values": { "name": "촉", "level": 2, "scout": 1 } }
        ],
        "gameEnvironment": {
            "block_change_scout": true
        }
    },
    "environment": {
        "year": 200,
        "month": 1,
        "startyear": 190
    },
    "observe": {
        "nationIds": [1, 2]
    }
 }
@@ -0,0 +1,140 @@
 {
  "action": "UpdateCitySupply",
  "environment": {
    "year": 193,
    "month": 1,
    "startyear": 190
  },
  "setup": {
    "nation": [
      {
        "id": 99,
        "values": {
          "name": "보급검증국",
          "color": "#777777",
          "capital": 1,
          "level": 1,
          "type": "che_중립"
        }
      },
      {
        "id": 98,
        "values": {
          "name": "불일치수도국",
          "color": "#888888",
          "capital": 2,
          "level": 1,
          "type": "che_중립"
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "nation": 99,
          "supply": 0,
          "front": 2,
          "pop": 1001,
          "agri": 501,
          "comm": 499,
          "secu": 99,
          "trust": 50,
          "def": 101,
          "wall": 50,
          "officer_set": 7,
          "term": 2,
          "conflict": {"98": 3}
        }
      },
      {
        "id": 9,
        "values": {
          "nation": 99,
          "supply": 0,
          "front": 2,
          "pop": 1001,
          "agri": 501,
          "comm": 499,
          "secu": 99,
          "trust": 50,
          "def": 101,
          "wall": 50,
          "officer_set": 7,
          "term": 2,
          "conflict": {"98": 3}
        }
      },
      {
        "id": 2,
        "values": {
          "nation": 99,
          "supply": 1,
          "front": 2,
          "pop": 1001,
          "agri": 501,
          "comm": 499,
          "secu": 99,
          "trust": 33,
          "def": 101,
          "wall": 50,
          "officer_set": 7,
          "term": 2,
          "conflict": {"98": 3}
        }
      },
      {
        "id": 3,
        "values": {
          "nation": 0,
          "supply": 0,
          "front": 0,
          "trust": 50
        }
      }
    ],
    "general": [
      {
        "id": 1,
        "values": {
          "nation": 99,
          "city": 2,
          "officer_level": 4,
          "officer_city": 2,
          "crew": 101,
          "train": 51,
          "atmos": 99
        }
      },
      {
        "id": 2,
        "values": {
          "nation": 99,
          "city": 1,
          "officer_level": 4,
          "officer_city": 2,
          "crew": 101,
          "train": 51,
          "atmos": 99
        }
      },
      {
        "id": 3,
        "values": {
          "nation": 98,
          "city": 2,
          "officer_level": 3,
          "officer_city": 1,
          "crew": 101,
          "train": 51,
          "atmos": 99
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1, 2, 3],
    "cityIds": [1, 2, 3, 9],
    "nationIds": [98, 99]
  }
 }
@@ -0,0 +1,85 @@
 {
  "action": "UpdateNationLevel",
  "environment": {
    "year": 193,
    "month": 2,
    "startyear": 190,
    "killturn": 1000,
    "turnterm": 10
  },
  "setup": {
    "resetCities": true,
    "resetGenerals": true,
    "resetUniqueOccupancy": true,
    "syncEnvironment": true,
    "clearNationTurnIds": [1],
    "clearInheritanceOwnerIds": [990061],
    "nation": [
      {
        "id": 1,
        "values": {
          "name": "작위검증국",
          "color": "#777777",
          "capital": 1,
          "gold": 10000,
          "rice": 20000,
          "level": 0,
          "type": "che_중립",
          "aux": {}
        }
      }
    ],
    "city": [
      {
        "id": 1,
        "values": {
          "nation": 1,
          "level": 4
        }
      },
      {
        "id": 2,
        "values": {
          "nation": 1,
          "level": 4
        }
      }
    ],
    "general": [
      {
        "id": 1,
        "values": {
          "name": "조조",
          "nation": 1,
          "city": 1,
          "officer_level": 12,
          "owner": 990061,
          "npc": 0,
          "killturn": 1000,
          "belong": 10,
          "horse": "None",
          "weapon": "None",
          "book": "None",
          "item": "None",
          "aux": {}
        }
      },
      {
        "id": 2,
        "values": {
          "nation": 0,
          "city": 2,
          "officer_level": 1,
          "npc": 0,
          "killturn": 0
        }
      }
    ]
  },
  "observe": {
    "generalIds": [1],
    "cityIds": [1, 2],
    "nationIds": [1],
    "ownerIds": [990061]
  }
 }
@@ -0,0 +1,40 @@
 <?php
 declare(strict_types=1);
 namespace sammo;
 if (PHP_SAPI !== 'cli') {
    http_response_code(404);
    exit;
 }
 chdir(dirname(__DIR__));
 require_once 'lib.php';
 require_once 'func.php';
 $input = stream_get_contents(STDIN);
 $keys = Json::decode($input);
 if (!is_array($keys)) {
    fwrite(STDERR, "Expected a JSON array of item keys.\n");
    exit(2);
 }
 $result = [];
 foreach ($keys as $key) {
    if (!is_string($key)) {
        continue;
    }
    $item = buildItemClass($key);
    $result[$key] = [
        'rawName' => $item->getRawName(),
        'name' => $item->getName(),
        'info' => $item->getInfo(),
        'cost' => $item->getCost(),
        'buyable' => $item->isBuyable(),
        'consumable' => $item->isConsumable(),
        'reqSecu' => $item->getReqSecu(),
    ];
 }
 echo Json::encode($result);
@@ -0,0 +1,1579 @@
 <?php
 declare(strict_types=1);
 namespace sammo;
 if (PHP_SAPI !== 'cli' || getenv('TURN_DIFFERENTIAL_ENABLED') !== '1') {
    http_response_code(404);
    exit;
 }
 chdir(dirname(__DIR__));
 $_SERVER['REMOTE_ADDR'] ??= '127.0.0.1';
 error_reporting(E_ALL & ~E_DEPRECATED);
 require_once 'lib.php';
 require_once 'func.php';
 require_once __DIR__ . '/turn_state_snapshot.php';
 /** @param array<string, mixed> $values */
 function comparisonMonthlyPatch(string $table, int $id, array $values): void
 {
    $definitions = [
        'city' => [
            'idColumn' => 'city',
            'allowed' => [
                'name', 'level', 'nation', 'supply', 'front', 'pop', 'pop_max',
                'agri', 'agri_max', 'comm', 'comm_max', 'secu', 'secu_max',
                'trust', 'trade', 'def', 'def_max', 'wall', 'wall_max',
                'officer_set', 'state', 'region', 'term', 'conflict', 'dead',
            ],
        ],
        'nation' => [
            'idColumn' => 'nation',
            'allowed' => [
                'name', 'color', 'capital', 'gennum', 'gold', 'rice', 'tech',
                'power', 'level', 'type', 'bill', 'rate_tmp', 'scout', 'chief_set', 'aux',
                'rate', 'strategic_cmd_limit', 'surlimit', 'spy',
            ],
        ],
        'general' => [
            'idColumn' => 'no',
            'allowed' => [
                'name', 'nation', 'city', 'officer_level', 'officer_city',
                'crew', 'train', 'atmos', 'owner', 'npc', 'killturn', 'belong',
                'gold', 'rice', 'horse', 'weapon', 'book', 'item', 'aux',
                'leadership', 'strength', 'intel', 'experience', 'dedication',
                'injury',
                'dex1', 'dex2', 'dex3', 'dex4', 'dex5', 'personal', 'special',
                'specage', 'special2', 'specage2', 'betray', 'age',
                'bornyear', 'deadyear', 'turntime', 'makelimit',
            ],
        ],
    ];
    $definition = $definitions[$table] ?? null;
    if ($definition === null) {
        throw new \InvalidArgumentException("unsupported setup table: {$table}");
    }
    $patch = [];
    foreach ($values as $key => $value) {
        if (!is_string($key) || !in_array($key, $definition['allowed'], true)) {
            throw new \InvalidArgumentException("unsupported {$table} setup field");
        }
        if (in_array($key, ['conflict', 'aux'], true) && is_array($value)) {
            $value = json_encode($value, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
        }
        $patch[$key] = $value;
    }
    if ($table === 'nation') {
        $patch += [
            'nation' => $id,
            'name' => "fixture-nation-{$id}",
            'color' => '#777777',
            'capital' => 0,
            'gold' => 0,
            'rice' => 0,
            'level' => 1,
            'type' => 'che_중립',
            'aux' => '{}',
        ];
        DB::db()->insertUpdate('nation', $patch, $patch);
    } elseif ($patch !== []) {
        DB::db()->update($table, $patch, "`{$definition['idColumn']}` = %i", $id);
    }
 }
 /** @param array<string, mixed> $observe */
 function comparisonMonthlyDetails(array $observe, int $worldHistoryAfterId): array
 {
    $db = DB::db();
    $generals = array_map(
        static fn(array $row): array => comparisonPickRow(
            $row,
            [
                'id' => 'no',
                'nationId' => 'nation',
                'cityId' => 'city',
                'officerLevel' => 'officer_level',
                'officerCityId' => 'officer_city',
                'crew' => 'crew',
                'train' => 'train',
                'atmos' => 'atmos',
                'gold' => 'gold',
                'rice' => 'rice',
                'injury' => 'injury',
                'leadership' => 'leadership',
                'strength' => 'strength',
                'intelligence' => 'intel',
                'age' => 'age',
                'specialDomestic' => 'special',
                'specAge' => 'specage',
                'specialWar' => 'special2',
                'specAge2' => 'specage2',
                'betray' => 'betray',
                'makeLimit' => 'makelimit',
                'horse' => 'horse',
                'weapon' => 'weapon',
                'book' => 'book',
                'item' => 'item',
                'dex1' => 'dex1',
                'dex2' => 'dex2',
                'dex3' => 'dex3',
                'dex4' => 'dex4',
                'dex5' => 'dex5',
                'aux' => 'aux',
            ],
            ['aux'],
        ),
        comparisonRowsById('general', 'no', comparisonIntegerList($observe['generalIds'] ?? [], 'generalIds')),
    );
    $cities = array_map(
        static fn(array $row): array => comparisonPickRow(
            $row,
            [
                'id' => 'city',
                'nationId' => 'nation',
                'state' => 'state',
                'supplyState' => 'supply',
                'frontState' => 'front',
                'officerSet' => 'officer_set',
                'term' => 'term',
                'dead' => 'dead',
                'population' => 'pop',
                'populationMax' => 'pop_max',
                'agriculture' => 'agri',
                'agricultureMax' => 'agri_max',
                'commerce' => 'comm',
                'commerceMax' => 'comm_max',
                'security' => 'secu',
                'securityMax' => 'secu_max',
                'trust' => 'trust',
                'trade' => 'trade',
                'defence' => 'def',
                'defenceMax' => 'def_max',
                'wall' => 'wall',
                'wallMax' => 'wall_max',
                'conflict' => 'conflict',
            ],
            ['conflict'],
        ),
        comparisonRowsById('city', 'city', comparisonIntegerList($observe['cityIds'] ?? [], 'cityIds')),
    );
    $nations = array_map(
        static fn(array $row): array => comparisonPickRow(
            $row,
            [
                'id' => 'nation',
                'gold' => 'gold',
                'rice' => 'rice',
                'rate' => 'rate_tmp',
                'baseRate' => 'rate',
                'power' => 'power',
                'generalCount' => 'gennum',
                'tech' => 'tech',
                'typeCode' => 'type',
                'scout' => 'scout',
                'strategicCommandLimit' => 'strategic_cmd_limit',
                'surrenderLimit' => 'surlimit',
                'spy' => 'spy',
                'chiefSet' => 'chief_set',
            ],
            ['spy'],
        ),
        comparisonRowsById('nation', 'nation', comparisonIntegerList($observe['nationIds'] ?? [], 'nationIds')),
    );
    $worldHistory = array_map(
        static fn(array $row): array => comparisonPickRow(
            $row,
            [
                'id' => 'id',
                'nationId' => 'nation_id',
                'year' => 'year',
                'month' => 'month',
                'text' => 'text',
            ],
        ),
        $db->query(
            'SELECT id, nation_id, year, month, text FROM world_history WHERE id > %i ORDER BY id',
            $worldHistoryAfterId,
        ),
    );
    $inheritanceKeys = $observe['inheritanceKeys'] ?? ['unifier'];
    if (!is_array($inheritanceKeys) || array_filter($inheritanceKeys, static fn($key): bool => !is_string($key))) {
        throw new \InvalidArgumentException('inheritanceKeys must be an array of strings');
    }
    $inheritancePoints = [];
    foreach (comparisonIntegerList($observe['ownerIds'] ?? [], 'ownerIds') as $ownerId) {
        $entry = ['ownerId' => $ownerId];
        foreach ($inheritanceKeys as $key) {
            $value = $db->queryFirstField(
                'SELECT value FROM storage WHERE namespace = %s AND `key` = %s',
                "inheritance_{$ownerId}",
                $key,
            );
            $entry[$key] = $value === null ? 0 : (comparisonJsonValue($value)[0] ?? 0);
        }
        $inheritancePoints[] = $entry;
    }
    $rankGeneralIds = comparisonIntegerList($observe['rankGeneralIds'] ?? [], 'rankGeneralIds');
    $rankTypes = $observe['rankTypes'] ?? [];
    if (!is_array($rankTypes) || array_filter($rankTypes, static fn($type): bool => !is_string($type))) {
        throw new \InvalidArgumentException('rankTypes must be an array of strings');
    }
    $rankData = (!$rankGeneralIds || !$rankTypes)
        ? []
        : iterator_to_array($db->query(
            'SELECT general_id AS generalId, nation_id AS nationId, `type`, `value` FROM rank_data WHERE general_id IN %li AND `type` IN %ls ORDER BY general_id, `type`',
            $rankGeneralIds,
            $rankTypes,
        ));
    $generalAccessLogs = [];
    $accessGeneralIds = comparisonIntegerList($observe['accessGeneralIds'] ?? [], 'accessGeneralIds');
    if ($accessGeneralIds) {
        $generalAccessLogs = iterator_to_array($db->query(
            'SELECT general_id AS generalId, refresh_score_total AS refreshScoreTotal FROM general_access_log WHERE general_id IN %li ORDER BY general_id',
            $accessGeneralIds,
        ));
    }
    $nationEnvironment = [];
    $nationEnvironmentKeys = $observe['nationEnvironmentKeys'] ?? [];
    if (
        !is_array($nationEnvironmentKeys)
        || array_filter($nationEnvironmentKeys, static fn($key): bool => !is_string($key))
    ) {
        throw new \InvalidArgumentException('nationEnvironmentKeys must be an array of strings');
    }
    foreach (comparisonIntegerList($observe['nationIds'] ?? [], 'nationIds') as $nationId) {
        $entry = ['nationId' => $nationId];
        $storage = KVStorage::getStorage($db, $nationId, 'nation_env');
        foreach ($nationEnvironmentKeys as $key) {
            $entry[$key] = $storage->getValue($key);
        }
        $nationEnvironment[] = $entry;
    }
    return [
        'generals' => $generals,
        'cities' => $cities,
        'nations' => $nations,
        'worldHistory' => $worldHistory,
        'inheritancePoints' => $inheritancePoints,
        'rankData' => $rankData,
        'generalAccessLogs' => $generalAccessLogs,
        'nationEnvironment' => $nationEnvironment,
    ];
 }
 /**
 * Exercise the dynamically-created invader events against one evolving database.
 *
 * @param array<string, mixed> $request
 * @param array<string, mixed> $environment
 * @return array<string, mixed>
 */
 function comparisonInvaderLifecycleTrace(
    array $request,
    array $environment,
    int $generalIdBeforeAction,
    int $nationIdBeforeAction,
    int $eventIdBeforeAction,
    int $worldHistoryIdBeforeAction,
 ): array {
    $db = DB::db();
    $args = $request['args'] ?? [];
    if (!is_array($args) || count($args) > 4) {
        throw new \InvalidArgumentException('InvaderLifecycle args must have at most four entries');
    }
    $year = $environment['year'];
    $month = $environment['month'];
    $startYear = $environment['startyear'];
    $raiseEnvironment = [
        'year' => $year,
        'month' => $month,
        'startyear' => $startYear,
        'turnterm' => $environment['turnterm'],
        'turntime' => $environment['turntime'],
        'show_img_level' => $environment['show_img_level'] ?? 3,
        'stored_icons' => $environment['stored_icons'] ?? [],
        'icon_path' => $environment['icon_path'] ?? '.',
        'fiction' => $environment['fiction'] ?? [0],
    ];
    (new \sammo\Event\Action\RaiseInvader(...$args))->run($raiseEnvironment);
    $invaderNationIds = array_map(
        'intval',
        $db->queryFirstColumn('SELECT nation FROM nation WHERE nation > %i ORDER BY nation', $nationIdBeforeAction),
    );
    $existingNationId = (int)$db->queryFirstField(
        'SELECT nation FROM nation WHERE nation <= %i ORDER BY nation LIMIT 1',
        $nationIdBeforeAction,
    );
    $rulerIds = array_map(
        'intval',
        $db->queryFirstColumn(
            'SELECT no FROM general WHERE nation IN %li AND officer_level = 12 ORDER BY nation',
            $invaderNationIds,
        ),
    );
    if ($invaderNationIds === [] || $existingNationId <= 0 || count($rulerIds) !== count($invaderNationIds)) {
        throw new \RuntimeException('InvaderLifecycle failed to create the expected entities');
    }
    $autoDeleteEvents = [];
    $endingEventId = 0;
    foreach ($db->query('SELECT id, action FROM event WHERE id > %i ORDER BY id', $eventIdBeforeAction) as $row) {
        $action = comparisonJsonValue($row['action']);
        $actionName = $action[0][0] ?? null;
        if ($actionName === 'AutoDeleteInvader') {
            $autoDeleteEvents[] = [
                'eventId' => (int)$row['id'],
                'nationId' => (int)($action[0][1] ?? 0),
            ];
        } elseif ($actionName === 'InvaderEnding') {
            $endingEventId = (int)$row['id'];
        }
    }
    if (count($autoDeleteEvents) !== count($invaderNationIds) || $endingEventId <= 0) {
        throw new \RuntimeException('InvaderLifecycle failed to create follow-up events');
    }
    $diplomacyRows = iterator_to_array($db->query(
        'SELECT me, you, state, term FROM diplomacy WHERE (me IN %li AND you = %i) OR (me = %i AND you IN %li) ORDER BY me, you',
        $invaderNationIds,
        $existingNationId,
        $existingNationId,
        $invaderNationIds,
    ));
    $diplomacyStates = array_values(array_unique(array_map(
        static fn(array $row): string => "{$row['state']}:{$row['term']}",
        $diplomacyRows,
    )));
    sort($diplomacyStates);
    $generalCounts = array_map(
        static fn(int $nationId): int => (int)DB::db()->queryFirstField(
            'SELECT count(*) FROM general WHERE nation = %i',
            $nationId,
        ),
        $invaderNationIds,
    );
    $diplomacyCounts = array_map(
        static fn(int $nationId): int => (int)DB::db()->queryFirstField(
            'SELECT count(*) FROM diplomacy WHERE (me = %i AND you = %i) OR (me = %i AND you = %i)',
            $nationId,
            $existingNationId,
            $existingNationId,
            $nationId,
        ),
        $invaderNationIds,
    );
    $gameStorage = KVStorage::getStorage($db, 'game_env');
    $afterRaise = [
        'createdNationCount' => count($invaderNationIds),
        'createdGeneralCount' => (int)$db->queryFirstField(
            'SELECT count(*) FROM general WHERE no > %i',
            $generalIdBeforeAction,
        ),
        'followUpEventCount' => (int)$db->queryFirstField(
            'SELECT count(*) FROM event WHERE id > %i',
            $eventIdBeforeAction,
        ),
        'generalCountsPerNation' => array_values(array_unique($generalCounts)),
        'diplomacyCountsPerNation' => array_values(array_unique($diplomacyCounts)),
        'diplomacyStates' => $diplomacyStates,
        'isunited' => (int)$gameStorage->isunited,
        'blockChangeScout' => (bool)$gameStorage->block_change_scout,
    ];
    $warResults = [];
    foreach ($autoDeleteEvents as $autoDeleteEvent) {
        $warResult = (new \sammo\Event\Action\AutoDeleteInvader($autoDeleteEvent['nationId']))->run([
            'year' => $year,
            'month' => $month + 1,
            'startyear' => $startYear,
            'currentEventID' => $autoDeleteEvent['eventId'],
        ]);
        $warResults[] = $warResult[1] ?? null;
    }
    $atWar = [
        'results' => array_values(array_unique($warResults)),
        'autoDeleteEventCount' => (int)$db->queryFirstField(
            'SELECT count(*) FROM event WHERE id IN %li',
            array_column($autoDeleteEvents, 'eventId'),
        ),
    ];
    $db->update(
        'diplomacy',
        ['state' => 2, 'term' => 0],
        'me IN %li OR you IN %li',
        $invaderNationIds,
        $invaderNationIds,
    );
    $peaceResults = [];
    foreach ($autoDeleteEvents as $autoDeleteEvent) {
        $peaceResult = (new \sammo\Event\Action\AutoDeleteInvader($autoDeleteEvent['nationId']))->run([
            'year' => $year,
            'month' => $month + 2,
            'startyear' => $startYear,
            'currentEventID' => $autoDeleteEvent['eventId'],
        ]);
        $peaceResults[] = $peaceResult[1] ?? null;
    }
    $atPeace = [
        'results' => array_values(array_unique($peaceResults)),
        'autoDeleteEventCount' => (int)$db->queryFirstField(
            'SELECT count(*) FROM event WHERE id IN %li',
            array_column($autoDeleteEvents, 'eventId'),
        ),
        'rulerWanderTurnCount' => (int)$db->queryFirstField(
            'SELECT count(*) FROM general_turn WHERE general_id IN %li AND action = %s',
            $rulerIds,
            'che_방랑',
        ),
        'endingEventPresent' => (bool)$db->queryFirstField(
            'SELECT count(*) FROM event WHERE id = %i',
            $endingEventId,
        ),
    ];
    $invaderGeneralIds = array_map('intval', $db->queryFirstColumn(
        'SELECT no FROM general WHERE nation IN %li',
        $invaderNationIds,
    ));
    if ($invaderGeneralIds !== []) {
        $db->delete('general_turn', 'general_id IN %li', $invaderGeneralIds);
        $db->delete('rank_data', 'general_id IN %li', $invaderGeneralIds);
        $db->delete('troop', 'nation IN %li', $invaderNationIds);
        $db->delete('general', 'no IN %li', $invaderGeneralIds);
    }
    $db->delete('nation_turn', 'nation_id IN %li', $invaderNationIds);
    $db->delete('diplomacy', 'me IN %li OR you IN %li', $invaderNationIds, $invaderNationIds);
    $db->delete('nation', 'nation IN %li', $invaderNationIds);
    $db->update('city', ['nation' => $existingNationId], true);
    $endingResult = (new \sammo\Event\Action\InvaderEnding())->run([
        'year' => $year,
        'month' => $month + 3,
        'startyear' => $startYear,
        'currentEventID' => $endingEventId,
    ]);
    $gameStorage->resetCache();
    $afterUserWin = [
        'result' => $endingResult[1] ?? null,
        'endingEventPresent' => (bool)$db->queryFirstField(
            'SELECT count(*) FROM event WHERE id = %i',
            $endingEventId,
        ),
        'isunited' => (int)$gameStorage->isunited,
        'refreshLimit' => (int)$gameStorage->refreshLimit,
        'logs' => array_values($db->queryFirstColumn(
            'SELECT text FROM world_history WHERE id > %i AND nation_id = 0 AND year = %i AND month = %i ORDER BY id',
            $worldHistoryIdBeforeAction,
            $year,
            $month + 3,
        )),
    ];
    return [
        'schemaVersion' => 1,
        'engine' => 'ref',
        'action' => 'InvaderLifecycle',
        'phases' => [
            'afterRaise' => $afterRaise,
            'atWar' => $atWar,
            'atPeace' => $atPeace,
            'afterUserWin' => $afterUserWin,
        ],
    ];
 }
 /**
 * Exercise NPC nation creation and the same-month troop leader follow-up.
 *
 * @param array<string, mixed> $environment
 * @return array<string, mixed>
 */
 function comparisonNpcNationLifecycleTrace(
    array $environment,
    int $generalIdBeforeAction,
    int $nationIdBeforeAction,
    int $worldHistoryIdBeforeAction,
 ): array {
    $db = DB::db();
    $actionEnvironment = [
        'year' => $environment['year'],
        'month' => $environment['month'],
        'startyear' => $environment['startyear'],
        'turnterm' => $environment['turnterm'],
        'turntime' => $environment['turntime'],
        'show_img_level' => $environment['show_img_level'] ?? 3,
        'stored_icons' => $environment['stored_icons'] ?? [],
        'icon_path' => $environment['icon_path'] ?? '.',
        'fiction' => $environment['fiction'] ?? [0],
    ];
    $gameStorage = KVStorage::getStorage($db, 'game_env');
    $leaderCounterBefore = (int)($gameStorage->lastNPCTroopLeaderID ?? 0);
    (new \sammo\Event\Action\RaiseNPCNation())->run($actionEnvironment);
    $createdNationIds = array_map(
        'intval',
        $db->queryFirstColumn('SELECT nation FROM nation WHERE nation > %i ORDER BY nation', $nationIdBeforeAction),
    );
    if ($createdNationIds === []) {
        throw new \RuntimeException('NpcNationLifecycle failed to create a nation');
    }
    $createdNationGeneralCounts = array_map(
        static fn(int $nationId): int => (int)DB::db()->queryFirstField(
            'SELECT count(*) FROM general WHERE nation = %i',
            $nationId,
        ),
        $createdNationIds,
    );
    $afterRaise = [
        'createdNationCount' => count($createdNationIds),
        'createdGeneralCount' => (int)$db->queryFirstField(
            'SELECT count(*) FROM general WHERE no > %i',
            $generalIdBeforeAction,
        ),
        'generalCountsPerCreatedNation' => array_values(array_unique($createdNationGeneralCounts)),
        'historyLogs' => array_values($db->queryFirstColumn(
            'SELECT text FROM world_history WHERE id > %i AND nation_id = 0 ORDER BY id',
            $worldHistoryIdBeforeAction,
        )),
    ];
    (new \sammo\Event\Action\ProvideNPCTroopLeader())->run($actionEnvironment);
    $leaderIds = array_map(
        'intval',
        $db->queryFirstColumn('SELECT no FROM general WHERE no > %i AND npc = 5 ORDER BY no', $generalIdBeforeAction),
    );
    if ($leaderIds === []) {
        throw new \RuntimeException('NpcNationLifecycle failed to create troop leaders');
    }
    $leaderNationCounts = array_map(
        static fn(int $nationId): int => (int)DB::db()->queryFirstField(
            'SELECT count(*) FROM general WHERE nation = %i AND npc = 5',
            $nationId,
        ),
        array_map(
            'intval',
            $db->queryFirstColumn('SELECT nation FROM nation WHERE level > 0 ORDER BY nation'),
        ),
    );
    $gatherTurnCounts = array_map(
        static fn(int $generalId): int => (int)DB::db()->queryFirstField(
            'SELECT count(*) FROM general_turn WHERE general_id = %i AND action = %s',
            $generalId,
            'che_집합',
        ),
        $leaderIds,
    );
    $gameStorage->resetCache();
    $afterProvide = [
        'createdLeaderCount' => count($leaderIds),
        'leaderCountsPerActiveNation' => array_values(array_unique($leaderNationCounts)),
        'troopCount' => (int)$db->queryFirstField(
            'SELECT count(*) FROM troop WHERE troop_leader IN %li',
            $leaderIds,
        ),
        'gatherTurnCounts' => array_values(array_unique($gatherTurnCounts)),
        'leaderCounterDelta' => (int)$gameStorage->lastNPCTroopLeaderID - $leaderCounterBefore,
    ];
    return [
        'schemaVersion' => 1,
        'engine' => 'ref',
        'action' => 'NpcNationLifecycle',
        'phases' => [
            'afterRaise' => $afterRaise,
            'afterProvide' => $afterProvide,
        ],
    ];
 }
 /**
 * Exercise nation betting from monthly open through real user bets and settlement.
 *
 * @param array<string, mixed> $request
 * @param array<string, mixed> $environment
 * @return array<string, mixed>
 */
 function comparisonNationBettingLifecycleTrace(
    array $request,
    array $environment,
    int $eventIdBeforeAction,
    int $worldHistoryIdBeforeAction,
 ): array {
    $db = DB::db();
    $args = $request['args'] ?? [];
    if (!is_array($args) || count($args) > 2) {
        throw new \InvalidArgumentException('NationBettingLifecycle args must have at most two entries');
    }
    $bettorGeneralIds = comparisonIntegerList(
        $request['bettorGeneralIds'] ?? [],
        'bettorGeneralIds',
    );
    $bettorOwnerIds = comparisonIntegerList(
        $request['bettorOwnerIds'] ?? [],
        'bettorOwnerIds',
    );
    if (count($bettorGeneralIds) !== 2 || count($bettorOwnerIds) !== 2) {
        throw new \InvalidArgumentException(
            'NationBettingLifecycle requires exactly two bettorGeneralIds and bettorOwnerIds',
        );
    }
    $year = $environment['year'];
    $month = $environment['month'];
    $startYear = $environment['startyear'];
    (new \sammo\Event\Action\OpenNationBetting(...$args))->run([
        'year' => $year,
        'month' => $month,
        'startyear' => $startYear,
    ]);
    $gameStorage = KVStorage::getStorage($db, 'game_env');
    $gameStorage->resetCache();
    $bettingId = (int)$gameStorage->last_betting_id;
    $betting = new Betting($bettingId);
    $bettingInfo = $betting->getInfo();
    $candidateNationIds = array_map(
        static fn(\sammo\DTO\SelectItem $candidate): int => (int)($candidate->aux['nation'] ?? 0),
        $bettingInfo->candidates,
    );
    if (count($candidateNationIds) !== 2) {
        throw new \RuntimeException('NationBettingLifecycle requires exactly two candidates');
    }
    $finishEventCount = (int)$db->queryFirstField(
        'SELECT count(*) FROM event WHERE id > %i AND action LIKE %s',
        $eventIdBeforeAction,
        "%FinishNationBetting%{$bettingId}%",
    );
    $afterOpen = [
        'bettingId' => $bettingId,
        'candidateNationIds' => $candidateNationIds,
        'systemBonus' => (int)($db->queryFirstField(
            'SELECT amount FROM ng_betting WHERE betting_id = %i AND general_id = 0',
            $bettingId,
        ) ?? 0),
        'finishEventCount' => $finishEventCount,
        'historyLogs' => array_values($db->queryFirstColumn(
            'SELECT text FROM world_history WHERE id > %i AND nation_id = 0 ORDER BY id',
            $worldHistoryIdBeforeAction,
        )),
    ];
    $betting->bet($bettorGeneralIds[0], $bettorOwnerIds[0], [1], 100);
    $betting->bet($bettorGeneralIds[1], $bettorOwnerIds[1], [0], 100);
    $afterBets = [
        'bets' => array_map(
            static fn(array $row): array => [
                'generalId' => (int)$row['general_id'],
                'ownerId' => $row['user_id'] === null ? null : (int)$row['user_id'],
                'selectionKey' => $row['betting_type'],
                'amount' => (int)$row['amount'],
            ],
            iterator_to_array($db->query(
                'SELECT general_id, user_id, betting_type, amount FROM ng_betting WHERE betting_id = %i ORDER BY general_id',
                $bettingId,
            )),
        ),
        'inheritancePrevious' => array_map(
            static function (int $ownerId): int {
                $value = KVStorage::getStorage(DB::db(), "inheritance_{$ownerId}")->getValue('previous');
                return is_array($value) ? (int)($value[0] ?? 0) : 0;
            },
            $bettorOwnerIds,
        ),
        'spentRank' => array_map(
            static fn(int $generalId): int => (int)(DB::db()->queryFirstField(
                'SELECT value FROM rank_data WHERE general_id = %i AND type = %s',
                $generalId,
                \sammo\Enums\RankColumn::inherit_point_spent_dynamic->value,
            ) ?? 0),
            $bettorGeneralIds,
        ),
    ];
    $db->update('nation', ['level' => 0], 'nation = %i', $candidateNationIds[1]);
    $finishResult = (new \sammo\Event\Action\FinishNationBetting($bettingId))->run([
        'year' => $year,
        'month' => $month + 1,
        'startyear' => $startYear,
    ]);
    $settledInfo = (new Betting($bettingId))->getInfo();
    $afterFinish = [
        'result' => $finishResult[1] ?? null,
        'finished' => $settledInfo->finished,
        'winner' => $settledInfo->winner,
        'inheritancePrevious' => array_map(
            static function (int $ownerId): int {
                $value = KVStorage::getStorage(DB::db(), "inheritance_{$ownerId}")->getValue('previous');
                return is_array($value) ? (int)($value[0] ?? 0) : 0;
            },
            $bettorOwnerIds,
        ),
        'earnedRank' => array_map(
            static fn(int $generalId): int => (int)(DB::db()->queryFirstField(
                'SELECT value FROM rank_data WHERE general_id = %i AND type = %s',
                $generalId,
                \sammo\Enums\RankColumn::inherit_point_earned_by_action->value,
            ) ?? 0),
            $bettorGeneralIds,
        ),
        'historyLogs' => array_values($db->queryFirstColumn(
            'SELECT text FROM world_history WHERE id > %i AND nation_id = 0 ORDER BY id',
            $worldHistoryIdBeforeAction,
        )),
    ];
    return [
        'schemaVersion' => 1,
        'engine' => 'ref',
        'action' => 'NationBettingLifecycle',
        'phases' => [
            'afterOpen' => $afterOpen,
            'afterBets' => $afterBets,
            'afterFinish' => $afterFinish,
        ],
    ];
 }
 function comparisonMonthlyEventTraceMain(): void
 {
    try {
        $input = stream_get_contents(STDIN);
        $request = json_decode($input === '' ? '{}' : $input, true, flags: JSON_THROW_ON_ERROR);
        if (!is_array($request)) {
            throw new \InvalidArgumentException('request must be an object');
        }
        $actionName = $request['action'] ?? null;
        $supportedActions = [
            'UpdateCitySupply',
            'UpdateNationLevel',
            'RaiseDisaster',
            'ProcessSemiAnnual',
            'ProcessWarIncome',
            'CreateAdminNPC',
            'CreateManyNPC',
            'RegNPC',
            'RegNeutralNPC',
            'RaiseNPCNation',
            'NpcNationLifecycle',
            'RaiseInvader',
            'InvaderLifecycle',
            'AutoDeleteInvader',
            'InvaderEnding',
            'ChangeCity',
            'ProvideNPCTroopLeader',
            'NationBettingLifecycle',
            'OpenNationBetting',
            'FinishNationBetting',
            'BlockScoutAction',
            'UnblockScoutAction',
            'AssignGeneralSpeciality',
            'AddGlobalBetray',
            'LostUniqueItem',
            'MergeInheritPointRank',
            'ProcessIncome',
            'NoticeToHistoryLog',
            'NewYear',
            'ResetOfficerLock',
            'PreUpdateMonthly',
            'PostUpdateMonthly',
            'MonthlyBoundary',
        ];
        if (!in_array($actionName, $supportedActions, true)) {
            throw new \InvalidArgumentException('unsupported monthly action');
        }
        $setup = $request['setup'] ?? [];
        if (!is_array($setup)) {
            throw new \InvalidArgumentException('setup must be an object');
        }
        foreach (['city', 'nation', 'general'] as $table) {
            $rows = $setup[$table] ?? [];
            if (!is_array($rows)) {
                throw new \InvalidArgumentException("setup.{$table} must be an array");
            }
            foreach ($rows as $row) {
                if (!is_array($row) || !is_int($row['id'] ?? null) || !is_array($row['values'] ?? null)) {
                    throw new \InvalidArgumentException("invalid setup.{$table} row");
                }
                comparisonMonthlyPatch($table, $row['id'], $row['values']);
            }
        }
        if (($setup['resetCities'] ?? false) === true) {
            DB::db()->query('UPDATE city SET nation = 0, level = 1');
            foreach ($setup['city'] ?? [] as $row) {
                comparisonMonthlyPatch('city', $row['id'], $row['values']);
            }
        }
        if (($setup['deleteOtherCities'] ?? false) === true) {
            $keepCityIds = comparisonIntegerList($setup['keepCityIds'] ?? [], 'keepCityIds');
            if ($keepCityIds === []) {
                throw new \InvalidArgumentException('deleteOtherCities requires keepCityIds');
            }
            DB::db()->query('DELETE FROM city WHERE city NOT IN %li', $keepCityIds);
        }
        if (($setup['resetGenerals'] ?? false) === true) {
            DB::db()->query(
                'UPDATE general SET nation = 0, officer_level = 1, npc = 2, killturn = 0, horse = %s, weapon = %s, book = %s, item = %s',
                'None',
                'None',
                'None',
                'None',
            );
            foreach ($setup['general'] ?? [] as $row) {
                comparisonMonthlyPatch('general', $row['id'], $row['values']);
            }
        }
        if (($setup['deleteOtherGenerals'] ?? false) === true) {
            $keepGeneralIds = comparisonIntegerList($setup['keepGeneralIds'] ?? [], 'keepGeneralIds');
            if (!$keepGeneralIds) {
                throw new \InvalidArgumentException('deleteOtherGenerals requires keepGeneralIds');
            }
            DB::db()->query('DELETE FROM general_turn WHERE general_id NOT IN %li', $keepGeneralIds);
            DB::db()->query('DELETE FROM rank_data WHERE general_id NOT IN %li', $keepGeneralIds);
            DB::db()->query('DELETE FROM general WHERE no NOT IN %li', $keepGeneralIds);
        }
        if (($setup['resetNations'] ?? false) === true) {
            DB::db()->query('UPDATE nation SET level = 0, gennum = 0, tech = 0');
            foreach ($setup['nation'] ?? [] as $row) {
                comparisonMonthlyPatch('nation', $row['id'], $row['values']);
            }
        }
        if (($setup['deleteOtherNations'] ?? false) === true) {
            $keepNationIds = comparisonIntegerList($setup['keepNationIds'] ?? [], 'keepNationIds');
            if (!$keepNationIds) {
                throw new \InvalidArgumentException('deleteOtherNations requires keepNationIds');
            }
            DB::db()->query(
                'DELETE FROM diplomacy WHERE me NOT IN %li OR you NOT IN %li',
                $keepNationIds,
                $keepNationIds,
            );
            DB::db()->query('DELETE FROM nation_turn WHERE nation_id NOT IN %li', $keepNationIds);
            DB::db()->query('DELETE FROM nation WHERE nation NOT IN %li', $keepNationIds);
        }
        if (($setup['resetUniqueOccupancy'] ?? false) === true) {
            DB::db()->delete('ng_auction', '`type` = %s AND finished = 0', 'uniqueItem');
            DB::db()->query('DELETE FROM storage WHERE namespace LIKE %s', 'ut\\_%');
        }
        if (($setup['clearNeutralAuctions'] ?? false) === true) {
            DB::db()->delete(
                'ng_auction',
                '`type` IN %ls AND host_general_id = 0',
                ['buyRice', 'sellRice'],
            );
        }
        foreach (comparisonIntegerList($setup['clearNationTurnIds'] ?? [], 'clearNationTurnIds') as $nationId) {
            DB::db()->delete('nation_turn', 'nation_id = %i', $nationId);
        }
        foreach (comparisonIntegerList($setup['clearInheritanceOwnerIds'] ?? [], 'clearInheritanceOwnerIds') as $ownerId) {
            DB::db()->delete('storage', 'namespace = %s', "inheritance_{$ownerId}");
        }
        if (($setup['clearBetting'] ?? false) === true) {
            DB::db()->query('DELETE FROM ng_betting');
            DB::db()->query('DELETE FROM storage WHERE namespace = %s', 'betting');
            $gameStorage = KVStorage::getStorage(DB::db(), 'game_env');
            $gameStorage->setValue('last_betting_id', 0);
        }
        foreach ($setup['bettingInfo'] ?? [] as $rawBettingInfo) {
            if (!is_array($rawBettingInfo) || !is_int($rawBettingInfo['id'] ?? null)) {
                throw new \InvalidArgumentException('invalid setup.bettingInfo row');
            }
            KVStorage::getStorage(DB::db(), 'betting')->setValue(
                "id_{$rawBettingInfo['id']}",
                $rawBettingInfo,
            );
        }
        foreach ($setup['bet'] ?? [] as $row) {
            if (
                !is_array($row)
                || !is_int($row['betting_id'] ?? null)
                || !is_int($row['general_id'] ?? null)
                || !is_string($row['betting_type'] ?? null)
                || !is_int($row['amount'] ?? null)
            ) {
                throw new \InvalidArgumentException('invalid setup.bet row');
            }
            DB::db()->insert('ng_betting', [
                'betting_id' => $row['betting_id'],
                'general_id' => $row['general_id'],
                'user_id' => $row['user_id'] ?? null,
                'betting_type' => $row['betting_type'],
                'amount' => $row['amount'],
            ]);
        }
        foreach ($setup['inheritancePrevious'] ?? [] as $ownerId => $value) {
            if (!is_numeric($ownerId) || !is_int($value)) {
                throw new \InvalidArgumentException('invalid setup.inheritancePrevious entry');
            }
            KVStorage::getStorage(DB::db(), "inheritance_{$ownerId}")->setValue('previous', [$value, null]);
        }
        foreach ($setup['inheritancePoints'] ?? [] as $row) {
            if (
                !is_array($row)
                || !is_int($row['ownerId'] ?? null)
                || !is_string($row['key'] ?? null)
                || !is_numeric($row['value'] ?? null)
            ) {
                throw new \InvalidArgumentException('invalid setup.inheritancePoints row');
            }
            KVStorage::getStorage(DB::db(), "inheritance_{$row['ownerId']}")->setValue(
                $row['key'],
                [$row['value'], null],
            );
        }
        foreach ($setup['rankData'] ?? [] as $row) {
            if (
                !is_array($row)
                || !is_int($row['generalId'] ?? null)
                || !is_string($row['type'] ?? null)
                || !is_int($row['value'] ?? null)
            ) {
                throw new \InvalidArgumentException('invalid setup.rankData row');
            }
            $nationId = (int)(DB::db()->queryFirstField(
                'SELECT nation FROM general WHERE no = %i',
                $row['generalId'],
            ) ?? 0);
            DB::db()->insertUpdate('rank_data', [
                'general_id' => $row['generalId'],
                'nation_id' => $nationId,
                'type' => $row['type'],
                'value' => $row['value'],
            ], [
                'nation_id' => $nationId,
                'value' => $row['value'],
            ]);
        }
        foreach ($setup['generalAccessLog'] ?? [] as $row) {
            if (
                !is_array($row)
                || !is_int($row['generalId'] ?? null)
                || !is_int($row['refreshScoreTotal'] ?? null)
            ) {
                throw new \InvalidArgumentException('invalid setup.generalAccessLog row');
            }
            DB::db()->insertUpdate('general_access_log', [
                'general_id' => $row['generalId'],
                'refresh_score_total' => $row['refreshScoreTotal'],
            ], [
                'refresh_score_total' => $row['refreshScoreTotal'],
            ]);
        }
        foreach ($setup['nationEnvironment'] ?? [] as $row) {
            if (
                !is_array($row)
                || !is_int($row['nationId'] ?? null)
                || !is_string($row['key'] ?? null)
                || !array_key_exists('value', $row)
            ) {
                throw new \InvalidArgumentException('invalid setup.nationEnvironment row');
            }
            KVStorage::getStorage(DB::db(), $row['nationId'], 'nation_env')->setValue(
                $row['key'],
                $row['value'],
            );
        }
        if (($setup['resetDiplomacy'] ?? false) === true) {
            DB::db()->query('DELETE FROM diplomacy');
        }
        foreach ($setup['diplomacy'] ?? [] as $row) {
            if (
                !is_array($row)
                || !is_int($row['fromNationId'] ?? null)
                || !is_int($row['toNationId'] ?? null)
                || !is_int($row['state'] ?? null)
                || !is_int($row['term'] ?? null)
            ) {
                throw new \InvalidArgumentException('invalid setup.diplomacy row');
            }
            $diplomacyPatch = [
                'me' => $row['fromNationId'],
                'you' => $row['toNationId'],
                'state' => $row['state'],
                'term' => $row['term'],
                'dead' => $row['dead'] ?? 0,
            ];
            DB::db()->insertUpdate('diplomacy', $diplomacyPatch, $diplomacyPatch);
        }
        if (($setup['resetEvents'] ?? false) === true) {
            DB::db()->query('DELETE FROM event');
        }
        foreach ($setup['event'] ?? [] as $row) {
            if (!is_array($row) || !is_int($row['id'] ?? null) || !is_array($row['action'] ?? null)) {
                throw new \InvalidArgumentException('invalid setup.event row');
            }
            $eventPatch = [
                'id' => $row['id'],
                'target' => $row['target'] ?? 'month',
                'priority' => $row['priority'] ?? 1000,
                'condition' => Json::encode($row['condition'] ?? true),
                'action' => Json::encode($row['action']),
            ];
            DB::db()->insertUpdate('event', $eventPatch, $eventPatch);
        }
        $gameEnvironmentPatch = $setup['gameEnvironment'] ?? [];
        if (!is_array($gameEnvironmentPatch)) {
            throw new \InvalidArgumentException('setup.gameEnvironment must be an object');
        }
        $gameStorage = KVStorage::getStorage(DB::db(), 'game_env');
        $worldPatch = $setup['world'] ?? [];
        if (!is_array($worldPatch)) {
            throw new \InvalidArgumentException('setup.world must be an object');
        }
        if (array_key_exists('hiddenSeed', $worldPatch)) {
            if (!is_string($worldPatch['hiddenSeed']) || $worldPatch['hiddenSeed'] === '') {
                throw new \InvalidArgumentException('setup.world.hiddenSeed must be a non-empty string');
            }
            UniqueConst::$hiddenSeed = $worldPatch['hiddenSeed'];
        }
        foreach ([
            'isunited',
            'refreshLimit',
            'block_change_scout',
            'lastNPCTroopLeaderID',
            'tournament',
            'tnmt_trig',
            'tnmt_pattern',
            'prev_winner',
        ] as $key) {
            if (array_key_exists($key, $gameEnvironmentPatch)) {
                $gameStorage->setValue($key, $gameEnvironmentPatch[$key]);
            }
        }
        if (($setup['setAllCitiesNation'] ?? null) !== null) {
            if (!is_int($setup['setAllCitiesNation'])) {
                throw new \InvalidArgumentException('setup.setAllCitiesNation must be an integer');
            }
            DB::db()->update('city', ['nation' => $setup['setAllCitiesNation']], true);
        }
        $db = DB::db();
        $generalIdBeforeAction =
            (int)($db->queryFirstField('SELECT COALESCE(MAX(no), 0) FROM general') ?? 0);
        $nationIdBeforeAction =
            (int)($db->queryFirstField('SELECT COALESCE(MAX(nation), 0) FROM nation') ?? 0);
        $eventIdBeforeAction =
            (int)($db->queryFirstField('SELECT COALESCE(MAX(id), 0) FROM event') ?? 0);
        $auctionIdBeforeAction =
            (int)($db->queryFirstField('SELECT COALESCE(MAX(id), 0) FROM ng_auction') ?? 0);
        $snapshotRequest = ['observe' => $request['observe'] ?? []];
        $snapshotRequest['observe']['logAfterId'] =
            (int)($db->queryFirstField('SELECT COALESCE(MAX(id), 0) FROM general_record') ?? 0);
        $worldHistoryAfterId =
            (int)($db->queryFirstField('SELECT COALESCE(MAX(id), 0) FROM world_history') ?? 0);
        $before = comparisonTurnStateSnapshot($snapshotRequest);
        $beforeDetails = comparisonMonthlyDetails($snapshotRequest['observe'], $worldHistoryAfterId);
        $environment = $request['environment'] ?? [];
        if (!is_array($environment)) {
            throw new \InvalidArgumentException('environment must be an object');
        }
        $year = $environment['year'] ?? null;
        $month = $environment['month'] ?? null;
        $startYear = $environment['startyear'] ?? null;
        if (!is_int($year) || !is_int($month) || !is_int($startYear)) {
            throw new \InvalidArgumentException('environment year, month, and startyear must be integers');
        }
        if (($setup['syncEnvironment'] ?? false) === true) {
            $gameStorage = KVStorage::getStorage(DB::db(), 'game_env');
            $environmentValues = [
                'year' => $year,
                'month' => $month,
                'startyear' => $startYear,
                'killturn' => $environment['killturn'] ?? $gameStorage->killturn,
                'turnterm' => $environment['turnterm'] ?? $gameStorage->turnterm,
            ];
            if (isset($environment['starttime'])) {
                if (!is_string($environment['starttime']) || $environment['starttime'] === '') {
                    throw new \InvalidArgumentException('environment.starttime must be a non-empty string');
                }
                $environmentValues['starttime'] = $environment['starttime'];
            }
            foreach ($environmentValues as $key => $value) {
                $gameStorage->setValue($key, $value);
            }
            if ($actionName === 'MonthlyBoundary') {
                $before = comparisonTurnStateSnapshot($snapshotRequest);
                $beforeDetails = comparisonMonthlyDetails($snapshotRequest['observe'], $worldHistoryAfterId);
            }
        }
        if ($actionName === 'InvaderLifecycle') {
            foreach (['turnterm', 'turntime'] as $requiredEnvironmentKey) {
                if (!array_key_exists($requiredEnvironmentKey, $environment)) {
                    throw new \InvalidArgumentException(
                        "InvaderLifecycle requires environment.{$requiredEnvironmentKey}",
                    );
                }
            }
            echo json_encode(
                comparisonInvaderLifecycleTrace(
                    $request,
                    $environment,
                    $generalIdBeforeAction,
                    $nationIdBeforeAction,
                    $eventIdBeforeAction,
                    $worldHistoryAfterId,
                ),
                JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION,
            ), PHP_EOL;
            return;
        }
        if ($actionName === 'NpcNationLifecycle') {
            foreach (['turnterm', 'turntime'] as $requiredEnvironmentKey) {
                if (!array_key_exists($requiredEnvironmentKey, $environment)) {
                    throw new \InvalidArgumentException(
                        "NpcNationLifecycle requires environment.{$requiredEnvironmentKey}",
                    );
                }
            }
            echo json_encode(
                comparisonNpcNationLifecycleTrace(
                    $environment,
                    $generalIdBeforeAction,
                    $nationIdBeforeAction,
                    $worldHistoryAfterId,
                ),
                JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION,
            ), PHP_EOL;
            return;
        }
        if ($actionName === 'NationBettingLifecycle') {
            echo json_encode(
                comparisonNationBettingLifecycleTrace(
                    $request,
                    $environment,
                    $eventIdBeforeAction,
                    $worldHistoryAfterId,
                ),
                JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION,
            ), PHP_EOL;
            return;
        }
        $actionClass = "\\sammo\\Event\\Action\\{$actionName}";
        if (in_array($actionName, ['PreUpdateMonthly', 'PostUpdateMonthly', 'MonthlyBoundary'], true)) {
            $action = null;
        } elseif ($actionName === 'ProcessSemiAnnual') {
            $resource = $request['resource'] ?? null;
            if (!is_string($resource)) {
                throw new \InvalidArgumentException('ProcessSemiAnnual requires resource');
            }
            $action = new $actionClass($resource);
        } elseif (in_array($actionName, ['CreateManyNPC', 'RegNPC', 'RegNeutralNPC', 'RaiseInvader', 'AutoDeleteInvader', 'ChangeCity', 'OpenNationBetting', 'FinishNationBetting', 'BlockScoutAction', 'UnblockScoutAction', 'AddGlobalBetray', 'LostUniqueItem', 'ProcessIncome', 'NoticeToHistoryLog'], true)) {
            $args = $request['args'] ?? [];
            if (!is_array($args)) {
                throw new \InvalidArgumentException("{$actionName} args must be an array");
            }
            if ($actionName === 'CreateManyNPC' && count($args) > 2) {
                throw new \InvalidArgumentException('CreateManyNPC args must have at most two entries');
            }
            if ($actionName === 'RaiseInvader' && count($args) > 4) {
                throw new \InvalidArgumentException('RaiseInvader args must have at most four entries');
            }
            if ($actionName === 'ChangeCity' && count($args) !== 2) {
                throw new \InvalidArgumentException('ChangeCity args must have exactly two entries');
            }
            if ($actionName === 'OpenNationBetting' && count($args) > 2) {
                throw new \InvalidArgumentException('OpenNationBetting args must have at most two entries');
            }
            if ($actionName === 'FinishNationBetting' && count($args) !== 1) {
                throw new \InvalidArgumentException('FinishNationBetting args must have exactly one entry');
            }
            if (in_array($actionName, ['BlockScoutAction', 'UnblockScoutAction'], true) && count($args) > 1) {
                throw new \InvalidArgumentException("{$actionName} args must have at most one entry");
            }
            if ($actionName === 'AddGlobalBetray' && count($args) > 2) {
                throw new \InvalidArgumentException('AddGlobalBetray args must have at most two entries');
            }
            if ($actionName === 'LostUniqueItem' && count($args) > 1) {
                throw new \InvalidArgumentException('LostUniqueItem args must have at most one entry');
            }
            if ($actionName === 'ProcessIncome' && count($args) !== 1) {
                throw new \InvalidArgumentException('ProcessIncome args must have exactly one entry');
            }
            if ($actionName === 'NoticeToHistoryLog' && (count($args) < 1 || count($args) > 2)) {
                throw new \InvalidArgumentException('NoticeToHistoryLog args must have one or two entries');
            }
            $action = new $actionClass(...$args);
        } else {
            $action = new $actionClass();
        }
        $actionEnvironment = [
            'year' => $year,
            'month' => $month,
            'startyear' => $startYear,
        ];
        if (isset($environment['currentEventID'])) {
            if (!is_int($environment['currentEventID'])) {
                throw new \InvalidArgumentException('currentEventID must be an integer');
            }
            $actionEnvironment['currentEventID'] = $environment['currentEventID'];
        }
        if ($actionName === 'UpdateNationLevel') {
            $killturn = $environment['killturn'] ?? null;
            $turnterm = $environment['turnterm'] ?? null;
            if (!is_int($killturn) || !is_int($turnterm) || $turnterm <= 0) {
                throw new \InvalidArgumentException('UpdateNationLevel requires integer killturn and positive turnterm');
            }
            $actionEnvironment['killturn'] = $killturn;
            $actionEnvironment['turnterm'] = $turnterm;
        }
        if (in_array($actionName, ['CreateManyNPC', 'RegNPC', 'RegNeutralNPC', 'RaiseNPCNation', 'RaiseInvader', 'ProvideNPCTroopLeader'], true)) {
            $turnterm = $environment['turnterm'] ?? null;
            $turntime = $environment['turntime'] ?? null;
            $showImgLevel = $environment['show_img_level'] ?? 3;
            $fiction = $environment['fiction'] ?? [0];
            if (
                !is_int($turnterm)
                || $turnterm <= 0
                || !is_string($turntime)
                || !is_int($showImgLevel)
                || !is_array($fiction)
            ) {
                throw new \InvalidArgumentException(
                    "{$actionName} requires positive turnterm, string turntime, integer show_img_level, and array fiction",
                );
            }
            $actionEnvironment += [
                'turnterm' => $turnterm,
                'turntime' => $turntime,
                'show_img_level' => $showImgLevel,
                'stored_icons' => $environment['stored_icons'] ?? [],
                'icon_path' => $environment['icon_path'] ?? '.',
                'fiction' => $fiction,
            ];
        }
        if ($actionName === 'PreUpdateMonthly') {
            if (!preUpdateMonthly()) {
                throw new \RuntimeException('preUpdateMonthly failed');
            }
        } elseif ($actionName === 'PostUpdateMonthly') {
            $seedYear = $environment['seedYear'] ?? null;
            $seedMonth = $environment['seedMonth'] ?? null;
            if (!is_int($seedYear) || !is_int($seedMonth)) {
                throw new \InvalidArgumentException('PostUpdateMonthly requires seedYear and seedMonth');
            }
            postUpdateMonthly(new RandUtil(new LiteHashDRBG(Util::simpleSerialize(
                UniqueConst::$hiddenSeed,
                'monthly',
                $seedYear,
                $seedMonth,
            ))));
        } elseif ($actionName === 'MonthlyBoundary') {
            $turntime = $environment['turntime'] ?? null;
            if (!is_string($turntime) || $turntime === '') {
                throw new \InvalidArgumentException('MonthlyBoundary requires turntime');
            }
            $gameStorage = KVStorage::getStorage($db, 'game_env');
            $seedYear = (int)$gameStorage->year;
            $seedMonth = (int)$gameStorage->month;
            TurnExecutionHelper::runEventHandler($db, $gameStorage, Enums\EventTarget::PreMonth);
            if (!preUpdateMonthly()) {
                throw new \RuntimeException('preUpdateMonthly failed');
            }
            turnDate($turntime);
            $gameStorage->resetCache();
            if ((int)$gameStorage->month === 1) {
                checkStatistic();
            }
            TurnExecutionHelper::runEventHandler($db, $gameStorage, Enums\EventTarget::Month);
            postUpdateMonthly(new RandUtil(new LiteHashDRBG(Util::simpleSerialize(
                UniqueConst::$hiddenSeed,
                'monthly',
                $seedYear,
                $seedMonth,
            ))));
        } else {
            $action->run($actionEnvironment);
        }
        unset($action);
        gc_collect_cycles();
        $after = comparisonTurnStateSnapshot($snapshotRequest);
        $afterDetails = comparisonMonthlyDetails($snapshotRequest['observe'], $worldHistoryAfterId);
        $createdGenerals = [];
        if (in_array($actionName, ['CreateManyNPC', 'RegNPC', 'RegNeutralNPC', 'RaiseNPCNation', 'RaiseInvader', 'ProvideNPCTroopLeader'], true)) {
            foreach ($db->query('SELECT * FROM general WHERE no > %i ORDER BY no', $generalIdBeforeAction) as $row) {
                $generalId = (int)$row['no'];
                $turnRows = $db->query(
                    'SELECT turn_idx, action, arg FROM general_turn WHERE general_id = %i ORDER BY turn_idx',
                    $generalId,
                );
                $createdGenerals[] = comparisonPickRow(
                    $row,
                    [
                        'id' => 'no',
                        'name' => 'name',
                        'nationId' => 'nation',
                        'cityId' => 'city',
                        'leadership' => 'leadership',
                        'strength' => 'strength',
                        'intelligence' => 'intel',
                        'experience' => 'experience',
                        'dedication' => 'dedication',
                        'officerLevel' => 'officer_level',
                        'gold' => 'gold',
                        'rice' => 'rice',
                        'crew' => 'crew',
                        'crewTypeId' => 'crewtype',
                        'train' => 'train',
                        'atmos' => 'atmos',
                        'turnTime' => 'turntime',
                        'killturn' => 'killturn',
                        'age' => 'age',
                        'npcState' => 'npc',
                        'npcOriginalState' => 'npc_org',
                        'affinity' => 'affinity',
                        'personality' => 'personal',
                        'specialDomestic' => 'special',
                        'specialWar' => 'special2',
                        'specAge' => 'specage',
                        'specAge2' => 'specage2',
                        'bornYear' => 'bornyear',
                        'deadYear' => 'deadyear',
                        'picture' => 'picture',
                        'dex1' => 'dex1',
                        'dex2' => 'dex2',
                        'dex3' => 'dex3',
                        'dex4' => 'dex4',
                        'dex5' => 'dex5',
                    ],
                ) + [
                    'turnCount' => count($turnRows),
                    'turnActions' => array_values(array_unique(array_column($turnRows, 'action'))),
                    'rankCount' => (int)$db->queryFirstField(
                        'SELECT count(*) FROM rank_data WHERE general_id = %i',
                        $generalId,
                    ),
                    'nonZeroRankCount' => (int)$db->queryFirstField(
                        'SELECT count(*) FROM rank_data WHERE general_id = %i AND value != 0',
                        $generalId,
                    ),
                    'troop' => $db->queryFirstRow(
                        'SELECT troop_leader AS id, nation AS nationId, name FROM troop WHERE troop_leader = %i',
                        $generalId,
                    ) ?: null,
                ];
            }
        }
        $createdNations = [];
        if (in_array($actionName, ['RaiseNPCNation', 'RaiseInvader'], true)) {
            foreach ($db->query('SELECT * FROM nation WHERE nation > %i ORDER BY nation', $nationIdBeforeAction) as $row) {
                $nationId = (int)$row['nation'];
                $createdNations[] = comparisonPickRow(
                    $row,
                    [
                        'id' => 'nation',
                        'name' => 'name',
                        'color' => 'color',
                        'capitalCityId' => 'capital',
                        'generalCount' => 'gennum',
                        'gold' => 'gold',
                        'rice' => 'rice',
                        'tech' => 'tech',
                        'level' => 'level',
                        'typeCode' => 'type',
                        'bill' => 'bill',
                        'rate' => 'rate',
                        'scout' => 'scout',
                        'war' => 'war',
                        'strategicCommandLimit' => 'strategic_cmd_limit',
                        'surrenderLimit' => 'surlimit',
                        'aux' => 'aux',
                    ],
                    ['aux'],
                ) + [
                    'nationTurnCount' => (int)$db->queryFirstField(
                        'SELECT count(*) FROM nation_turn WHERE nation_id = %i',
                        $nationId,
                    ),
                    'diplomacyCount' => (int)$db->queryFirstField(
                        'SELECT count(*) FROM diplomacy WHERE me = %i OR you = %i',
                        $nationId,
                        $nationId,
                    ),
                ];
            }
        }
        $response = [
            'schemaVersion' => 1,
            'engine' => 'ref',
            'action' => $actionName,
            'before' => $before,
            'beforeDetails' => $beforeDetails,
            'after' => $after,
            'afterDetails' => $afterDetails,
        ];
        if (in_array($actionName, ['CreateManyNPC', 'RegNPC', 'RegNeutralNPC'], true)) {
            $response['createdGenerals'] = $createdGenerals;
        }
        if (in_array($actionName, ['RaiseNPCNation', 'RaiseInvader'], true)) {
            $response['createdGenerals'] = $createdGenerals;
            $response['createdNations'] = $createdNations;
        }
        if ($actionName === 'ProvideNPCTroopLeader') {
            $response['createdGenerals'] = $createdGenerals;
            $response['gameEnvironment'] = KVStorage::getStorage(DB::db(), 'game_env')->getValues([
                'lastNPCTroopLeaderID',
            ]);
        }
        if ($actionName === 'PreUpdateMonthly') {
            $response['gameEnvironment'] = KVStorage::getStorage(DB::db(), 'game_env')->getValues([
                'develcost',
            ]);
        }
        if ($actionName === 'PostUpdateMonthly') {
            $response['gameEnvironment'] = KVStorage::getStorage(DB::db(), 'game_env')->getValues([
                'tournament',
                'tnmt_trig',
                'tnmt_pattern',
                'tnmt_type',
                'tnmt_auto',
                'phase',
            ]);
            $response['createdNeutralAuctions'] = array_map(
                static fn(array $row): array => [
                    'id' => (int)$row['id'],
                    'type' => $row['type'],
                    'target' => $row['target'],
                    'detail' => Json::decode($row['detail']),
                ],
                iterator_to_array(
                    $db->query(
                        'SELECT id, `type`, target, detail FROM ng_auction WHERE id > %i AND host_general_id = 0 ORDER BY id',
                        $auctionIdBeforeAction,
                    ),
                ),
            );
        }
        if (in_array($actionName, ['OpenNationBetting', 'FinishNationBetting'], true)) {
            $bettingStorage = KVStorage::getStorage(DB::db(), 'betting');
            $response['betting'] = $bettingStorage->getAll();
            $response['bets'] = iterator_to_array(
                $db->query(
                    'SELECT betting_id AS bettingId, general_id AS generalId, user_id AS userId, betting_type AS selectionKey, amount FROM ng_betting ORDER BY id',
                ),
            );
            $response['createdEvents'] = array_map(
                static fn(array $row): array => comparisonPickRow(
                    $row,
                    [
                        'id' => 'id',
                        'targetCode' => 'target',
                        'priority' => 'priority',
                        'condition' => 'condition',
                        'action' => 'action',
                    ],
                    ['condition', 'action'],
                ),
                iterator_to_array(
                    $db->query(
                        'SELECT id, target, priority, `condition`, action FROM event WHERE id > %i ORDER BY id',
                        $eventIdBeforeAction,
                    ),
                ),
            );
            $response['gameEnvironment'] = KVStorage::getStorage(DB::db(), 'game_env')->getValues([
                'last_betting_id',
            ]);
            $response['inheritancePrevious'] = [];
            foreach (comparisonIntegerList($request['observe']['ownerIds'] ?? [], 'ownerIds') as $ownerId) {
                $value = KVStorage::getStorage(DB::db(), "inheritance_{$ownerId}")->getValue('previous');
                $response['inheritancePrevious'][(string)$ownerId] = is_array($value) ? ($value[0] ?? 0) : 0;
            }
        }
        if (in_array($actionName, ['BlockScoutAction', 'UnblockScoutAction'], true)) {
            $response['gameEnvironment'] = KVStorage::getStorage(DB::db(), 'game_env')->getValues([
                'block_change_scout',
            ]);
        }
        if ($actionName === 'RaiseInvader') {
            $response['createdEvents'] = array_map(
                static fn(array $row): array => comparisonPickRow(
                    $row,
                    [
                        'id' => 'id',
                        'targetCode' => 'target',
                        'priority' => 'priority',
                        'condition' => 'condition',
                        'action' => 'action',
                    ],
                    ['condition', 'action'],
                ),
                iterator_to_array(
                    $db->query(
                        'SELECT id, target, priority, `condition`, action FROM event WHERE id > %i ORDER BY id',
                        $eventIdBeforeAction,
                    ),
                ),
            );
            $response['createdDiplomacy'] = iterator_to_array(
                $db->query(
                    'SELECT me AS fromNationId, you AS toNationId, state, term FROM diplomacy WHERE me > %i OR you > %i ORDER BY me, you',
                    $nationIdBeforeAction,
                    $nationIdBeforeAction,
                ),
            );
            $gameStorage = KVStorage::getStorage(DB::db(), 'game_env');
            $response['gameEnvironment'] = $gameStorage->getValues([
                'isunited',
                'turnterm',
                'block_change_scout',
                'refreshLimit',
            ]);
        }
        if (in_array($actionName, ['AutoDeleteInvader', 'InvaderEnding'], true)) {
            $gameStorage = KVStorage::getStorage(DB::db(), 'game_env');
            $response['gameEnvironment'] = $gameStorage->getValues([
                'isunited',
                'turnterm',
                'block_change_scout',
                'refreshLimit',
            ]);
        }
        if (($request['compactOutput'] ?? false) === true) {
            $observedGeneralTurns = [];
            foreach (comparisonIntegerList($request['observe']['generalIds'] ?? [], 'generalIds') as $generalId) {
                $observedGeneralTurns[(string)$generalId] = iterator_to_array(
                    $db->query(
                        'SELECT turn_idx AS turnIndex, action, arg FROM general_turn WHERE general_id = %i ORDER BY turn_idx',
                        $generalId,
                    ),
                );
            }
            $response = [
                'schemaVersion' => 1,
                'engine' => 'ref',
                'action' => $actionName,
                'afterDetails' => $afterDetails,
                'createdGeneralCount' => count($createdGenerals),
                'firstCreatedGenerals' => array_slice($createdGenerals, 0, 3),
                'createdNations' => $response['createdNations'] ?? [],
                'createdEvents' => $response['createdEvents'] ?? [],
                'createdDiplomacy' => $response['createdDiplomacy'] ?? [],
                'gameEnvironment' => $response['gameEnvironment'] ?? [],
                'logs' => $after['logs'],
                'observedGeneralTurns' => $observedGeneralTurns,
                'remainingEventIds' => array_map(
                    'intval',
                    $db->queryFirstColumn('SELECT id FROM event ORDER BY id'),
                ),
            ];
        }
        echo json_encode(
            $response,
            JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION,
        ), PHP_EOL;
    } catch (\Throwable $throwable) {
        fwrite(STDERR, $throwable::class . ': ' . $throwable->getMessage() . PHP_EOL);
        exit(1);
    }
 }
 comparisonMonthlyEventTraceMain();
@@ -0,0 +1,40 @@
 <?php
 declare(strict_types=1);
 namespace sammo;
 if (PHP_SAPI !== 'cli') {
    http_response_code(404);
    exit;
 }
 chdir(dirname(__DIR__));
 require_once 'lib.php';
 require_once 'func.php';
 $groups = [
    'nation' => ['ActionNationType', 'ActionNationType'],
    'domestic' => ['ActionSpecialDomestic', 'ActionSpecialDomestic'],
    'war' => ['ActionSpecialWar', 'ActionSpecialWar'],
    'personality' => ['ActionPersonality', 'ActionPersonality'],
 ];
 $result = [];
 foreach ($groups as $kind => [$directory, $namespace]) {
    foreach (glob(__DIR__ . "/../sammo/{$directory}/*.php") ?: [] as $path) {
        $key = basename($path, '.php');
        if ($key === 'None' || str_starts_with($key, 'che_event_') || $key === 'che_거상') {
            continue;
        }
        $className = "\\sammo\\{$namespace}\\{$key}";
        $trait = new $className();
        $result[$kind][$key] = [
            'name' => $trait->getName(),
            'info' => $trait->getInfo(),
        ];
    }
    ksort($result[$kind]);
 }
 echo Json::encode($result);
@@ -0,0 +1,804 @@
 <?php
 declare(strict_types=1);
 namespace sammo;
 use sammo\Enums\RankColumn;
 if (PHP_SAPI !== 'cli') {
    http_response_code(404);
    exit;
 }
 chdir(dirname(__DIR__));
 $_SERVER['REMOTE_ADDR'] ??= '127.0.0.1';
 error_reporting(E_ALL & ~E_DEPRECATED);
 require_once 'lib.php';
 require_once 'func.php';
 require_once __DIR__ . '/turn_state_snapshot.php';
 final class TurnComparisonTracingRNG implements RNG
 {
    private int $sequence = 0;
    /** @var list<array<string, mixed>> */
    public array $calls = [];
    public function __construct(private readonly RNG $inner)
    {
    }
    public static function getMaxInt(): int
    {
        return LiteHashDRBG::getMaxInt();
    }
    public function nextBytes(int $bytes): string
    {
        $value = $this->inner->nextBytes($bytes);
        $this->record('nextBytes', ['bytes' => $bytes], bin2hex($value));
        return $value;
    }
    public function nextBits(int $bits): string
    {
        $value = $this->inner->nextBits($bits);
        $this->record('nextBits', ['bits' => $bits], bin2hex($value));
        return $value;
    }
    public function nextInt(?int $max = null): int
    {
        $value = $this->inner->nextInt($max);
        $this->record('nextInt', ['maxInclusive' => $max], $value);
        return $value;
    }
    public function nextFloat1(): float
    {
        $value = $this->inner->nextFloat1();
        $this->record('nextFloat1', [], $value);
        return $value;
    }
    private function record(string $operation, array $arguments, mixed $result): void
    {
        $this->calls[] = [
            'seq' => $this->sequence++,
            'operation' => $operation,
            'arguments' => $arguments === [] ? (object)[] : $arguments,
            'result' => $result,
        ];
    }
 }
 /** @return array<string, mixed> */
 function comparisonMappedPatch(array $row, array $mapping): array
 {
    $patch = [];
    foreach ($mapping as $canonical => $legacy) {
        if (array_key_exists($canonical, $row)) {
            $patch[$legacy] = $row[$canonical];
        }
    }
    return $patch;
 }
 function comparisonApplyTurnFixtureSetup(mixed $setup): void
 {
    if ($setup === null) {
        return;
    }
    if (!is_array($setup)) {
        throw new \InvalidArgumentException('setup must be an object');
    }
    $db = DB::db();
    $world = $setup['world'] ?? null;
    if ($world !== null) {
        if (!is_array($world)) {
            throw new \InvalidArgumentException('setup.world must be an object');
        }
        $game = KVStorage::getStorage($db, 'game_env');
        foreach (['year', 'month', 'startyear', 'init_year', 'init_month'] as $key) {
            $fixtureKey = match ($key) {
                'startyear' => 'startYear',
                'init_year' => 'initYear',
                'init_month' => 'initMonth',
                default => $key,
            };
            if (!array_key_exists($fixtureKey, $world)) {
                continue;
            }
            $value = $world[$fixtureKey];
            if (
                !is_int($value)
                || $value < 1
                || (in_array($key, ['month', 'init_month'], true) && $value > 12)
            ) {
                throw new \InvalidArgumentException("setup.world.{$fixtureKey} is invalid");
            }
            $game->setValue($key, $value);
        }
        $game->resetCache();
        if (array_key_exists('hiddenSeed', $world)) {
            $hiddenSeed = $world['hiddenSeed'];
            if (!is_string($hiddenSeed) || $hiddenSeed === '' || strlen($hiddenSeed) > 256) {
                throw new \InvalidArgumentException('setup.world.hiddenSeed is invalid');
            }
            UniqueConst::$hiddenSeed = $hiddenSeed;
        }
        // 비교 fixture는 전역 상태에 의존하지 않도록 effect 기본값을 null로 고정하고,
        // 명시된 경우에만 해당 effect를 활성화합니다.
        GameConst::$scenarioEffect = null;
        if (array_key_exists('scenarioEffect', $world)) {
            $scenarioEffect = $world['scenarioEffect'];
            if ($scenarioEffect === '' || $scenarioEffect === 'None') {
                $scenarioEffect = null;
            }
            if ($scenarioEffect !== null) {
                if (!is_string($scenarioEffect) || getScenarioEffectClass($scenarioEffect) === null) {
                    throw new \InvalidArgumentException('setup.world.scenarioEffect is invalid');
                }
            }
            GameConst::$scenarioEffect = $scenarioEffect;
        }
        if (array_key_exists('staticEventHandlers', $world)) {
            $handlersByEvent = $world['staticEventHandlers'];
            if (!is_array($handlersByEvent)) {
                throw new \InvalidArgumentException('setup.world.staticEventHandlers must be an object');
            }
            foreach ($handlersByEvent as $eventType => $handlers) {
                if (!is_string($eventType) || $eventType === '' || !is_array($handlers)) {
                    throw new \InvalidArgumentException('setup.world.staticEventHandlers is invalid');
                }
                foreach ($handlers as $handler) {
                    if (!is_string($handler) || $handler === '') {
                        throw new \InvalidArgumentException('setup.world.staticEventHandlers is invalid');
                    }
                }
            }
            GameConst::$staticEventHandlers = $handlersByEvent;
        }
    }
    foreach (['nations', 'cities', 'generals', 'troops', 'diplomacy'] as $collection) {
        if (isset($setup[$collection]) && !is_array($setup[$collection])) {
            throw new \InvalidArgumentException("setup.{$collection} must be an array");
        }
    }
    $generalCooldowns = comparisonGeneralCooldownSelectors(
        $setup['generalCooldowns'] ?? [],
        'setup.generalCooldowns',
    );
    if ($generalCooldowns !== []) {
        $nextExecuteStorage = KVStorage::getStorage($db, 'next_execute');
        foreach ($setup['generalCooldowns'] as $entry) {
            $nextAvailableTurn = $entry['nextAvailableTurn'] ?? null;
            if (!is_int($nextAvailableTurn) || $nextAvailableTurn < 0) {
                throw new \InvalidArgumentException(
                    'setup.generalCooldowns entries require a non-negative nextAvailableTurn',
                );
            }
            $key = "next_execute_{$entry['generalId']}_{$entry['actionName']}";
            $nextExecuteStorage->setValue($key, $nextAvailableTurn);
        }
        $nextExecuteStorage->resetCache();
    }
    if (isset($setup['randomFoundingCandidateCityIds'])) {
        $candidateCityIds = comparisonIntegerList(
            $setup['randomFoundingCandidateCityIds'],
            'randomFoundingCandidateCityIds',
        );
        $db->update('city', ['level' => 4], '1 = 1');
        if ($candidateCityIds !== []) {
            $db->update('city', ['level' => 5], 'city IN %li', $candidateCityIds);
        }
    }
    if (($setup['isolateWorld'] ?? false) === true) {
        $generalIds = array_values(array_map(
            static fn(array $row): int => (int)$row['id'],
            $setup['generals'] ?? [],
        ));
        $nationIds = array_values(array_map(
            static fn(array $row): int => (int)$row['id'],
            $setup['nations'] ?? [],
        ));
        if ($generalIds === [] || $nationIds === []) {
            throw new \InvalidArgumentException('isolateWorld requires generals and nations');
        }
        $generalTemplate = $db->queryFirstRow(
            'SELECT * FROM general WHERE no IN %li ORDER BY no LIMIT 1',
            $generalIds,
        );
        if ($generalTemplate === null) {
            throw new \InvalidArgumentException('isolateWorld requires at least one existing fixture general');
        }
        $generalTemplateId = (int)$generalTemplate['no'];
        $rankDataTemplate = $db->query(
            'SELECT `type`, `value` FROM rank_data WHERE general_id = %i',
            $generalTemplateId,
        );
        $db->delete('general_turn', 'general_id NOT IN %li', $generalIds);
        $db->delete('rank_data', 'general_id NOT IN %li', $generalIds);
        $db->delete('nation_turn', 'nation_id NOT IN %li', $nationIds);
        $db->delete('troop', '1 = 1');
        $db->delete('diplomacy', '1 = 1');
        $db->delete('general', 'no NOT IN %li', $generalIds);
        foreach ($generalIds as $generalId) {
            if ($db->queryFirstField('SELECT no FROM general WHERE no = %i', $generalId) !== null) {
                continue;
            }
            $newGeneral = $generalTemplate;
            $newGeneral['no'] = $generalId;
            $newGeneral['owner'] = 0;
            $newGeneral['name'] = "fixture-general-{$generalId}";
            $db->insert('general', $newGeneral);
        }
        foreach ($generalIds as $generalId) {
            foreach ($rankDataTemplate as $rankRow) {
                $rankData = [
                    'general_id' => $generalId,
                    'type' => $rankRow['type'],
                    'value' => $rankRow['value'],
                ];
                $db->insertUpdate('rank_data', $rankData, $rankData);
            }
        }
        $db->delete('nation', 'nation NOT IN %li', $nationIds);
        $db->update('city', [
            'nation' => 0,
            'supply' => 0,
            'front' => 0,
            'state' => 0,
            'term' => 0,
            'conflict' => '{}',
            'officer_set' => 0,
        ], '1 = 1');
    }
    foreach ($setup['nations'] ?? [] as $row) {
        if (!is_array($row) || !is_int($row['id'] ?? null) || $row['id'] < 1) {
            throw new \InvalidArgumentException('setup.nations requires positive integer ids');
        }
        $data = comparisonMappedPatch($row, [
            'id' => 'nation',
            'name' => 'name',
            'color' => 'color',
            'capitalCityId' => 'capital',
            'gold' => 'gold',
            'rice' => 'rice',
            'tech' => 'tech',
            'level' => 'level',
            'typeCode' => 'type',
            'war' => 'war',
            'diplomacyLimit' => 'surlimit',
            'generalCount' => 'gennum',
            'power' => 'power',
            'capitalRevision' => 'capset',
            'strategicCommandLimit' => 'strategic_cmd_limit',
        ]);
        if (isset($row['meta'])) {
            $data['aux'] = Json::encode($row['meta']);
        }
        $data += [
            'name' => "fixture-nation-{$row['id']}",
            'color' => '#777777',
            'capital' => 0,
            'gold' => 0,
            'rice' => 0,
            'level' => 1,
            'type' => 'che_중립',
            'aux' => '{}',
        ];
        $db->insertUpdate('nation', $data, $data);
        $nationStor = KVStorage::getStorage($db, $row['id'], 'nation_env');
        if (($setup['isolateWorld'] ?? false) === true) {
            $nationStor->deleteValue('recv_assist');
            $nationStor->deleteValue('resp_assist');
        }
        if (array_key_exists('nationEnv', $row)) {
            if (!is_array($row['nationEnv'])) {
                throw new \InvalidArgumentException('setup.nations.nationEnv must be an object');
            }
            foreach ($row['nationEnv'] as $key => $value) {
                if (!is_string($key) || $key === '') {
                    throw new \InvalidArgumentException('setup.nations.nationEnv keys must be non-empty strings');
                }
                $nationStor->setValue($key, $value);
            }
            $nationStor->resetCache();
        }
        if (array_key_exists('turnLastByOfficerLevel', $row)) {
            $turnLastByOfficerLevel = $row['turnLastByOfficerLevel'];
            if (!is_array($turnLastByOfficerLevel)) {
                throw new \InvalidArgumentException('setup.nations.turnLastByOfficerLevel must be an object');
            }
            foreach ($turnLastByOfficerLevel as $officerLevel => $lastTurn) {
                $officerLevel = filter_var($officerLevel, FILTER_VALIDATE_INT);
                if (
                    $officerLevel === false
                    || $officerLevel < 5
                    || $officerLevel > 12
                    || !is_array($lastTurn)
                ) {
                    throw new \InvalidArgumentException(
                        'setup.nations.turnLastByOfficerLevel requires officer levels 5 through 12'
                    );
                }
                $nationStor->setValue("turn_last_{$officerLevel}", $lastTurn);
            }
            $nationStor->resetCache();
        }
    }
    if (($setup['isolateWorld'] ?? false) === true && ($setup['nations'] ?? []) !== []) {
        $maxNationId = max(array_map(
            static fn(array $row): int => (int)$row['id'],
            $setup['nations'],
        ));
        $db->query('ALTER TABLE nation AUTO_INCREMENT = %i', $maxNationId + 1);
    }
    foreach ($setup['cities'] ?? [] as $row) {
        if (!is_array($row) || !is_int($row['id'] ?? null) || $row['id'] < 1) {
            throw new \InvalidArgumentException('setup.cities requires positive integer ids');
        }
        $patch = comparisonMappedPatch($row, [
            'nationId' => 'nation',
            'level' => 'level',
            'population' => 'pop',
            'populationMax' => 'pop_max',
            'agriculture' => 'agri',
            'agricultureMax' => 'agri_max',
            'commerce' => 'comm',
            'commerceMax' => 'comm_max',
            'security' => 'secu',
            'securityMax' => 'secu_max',
            'supplyState' => 'supply',
            'frontState' => 'front',
            'defence' => 'def',
            'defenceMax' => 'def_max',
            'wall' => 'wall',
            'wallMax' => 'wall_max',
            'state' => 'state',
            'term' => 'term',
            'trust' => 'trust',
            'trade' => 'trade',
            'officerSet' => 'officer_set',
        ]);
        if (array_key_exists('conflictEntries', $row)) {
            if (!is_array($row['conflictEntries'])) {
                throw new \InvalidArgumentException('setup.cities.conflictEntries must be an array');
            }
            $orderedConflict = [];
            foreach ($row['conflictEntries'] as $entry) {
                if (
                    !is_array($entry)
                    || count($entry) !== 2
                    || !is_int($entry[0] ?? null)
                    || $entry[0] < 1
                    || !is_numeric($entry[1] ?? null)
                ) {
                    throw new \InvalidArgumentException(
                        'setup.cities.conflictEntries requires [positive nation id, numeric value] pairs'
                    );
                }
                $orderedConflict[$entry[0]] = $entry[1];
            }
            $patch['conflict'] = Json::encode($orderedConflict);
        } elseif (array_key_exists('conflict', $row)) {
            if (!is_array($row['conflict'])) {
                throw new \InvalidArgumentException('setup.cities.conflict must be an object');
            }
            $patch['conflict'] = Json::encode($row['conflict']);
        }
        if ($patch !== []) {
            $db->update('city', $patch, 'city = %i', $row['id']);
        }
    }
    foreach ($setup['generals'] ?? [] as $row) {
        if (!is_array($row) || !is_int($row['id'] ?? null) || $row['id'] < 1) {
            throw new \InvalidArgumentException('setup.generals requires positive integer ids');
        }
        $patch = comparisonMappedPatch($row, [
            'name' => 'name',
            'nationId' => 'nation',
            'cityId' => 'city',
            'troopId' => 'troop',
            'leadership' => 'leadership',
            'strength' => 'strength',
            'intelligence' => 'intel',
            'leadershipExp' => 'leadership_exp',
            'strengthExp' => 'strength_exp',
            'intelExp' => 'intel_exp',
            'experience' => 'experience',
            'dedication' => 'dedication',
            'expLevel' => 'explevel',
            'officerLevel' => 'officer_level',
            'officerCityId' => 'officer_city',
            'belong' => 'belong',
            'permission' => 'permission',
            'betray' => 'betray',
            'makeLimit' => 'makelimit',
            'injury' => 'injury',
            'age' => 'age',
            'gold' => 'gold',
            'rice' => 'rice',
            'crew' => 'crew',
            'crewTypeId' => 'crewtype',
            'train' => 'train',
            'atmos' => 'atmos',
            'dex1' => 'dex1',
            'dex2' => 'dex2',
            'dex3' => 'dex3',
            'dex4' => 'dex4',
            'dex5' => 'dex5',
            'specAge' => 'specage',
            'specAge2' => 'specage2',
            'killTurn' => 'killturn',
            'npcState' => 'npc',
            'blockState' => 'block',
            'specialDomestic' => 'special',
            'specialWar' => 'special2',
            'personality' => 'personal',
            'itemHorse' => 'horse',
            'itemWeapon' => 'weapon',
            'itemBook' => 'book',
            'itemExtra' => 'item',
        ]);
        if (isset($row['meta'])) {
            $patch['aux'] = Json::encode($row['meta']);
        }
        if (array_key_exists('penalty', $row)) {
            if (!is_array($row['penalty'])) {
                throw new \InvalidArgumentException('setup.generals.penalty must be an object');
            }
            $patch['penalty'] = Json::encode($row['penalty']);
        }
        if (isset($row['lastTurn']) && is_array($row['lastTurn'])) {
            $patch['last_turn'] = Json::encode($row['lastTurn']);
        }
        if ($patch !== []) {
            $db->update('general', $patch, 'no = %i', $row['id']);
        }
        if (array_key_exists('nationId', $row)) {
            $db->update('rank_data', [
                'nation_id' => $row['nationId'],
            ], 'general_id = %i', $row['id']);
        }
    }
    foreach ($setup['rankData'] ?? [] as $row) {
        if (
            !is_array($row)
            || !is_int($row['generalId'] ?? null)
            || !is_string($row['type'] ?? null)
            || RankColumn::tryFrom($row['type']) === null
            || !is_int($row['value'] ?? null)
        ) {
            throw new \InvalidArgumentException('invalid setup.rankData row');
        }
        $nationId = (int)($db->queryFirstField(
            'SELECT nation FROM general WHERE no = %i',
            $row['generalId'],
        ) ?? 0);
        $db->insertUpdate('rank_data', [
            'general_id' => $row['generalId'],
            'nation_id' => $nationId,
            'type' => $row['type'],
            'value' => $row['value'],
        ], [
            'nation_id' => $nationId,
            'value' => $row['value'],
        ]);
    }
    if (($setup['isolateWorld'] ?? false) === true && ($setup['generals'] ?? []) !== []) {
        $maxGeneralId = max(array_map(
            static fn(array $row): int => (int)$row['id'],
            $setup['generals'],
        ));
        $db->query('ALTER TABLE general AUTO_INCREMENT = %i', $maxGeneralId + 1);
    }
    foreach ($setup['troops'] ?? [] as $row) {
        if (
            !is_array($row)
            || !is_int($row['id'] ?? null)
            || !is_int($row['nationId'] ?? null)
            || !is_string($row['name'] ?? null)
            || $row['id'] < 1
            || $row['nationId'] < 1
            || $row['name'] === ''
        ) {
            throw new \InvalidArgumentException('setup.troops requires positive id/nationId and non-empty name');
        }
        $data = [
            'troop_leader' => $row['id'],
            'nation' => $row['nationId'],
            'name' => $row['name'],
        ];
        $db->insertUpdate('troop', $data, $data);
    }
    foreach ($setup['diplomacy'] ?? [] as $row) {
        if (
            !is_array($row) ||
            !is_int($row['fromNationId'] ?? null) ||
            !is_int($row['toNationId'] ?? null) ||
            $row['fromNationId'] < 1 ||
            $row['toNationId'] < 1
        ) {
            throw new \InvalidArgumentException('setup.diplomacy requires positive integer nation ids');
        }
        $data = comparisonMappedPatch($row, [
            'fromNationId' => 'me',
            'toNationId' => 'you',
            'state' => 'state',
            'term' => 'term',
            'dead' => 'dead',
        ]);
        $data += ['state' => 3, 'term' => 0, 'dead' => 0];
        $db->insertUpdate('diplomacy', $data, $data);
    }
 }
 function comparisonRunTurnCommand(array $request): array
 {
    if (getenv('TURN_DIFFERENTIAL_ENABLED') !== '1') {
        throw new \RuntimeException('TURN_DIFFERENTIAL_ENABLED=1 is required');
    }
    $kind = $request['kind'] ?? null;
    if (!in_array($kind, ['general', 'nation', 'instantNation', 'troopJoinStaticEvent'], true)) {
        throw new \InvalidArgumentException(
            'kind must be general, nation, instantNation, or troopJoinStaticEvent',
        );
    }
    $actorGeneralId = $request['actorGeneralId'] ?? null;
    $action = $request['action'] ?? null;
    $args = $request['args'] ?? null;
    $includeLifecycle = $request['includeLifecycle'] ?? false;
    if (!is_int($actorGeneralId) || $actorGeneralId < 1) {
        throw new \InvalidArgumentException('actorGeneralId must be a positive integer');
    }
    if (!is_string($action) || $action === '') {
        throw new \InvalidArgumentException('action must be a non-empty string');
    }
    if (!is_bool($includeLifecycle)) {
        throw new \InvalidArgumentException('includeLifecycle must be a boolean');
    }
    if ($includeLifecycle && $kind !== 'general') {
        throw new \InvalidArgumentException('includeLifecycle currently supports general commands only');
    }
    comparisonApplyTurnFixtureSetup($request['setup'] ?? null);
    if ($includeLifecycle) {
        DB::db()->insertUpdate('general_turn', [
            'general_id' => $actorGeneralId,
            'turn_idx' => 0,
            'action' => $action,
            'arg' => Json::encode($args),
            'brief' => $action,
        ], [
            'action' => $action,
            'arg' => Json::encode($args),
            'brief' => $action,
        ]);
    }
    $snapshotRequest = ['observe' => $request['observe'] ?? []];
    $before = comparisonTurnStateSnapshot($snapshotRequest);
    $db = DB::db();
    $gameStorage = KVStorage::getStorage($db, 'game_env');
    $gameStorage->resetCache();
    $environment = $gameStorage->getAll();
    if ($kind === 'troopJoinStaticEvent') {
        if ($action !== \sammo\API\Troop\JoinTroop::class) {
            throw new \InvalidArgumentException('troopJoinStaticEvent requires the JoinTroop API action');
        }
        $troopId = is_array($args) ? ($args['troopID'] ?? null) : null;
        if (!is_int($troopId) || $troopId < 1) {
            throw new \InvalidArgumentException('troopJoinStaticEvent requires a positive integer troopID');
        }
        $general = GeneralLite::createObjFromDB(
            $actorGeneralId,
            ['troop'],
            Enums\GeneralLiteQueryMode::Lite,
        );
        if ($general === null) {
            throw new \RuntimeException('장수 정보를 불러올 수 없습니다.');
        }
        if ($general->getVar('troop') != 0) {
            throw new \RuntimeException('이미 부대에 소속되어 있습니다.');
        }
        $nationId = $general->getNationID();
        if ($nationId == 0) {
            throw new \RuntimeException('국가에 소속되어 있지 않습니다.');
        }
        $troopExists = $db->queryFirstField(
            'SELECT `troop_leader` FROM `troop` WHERE `troop_leader` = %i AND `nation` = %i',
            $troopId,
            $nationId,
        );
        if (!$troopExists) {
            throw new \RuntimeException('부대가 올바르지 않습니다.');
        }
        GameConst::$staticEventHandlers = [
            \sammo\API\Troop\JoinTroop::class => ['event_부대탑승즉시이동'],
        ];
        $general->setVar('troop', $troopId);
        StaticEventHandler::handleEvent($general, null, \sammo\API\Troop\JoinTroop::class, [], $args);
        $general->applyDB($db);
        $after = comparisonTurnStateSnapshot($snapshotRequest);
        return [
            'schemaVersion' => 1,
            'engine' => 'ref',
            'execution' => [
                'kind' => $kind,
                'actorGeneralId' => $actorGeneralId,
                'action' => $action,
                'args' => $args,
                'seedDomain' => 'none',
                'outcome' => ['completed' => true],
            ],
            'before' => $before,
            'after' => $after,
            'rng' => [],
        ];
    }
    $general = General::createObjFromDB($actorGeneralId);
    if ($kind === 'instantNation') {
        $command = buildNationCommandClass($action, $general, $environment, new LastTurn(), $args);
        if (!$command->hasFullConditionMet()) {
            throw new \RuntimeException($command->getFailString());
        }
        $completed = $command->run(NoRNG::rngInstance());
        $command->setNextAvailable();
        $general->getLogger()->flush();
        $after = comparisonTurnStateSnapshot($snapshotRequest);
        return [
            'schemaVersion' => 1,
            'engine' => 'ref',
            'execution' => [
                'kind' => $kind,
                'actorGeneralId' => $actorGeneralId,
                'action' => $action,
                'args' => $args,
                'seedDomain' => 'none',
                'outcome' => [
                    'lastTurn' => (object)[],
                    'commandName' => $command->getName(),
                    'completed' => $completed,
                ],
            ],
            'before' => $before,
            'after' => $after,
            'rng' => [],
        ];
    }
    $turn = new TurnExecutionHelper($general);
    $general->increaseInheritancePoint(Enums\InheritanceKey::lived_month, 1);
    $preprocessRng = new RandUtil(new LiteHashDRBG(Util::simpleSerialize(
        UniqueConst::$hiddenSeed,
        'preprocess',
        (int)$environment['year'],
        (int)$environment['month'],
        $actorGeneralId,
    )));
    $turn->preprocessCommand($preprocessRng, $environment);
    $seedDomain = $kind === 'general' ? 'generalCommand' : 'nationCommand';
    $seed = Util::simpleSerialize(
        UniqueConst::$hiddenSeed,
        $seedDomain,
        (int)$environment['year'],
        (int)$environment['month'],
        $actorGeneralId,
        $action,
    );
    $tracingRng = new TurnComparisonTracingRNG(new LiteHashDRBG($seed));
    $rng = new RandUtil($tracingRng);
    if ($kind === 'general' && $action === 'che_견문') {
        \sammo\TextDecoration\SightseeingMessage::setComparisonRng($rng);
    }
    if ($kind === 'general') {
        $previousLastTurn = $general->getLastTurn();
        $previousLastTurnRaw = $previousLastTurn->toRaw();
        $command = buildGeneralCommandClass($action, $general, $environment, $args);
        $commandFullConditionMet = $command->hasFullConditionMet();
        $resultTurn = $turn->processCommand($rng, $command, false);
    } else {
        $nationStor = KVStorage::getStorage($db, $general->getNationID(), 'nation_env');
        $lastNationTurnKey = "turn_last_{$general->getVar('officer_level')}";
        $previousLastTurn = LastTurn::fromRaw($nationStor->getValue($lastNationTurnKey));
        $previousLastTurnRaw = $previousLastTurn->toRaw();
        $command = buildNationCommandClass($action, $general, $environment, $previousLastTurn, $args);
        $commandFullConditionMet = $command->hasFullConditionMet();
        $resultTurn = $turn->processNationCommand($rng, $command);
        $nationStor->setValue($lastNationTurnKey, $resultTurn->toRaw());
    }
    if ($includeLifecycle) {
        pullGeneralCommand($general->getID());
        $general->increaseVarWithLimit(
            'myset',
            GameConst::$incDefSettingChange,
            null,
            GameConst::$maxDefSettingChange,
        );
        $turn->updateTurnTime();
    }
    $general->getLogger()->flush();
    $turn->applyDB();
    unset($turn);
    $after = comparisonTurnStateSnapshot($snapshotRequest);
    $resultTurnRaw = $resultTurn->toRaw();
    $resultTerm = (int)($resultTurnRaw['term'] ?? 0);
    $preReqTurn = $command->getPreReqTurn();
    $acceptScoutCompleted = (
        $action === 'che_등용수락'
        && is_array($args)
        && is_int($args['destNationID'] ?? null)
        && $general->getNationID() === $args['destNationID']
    );
    $foundNationCompleted = (
        in_array($action, ['che_건국', 'cr_건국', 'che_무작위건국'], true)
        && is_array($args)
        && is_string($args['nationName'] ?? null)
        && DB::db()->queryFirstField(
            'SELECT name FROM nation WHERE nation = %i',
            $general->getNationID(),
        ) === $args['nationName']
    );
    $completedByState = (
        $action === 'che_접경귀환'
        && $tracingRng->calls !== []
    ) || $acceptScoutCompleted || $foundNationCompleted || (($resultTurnRaw['command'] ?? null) === $command->getName()
        && (
            ($preReqTurn === 0 && $resultTerm === 0)
            || (
                $preReqTurn > 0
                && ($previousLastTurnRaw['command'] ?? null) === $command->getName()
                && ($previousLastTurnRaw['arg'] ?? null) === $command->getArg()
                && (int)($previousLastTurnRaw['term'] ?? 0) === $preReqTurn
            )
        ));
    $completed = $commandFullConditionMet && $completedByState;
    return [
        'schemaVersion' => 1,
        'engine' => 'ref',
        'execution' => [
            'kind' => $kind,
            'actorGeneralId' => $actorGeneralId,
            'action' => $action,
            'args' => $args,
            'seedDomain' => $seedDomain,
            'outcome' => [
                'lastTurn' => $resultTurnRaw,
                'commandName' => $command->getName(),
                'completed' => $completed,
            ],
        ],
        'before' => $before,
        'after' => $after,
        'rng' => $tracingRng->calls,
    ];
 }
 try {
    $input = stream_get_contents(STDIN);
    $request = json_decode($input === '' ? '{}' : $input, true, flags: JSON_THROW_ON_ERROR);
    if (!is_array($request)) {
        throw new \InvalidArgumentException('request must be an object');
    }
    echo json_encode(
        comparisonRunTurnCommand($request),
        JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION,
    ), PHP_EOL;
 } catch (\Throwable $throwable) {
    fwrite(STDERR, $throwable::class . ': ' . $throwable->getMessage() . PHP_EOL);
    exit(1);
 }
@@ -0,0 +1,643 @@
 <?php
 declare(strict_types=1);
 namespace sammo;
 use sammo\Enums\RankColumn;
 if (PHP_SAPI !== 'cli') {
    http_response_code(404);
    exit;
 }
 chdir(dirname(__DIR__));
 require_once 'lib.php';
 require_once 'func.php';
 /** @return list<int> */
 function comparisonIntegerList(mixed $value, string $label): array
 {
    if ($value === null) {
        return [];
    }
    if (!is_array($value)) {
        throw new \InvalidArgumentException("{$label} must be an array");
    }
    $result = [];
    foreach ($value as $entry) {
        if (!is_int($entry) || $entry < 0) {
            throw new \InvalidArgumentException("{$label} entries must be non-negative integers");
        }
        $result[$entry] = $entry;
    }
    ksort($result, SORT_NUMERIC);
    return array_values($result);
 }
 function comparisonJsonValue(mixed $value): mixed
 {
    if (!is_string($value) || $value === '') {
        return $value;
    }
    try {
        return json_decode($value, true, flags: JSON_THROW_ON_ERROR);
    } catch (\JsonException) {
        return $value;
    }
 }
 function comparisonOptionalCode(mixed $value): ?string
 {
    if (!is_string($value) || $value === '' || $value === 'None') {
        return null;
    }
    return $value;
 }
 /** @return list<array{generalId: int, actionName: string}> */
 function comparisonGeneralCooldownSelectors(mixed $value, string $label): array
 {
    if ($value === null) {
        return [];
    }
    if (!is_array($value)) {
        throw new \InvalidArgumentException("{$label} must be an array");
    }
    $result = [];
    foreach ($value as $entry) {
        if (!is_array($entry)) {
            throw new \InvalidArgumentException("{$label} entries must be objects");
        }
        $generalId = $entry['generalId'] ?? null;
        $actionName = $entry['actionName'] ?? null;
        if (!is_int($generalId) || $generalId < 1 || !is_string($actionName) || $actionName === '') {
            throw new \InvalidArgumentException(
                "{$label} entries require a positive generalId and non-empty actionName",
            );
        }
        $result["{$generalId}:{$actionName}"] = [
            'generalId' => $generalId,
            'actionName' => $actionName,
        ];
    }
    ksort($result, SORT_STRING);
    return array_values($result);
 }
 /** @return list<array{nationId: int, actionName: string}> */
 function comparisonNationCooldownSelectors(mixed $value, string $label): array
 {
    if ($value === null) {
        return [];
    }
    if (!is_array($value)) {
        throw new \InvalidArgumentException("{$label} must be an array");
    }
    $result = [];
    foreach ($value as $entry) {
        if (!is_array($entry)) {
            throw new \InvalidArgumentException("{$label} entries must be objects");
        }
        $nationId = $entry['nationId'] ?? null;
        $actionName = $entry['actionName'] ?? null;
        if (!is_int($nationId) || $nationId < 1 || !is_string($actionName) || $actionName === '') {
            throw new \InvalidArgumentException(
                "{$label} entries require a positive nationId and non-empty actionName",
            );
        }
        $result["{$nationId}:{$actionName}"] = [
            'nationId' => $nationId,
            'actionName' => $actionName,
        ];
    }
    ksort($result, SORT_STRING);
    return array_values($result);
 }
 /** @return list<array{fromNationId: int, toNationId: int}> */
 function comparisonDiplomacyPairSelectors(mixed $value, string $label): array
 {
    if ($value === null) {
        return [];
    }
    if (!is_array($value)) {
        throw new \InvalidArgumentException("{$label} must be an array");
    }
    $result = [];
    foreach ($value as $entry) {
        if (!is_array($entry)) {
            throw new \InvalidArgumentException("{$label} entries must be objects");
        }
        $fromNationId = $entry['fromNationId'] ?? null;
        $toNationId = $entry['toNationId'] ?? null;
        if (!is_int($fromNationId) || $fromNationId < 1 || !is_int($toNationId) || $toNationId < 1) {
            throw new \InvalidArgumentException(
                "{$label} entries require positive fromNationId and toNationId",
            );
        }
        $result["{$fromNationId}:{$toNationId}"] = [
            'fromNationId' => $fromNationId,
            'toNationId' => $toNationId,
        ];
    }
    ksort($result, SORT_STRING);
    return array_values($result);
 }
 /** @param array<string, mixed> $row */
 function comparisonPickRow(array $row, array $mapping, array $jsonKeys = []): array
 {
    $result = [];
    foreach ($mapping as $canonical => $legacy) {
        if (!array_key_exists($legacy, $row)) {
            continue;
        }
        $value = $row[$legacy];
        if (in_array($legacy, $jsonKeys, true)) {
            $value = comparisonJsonValue($value);
        }
        $result[$canonical] = $value;
    }
    return $result;
 }
 /** @param list<int> $ids */
 function comparisonRowsById(string $table, string $idColumn, array $ids): array
 {
    $db = DB::db();
    $rows = [];
    foreach ($ids as $id) {
        $row = $db->queryFirstRow(
            "SELECT * FROM `{$table}` WHERE `{$idColumn}` = %i",
            $id,
        );
        if ($row !== null) {
            $rows[] = $row;
        }
    }
    return $rows;
 }
 function comparisonTurnStateSnapshot(array $request): array
 {
    $observe = $request['observe'] ?? [];
    if (!is_array($observe)) {
        throw new \InvalidArgumentException('observe must be an object');
    }
    $generalIds = comparisonIntegerList($observe['generalIds'] ?? [], 'generalIds');
    $cityIds = comparisonIntegerList($observe['cityIds'] ?? [], 'cityIds');
    $nationIds = comparisonIntegerList($observe['nationIds'] ?? [], 'nationIds');
    $logAfterId = $observe['logAfterId'] ?? 0;
    $messageAfterId = $observe['messageAfterId'] ?? 0;
    $includeNationHistoryLogs = $observe['includeNationHistoryLogs'] ?? false;
    $includeGlobalHistoryLogs = $observe['includeGlobalHistoryLogs'] ?? false;
    $generalCooldownSelectors = comparisonGeneralCooldownSelectors(
        $observe['generalCooldowns'] ?? [],
        'generalCooldowns',
    );
    $nationCooldownSelectors = comparisonNationCooldownSelectors(
        $observe['nationCooldowns'] ?? [],
        'nationCooldowns',
    );
    $diplomacyPairSelectors = comparisonDiplomacyPairSelectors(
        $observe['diplomacyPairs'] ?? [],
        'diplomacyPairs',
    );
    if (
        !is_int($logAfterId)
        || $logAfterId < 0
        || !is_int($messageAfterId)
        || $messageAfterId < 0
    ) {
        throw new \InvalidArgumentException('logAfterId and messageAfterId must be non-negative integers');
    }
    if (!is_bool($includeNationHistoryLogs)) {
        throw new \InvalidArgumentException('includeNationHistoryLogs must be a boolean');
    }
    if (!is_bool($includeGlobalHistoryLogs)) {
        throw new \InvalidArgumentException('includeGlobalHistoryLogs must be a boolean');
    }
    $db = DB::db();
    $game = KVStorage::getStorage($db, 'game_env');
    $game->resetCache();
    $worldValues = $game->getValues([
        'year',
        'month',
        'turnterm',
        'turntime',
        'isunited',
        'scenario',
        'init_year',
        'init_month',
        'develcost',
        'killturn',
    ]);
    $nextExecuteStorage = KVStorage::getStorage($db, 'next_execute');
    $nextExecuteStorage->resetCache();
    $generalCooldowns = array_map(
        static function (array $selector) use ($nextExecuteStorage): array {
            $key = "next_execute_{$selector['generalId']}_{$selector['actionName']}";
            $value = $nextExecuteStorage->getValue($key);
            return [
                ...$selector,
                'nextAvailableTurn' => is_int($value) ? $value : null,
            ];
        },
        $generalCooldownSelectors,
    );
    $nationCooldowns = array_map(
        static function (array $selector) use ($db): array {
            $nationStorage = KVStorage::getStorage($db, $selector['nationId'], 'nation_env');
            $nationStorage->resetCache();
            $value = $nationStorage->getValue("next_execute_{$selector['actionName']}");
            return [
                ...$selector,
                'nextAvailableTurn' => is_int($value) ? $value : null,
            ];
        },
        $nationCooldownSelectors,
    );
    $generals = array_map(
        static function (array $row): array {
            $result = comparisonPickRow(
                $row,
            [
                'id' => 'no',
                'name' => 'name',
                'nationId' => 'nation',
                'cityId' => 'city',
                'troopId' => 'troop',
                'leadership' => 'leadership',
                'strength' => 'strength',
                'intelligence' => 'intel',
                'experience' => 'experience',
                'dedication' => 'dedication',
                'expLevel' => 'explevel',
                'officerLevel' => 'officer_level',
                'officerCityId' => 'officer_city',
                'belong' => 'belong',
                'permission' => 'permission',
                'betray' => 'betray',
                'makeLimit' => 'makelimit',
                'injury' => 'injury',
                'gold' => 'gold',
                'rice' => 'rice',
                'crew' => 'crew',
                'crewTypeId' => 'crewtype',
                'train' => 'train',
                'atmos' => 'atmos',
                'age' => 'age',
                'npcState' => 'npc',
                'turnTime' => 'turntime',
                'recentWarTime' => 'recent_war',
                'lastTurn' => 'last_turn',
                'meta' => 'aux',
                'penalty' => 'penalty',
                'leadershipExp' => 'leadership_exp',
                'strengthExp' => 'strength_exp',
                'intelExp' => 'intel_exp',
                'dex1' => 'dex1',
                'dex2' => 'dex2',
                'dex3' => 'dex3',
                'dex4' => 'dex4',
                'dex5' => 'dex5',
                'specAge' => 'specage',
                'specAge2' => 'specage2',
                'killTurn' => 'killturn',
                'mySet' => 'myset',
                'specialDomestic' => 'special',
                'specialWar' => 'special2',
                'personality' => 'personal',
                'itemHorse' => 'horse',
                'itemWeapon' => 'weapon',
                'itemBook' => 'book',
                'itemExtra' => 'item',
            ],
            ['last_turn', 'aux', 'penalty'],
            );
            foreach ([
                'specialDomestic',
                'specialWar',
                'personality',
                'itemHorse',
                'itemWeapon',
                'itemBook',
                'itemExtra',
            ] as $key) {
                $result[$key] = comparisonOptionalCode($result[$key] ?? null);
            }
            $result['maxBelong'] = (int)($result['meta']['max_belong'] ?? 0);
            $ownerId = (int)($row['owner'] ?? 0);
            $activeActionPoints = 0;
            if ($ownerId > 0) {
                $inheritanceStorage = KVStorage::getStorage(DB::db(), "inheritance_{$ownerId}");
                $inheritanceStorage->resetCache();
                $stored = $inheritanceStorage->getValue('active_action');
                if (is_array($stored) && (is_int($stored[0] ?? null) || is_float($stored[0] ?? null))) {
                    $activeActionPoints = $stored[0];
                }
            }
            $result['hasOwner'] = $ownerId > 0;
            $result['inheritActiveActionPoints'] = $activeActionPoints;
            return $result;
        },
        comparisonRowsById('general', 'no', $generalIds),
    );
    $rankTypes = array_map(
        static fn(RankColumn $column): string => $column->value,
        RankColumn::cases(),
    );
    $rankData = $generalIds === []
        ? []
        : iterator_to_array($db->query(
            'SELECT general_id AS generalId, nation_id AS nationId, `type`, `value`'
            . ' FROM rank_data WHERE general_id IN %li AND `type` IN %ls'
            . ' ORDER BY general_id, `type`',
            $generalIds,
            $rankTypes,
        ));
    $cities = array_map(
        static fn(array $row): array => comparisonPickRow(
            $row,
            [
                'id' => 'city',
                'name' => 'name',
                'nationId' => 'nation',
                'level' => 'level',
                'population' => 'pop',
                'populationMax' => 'pop_max',
                'agriculture' => 'agri',
                'agricultureMax' => 'agri_max',
                'commerce' => 'comm',
                'commerceMax' => 'comm_max',
                'security' => 'secu',
                'securityMax' => 'secu_max',
                'supplyState' => 'supply',
                'frontState' => 'front',
                'defence' => 'def',
                'defenceMax' => 'def_max',
                'wall' => 'wall',
                'wallMax' => 'wall_max',
                'state' => 'state',
                'term' => 'term',
                'trust' => 'trust',
                'trade' => 'trade',
                'conflict' => 'conflict',
                'officerSet' => 'officer_set',
            ],
            ['conflict'],
        ),
        comparisonRowsById('city', 'city', $cityIds),
    );
    $nations = array_map(
        static function (array $row) use ($db): array {
            $projected = comparisonPickRow(
                $row,
                [
                    'id' => 'nation',
                    'name' => 'name',
                    'color' => 'color',
                    'capitalCityId' => 'capital',
                    'gold' => 'gold',
                    'rice' => 'rice',
                    'tech' => 'tech',
                    'level' => 'level',
                    'typeCode' => 'type',
                    'generalCount' => 'gennum',
                    'power' => 'power',
                    'war' => 'war',
                    'diplomacyLimit' => 'surlimit',
                    'capitalRevision' => 'capset',
                    'strategicCommandLimit' => 'strategic_cmd_limit',
                    'meta' => 'aux',
                ],
                ['aux'],
            );
            $nationStor = KVStorage::getStorage($db, (int)$row['nation'], 'nation_env');
            $receivedAssist = $nationStor->getValue('recv_assist');
            if (is_array($receivedAssist) && $receivedAssist !== []) {
                $projected['meta']['recv_assist'] = $receivedAssist;
            }
            $respondedAssist = $nationStor->getValue('resp_assist');
            if (is_array($respondedAssist) && $respondedAssist !== []) {
                $projected['meta']['resp_assist'] = $respondedAssist;
            }
            return $projected;
        },
        comparisonRowsById('nation', 'nation', $nationIds),
    );
    $diplomacyPairs = [];
    foreach ($nationIds as $fromNationId) {
        foreach ($nationIds as $toNationId) {
            if ($fromNationId === $toNationId) {
                continue;
            }
            $diplomacyPairs["{$fromNationId}:{$toNationId}"] = [
                'fromNationId' => $fromNationId,
                'toNationId' => $toNationId,
            ];
        }
    }
    foreach ($diplomacyPairSelectors as $pair) {
        $diplomacyPairs["{$pair['fromNationId']}:{$pair['toNationId']}"] = $pair;
    }
    ksort($diplomacyPairs, SORT_STRING);
    $diplomacy = [];
    foreach ($diplomacyPairs as $pair) {
        $row = $db->queryFirstRow(
            'SELECT me, you, state, term, dead FROM diplomacy WHERE me = %i AND you = %i',
            $pair['fromNationId'],
            $pair['toNationId'],
        );
        if ($row !== null) {
            $diplomacy[] = comparisonPickRow($row, [
                'fromNationId' => 'me',
                'toNationId' => 'you',
                'state' => 'state',
                'term' => 'term',
                'dead' => 'dead',
            ]);
        }
    }
    $generalTurns = [];
    foreach ($generalIds as $generalId) {
        foreach ($db->query(
            'SELECT general_id, turn_idx, action, arg FROM general_turn WHERE general_id = %i ORDER BY turn_idx',
            $generalId,
        ) as $row) {
            $generalTurns[] = comparisonPickRow(
                $row,
                ['generalId' => 'general_id', 'turnIndex' => 'turn_idx', 'action' => 'action', 'args' => 'arg'],
                ['arg'],
            );
        }
    }
    $nationTurns = [];
    foreach ($nationIds as $nationId) {
        foreach ($db->query(
            'SELECT nation_id, officer_level, turn_idx, action, arg FROM nation_turn WHERE nation_id = %i ORDER BY officer_level, turn_idx',
            $nationId,
        ) as $row) {
            $nationTurns[] = comparisonPickRow(
                $row,
                [
                    'nationId' => 'nation_id',
                    'officerLevel' => 'officer_level',
                    'turnIndex' => 'turn_idx',
                    'action' => 'action',
                    'args' => 'arg',
                ],
                ['arg'],
            );
        }
    }
    $logs = [];
    if ($generalIds !== []) {
        foreach ($db->query(
            'SELECT id, general_id, log_type, year, month, text FROM general_record WHERE id > %i ORDER BY id',
            $logAfterId,
        ) as $row) {
            if ((int)$row['general_id'] !== 0 && !in_array((int)$row['general_id'], $generalIds, true)) {
                continue;
            }
            $generalId = (int)$row['general_id'];
            $category = (string)$row['log_type'];
            if ($category === 'battle') {
                $category = 'battle_detail';
            } elseif ($generalId === 0) {
                $category = 'summary';
            }
            $logs[] = comparisonPickRow($row, [
                'id' => 'id',
                'generalId' => 'general_id',
                'year' => 'year',
                'month' => 'month',
                'text' => 'text',
            ]) + [
                'scope' => $generalId === 0 ? 'system' : 'general',
                'category' => $category,
                'nationId' => null,
            ];
        }
    }
    if ($includeNationHistoryLogs && $nationIds !== []) {
        foreach ($db->query(
            'SELECT id, nation_id, year, month, text FROM world_history WHERE nation_id IN %li ORDER BY id',
            $nationIds,
        ) as $row) {
            $logs[] = comparisonPickRow($row, [
                'id' => 'id',
                'nationId' => 'nation_id',
                'year' => 'year',
                'month' => 'month',
                'text' => 'text',
            ]) + [
                'scope' => 'nation',
                'category' => 'history',
                'generalId' => null,
            ];
        }
    }
    if ($includeGlobalHistoryLogs) {
        foreach ($db->query(
            'SELECT id, nation_id, year, month, text FROM world_history WHERE nation_id = 0 ORDER BY id',
        ) as $row) {
            $logs[] = comparisonPickRow($row, [
                'id' => 'id',
                'nationId' => 'nation_id',
                'year' => 'year',
                'month' => 'month',
                'text' => 'text',
            ]) + [
                'scope' => 'system',
                'category' => 'history',
                'generalId' => null,
            ];
        }
    }
    $messages = array_map(
        static fn(array $row): array => comparisonPickRow(
            $row,
            [
                'id' => 'id',
                'mailbox' => 'mailbox',
                'type' => 'type',
                'sourceId' => 'src',
                'destinationId' => 'dest',
                'createdAt' => 'time',
                'payload' => 'message',
            ],
            ['message'],
        ),
        $db->query(
            'SELECT id, mailbox, type, src, dest, time, message FROM message WHERE id > %i ORDER BY id',
            $messageAfterId,
        ),
    );
    return [
        'schemaVersion' => 1,
        'engine' => 'ref',
        'world' => [
            'year' => (int)$worldValues['year'],
            'month' => (int)$worldValues['month'],
            'tickMinutes' => (int)$worldValues['turnterm'],
            'turnTime' => (string)$worldValues['turntime'],
            'isUnited' => (int)$worldValues['isunited'],
            'scenarioId' => (int)$worldValues['scenario'],
            'initYear' => (int)$worldValues['init_year'],
            'initMonth' => (int)$worldValues['init_month'],
            'develCost' => (int)$worldValues['develcost'],
            'killTurn' => (int)$worldValues['killturn'],
            'generalCooldowns' => $generalCooldowns,
            'nationCooldowns' => $nationCooldowns,
        ],
        'generals' => $generals,
        'rankData' => $rankData,
        'cities' => $cities,
        'nations' => $nations,
        'diplomacy' => $diplomacy,
        'generalTurns' => $generalTurns,
        'nationTurns' => $nationTurns,
        'logs' => $logs,
        'messages' => $messages,
        'watermarks' => [
            'logId' => (int)($db->queryFirstField('SELECT COALESCE(MAX(id), 0) FROM general_record') ?? 0),
            'historyLogId' => (int)($db->queryFirstField('SELECT COALESCE(MAX(id), 0) FROM world_history') ?? 0),
            'messageId' => (int)($db->queryFirstField('SELECT COALESCE(MAX(id), 0) FROM message') ?? 0),
        ],
    ];
 }
 function comparisonTurnStateSnapshotMain(): void
 {
    try {
        $input = stream_get_contents(STDIN);
        $request = json_decode($input === '' ? '{}' : $input, true, flags: JSON_THROW_ON_ERROR);
        if (!is_array($request)) {
            throw new \InvalidArgumentException('request must be an object');
        }
        echo json_encode(
            comparisonTurnStateSnapshot($request),
            JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION,
        ), PHP_EOL;
    } catch (\Throwable $throwable) {
        fwrite(STDERR, $throwable::class . ': ' . $throwable->getMessage() . PHP_EOL);
        exit(1);
    }
 }
 if (realpath((string)($_SERVER['SCRIPT_FILENAME'] ?? '')) === __FILE__) {
    comparisonTurnStateSnapshotMain();
 }
@@ -51,6 +51,22 @@
    display: none;
 }
 .picture_choice {
    margin: 8px auto;
 }
 .picture_choice label,
 .event_picture label {
    display: inline-flex;
    align-items: center;
    gap: 4px;
    margin: 4px 8px;
 }
 .picture_choice img {
    object-fit: cover;
 }
 .custom_picture {
    display: none;
 }
@@ -61,4 +77,4 @@
 .custom_stat {
    display: none;
-}
+}
@@ -52,8 +52,8 @@ class DB
    /**
     * DB 객체 생성
-     * 
+     *
-     * @return \MeekroDB 
+     * @return \MeekroDB
     * @suppress PhanTypeMismatchProperty
     */
    public static function db()
@@ -61,11 +61,6 @@ class DB
        if (self::$uDB === null) {
            self::$uDB = new \MeekroDB(self::$host, self::$user, self::$password, self::$dbName, self::$port, self::$encoding);
            self::$uDB->connect_options[MYSQLI_OPT_INT_AND_FLOAT_NATIVE] = true;
            self::$uDB->error_handler = function () {
            };
            self::$uDB->throw_exception_on_error = true;
            self::$uDB->throw_exception_on_nonsql_error = true;
        }
        return self::$uDB;
    }
@@ -0,0 +1,53 @@
 <?php
 namespace sammo;
 use sammo\DTO\MenuItem;
 use sammo\DTO\MenuMulti;
 use sammo\DTO\MenuSplit;
 //변경을 원한다면 파일을 복제 후 수정
 class GlobalMenu {
  /** @var (MenuItem|MenuMulti|MenuSplit)[] */
  const version = 3;
  static ?array $menu = null;
  public static function getMenu(): array{
    if(static::$menu !== null){
      return static::$menu;
    }
    static::$menu = [
      new MenuItem('천통국 베팅', 'v_nationBetting.php', condHighlightVar: 'nationBetting'),
      new MenuMulti('게임정보', [
        new MenuItem('세력일람', 'a_kingdomList.php', newTab: true),
        new MenuItem('장수일람', 'a_genList.php', newTab: true),
        new MenuItem('명장일람', 'a_bestGeneral.php', newTab: true),
        new MenuItem('명예의전당', 'a_hallOfFame.php', newTab: true),
        new MenuItem('왕조일람', 'a_emperior.php', newTab: true),
      ]),
      new MenuItem('연감', 'v_history.php', newTab: true),
      new MenuSplit(
        new MenuItem('게시판', '/board/community', newTab: true),
        [
          new MenuItem('건의/제안', '/board/request', newTab: true),
          new MenuItem('팁/강좌', '/board/tip', newTab: true),
          new MenuItem('패치 내역', '/board/patch', newTab: true),
        ]
      ),
      new MenuSplit(
        new MenuItem('공식 오픈 톡', 'https://open.kakao.com/o/', newTab: true),
        [
          new MenuItem('잡담 오픈 톡', 'https://open.kakao.com/o/', newTab: true)
        ],
      ),
      new MenuItem('전투 시뮬레이터', 'battle_simulator.php', newTab: true),
      new MenuMulti('기타 정보', [
        new MenuItem('접속량정보', 'a_traffic.php', newTab: true),
        new MenuItem('빙의일람', 'a_npcList', newTab: true, condShowVar: 'npcMode'),
      ]),
      new MenuItem('설문조사', 'v_vote.php', newTab: true, condHighlightVar: 'vote'),
    ];
    return static::$menu;
  }
 }
@@ -0,0 +1,6 @@
 <?php
 namespace sammo;
 class ServerEnv extends ServerDefaultEnv {
    //ServerEnv 기본값을 변경하고 싶다면 orig를 제거한 복사본을 만들고 수정
 }
@@ -5,9 +5,12 @@ namespace sammo;
 use DateTime;
 use Ds\Set;
 use sammo\Enums\AuctionType;
 use sammo\Enums\GeneralAccessLogColumn;
 use sammo\Enums\GeneralColumn;
 use sammo\Enums\GeneralQueryMode;
 use sammo\Enums\InheritanceKey;
 use sammo\Enums\PenaltyKey;
 use sammo\Enums\RankColumn;
 use sammo\Event\Action;
 require_once 'process_war.php';
 require_once 'func_gamerule.php';
@@ -104,28 +107,27 @@ function GetImageURL($imgsvr, $filepath = '')
 }
 /**
- * @param null|int $con 장수의 벌점
+ * @param null|int $refreshScore 장수의 벌점
 * @param null|int $conlimit 최대 벌점
 */
-function checkLimit($con = null)
+function checkLimit($refreshScore = null)
 {
    $session = Session::getInstance();
-    if ($session->userGrade >= 4) {
+    if ($session->userGrade >= 6) {
        return 0;
    }
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
-    if ($con === null) {
+    if ($refreshScore === null) {
-        $con = $db->queryFirstField('SELECT con FROM general WHERE `owner`=%i', Session::getUserID());
+        $refreshScore = $db->queryFirstField('SELECT refresh_score FROM general_access_log WHERE `general_id`=%i', Session::getGeneralID());
    }
-    $conlimit = $gameStor->conlimit;
+    $refreshLimit = $gameStor->refreshLimit;
-    if ($con > $conlimit) {
+    if ($refreshScore > $refreshLimit) {
        return 2;
        //접속제한 90%이면 경고문구
-    } elseif ($con > $conlimit * 0.9) {
+    } elseif ($refreshScore > $refreshLimit * 0.9) {
        return 1;
    } else {
        return 0;
@@ -148,7 +150,7 @@ function getRandGenName(RandUtil $rng)
-function cityInfo(General $generalObj)
+function cityInfo(GeneralLite $generalObj)
 {
    $db = DB::db();
@@ -375,11 +377,11 @@ function myNationInfo(General $generalObj)
 function checkSecretMaxPermission($penalty)
 {
    $secretMax = 4;
-    if ($penalty['noTopSecret'] ?? false) {
+    if ($penalty[PenaltyKey::NoTopSecret->value] ?? false) {
        $secretMax = 1;
-    } else if ($penalty['noChief'] ?? false) {
+    } else if ($penalty[PenaltyKey::NoChief->value] ?? false) {
        $secretMax = 1;
-    } else if ($penalty['noAmbassador'] ?? false) {
+    } else if ($penalty[PenaltyKey::NoAmbassador->value] ?? false) {
        $secretMax = 2;
    }
    return $secretMax;
@@ -402,19 +404,19 @@ function checkSecretPermission(array $me, $checkSecretLimit = true)
    }
-    if ($penalty['noSecret'] ?? false) {
+    if ($penalty[PenaltyKey::NoChief->value] ?? false) {
        return 0;
    }
    $secretMin = 0;
-    $secretMax = checkSecretMaxPermission($me, $penalty);
+    $secretMax = checkSecretMaxPermission($penalty);
    if ($me['officer_level'] == 12) {
        $secretMin = 4;
-    } else if ($me['permission'] == 'ambassador') {
+    } else if ($permission == 'ambassador') {
        $secretMin = 4;
-    } else if ($me['permission'] == 'auditor') {
+    } else if ($permission == 'auditor') {
        $secretMin = 3;
    } else if ($me['officer_level'] >= 5) {
        $secretMin = 2;
@@ -643,7 +645,7 @@ function generalInfo(General $generalObj)
        $age = "<font color=red>{$age} 세</font>";
    }
-    $connectCnt = round($generalObj->getVar('connect'), -1);
+    $refreshScoreTotal = round($generalObj->getAccessLogVar(GeneralAccessLogColumn::refreshScoreTotal) ?? 0, -1);
    $specialDomestic = $generalObj->getVar('special') === GameConst::$defaultSpecialDomestic
        ? "{$generalObj->getVar('specage')}세"
        : "<font color=limegreen>" . displayiActionObjInfo($generalObj->getSpecialDomestic()) . "</font>";
@@ -752,7 +754,7 @@ function generalInfo(General $generalObj)
        <td style='text-align:center;' class='bg1'><b>부대</b></td>
        <td style='text-align:center;' colspan=3>{$troopInfo}</td>
        <td style='text-align:center;' class='bg1'><b>벌점</b></td>
-        <td style='text-align:center;' colspan=5>" . getConnect($connectCnt) . " {$connectCnt}({$generalObj->getVar('con')})</td>
+        <td style='text-align:center;' colspan=5>" . getRefreshScoreText($refreshScoreTotal) . " {$refreshScoreTotal}({$generalObj->getAccessLogVar(GeneralAccessLogColumn::refreshScore)})</td>
    </tr>
 </table>";
 }
@@ -886,7 +888,7 @@ function generalInfo2(General $generalObj)
 function getOnlineNum(): int
 {
-    return KVStorage::getStorage(DB::db(), 'game_env')->getValue('online') ?? 0;
+    return KVStorage::getStorage(DB::db(), 'game_env')->getValue('online_user_cnt') ?? 0;
 }
 function onlinegen(General $general)
@@ -906,7 +908,7 @@ function nationMsg(General $general)
    $nationID = $general->getNationID();
    $nationStor = KVStorage::getStorage($db, $nationID, 'nation_env');
-    return $nationStor->notice ?? '';
+    return $nationStor->nationNotice['msg'] ?? '';
 }
 function banner()
@@ -999,76 +1001,69 @@ function increaseRefresh($type = "", $cnt = 1)
    $generalID = $session->generalID;
    $userGrade = $session->userGrade;
-    $date = TimeUtil::now();
+    $dateObj = new \DateTimeImmutable();
    $date = TimeUtil::format($dateObj, false);
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
    $gameStor->refresh = $gameStor->refresh + $cnt; //TODO: +로 증가하는 값은 별도로 분리
    $isunited = $gameStor->isunited;
    $opentime = $gameStor->opentime;
-    if ($isunited != 2 && $generalID && $userGrade < 6 && $opentime <= TimeUtil::now()) {
+    if ($userGrade >= 6) {
-        $db->update('general', [
+        return;
-            'lastrefresh' => $date,
+    }
-            'con' => $db->sqleval('con + %i', $cnt),
+    if ($isunited == 2) {
-            'connect' => $db->sqleval('connect + %i', $cnt),
+        return;
-            'refcnt' => $db->sqleval('refcnt + %i', $cnt),
+    }
-            'refresh' => $db->sqleval('refresh + %i', $cnt)
+    if (!$generalID) {
-        ], 'owner=%i', $userID);
+        return;
    }
    if ($opentime > $date) {
        return;
    }
-    $date = date('Y_m_d H:i:s');
+    $gameStor->refresh = $gameStor->refresh + $cnt; //TODO: +로 증가하는 값은 별도로 분리
    $date2 = substr($date, 0, 10);
    $online = getOnlineNum();
    file_put_contents(
        __DIR__ . "/logs/" . UniqueConst::$serverID . "/_{$date2}_refresh.txt",
        sprintf(
            "%s, %s, %s, %s, %s, %d\n",
            $date,
            $session->userName,
            $session->generalName,
            $session->ip,
            $type,
            $online
        ),
        FILE_APPEND
    );
-    $proxy_headers = array(
+    $db->insertUpdate('general_access_log', [
-        'HTTP_VIA',
+        GeneralAccessLogColumn::generalID->value => $generalID,
-        'HTTP_X_FORWARDED_FOR',
+        GeneralAccessLogColumn::userID->value => $userID,
-        'HTTP_FORWARDED_FOR',
+        GeneralAccessLogColumn::lastRefresh->value => $date,
-        'HTTP_X_FORWARDED',
+        GeneralAccessLogColumn::refreshTotal->value => $cnt,
-        'HTTP_FORWARDED',
+        GeneralAccessLogColumn::refresh->value => $cnt,
-        'HTTP_CLIENT_IP',
+        GeneralAccessLogColumn::refreshScore->value => $cnt,
-        'HTTP_FORWARDED_FOR_IP',
+        GeneralAccessLogColumn::refreshScoreTotal->value => $cnt,
-        'VIA',
+    ], [
-        'X_FORWARDED_FOR',
+        GeneralAccessLogColumn::lastRefresh->value => $date,
-        'FORWARDED_FOR',
+        GeneralAccessLogColumn::refreshTotal->value => $db->sqleval('%b + %i', GeneralAccessLogColumn::refreshTotal->value, $cnt),
-        'X_FORWARDED',
+        GeneralAccessLogColumn::refresh->value => $db->sqleval('%b + %i', GeneralAccessLogColumn::refresh->value, $cnt),
-        'FORWARDED',
+        GeneralAccessLogColumn::refreshScore->value => $db->sqleval('%b + %i', GeneralAccessLogColumn::refreshScore->value, $cnt),
-        'CLIENT_IP',
+        GeneralAccessLogColumn::refreshScoreTotal->value => $db->sqleval('%b + %i', GeneralAccessLogColumn::refreshScoreTotal->value, $cnt),
-        'FORWARDED_FOR_IP',
+    ]);
        'HTTP_PROXY_CONNECTION'
    );
-    $str = "";
+    $serverPath = __DIR__;
-    foreach ($proxy_headers as $x) {
+
-        if (isset($_SERVER[$x])) $str .= "//{$x}:{$_SERVER[$x]}";
+    $serverID = UniqueConst::$serverID;
-    }
+    $logPath = "{$serverPath}/logs/{$serverID}/api_log.db";
-    if ($str != "") {
+
-        file_put_contents(
+    $logDB = FileDB::db($logPath, $serverPath . '/../f_install/sql/api_log.sql');
-            __DIR__ . "/logs/" . UniqueConst::$serverID . "/_{$date2}_ipcheck.txt",
+
-            sprintf(
+    $ip = $_SERVER['HTTP_X_FORWARDED_FOR'] ?? $_SERVER['REMOTE_ADDR'] ?? 'local';
-                "%s, %s, %s%s\n",
+    $date = date('Y-m-d H:i:s');
-                $session->userName,
+
-                $session->generalName,
+    $logDB->insert('api_log', [
-                $_SERVER['REMOTE_ADDR'],
+        'user_id' => $session->userID,
-                $str
+        'ip' => $ip,
-            ),
+        'date' => $date,
-            FILE_APPEND
+        'path' => "refresh",
-        );
+        'arg' => Json::encode([
-    }
+            'type' => $type,
        ]),
        'aux' => Json::encode([
            'generalID' => $generalID,
            'generalName' => $session->generalName,
            'userName' => $session->userName,
        ]),
    ]);
 }
 function updateTraffic()
@@ -1076,12 +1071,9 @@ function updateTraffic()
    $online = getOnlineNum();
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
-    $admin = $gameStor->getValues(['year', 'month', 'refresh', 'maxonline', 'maxrefresh']);
+    $admin = $gameStor->getValues(['year', 'month', 'refresh', 'maxonline', 'maxrefresh', 'recentTraffic']);
    /** @var array{year:int,month:int,refresh:int,maxonline:int,maxrefresh:int} $admin */
    //최다갱신자
    $user = $db->queryFirstRow('select name,refresh from general order by refresh desc limit 1');
    if ($admin['maxrefresh'] < $admin['refresh']) {
        $admin['maxrefresh'] = $admin['refresh'];
    }
@@ -1092,22 +1084,20 @@ function updateTraffic()
    $gameStor->maxrefresh = $admin['maxrefresh'];
    $gameStor->maxonline = $admin['maxonline'];
-    $db->update('general', ['refresh' => 0], true);
+    $recentTraffic = $admin['recentTraffic'] ?? [];
    if(count($recentTraffic) >= 5){
        array_shift($recentTraffic);
    }
    $recentTraffic[] = [
        'year'=>$admin['year'],
        'month' => $admin['month'],
        'refresh' => $admin['refresh'],
        'online' => $online,
        'date' => TimeUtil::now(),
    ];
    $gameStor->recentTraffic = $recentTraffic;
-    $date = TimeUtil::now();
+    $db->update('general_access_log', ['refresh' => 0], true);
    //일시|년|월|총갱신|접속자|최다갱신자
    file_put_contents(
        __DIR__ . "/logs/" . UniqueConst::$serverID . "/_traffic.txt",
        Json::encode([
            $date,
            $admin['year'],
            $admin['month'],
            $admin['refresh'],
            $online,
            $user['name'] . "(" . $user['refresh'] . ")"
        ]) . "\n",
        FILE_APPEND
    );
 }
 function CheckOverhead()
@@ -1115,13 +1105,13 @@ function CheckOverhead()
    //서버정보
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
-    list($turnterm, $conlimit) = $gameStor->getValuesAsArray(['turnterm', 'conlimit']);
+    [$turnterm, $refreshLimit] = $gameStor->getValuesAsArray(['turnterm', 'refreshLimit']);
-    $con = Util::round(pow($turnterm, 0.6) * 3) * 10;
+    $nextRefreshLimit = Util::round(pow($turnterm, 0.6) * 3) * GameConst::$refreshLimitCoef;
-    if ($con != $conlimit) {
+    if ($nextRefreshLimit != $refreshLimit) {
-        $gameStor->conlimit = $con;
+        $gameStor->refreshLimit = $nextRefreshLimit;
    }
 }
@@ -1223,10 +1213,18 @@ function updateOnline()
        $nationname[$nation['nation']] = $nation['name'];
    }
    //동접수
-    $before5Min = TimeUtil::nowAddMinutes(-5);
+    $startTurn = cutTurn($gameStor->turntime, $gameStor->turnterm, false);
-    $onlineUser = $db->query('SELECT no,name,nation FROM general WHERE lastrefresh > %s AND npc < 2', $before5Min);
+    $onlineUser = $db->query(
        'SELECT %b, %b, %b FROM `general_access_log` as `log` INNER JOIN `general` ON `log`.%b = `general`.%b WHERE %b >= %s',
        GeneralColumn::no->value,
        GeneralColumn::name->value,
        GeneralColumn::nation->value,
        GeneralAccessLogColumn::generalID->value,
        GeneralColumn::no->value,
        GeneralAccessLogColumn::lastRefresh->value,
        $startTurn
    );
    $onlineNum = count($onlineUser);
    $onlineNationUsers = Util::arrayGroupBy($onlineUser, 'nation');
@@ -1249,76 +1247,6 @@ function updateOnline()
    $gameStor->online_nation = join(', ', $onlineNation);
 }
 function addAge(RandUtil $rng)
 {
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
    //나이와 호봉 증가
    $db->update('general', [
        'age' => $db->sqleval('age+1'),
    ], true);
    $db->update('general', [
        'belong' => $db->sqleval('belong+1')
    ], 'nation != 0');
    [$startYear, $year, $month] = $gameStor->getValuesAsArray(['startyear', 'year', 'month']);
    if ($year >= $startYear + 3) {
        foreach ($db->query('SELECT no,name,nation,leadership,strength,intel,aux from general where specage<=age and special=%s', GameConst::$defaultSpecialDomestic) as $general) {
            $generalID = $general['no'];
            $special = SpecialityHelper::pickSpecialDomestic(
                $rng,
                $general,
                (Json::decode($general['aux'])['prev_types_special']) ?? []
            );
            $specialClass = buildGeneralSpecialDomesticClass($special);
            $specialText = $specialClass->getName();
            $db->update('general', [
                'special' => $special
            ], 'no=%i', $generalID);
            $logger = new ActionLogger($generalID, $general['nation'], $year, $month);
            $josaUl = JosaUtil::pick($specialText, '을');
            $logger->pushGeneralActionLog("특기 【<b><L>{$specialText}</></b>】{$josaUl} 익혔습니다!", ActionLogger::PLAIN);
            $logger->pushGeneralHistoryLog("특기 【<b><C>{$specialText}</></b>】{$josaUl} 습득");
        }
        foreach ($db->query('SELECT no,name,nation,leadership,strength,intel,npc,dex1,dex2,dex3,dex4,dex5,aux from general where specage2<=age and special2=%s', GameConst::$defaultSpecialWar) as $general) {
            $generalID = $general['no'];
            $generalAux = Json::decode($general['aux']);
            $updateVars = [];
            if (key_exists('inheritSpecificSpecialWar', $generalAux)) {
                $special2 = $generalAux['inheritSpecificSpecialWar'];
                unset($generalAux['inheritSpecificSpecialWar']);
                $updateVars['aux'] = Json::encode($generalAux);
            } else {
                $special2 = SpecialityHelper::pickSpecialWar(
                    $rng,
                    $general,
                    ($generalAux['prev_types_special2']) ?? []
                );
            }
            $specialClass = buildGeneralSpecialWarClass($special2);
            $specialText = $specialClass->getName();
            $updateVars['special2'] = $special2;
            $db->update('general', $updateVars, 'no=%i', $general['no']);
            $logger = new ActionLogger($generalID, $general['nation'], $year, $month);
            $josaUl = JosaUtil::pick($specialText, '을');
            $logger->pushGeneralActionLog("특기 【<b><L>{$specialText}</></b>】{$josaUl} 익혔습니다!", ActionLogger::PLAIN);
            $logger->pushGeneralHistoryLog("특기 【<b><C>{$specialText}</></b>】{$josaUl} 습득");
        }
    }
 }
 function turnDate($curtime)
 {
    $db = DB::db();
@@ -1410,7 +1338,7 @@ function CheckHall($no)
        ["betrate", 'calc'],
    ];
-    $generalObj = General::createGeneralObjFromDB($no, null, 2);
+    $generalObj = General::createObjFromDB($no);
    $ttw = $generalObj->getRankVar(RankColumn::ttw);
    $ttd = $generalObj->getRankVar(RankColumn::ttd);
@@ -1473,8 +1401,11 @@ function CheckHall($no)
    foreach ($types as [$typeName, $valueType]) {
-        if ($valueType === 'natural') {
+        if ($valueType === 'natural') {
-            $value = $generalObj->getVar($typeName);
+            $value = $generalObj->getVar($typeName);
            if (in_array($typeName, ['dex1', 'dex2', 'dex3', 'dex4', 'dex5'], true)) {
                $value = CentennialAllStarGrowthService::recordableValue($generalObj, $typeName);
            }
        } else if ($valueType === 'rank') {
            $value = $generalObj->getRankVar(RankColumn::from($typeName));
        } else if ($valueType === 'calc') {
@@ -1741,11 +1672,10 @@ function tryUniqueItemLottery(RandUtil $rng, General $general, string $acquireTy
        $prob = 1 / ($genCount * $itemTypeCnt * 0.7 / 3); // 투표율 70%, 설문조사 한번에 2~3개 등장
    } else if ($acquireType == '랜덤 임관') {
        $prob = 1 / ($genCount * $itemTypeCnt / 10 / 2); // 랜임시 2개(10%) 등장(200명중 20명 랜임시도?)
    } else if ($acquireType == '건국') {
        $prob = 1 / ($genCount * $itemTypeCnt / 10 / 4); // 건국시 4개(20%) 등장(200명시 20국 정도 됨)
    }
-    $prob = Util::valueFit($prob, null, 1 / 4); //최대치 감소
+    $prob *= GameConst::$uniqueTrialCoef;
    $prob = Util::valueFit($prob, null, GameConst::$maxUniqueTrialProb); //최대치 감소
    $result = false;
    $prob /= sqrt(7);
@@ -1755,6 +1685,9 @@ function tryUniqueItemLottery(RandUtil $rng, General $general, string $acquireTy
        //포인트로 랜덤 유니크 획득
        $prob = 1;
    }
    else if ($acquireType == '건국') {
        $prob = 1; // 건국시 100%
    }
    foreach (Util::range($maxCnt) as $_idx) {
        if ($rng->nextBool($prob)) {
@@ -1799,22 +1732,21 @@ function deleteNation(General $lord, bool $applyDB): array
    $logger->pushGlobalHistoryLog("<R><b>【멸망】</b></><D><b>{$nationName}</b></>{$josaUn} <R>멸망</>했습니다.");
-    $nationGeneralList = General::createGeneralObjListFromDB(
+    $nationGeneralList = General::createObjListFromDB(
        $db->queryFirstColumn(
            'SELECT `no` FROM general WHERE nation=%i AND no != %i',
            $nationID,
            $lordID
        ),
-        ['npc', 'gold', 'rice', 'experience', 'explevel', 'dedication', 'dedlevel', 'belong', 'aux'],
+        ['npc', 'owner', 'gold', 'rice', 'experience', 'explevel', 'dedication', 'dedlevel', 'belong', 'aux'],
        1
    );
    $nationGeneralList[$lordID] = $lord;
    $nation['generals'] = array_keys($nationGeneralList);
    $nation['aux'] = Json::decode($nation['aux']);
-    $nation['msg'] = $nationStor->notice;
+    $nation['msg'] = $nationStor->nationNotice['msg'] ?? '';
    $nation['scout_msg'] = $nationStor->scout_msg;
-    $nation['aux'] += $nationStor->max_power;
+    $nation['aux'] += $nationStor->max_power ?? [];
    $nation['history'] = getNationHistoryLogAll($nationID);
    $josaYi = JosaUtil::pick($nationName, '이');
@@ -1823,13 +1755,16 @@ function deleteNation(General $lord, bool $applyDB): array
    // 전 장수 재야로
    foreach ($nationGeneralList as $general) {
-        $general->setAuxVar(
+        if ($general->getNPCType() < 2) {
-            InheritanceKey::max_belong->value,
+            $general->setAuxVar(
-            max(
+                InheritanceKey::max_belong->value,
-                $general->getVar('belong'),
+                max(
-                $general->getAuxVar(InheritanceKey::max_belong->value) ?? 0
+                    $general->getVar('belong'),
-            )
+                    $general->getAuxVar(InheritanceKey::max_belong->value) ?? 0
-        );
+                )
            );
        }
        $general->setVar('belong', 0);
        $general->setVar('troop', 0);
        $general->setVar('officer_level', 0);
@@ -3,6 +3,7 @@ namespace sammo;
 use sammo\Command\GeneralCommand;
 use sammo\Command\NationCommand;
 use sammo\Enums\PenaltyKey;
 function getGeneralTurnBrief(General $generalObj, array $turnList) {
    $result = [];
@@ -213,7 +214,7 @@ function _setGeneralCommand(GeneralCommand $command, array $turnList):void {
    $db->update('general_turn', [
        'action'=>$commandName,
-        'arg'=>Json::encode($arg, JSON::EMPTY_ARRAY_IS_DICT),
+        'arg'=>Json::encode($arg, Json::EMPTY_ARRAY_IS_DICT),
        'brief'=>$brief
    ], 'general_id = %i AND turn_idx IN %li', $generalID, $turnList);
 }
@@ -233,7 +234,7 @@ function _setNationCommand(NationCommand $command, array $turnList):void  {
    $db->update('nation_turn', [
        'action'=>$commandName,
-        'arg'=>Json::encode($arg, JSON::EMPTY_ARRAY_IS_DICT),
+        'arg'=>Json::encode($arg, Json::EMPTY_ARRAY_IS_DICT),
        'brief'=>$brief
    ], 'nation_id = %i AND officer_level = %i AND turn_idx IN %li', $nationID, $officerLevel, $turnList);
 }
@@ -350,7 +351,7 @@ function setGeneralCommand(int $generalID, array $rawTurnList, string $command,
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
    $env = $gameStor->getAll();
-    $general = General::createGeneralObjFromDB($generalID);
+    $general = General::createObjFromDB($generalID);
    try{
        $commandObj = buildGeneralCommandClass($command, $general, $env, $arg);
@@ -425,7 +426,7 @@ function setNationCommand(int $generalID, array $turnList, string $command, ?arr
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
    $env = $gameStor->getAll();
-    $general = General::createGeneralObjFromDB($generalID);
+    $general = General::createObjFromDB($generalID);
    if($general->getVar('officer_level') < 5){
        return [
@@ -434,6 +435,13 @@ function setNationCommand(int $generalID, array $turnList, string $command, ?arr
        ];
    }
    if($general->hasPenalty(PenaltyKey::NoChiefTurnInput)){
        return [
            'result'=>false,
            'reason'=>'수뇌 턴 입력 불가능'
        ];
    }
    try{
        $commandObj = buildNationCommandClass($command, $general, $env, $general->getLastTurn(), $arg);
    }
@@ -473,6 +481,13 @@ function setNationCommand(int $generalID, array $turnList, string $command, ?arr
    }
    _setNationCommand($commandObj, $turnList);
    if($general->getNPCType() < 2){
        //유저장인 경우에는 턴 리필
        $general->updateVarWithLimit('killturn', $env['killturn'], $general->getVar('killturn'));
        $general->applyDB($db);
    }
    return [
        'result'=>true,
        'brief'=>$commandObj->getBrief(),
@@ -133,19 +133,19 @@ function getNationType(?string $type) {
 }
-function getConnect($con) {
+function getRefreshScoreText($score) {
-    if($con < 50)        $conname = '안함';
+    if($score < 50)        $scoreName = '안함';
-    elseif($con <   100) $conname = '무관심';
+    elseif($score <   100) $scoreName = '무관심';
-    elseif($con <   200) $conname = '가끔';
+    elseif($score <   200) $scoreName = '가끔';
-    elseif($con <   400) $conname = '보통';
+    elseif($score <   400) $scoreName = '보통';
-    elseif($con <   800) $conname = '자주';
+    elseif($score <   800) $scoreName = '자주';
-    elseif($con <  1600) $conname = '열심';
+    elseif($score <  1600) $scoreName = '열심';
-    elseif($con <  3200) $conname = '중독';
+    elseif($score <  3200) $scoreName = '중독';
-    elseif($con <  6400) $conname = '폐인';
+    elseif($score <  6400) $scoreName = '폐인';
-    elseif($con < 12800) $conname = '경고';
+    elseif($score < 12800) $scoreName = '경고';
-    else $conname = '헐...';
+    else $scoreName = '헐...';
-    return $conname;
+    return $scoreName;
 }
 function getNationType2(?string $type) {
@@ -256,6 +256,41 @@ function buildItemClass(?string $type):BaseItem{
    return $obj;
 }
 function getScenarioEffectClass(?string $type){
    if($type === null || $type === ''){
        $type = 'None';
    }
    static $basePath = __NAMESPACE__.'\\ActionScenarioEffect\\';
    $classPath = ($basePath.$type);
    if(class_exists($classPath)){
        return $classPath;
    }
    $classPath = ($basePath.'che_'.$type);
    if(class_exists($classPath)){
        return $classPath;
    }
    throw new \InvalidArgumentException("{$type}은 시나리오 효과 클래스가 아님");
 }
 function buildScenarioEffectClass(?string $type):iAction{
    static $cache = [];
    if($type === null){
        $type = 'None';
    }
    if(key_exists($type, $cache)){
        return $cache[$type];
    }
    $class = getScenarioEffectClass($type);
    $obj = new $class();
    $cache[$type]= $obj;
    return $obj;
 }
 function getGeneralSpecialDomesticClass(?string $type){
    if($type === null || $type === ''){
        $type = GameConst::$defaultSpecialDomestic;
@@ -326,6 +361,41 @@ function buildGeneralSpecialWarClass(?string $type):BaseSpecial{
    return $obj;
 }
 function getActionCrewTypeClass(?string $type){
    if($type === null || $type === ''){
        $type = 'None';
    }
    static $basePath = __NAMESPACE__.'\\ActionCrewType\\';
    $classPath = ($basePath.$type);
    if(class_exists($classPath)){
        return $classPath;
    }
    $classPath = ($basePath.'che_'.$type);
    if(class_exists($classPath)){
        return $classPath;
    }
    throw new \InvalidArgumentException("{$type}은 올바른 병종 효과가 아님");
 }
 function buildActionCrewTypeClass(?string $type):iAction{
    static $cache = [];
    if($type === null){
        $type = 'None';
    }
    if(key_exists($type, $cache)){
        return $cache[$type];
    }
    $class = getActionCrewTypeClass($type);
    $obj = new $class();
    $cache[$type]= $obj;
    return $obj;
 }
 function getGeneralCommandClass(?string $type){
    if($type === null || $type === ''){
        $type = '휴식';
@@ -387,6 +457,29 @@ function buildWarUnitTriggerClass(?string $type, WarUnit $unit, ?array $args = n
    return $class->newInstanceArgs(array_merge([$unit], $args));
 }
 function getStaticEventClass(string $type){
    static $basePath = __NAMESPACE__.'\\StaticEvent\\';
    $classPath = ($basePath.$type);
    if(class_exists($classPath)){
        return $classPath;
    }
    throw new \InvalidArgumentException("{$type}은 StaticEvent가 아님");
 }
 function buildStaticEventClass(?string $type):BaseStaticEvent{
    static $cache = [];
    if(key_exists($type, $cache)){
        return $cache[$type];
    }
    $class = getStaticEventClass($type);
    $obj = new $class();
    $cache[$type] = $obj;
    return $obj;
 }
 function getGeneralPoolClass(string $type){
    static $basePath = __NAMESPACE__.'\\GeneralPool\\';
    $classPath = ($basePath.$type);
@@ -542,6 +635,8 @@ function getExpLevel($experience) {
        $level = Util::toInt(sqrt($experience/10));
    }
    $level = Util::clamp($level, 0, GameConst::$maxLevel);
    return $level;
 }
@@ -591,7 +686,7 @@ function TechLimit($startYear, $year, $tech) : bool {
    $relYear = $year - $startYear;
    $relMaxTech = Util::valueFit(
-        floor($relYear / 5) + 1,
+        floor($relYear / GameConst::$techLevelIncYear) + GameConst::$initialAllowedTechLevel,
        1,
        GameConst::$maxTechLevel
    );
@@ -4,6 +4,7 @@ namespace sammo;
 use sammo\DTO\AuctionInfo;
 use sammo\Enums\AuctionType;
 use sammo\Enums\EventTarget;
 use sammo\Enums\InheritanceKey;
 use sammo\Enums\RankColumn;
@@ -184,27 +185,6 @@ function updateGeneralNumber()
    refreshNationStaticInfo();
 }
 function updateYearly()
 {
    //통계
    checkStatistic();
 }
 //관직 변경 해제
 function updateQuaterly()
 {
    $db = DB::db();
    //천도 제한 해제, 관직 변경 제한 해제
    $db->update('nation', [
        'chief_set' => 0,
    ], true);
    //관직 변경 제한 해제
    $db->update('city', [
        'officer_set' => 0,
    ], true);
 }
 // 벌점 감소와 건국제한-1 전턴제한-1 외교제한-1, 1달마다 실행, 병사 있는 장수의 군량 감소, 수입비율 조정
 function preUpdateMonthly()
 {
@@ -220,62 +200,12 @@ function preUpdateMonthly()
    $admin = $gameStor->getValues(['startyear', 'year', 'month']);
    $logger = new ActionLogger(0, 0, $admin['year'], $admin['month']);
    //보급선 체크
    checkSupply();
    //미보급도시 10% 감소
    $db->update('city', [
        'pop' => $db->sqleval('pop * 0.9'),
        'trust' => $db->sqleval('trust * 0.9'),
        'agri' => $db->sqleval('agri * 0.9'),
        'comm' => $db->sqleval('comm * 0.9'),
        'secu' => $db->sqleval('secu * 0.9'),
        'def' => $db->sqleval('def * 0.9'),
        'wall' => $db->sqleval('wall * 0.9'),
    ], 'supply = 0');
    //미보급도시 장수 병 훈 사 5%감소
    //NOTE: update inner join도 가능하지만, meekrodb 기준으로 깔끔하게.
    $unsuppliedCities = $db->query('SELECT city, nation, trust, name FROM city WHERE supply = 0');
    foreach (Util::arrayGroupBy($unsuppliedCities, 'nation') as $nationID => $cityList) {
        $cityIDList = Util::squeezeFromArray($cityList, 'city');
        $db->update('general', [
            'crew' => $db->sqleval('crew*0.95'),
            'atmos' => $db->sqleval('atmos*0.95'),
            'train' => $db->sqleval('train*0.95'),
        ], 'city IN %li AND nation = %i', $cityIDList, $nationID);
    }
    //민심30이하 공백지 처리
    $lostCities = [];
    foreach ($unsuppliedCities as $unsuppliedCity) {
        if ($unsuppliedCity['trust'] >= 30) {
            continue;
        }
        $lostCities[$unsuppliedCity['city']] = $unsuppliedCity;
    }
    if ($lostCities) {
        foreach ($lostCities as $lostCity) {
            $josaYi = JosaUtil::pick($lostCity['name'], '이');
            $logger->pushGlobalHistoryLog("<R><b>【고립】</b></><G><b>{$lostCity['name']}</b></>{$josaYi} 보급이 끊겨 <R>미지배</> 도시가 되었습니다.");
        }
        $db->update('general', [
            'officer_level' => 1,
            'officer_city' => 0
        ], 'officer_city IN %li', array_keys($lostCities));
        $db->update('city', [
            'nation' => 0,
            'officer_set' => 0,
            'conflict' => '{}',
            'term' => 0,
            'front' => 0
        ], 'city IN %li', array_keys($lostCities));
    }
    //접률감소, 건국제한-1
    $db->update('general_access_log', [
        'refresh_score_total' => $db->sqleval('floor(refresh_score_total*0.99)'),
    ], true);
    $db->update('general', [
        'connect' => $db->sqleval('floor(connect*0.99)'),
        'makelimit' => $db->sqleval('greatest(0, makelimit - 1)'),
    ], true);
    //전략제한-1, 외교제한-1, 세율동기화
@@ -285,18 +215,10 @@ function preUpdateMonthly()
        'rate_tmp' => $db->sqleval('rate')
    ], true);
    //도시훈사 180년 60, 220년 87, 240년 100
    $rate = Util::round(($admin['year'] - $admin['startyear']) / 1.5) + 60;
    if ($rate > 100) $rate = 100;
    // 20 ~ 140원
    $develcost = ($admin['year'] - $admin['startyear'] + 10) * 2;
    $gameStor->city_rate = $rate;
    $gameStor->develcost = $develcost;
    //매달 사망자 수입 결산
    processWarIncome();
    //계략, 전쟁표시 해제
    $db->update('city', [
        'state' => $db->sqleval(<<<EOD
@@ -381,7 +303,6 @@ function postUpdateMonthly(RandUtil $rng)
                WHERE g.nation = A.nation)
        +(select round(sum(dex1+dex2+dex3+dex4+dex5)/1000) from general where nation=A.nation)
        +(select round(sum(experience+dedication)/100) from general where nation=A.nation)
        +(select round(avg(connect)) from general where nation=A.nation)
    )/10)
    as power,
    (select sum(crew) from general where nation=A.nation) as totalCrew
@@ -451,7 +372,7 @@ function postUpdateMonthly(RandUtil $rng)
            continue;
        }
-        //양측 기간 모두 0이 되는 상황이면 휴전
+        //양측 기간 모두 0이 되는 상황이면 종전
        $nation1 = getNationStaticInfo($me);
        $name1 = $nation1['name'];
        $nation2 = getNationStaticInfo($you);
@@ -460,7 +381,7 @@ function postUpdateMonthly(RandUtil $rng)
        $josaWa = JosaUtil::pick($name1, '와');
        $josaYi = JosaUtil::pick($name2, '이');
-        $globalLogger->pushGlobalHistoryLog("<R><b>【휴전】</b></><D><b>$name1</b></>{$josaWa} <D><b>$name2</b></>{$josaYi} <S>휴전</>합니다.");
+        $globalLogger->pushGlobalHistoryLog("<R><b>【종전】</b></><D><b>$name1</b></>{$josaWa} <D><b>$name2</b></>{$josaYi} <S>종전</>합니다.");
        $db->update('diplomacy', [
            'state' => 2,
            'term' => 0,
@@ -503,8 +424,6 @@ function postUpdateMonthly(RandUtil $rng)
    if ($admin['year'] >= $admin['startyear'] + 2) {
        checkWander($rng);
    }
    // 작위 업데이트
    updateNationState();
    updateGeneralNumber();
    refreshNationStaticInfo();
    // 천통여부 검사
@@ -528,11 +447,11 @@ function checkWander(RandUtil $rng)
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
-    $admin = $gameStor->getValues(['year', 'month']);
+    $admin = $gameStor->getValues(['year', 'month', 'init_year', 'init_month']);
    $wanderers = $db->queryFirstColumn('SELECT general.`no` FROM general LEFT JOIN nation ON general.nation = nation.nation WHERE nation.`level` = 0 AND general.`officer_level` = 12');
-    foreach (General::createGeneralObjListFromDB($wanderers) as $wanderer) {
+    foreach (General::createObjListFromDB($wanderers) as $wanderer) {
        $wanderCmd = buildGeneralCommandClass('che_해산', $wanderer, $admin);
        if ($wanderCmd->hasFullConditionMet()) {
            $logger = $wanderer->getLogger();
@@ -547,248 +466,6 @@ function checkWander(RandUtil $rng)
    }
 }
 function updateNationState()
 {
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
    $history = array();
    $admin = $gameStor->getValues(['killturn', 'year', 'month', 'fiction', 'startyear', 'show_img_level', 'turnterm', 'turntime']);
    $year = $admin['year'];
    $month = $admin['month'];
    $startYear = $admin['startyear'];
    $assemblerCnts = [];
    foreach ($db->queryAllLists('SELECT nation,count(no) FROM general WHERE npc = 5 GROUP BY nation') as [$nationID, $assemblerCnt]) {
        $assemblerCnts[$nationID] = $assemblerCnt;
    };
    foreach ($db->query('SELECT nation,name,level,tech,aux FROM nation') as $nation) {
        //TODO: level이 진관수이소중대특 체계를 벗어날 수 있음
        $nationID = $nation['nation'];
        $citycount = $db->queryFirstField('SELECT count(*) FROM city WHERE nation=%i AND level>=4', $nationID);
        if ($citycount == 0) {
            $nationlevel = 0;   // 방랑군
        } elseif ($citycount == 1) {
            $nationlevel = 1;   // 호족
        } elseif ($citycount <= 4) {
            $nationlevel = 2;   // 군벌
        } elseif ($citycount <= 7) {
            $nationlevel = 3;   // 주자사
        } elseif ($citycount <= 10) {
            $nationlevel = 4;   // 주목
        } elseif ($citycount <= 15) {
            $nationlevel = 5;   // 공
        } elseif ($citycount <= 20) {
            $nationlevel = 6;   // 왕
        } else {
            $nationlevel = 7;   // 황제
        }
        if ($nationlevel > $nation['level']) {
            $levelDiff = $nationlevel - $nation['level'];
            $oldLevel = $nation['level'];
            $nation['level'] = $nationlevel;
            $updateVals = [
                'level' => $nationlevel,
                'gold' => $db->sqleval('gold + %i', $nationlevel * 1000),
                'rice' => $db->sqleval('rice + %i', $nationlevel * 1000),
            ];
            switch ($nationlevel) {
                case 7:
                    $josaUl = JosaUtil::pick(getNationLevel($nationlevel), '을');
                    $history[] = "<C>●</>{$year}년 {$month}월:<Y><b>【작위】</b></><D><b>{$nation['name']}</b></>의 군주가 <Y>" . getNationLevel($nationlevel) . "</>{$josaUl} 자칭하였습니다.";
                    pushNationHistoryLog($nation['nation'], ["<C>●</>{$year}년 {$month}월:<D><b>{$nation['name']}</b></>의 군주가 <Y>" . getNationLevel($nationlevel) . "</>{$josaUl} 자칭"]);
                    $auxVal = Json::decode($nation['aux']);
                    $auxVal['can_국기변경'] = 1;
                    $auxVal['can_국호변경'] = 1;
                    $updateVals['aux'] = Json::encode($auxVal);
                    break;
                case 6:
                    $history[] = "<C>●</>{$year}년 {$month}월:<Y><b>【작위】</b></><D><b>{$nation['name']}</b></>의 군주가 <Y>" . getNationLevel($nationlevel) . "</>에 등극하였습니다.";
                    pushNationHistoryLog($nation['nation'], ["<C>●</>{$year}년 {$month}월:<D><b>{$nation['name']}</b></>의 군주가 <Y>" . getNationLevel($nationlevel) . "</>에 등극"]);
                    break;
                case 5:
                case 4:
                case 3:
                    $history[] = "<C>●</>{$year}년 {$month}월:<Y><b>【작위】</b></><D><b>{$nation['name']}</b></>의 군주가 <Y>" . getNationLevel($nationlevel) . "</>에 임명되었습니다.";
                    pushNationHistoryLog($nation['nation'], ["<C>●</>{$year}년 {$month}월:<D><b>{$nation['name']}</b></>의 군주가 <Y>" . getNationLevel($nationlevel) . "</>에 임명됨"]);
                    break;
                case 2:
                    $history[] = "<C>●</>{$year}년 {$month}월:<Y><b>【작위】</b></><D><b>{$nation['name']}</b></>의 군주가 독립하여 <Y>" . getNationLevel($nationlevel) . "</>로 나섰습니다.";
                    pushNationHistoryLog($nation['nation'], ["<C>●</>{$year}년 {$month}월:<D><b>{$nation['name']}</b></>의 군주가 <Y>" . getNationLevel($nationlevel) . "</>로 나서다"]);
                    break;
            }
            $db->update('nation', $updateVals, 'nation=%i', $nation['nation']);
            $turnRows = [];
            foreach (Util::range(getNationChiefLevel($nation['level']), 12) as $chiefLevel) {
                foreach (Util::range(GameConst::$maxChiefTurn) as $turnIdx) {
                    $turnRows[] = [
                        'nation_id' => $nation['nation'],
                        'officer_level' => $chiefLevel,
                        'turn_idx' => $turnIdx,
                        'action' => '휴식',
                        'arg' => null,
                        'brief' => '휴식'
                    ];
                }
            }
            $db->insertIgnore('nation_turn', $turnRows);
            if ($levelDiff) {
                //유니크 아이템 하나 돌리자
                $targetKillTurn = $admin['killturn'];
                $targetKillTurn -= 24 * 60 / $admin['turnterm'];
                $nationGenIDList = $db->queryFirstColumn(
                    'SELECT no FROM general WHERE nation = %i AND killturn >= %i AND npc < 2',
                    $nation['nation'],
                    $targetKillTurn
                );
                $nationGenList = General::createGeneralObjListFromDB($nationGenIDList, ['belong', 'npc', 'aux'], 2);
                $chiefID = null;
                $uniqueLotteryWeightList = [];
                $relYear = $year - $startYear;
                $maxTrialCountByYear = 1;
                foreach (GameConst::$maxUniqueItemLimit as $tmpVals) {
                    [$targetYear, $targetTrialCnt] = $tmpVals;
                    if ($relYear < $targetYear) {
                        break;
                    }
                    $maxTrialCountByYear = $targetTrialCnt;
                }
                foreach ($nationGenList as $nationGen) {
                    if ($nationGen->getVar('officer_level') == 12) {
                        $chiefID = $nationGen->getID();
                    }
                    $trialCnt = min($maxTrialCountByYear, count(GameConst::$allItems));
                    foreach ($nationGen->getItems() as $item) {
                        if (!$item->isBuyable()) {
                            $trialCnt -= 1;
                        }
                    }
                    if ($trialCnt <= 0) {
                        continue;
                    }
                    $score = $nationGen->getVar('belong') + 10;
                    if ($nationGen->getVar('officer_level') == 12) {
                        $score += 60;
                    } else if ($nationGen->getVar('officer_level') == 11) {
                        $score += 30;
                    } else if ($nationGen->getVar('officer_level') > 4) {
                        $score += 15;
                    }
                    $score *= 2 ** $trialCnt;
                    $uniqueLotteryWeightList[$nationGen->getID()] = [$nationGen, $score];
                }
                $nationLevelUpRNG = new RandUtil(new LiteHashDRBG(Util::simpleSerialize(
                    UniqueConst::$hiddenSeed,
                    'nationLevelUp',
                    $year,
                    $month,
                    $nationID
                )));
                foreach (Util::range($levelDiff) as $idx) {
                    if (!$uniqueLotteryWeightList) {
                        break;
                    }
                    /** @var General */
                    $winnerObj = $nationLevelUpRNG->choiceUsingWeightPair($uniqueLotteryWeightList);
                    unset($uniqueLotteryWeightList[$winnerObj->getID()]);
                    $givenUniqueRNG = new RandUtil(new LiteHashDRBG(Util::simpleSerialize(
                        UniqueConst::$hiddenSeed,
                        'givenUnique',
                        $year,
                        $month,
                        $nationID,
                        $winnerObj->getID(),
                    )));
                    giveRandomUniqueItem($givenUniqueRNG, $winnerObj, '작위보상');
                    $winnerObj->applyDB($db);
                }
                if ($chiefID) {
                    $chiefObj = General::createGeneralObjFromDB($chiefID, ['belong', 'npc', 'aux'], 2);
                    $chiefObj->increaseInheritancePoint(InheritanceKey::unifier, 250 * $levelDiff);
                    $chiefObj->applyDB($db);
                }
            }
        }
        $assemblerCnt = $assemblerCnts[$nation['nation']] ?? 0;
        $maxAssemblerCnt = [
            1 => 0,
            2 => 1,
            3 => 3,
            4 => 4,
            5 => 6,
            6 => 7,
            7 => 9
        ][$nationlevel] ?? 0;
        if ($assemblerCnt < $maxAssemblerCnt) {
            $lastAssemblerID = $gameStor->assembler_id ?? 0;
            $troopLeaderRng = new RandUtil(new LiteHashDRBG(Util::simpleSerialize(
                UniqueConst::$hiddenSeed,
                'troopLeader',
                $year,
                $month,
                $nationID
            )));
            while ($assemblerCnt < $maxAssemblerCnt) {
                $lastAssemblerID += 1;
                $npcObj = new Scenario\GeneralBuilder(
                    $troopLeaderRng,
                    sprintf('부대장%4d', $lastAssemblerID),
                    false,
                    null,
                    $nation['nation']
                );
                $npcObj->setAffinity(999)->setStat(10, 10, 10)
                    ->setSpecialSingle('척사')->setEgo('che_은둔')
                    ->setKillturn(70)->setGoldRice(0, 0)
                    ->setNPCType(5)->fillRemainSpecAsZero($admin);
                $npcObj->build($admin);
                $npcID = $npcObj->getGeneralID();
                $db->insert('troop', [
                    'troop_leader' => $npcID,
                    'name' => $npcObj->getGeneralName(),
                    'nation' => $nation['nation'],
                ]);
                $db->update('general', [
                    'troop' => $npcID
                ], 'no=%i', $npcID);
                $cmd = buildGeneralCommandClass('che_집합', General::createGeneralObjFromDB($npcID), $admin);
                _setGeneralCommand($cmd, iterator_to_array(Util::range(GameConst::$maxTurn)));
                $assemblerCnt += 1;
                $gameStor->assembler_id = $lastAssemblerID;
            }
        }
    }
    pushGlobalHistoryLog($history, $admin['year'], $admin['month']);
 }
 function checkStatistic()
 {
    $db = DB::db();
@@ -882,7 +559,7 @@ function checkStatistic()
    $nationHist = '';
    foreach (GameConst::$availableNationType as $nationType) {
-        if (!Util::array_get($nationHists[$nationType])) {
+        if (!($nationHists[$nationType] ?? null)) {
            $nationHists[$nationType] = '-';
        }
        $nationHist .= getNationType($nationType) . "({$nationHists[$nationType]}), ";
@@ -1021,7 +698,7 @@ function checkEmperior()
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
-    $admin = $gameStor->getValues(['year', 'month', 'isunited', 'conlimit']);
+    $admin = $gameStor->getValues(['year', 'month', 'isunited', 'refreshLimit']);
    if ($admin['isunited'] != 0) {
        return;
    }
@@ -1066,7 +743,7 @@ function checkEmperior()
    }
    $inheritPointManager = InheritancePointManager::getInstance();
-    $allUserGenerals = General::createGeneralObjListFromDB($db->queryFirstColumn('SELECT `no` FROM general WHERE npc < 2'));
+    $allUserGenerals = General::createObjListFromDB($db->queryFirstColumn('SELECT `no` FROM general WHERE npc < 2'));
    foreach ($allUserGenerals as $genObj) {
        if ($genObj->getNationID() == $nationID) {
            if ($genObj->getVar('officer_level') > 4) {
@@ -1074,15 +751,16 @@ function checkEmperior()
            };
        }
    }
-    processSumInheritPointRank();
+
    TurnExecutionHelper::runEventHandler($db, $gameStor, EventTarget::United);
    foreach ($allUserGenerals as $genObj) {
-        $inheritPointManager->mergeTotalInheritancePoint($genObj, true);
+        $inheritPointManager->mergeTotalInheritancePoint($genObj);
        $inheritPointManager->applyInheritanceUser($genObj->getVar('owner'));
        $inheritPointManager->clearInheritancePoint($genObj);
    }
    $gameStor->isunited = 2;
-    $gameStor->conlimit = $gameStor->conlimit * 100;
+    $gameStor->refreshLimit = $gameStor->refreshLimit * 100;
    foreach ($db->queryFirstColumn('SELECT no FROM general WHERE npc<2 AND age>=%i', GameConst::$minPushHallAge) as $hallGeneralNo) {
        CheckHall($hallGeneralNo);
@@ -1094,7 +772,7 @@ function checkEmperior()
    $chiefs = Util::convertArrayToDict(
        $db->query(
-            'SELECT no,name,picture,belong,officer_level FROM general WHERE nation=%i AND officer_level >= 5',
+            'SELECT no,npc,name,picture,belong,officer_level FROM general WHERE nation=%i AND officer_level >= 5',
            $nationID
        ),
        'officer_level'
@@ -1147,9 +825,9 @@ function checkEmperior()
    $nation = $nation;
    $nation['generals'] = $db->queryFirstColumn('SELECT `no` FROM general WHERE nation=%i', $nation['nation']);
    $nation['aux'] = Json::decode($nation['aux']);
-    $nation['msg'] = $nationStor->notice;
+    $nation['msg'] = $nationStor->nationNotice['msg'] ?? '';;
    $nation['scout_msg'] = $nationStor->scout_msg;
-    $nation['aux'] += $nationStor->max_power;
+    $nation['aux'] += $nationStor->max_power ?? [];
    $nation['history'] = getNationHistoryLogAll($nation['nation']);
    storeOldGenerals(0, $admin['year'], $admin['month']);
@@ -1221,16 +899,44 @@ function checkEmperior()
        'tiger' => $tigerstr,
        'eagle' => $eaglestr,
        'gen' => $gen,
-        'history' => JSON::encode($nationHistory),
+        'history' => Json::encode($nationHistory),
        'aux' => $statGeneral['aux']
    ]);
    $hiddenSeed = UniqueConst::$hiddenSeed;
-    $history = ["<C>●</>{$admin['year']}년 {$admin['month']}월:<Y><b>【통일】</b></><D><b>{$nation['name']}</b></>{$josaYi} 전토를 통일하였습니다. <span class='hidden_but_copyable'>(서버시드: $hiddenSeed})</span>"];
+    $history = ["<C>●</>{$admin['year']}년 {$admin['month']}월:<Y><b>【통일】</b></><D><b>{$nation['name']}</b></>{$josaYi} 전토를 통일하였습니다. <span class='hidden_but_copyable'>(서버시드: {$hiddenSeed})</span>"];
    pushGlobalHistoryLog($history, $admin['year'], $admin['month']);
    //연감 월결산
    LogHistory();
    $availableInvaderGame = false;
    foreach(CityConst::all() as $city){
        if($city->level == 4){
            $availableInvaderGame = true;
            break;
        }
    }
    if($availableInvaderGame){
        $invaderMsgCnt = 2;
        foreach(range(12, 5, -1) as $chiefLevel){
            if(!key_exists($chiefLevel, $chiefs)){
                continue;
            }
            $targetChief = $chiefs[$chiefLevel];
            if($targetChief['npc'] >= 2){
                continue;
            }
            $invaderMsgs = RaiseInvaderMessage::buildRaiseInvaderMessage($targetChief['no']);
            foreach($invaderMsgs as $invaderMsg){
                $invaderMsg->send();
            }
            $invaderMsgCnt--;
            if($invaderMsgCnt <= 0){
                break;
            }
        }
    }
 }
 function updateMaxDomesticCritical(General $general, $score)
@@ -1245,8 +951,19 @@ function updateMaxDomesticCritical(General $general, $score)
    }
 }
-function genGenericUniqueRNG(int $year, int $month, int $generalID): RandUtil
+function genGenericUniqueRNG(int $year, int $month, int $generalID, ?string $reason = null): RandUtil
 {
    if($reason){
        return new RandUtil(new LiteHashDRBG(Util::simpleSerialize(
            UniqueConst::$hiddenSeed,
            'unique',
            $year,
            $month,
            $generalID,
            $reason
        )));
    }
    return new RandUtil(new LiteHashDRBG(Util::simpleSerialize(
        UniqueConst::$hiddenSeed,
        'unique',
@@ -1256,7 +973,7 @@ function genGenericUniqueRNG(int $year, int $month, int $generalID): RandUtil
    )));
 }
-function genGenericUniqueRNGFromGeneral(General $general): RandUtil
+function genGenericUniqueRNGFromGeneral(General $general, string $reason): RandUtil
 {
    $logger = $general->getLogger();
    if (!$logger) {
@@ -1265,5 +982,5 @@ function genGenericUniqueRNGFromGeneral(General $general): RandUtil
    $year = $logger->getYear();
    $month = $logger->getMonth();
    $generalID = $general->getID();
-    return genGenericUniqueRNG($year, $month, $generalID);
+    return genGenericUniqueRNG($year, $month, $generalID, $reason);
 }
@@ -12,6 +12,7 @@ function printLimitMsg($turntime)
    <head>
        <title>접속제한</title>
        <meta charset="UTF-8">
        <meta name="color-scheme" content="dark">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=1024" />
        <?= WebUtil::printCSS('../d_shared/common.css') ?>
@@ -118,6 +119,11 @@ function backButton()
    return "<button type='button' class='btn btn-primary back_btn' onclick=location.replace('./')>돌아가기</button><br>";
 }
 function gatewayButton()
 {
    return "<button type='button' class='btn btn-primary back_btn' onclick=location.replace('../')>돌아가기</button><br>";
 }
 function CoreBackButton()
 {
    return "<button type='button' class='btn btn-primary back_btn' onclick=location.replace('v_chiefCenter.php')>돌아가기</button><br>";
@@ -132,7 +138,7 @@ function JSCitiesBasedOnDistance(int $cityNo, int $maxDistance = 1): array{
    $distanceList = searchDistance($cityNo, $maxDistance, true);
    $result = [];
    for ($dist = 1; $dist <= $maxDistance; $dist++) {
-        $result[$dist] = Util::array_get($distanceList[$dist], []);
+        $result[$dist] = $distanceList[$dist] ?? [];
    }
    return $result;
 }
@@ -146,7 +152,7 @@ function printCitiesBasedOnDistance(int $cityNo, int $maxDistance = 1): string
    for ($dist = 1; $dist <= $maxDistance; $dist++) {
        $cityList = array_map(function ($cityID) {
            return CityConst::byID($cityID)->name;
-        }, Util::array_get($distanceList[$dist], []));
+        }, $distanceList[$dist] ?? []);
        $cityStr = join(', ', $cityList);
@@ -25,6 +25,7 @@ function requireAdminPermissionHTML()
    <head>
        <title>관리메뉴</title>
        <meta charset="UTF-8">
        <meta name="color-scheme" content="dark">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=1024" />
        <?= WebUtil::printCSS('../d_shared/common.css') ?>
@@ -147,63 +148,6 @@ function allButton(bool $seizeNPCMode, array $opts = [])
    ], $opts));
 }
 function commandButton(array $opts = [])
 {
    $session = Session::getInstance();
    $userID = Session::getUserID();
    if (!$session->isGameLoggedIn()) {
        return '';
    }
    $db = DB::db();
    $me = $db->queryFirstRow("select no,nation,officer_level,belong,permission,penalty from general where owner=%i", $userID);
    $nation = $db->queryFirstRow("select nation,level,color,secretlimit from nation where nation=%i", $me['nation']) ?? [
        'nation' => 0,
        'level' => 0,
        'secretlimit' => 99,
        'color' => '#000000'
    ];
    $bgColor = $nation['color'] ?? '#000000';
    $fgColor = newColor($bgColor);
    $templates = new \League\Plates\Engine(__DIR__ . '/templates');
    $showSecret = false;
    $permission = checkSecretPermission($me);
    $btnClassForTournament = $opts['btnClass'];
    if ($opts['isTournamentApplicationOpen']) {
        if ($btnClassForTournament != 'dropdown-item') {
            $btnClassForTournament = 'toolbarButton2';
        }
    }
    $btnClassForBetting = $opts['btnClass'];
    if ($opts['isBettingActive']) {
        if ($btnClassForTournament != 'dropdown-item') {
            $btnClassForBetting = 'toolbarButton2';
        }
    }
    if ($permission >= 1) {
        $showSecret = true;
    } else if ($me['officer_level'] == 0) {
        $showSecret = false;
    }
    return $templates->render('commandButton', array_merge([
        'bgColor' => $bgColor,
        'fgColor' => $fgColor,
        'meLevel' => $me['officer_level'],
        'nationLevel' => $nation['level'],
        'showSecret' => $showSecret,
        'permission' => $permission,
        'btnClassForTournament' => $btnClassForTournament,
        'btnClassForBetting' => $btnClassForBetting,
    ], $opts));
 }
 function formatWounded(int $value, int $wound): string
 {
    if ($wound == 0) {
@@ -4,173 +4,32 @@ namespace sammo;
 use sammo\Enums\InheritanceKey;
 use sammo\Enums\RankColumn;
 use Ds\Map;
 use sammo\Enums\ResourceType;
 use sammo\Event\Action;
 /**
 * 시간 단위로 일어나는 이벤트들에 대한 함수 모음
 */
-
+/** @deprecated */
 function processSumInheritPointRank(){
    $db = DB::db();
    $generals = General::createGeneralObjListFromDB(null, null, 2);
    $points = new Map();
    $points->allocate(count($generals));
    foreach($generals as $general){
        $generalID = $general->getID();
        $points[$generalID] = 0;
    }
    foreach(InheritanceKey::cases() as $key){
        if($key === InheritanceKey::previous){
            continue;
        }
        $subPoints = InheritancePointManager::getInstance()->getInheritancePointFromAll($generals, $key);
        foreach($generals as $general){
            $generalID = $general->getID();
            $points[$generalID] += $subPoints[$generalID] ?? 0;
        }
    }
    $pointsPairs = [];
    foreach($points as $generalID => $point){
        $pointsPairs[] = [
            'nation_id' => $generals[$generalID]->getNationID(),
            'general_id' => $generalID,
            'type' => RankColumn::inherit_point_earned_by_merge->value,
            'value' => $point,
        ];
    }
    //XXX: multiple batch update가 제공되지 않으므로..
    $db->delete('rank_data', '`type` = %s', RankColumn::inherit_point_earned_by_merge->value);
    $db->insert('rank_data', $pointsPairs);
    $db->query(
        'UPDATE `rank_data` D SET `value` = (SELECT SUM(`value`) FROM `rank_data` S WHERE S.general_id = D.general_id AND S.`type` IN %ls) WHERE D.`type` = %s',
        [RankColumn::inherit_point_earned_by_action->value, RankColumn::inherit_point_earned_by_merge->value],
        RankColumn::inherit_point_earned->value
    );
    $db->query(
        'UPDATE `rank_data` D SET `value` = (SELECT `value` FROM `rank_data` S WHERE S.general_id = D.general_id AND S.`type` = %s) WHERE D.`type` = %s',
        RankColumn::inherit_point_spent_dynamic->value,
        RankColumn::inherit_point_spent->value
    );
 }
 //1월마다 실행
 function processSpring() {
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
-    // 1월엔 무조건 내정 1% 감소
+    $e_env = $gameStor->getValues(['startyear', 'year', 'month']);
-    $db->update('city',[
+    $e_env['currentEventID'] = 0;
-        'dead'=>0,
+    Action::build(["ProcessIncome", ResourceType::rice->value])->run($e_env);
        'agri'=>$db->sqleval('agri * 0.99'),
        'comm'=>$db->sqleval('comm * 0.99'),
        'secu'=>$db->sqleval('secu * 0.99'),
        'def'=>$db->sqleval('def * 0.99'),
        'wall'=>$db->sqleval('wall * 0.99'),
    ],true);
    //인구 증가
    popIncrease();
    // > 10000 유지비 3%, > 1000 유지비 1%
    // 유지비 1%
    $db->update('general', [
        'gold'=>$db->sqleval('IF(gold > 10000, gold * 0.97, gold * 0.99)')
    ], 'gold > 1000');
    // > 100000 유지비 5%, > 100000 유지비 3%, > 1000 유지비 1%
    $db->update('nation', [
        'gold'=>$db->sqleval('IF(gold > 100000, gold * 0.95, IF(gold > 10000, gold * 0.97, gold * 0.99))')
    ], 'gold > 1000');
    $admin = $gameStor->getValues(['year', 'month']);
    pushGlobalHistoryLog(["<R>★</>{$admin['year']}년 {$admin['month']}월: <S>모두들 즐거운 게임 하고 계신가요? ^^ <Y>매너 있는 플레이</> 부탁드리고, <M>지나친 훼접</>은 삼가주세요~</>"], $admin['year'], $admin['month']);
 }
 /** @deprecated */
 function processGoldIncome() {
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
-    [$year, $month] = $gameStor->getValuesAsArray(['year', 'month']);
+    $e_env = $gameStor->getValues(['startyear', 'year', 'month']);
-    $adminLog = [];
+    $e_env['currentEventID'] = 0;
-
+    Action::build(["ProcessIncome", ResourceType::gold->value])->run($e_env);
    $nationList = $db->query('SELECT name,nation,capital,gold,level,rate_tmp,bill,type from nation');
    $cityListByNation = Util::arrayGroupBy($db->query('SELECT * FROM city'), 'nation');
    $generalRawListByNation = Util::arrayGroupBy($db->query('SELECT no,name,nation,gold,officer_level,dedication,city FROM general WHERE npc != 5'), 'nation');
    //국가별 처리
    foreach($nationList as $nation) {
        $nationID = $nation['nation'];
        $generalRawList = $generalRawListByNation[$nationID];
        $income = getGoldIncome($nationID, $nation['level'], $nation['rate_tmp'], $nation['capital'], $nation['type'], $cityListByNation[$nationID]??[]);
        $originoutcome = getOutcome(100, $generalRawList);
        $outcome= Util::round($nation['bill'] / 100 * $originoutcome);
        // 실제 지급량 계산
        $nation['gold'] += $income;
        // 기본량도 안될경우
        if($nation['gold'] < GameConst::$basegold) {
            $realoutcome = 0;
            // 실지급률
            $ratio = 0;
        //기본량은 넘지만 요구량이 안될경우
        } elseif($nation['gold'] - GameConst::$basegold < $outcome) {
            $realoutcome = $nation['gold'] - GameConst::$basegold;
            $nation['gold'] = GameConst::$basegold;
            // 실지급률
            $ratio = $realoutcome / $originoutcome;
        } else {
            $realoutcome = $outcome;
            $nation['gold'] -= $realoutcome;
            // 실지급률
            $ratio = $realoutcome / $originoutcome;
        }
        $nation['gold'] = Util::valueFit($nation['gold'], GameConst::$basegold);
        $adminLog[] = StringUtil::padStringAlignRight((string)$nation['name'],12," ")
            ." // 세금 : ".StringUtil::padStringAlignRight((string)$income,6," ")
            ." // 세출 : ".StringUtil::padStringAlignRight((string)$originoutcome,6," ")
            ." // 실제 : ".tab2((string)$realoutcome,6," ")
            ." // 지급률 : ".tab2((string)round($ratio*100,2),5," ")
            ." % // 결과금 : ".tab2((string)$nation['gold'],6," ");
        $incomeText = number_format($income);
        $incomeLog = "이번 수입은 금 <C>$incomeText</>입니다.";
        $nationStor = KVStorage::getStorage($db, $nationID, 'nation_env');
        $nationStor->prev_income_gold = $income;
        $db->update('nation', [
            'gold'=>$nation['gold']
        ], 'nation=%i', $nationID);
        // 각 장수들에게 지급
        foreach ($generalRawList as $rawGeneral) {
            $generalObj = new General($rawGeneral, null, null, null, $year, $month, false);
            $gold = Util::round(getBill($generalObj->getVar('dedication'))*$ratio);
            $generalObj->increaseVar('gold', $gold);
            $logger = $generalObj->getLogger();
            if($generalObj->getVar('officer_level') > 4){
                $logger->pushGeneralActionLog($incomeLog, $logger::PLAIN);
            }
            $goldText = number_format($gold);
            $logger->pushGeneralActionLog("봉급으로 금 <C>$goldText</>을 받았습니다.", $logger::PLAIN);
            $generalObj->applyDB($db);
        }
    }
    $logger = new ActionLogger(0, 0, $year, $month);
    $logger->pushGlobalHistoryLog('<W><b>【지급】</b></>봄이 되어 봉록에 따라 자금이 지급됩니다.');
    $logger->flush();
    pushAdminLog($adminLog);
 }
 function popIncrease() {
@@ -304,29 +163,6 @@ function getGoldIncome(int $nationID, int $nationLevel, float $taxRate, int $cap
    return $cityIncome;
 }
 function processWarIncome() {
    $db = DB::db();
    $cityListByNation = Util::arrayGroupBy($db->query('SELECT * FROM city'), 'nation');
    foreach(getAllNationStaticInfo() as $nation){
        if($nation['level'] <= 0){
            continue;
        }
        $nationID = $nation['nation'];
        $income = getWarGoldIncome($nation['type'], $cityListByNation[$nationID]??[]);
        $db->update('nation', [
            'gold'=>$db->sqleval('gold + %i', $income)
        ], 'nation=%i', $nationID);
    }
    // 10%수입, 20%부상병
    $db->update('city', [
        'pop'=>$db->sqleval('pop + dead * %d', 0.2),
        'dead'=>0
    ], true);
 }
 function getWarGoldIncome(string $nationType, array $cityList){
    $nationTypeObj = buildNationTypeClass($nationType);
@@ -338,115 +174,14 @@ function getWarGoldIncome(string $nationType, array $cityList){
    return $cityIncome;
 }
-
+/** @deprecated */
 //7월마다 실행
 function processFall() {
    $db = DB::db();
    // 7월엔 무조건 내정 1% 감소
    $db->update('city',[
        'dead'=>0,
        'agri'=>$db->sqleval('agri * 0.99'),
        'comm'=>$db->sqleval('comm * 0.99'),
        'secu'=>$db->sqleval('secu * 0.99'),
        'def'=>$db->sqleval('def * 0.99'),
        'wall'=>$db->sqleval('wall * 0.99'),
    ],true);
    //인구 증가
    popIncrease();
    // > 10000 유지비 3%, > 1000 유지비 1%
    // 유지비 1%
    $db->update('general', [
        'rice'=>$db->sqleval('IF(rice > 10000, rice * 0.97, rice * 0.99)')
    ], 'rice > 1000');
    // > 100000 유지비 5%, > 100000 유지비 3%, > 1000 유지비 1%
    $db->update('nation', [
        'rice'=>$db->sqleval('IF(rice > 100000, rice * 0.95, IF(rice > 10000, rice * 0.97, rice * 0.99))')
    ], 'rice > 1000');
 }
 function processRiceIncome() {
    $db = DB::db();
    $gameStor = KVStorage::getStorage($db, 'game_env');
-    [$year, $month] = $gameStor->getValuesAsArray(['year', 'month']);
+    $e_env = $gameStor->getValues(['startyear', 'year', 'month']);
-    $adminLog = [];
+    $e_env['currentEventID'] = 0;
-
+    Action::build(["ProcessIncome", ResourceType::rice->value])->run($e_env);
    $nationList = $db->query('SELECT name,level,nation,capital,rice,rate_tmp,bill,type from nation');
    $cityListByNation = Util::arrayGroupBy($db->query('SELECT * FROM city'), 'nation');
    $generalRawListByNation = Util::arrayGroupBy($db->query('SELECT no,name,nation,rice,officer_level,dedication,city FROM general WHERE npc != 5'), 'nation');
    //국가별 처리
    foreach($nationList as $nation) {
        $nationID = $nation['nation'];
        $generalRawList = $generalRawListByNation[$nationID];
        $income = getRiceIncome($nation['nation'], $nation['level'], $nation['rate_tmp'], $nation['capital'], $nation['type'], $cityListByNation[$nationID]??[]);
        $income += getWallIncome($nation['nation'], $nation['level'], $nation['rate_tmp'], $nation['capital'], $nation['type'], $cityListByNation[$nationID]??[]);
        $originoutcome = getOutcome(100, $generalRawList);
        $outcome= Util::round($nation['bill'] / 100 * $originoutcome);
        // 실제 지급량 계산
        $nation['rice'] += $income;
        // 기본량도 안될경우
        if($nation['rice'] < GameConst::$baserice) {
            $realoutcome = 0;
            // 실지급률
            $ratio = 0;
        //기본량은 넘지만 요구량이 안될경우
        } elseif($nation['rice'] - GameConst::$baserice < $outcome) {
            $realoutcome = $nation['rice'] - GameConst::$baserice;
            $nation['rice'] = GameConst::$baserice;
            // 실지급률
            $ratio = $realoutcome / $originoutcome;
        } else {
            $realoutcome = $outcome;
            $nation['rice'] -= $realoutcome;
            // 실지급률
            $ratio = $realoutcome / $originoutcome;
        }
        $nation['rice'] = Util::valueFit($nation['rice'], GameConst::$baserice);
        $adminLog[] = StringUtil::padStringAlignRight($nation['name'],12," ")
            ." // 세곡 : ".StringUtil::padStringAlignRight((string)$income,6," ")
            ." // 세출 : ".StringUtil::padStringAlignRight((string)$originoutcome,6," ")
            ." // 실제 : ".tab2((string)$realoutcome,6," ")
            ." // 지급률 : ".tab2((string)round($ratio*100,2),5," ")
            ." % // 결과곡 : ".tab2((string)$nation['rice'],6," ");
        $incomeText = number_format($income);
        $incomeLog = "이번 수입은 쌀 <C>$incomeText</>입니다.";
        $nationStor = KVStorage::getStorage($db, $nationID, 'nation_env');
        $nationStor->prev_income_rice = $income;
        $db->update('nation', [
            'rice'=>$nation['rice']
        ], 'nation=%i', $nationID);
        // 각 장수들에게 지급
        foreach ($generalRawList as $rawGeneral) {
            $generalObj = new General($rawGeneral, null, null, null, $year, $month, false);
            $rice = Util::round(getBill($generalObj->getVar('dedication'))*$ratio);
            $generalObj->increaseVar('rice', $rice);
            $logger = $generalObj->getLogger();
            if($generalObj->getVar('officer_level') > 4){
                $logger->pushGeneralActionLog($incomeLog, $logger::PLAIN);
            }
            $riceText = number_format($rice);
            $logger->pushGeneralActionLog("봉급으로 쌀 <C>$riceText</>을 받았습니다.", $logger::PLAIN);
            $generalObj->applyDB($db);
        }
    }
    $logger = new ActionLogger(0, 0, $year, $month);
    $logger->pushGlobalHistoryLog('<W><b>【지급】</b></>가을이 되어 봉록에 따라 군량이 지급됩니다.');
    $logger->flush();
    pushAdminLog($adminLog);
 }
 function getRiceIncome(int $nationID, int $nationLevel, float $taxRate, int $capitalID, string $nationType, ?array $cityList) {
@@ -629,7 +364,14 @@ function disaster(RandUtil $rng) {
    $logger->flush();
    if (!$isGood) {
-        $generalListByCity = Util::arrayGroupBy($db->query('SELECT no, name, nation, city, officer_level, injury, leadership, strength, intel, horse, weapon, book, item, crew, crewtype, atmos, train, special, special2 FROM general WHERE city IN %li', Util::squeezeFromArray($targetCityList, 'city')), 'city');
+        [$queryColumns,,] = General::mergeQueryColumn();
        $generalListByCity = Util::arrayGroupBy(
            $db->query(
                'SELECT %l FROM general WHERE city IN %li',
                Util::formatListOfBackticks($queryColumns),
                Util::squeezeFromArray($targetCityList, 'city')
            ),
            'city');
        //NOTE: 쿼리 1번이지만 복잡하기 vs 쿼리 여러번이지만 조금 더 깔끔하기
        foreach ($targetCityList as $city) {
            $affectRatio = Util::valueFit($city['secu'] / $city['secu_max'] / 0.8, 0, 1);
@@ -648,7 +390,7 @@ function disaster(RandUtil $rng) {
            $generalList = array_map(
                function($rawGeneral) use ($city, $year, $month){
-                    return new General($rawGeneral, null, $city, null, $year, $month, false);
+                    return new General($rawGeneral, null, null, $city, null, $year, $month, false);
                },
                $generalListByCity[$city['city']]??[]
            );
--- a/Show More
+++ b/Show More