blob: a4a8e77b1127ec469201c6c55cd00ff4658c99a7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
#pragma once
#include <string>
#include <windows.h>
#include "ServerProperties.h"
struct _LoadSaveDataThreadParam;
typedef struct _LoadSaveDataThreadParam LoadSaveDataThreadParam;
namespace ServerRuntime
{
/** Tick callback used while waiting on async storage/network work */
typedef void (*WorldManagerTickProc)();
/** Optional action handler used while waiting for server actions */
typedef void (*WorldManagerHandleActionsProc)();
/**
* **World Bootstrap Status**
*
* Result type for world startup preparation, either loading an existing world or creating a new one
* ワールド起動準備の結果種別
*/
enum EWorldBootstrapStatus
{
/** Found and loaded an existing world */
eWorldBootstrap_Loaded,
/** No matching save was found, created a new world context */
eWorldBootstrap_CreatedNew,
/** Bootstrap failed and server startup should be aborted */
eWorldBootstrap_Failed
};
/**
* **World Bootstrap Result**
*
* Output payload returned by world startup preparation
* ワールド起動準備の出力データ
*/
struct WorldBootstrapResult
{
/** Bootstrap status */
EWorldBootstrapStatus status;
/** Save data used for server initialization, `NULL` when creating a new world */
LoadSaveDataThreadParam *saveData;
/** Save ID that was actually selected */
std::string resolvedSaveId;
WorldBootstrapResult()
: status(eWorldBootstrap_Failed)
, saveData(NULL)
{
}
};
/**
* **Bootstrap Target World For Server Startup**
*
* Resolves whether the target world should be loaded from an existing save or created as new
* - Applies `level-name` and `level-id` from `server.properties`
* - Loads when a matching save exists
* - Creates a new world context only when no save matches
* サーバー起動時のロードか新規作成かを確定する
*
* @param config Normalized `server.properties` values
* @param actionPad padId used by async storage APIs
* @param tickProc Tick callback run while waiting for async completion
* @return Bootstrap result including whether save data was loaded
*/
WorldBootstrapResult BootstrapWorldForServer(
const ServerPropertiesConfig &config,
int actionPad,
WorldManagerTickProc tickProc);
/**
* **Wait Until Server Action Returns To Idle**
*
* Waits until server action state reaches `Idle`
* サーバーアクションの待機処理
*
* @param actionPad padId to monitor
* @param timeoutMs Timeout in milliseconds
* @param tickProc Tick callback run inside the wait loop
* @param handleActionsProc Optional action handler callback
* @return `true` when `Idle` is reached before timeout
*/
bool WaitForWorldActionIdle(
int actionPad,
DWORD timeoutMs,
WorldManagerTickProc tickProc,
WorldManagerHandleActionsProc handleActionsProc);
}
|
