문서를 한국어로 변경

모든 MD 문서(README.md, MERGE_INSTRUCTIONS.md)를 한국어로 번역
- 기능 설명, 설치 방법, 사용 가이드 한국어화
- 기술 세부사항 및 문제 해결 섹션 한국어화
- 병합 가이드 및 롤백 방법 한국어화
This commit is contained in:
2025-10-22 15:19:43 +09:00
parent 3d9d6cc664
commit e988c90e2e
2 changed files with 216 additions and 216 deletions

View File

@ -1,19 +1,19 @@
# Merge Instructions for Existing Files
# 기존 파일 병합 가이드
This document describes the changes that need to be merged into existing WorldStalkerEditor module files.
이 문서는 기존 WorldStalkerEditor 모듈 파일에 병합해야 하는 변경사항을 설명합니다.
## Overview
## 개요
The Asset Export to JSON feature requires minimal modifications to existing files:
- **WorldStalkerEditor.h**: Add two private method declarations
- **WorldStalkerEditor.cpp**: Add include directive and implement menu registration
Asset Export to JSON 기능은 기존 파일에 대한 최소한의 수정만 필요합니다:
- **WorldStalkerEditor.h**: private 메서드 선언 2개 추가
- **WorldStalkerEditor.cpp**: include 지시문 추가 및 메뉴 등록 구현
## File: WorldStalkerEditor.h
## 파일: WorldStalkerEditor.h
### Location of Changes
Line 18-20 (after existing private member variables)
### 변경 위치
18-20 (기존 private 멤버 변수 다음)
### Changes to Add
### 추가할 변경사항
```cpp
private:
@ -21,7 +21,7 @@ private:
void AddToolbarMenuEntry(class FMenuBuilder& MenuBuilder);
```
### Complete Modified Section
### 완전한 수정 섹션
```cpp
class FWorldStalkerEditorModule : public IModuleInterface
@ -31,7 +31,7 @@ public:
virtual void ShutdownModule() override;
private:
// ADD THESE TWO LINES:
// 이 두 줄을 추가하세요:
void RegisterMenuExtensions();
void AddToolbarMenuEntry(class FMenuBuilder& MenuBuilder);
@ -41,83 +41,83 @@ private:
};
```
**Note**: The `AddToolbarMenuEntry` method is kept for backward compatibility but is not actively used.
**참고**: `AddToolbarMenuEntry` 메서드는 하위 호환성을 위해 유지되지만 실제로는 사용되지 않습니다.
---
## File: WorldStalkerEditor.cpp
## 파일: WorldStalkerEditor.cpp
### Change 1: Add Include Directive
### 변경 1: Include 지시문 추가
**Location**: Line 4 (after existing includes)
**위치**: 4줄 (기존 include 다음)
**Add this line**:
**이 줄을 추가**:
```cpp
#include "Utility/AssetExporterToJSON.h"
```
**Complete Include Section**:
**완전한 Include 섹션**:
```cpp
#include "WorldStalkerEditor.h"
#include "DataTable/DataTableNoticeListener.h"
#include "Asset/ObjectSaveEventListener.h"
#include "Utility/AssetExporterToJSON.h" // ADD THIS LINE
#include "Utility/AssetExporterToJSON.h" // 이 줄을 추가하세요
#include "ToolMenus.h"
```
### Change 2: Register Menu Extensions in StartupModule
### 변경 2: StartupModule에서 메뉴 확장 등록
**Location**: Inside `StartupModule()` method (after existing initialization)
**위치**: `StartupModule()` 메서드 내부 (기존 초기화 다음)
**Add these lines**:
**이 줄들을 추가**:
```cpp
// Register editor menu extensions
UToolMenus::RegisterStartupCallback(FSimpleMulticastDelegate::FDelegate::CreateRaw(this, &FWorldStalkerEditorModule::RegisterMenuExtensions));
```
**Complete StartupModule Method**:
**완전한 StartupModule 메서드**:
```cpp
void FWorldStalkerEditorModule::StartupModule()
{
DataTableListener = MakeShared<FDataTableNoticeListener>();
ObjectSaveEventListener = MakeShared<FObjectSaveEventListener>();
// ADD THESE TWO LINES:
// 이 두 줄을 추가하세요:
// Register editor menu extensions
UToolMenus::RegisterStartupCallback(FSimpleMulticastDelegate::FDelegate::CreateRaw(this, &FWorldStalkerEditorModule::RegisterMenuExtensions));
}
```
### Change 3: Cleanup in ShutdownModule
### 변경 3: ShutdownModule에서 정리
**Location**: Inside `ShutdownModule()` method (after existing cleanup)
**위치**: `ShutdownModule()` 메서드 내부 (기존 정리 코드 다음)
**Add these lines**:
**이 줄들을 추가**:
```cpp
// Unregister all tool menus
UToolMenus::UnRegisterStartupCallback(this);
UToolMenus::UnregisterOwner(this);
```
**Complete ShutdownModule Method**:
**완전한 ShutdownModule 메서드**:
```cpp
void FWorldStalkerEditorModule::ShutdownModule()
{
DataTableListener.Reset();
ObjectSaveEventListener.Reset();
// ADD THESE TWO LINES:
// 이 두 줄을 추가하세요:
// Unregister all tool menus
UToolMenus::UnRegisterStartupCallback(this);
UToolMenus::UnregisterOwner(this);
}
```
### Change 4: Add New Method Implementations
### 변경 4: 새 메서드 구현 추가
**Location**: After `ShutdownModule()` method (before `#undef LOCTEXT_NAMESPACE`)
**위치**: `ShutdownModule()` 메서드 다음 (`#undef LOCTEXT_NAMESPACE`)
**Add these two complete methods**:
**이 두 메서드 전체를 추가**:
```cpp
void FWorldStalkerEditorModule::RegisterMenuExtensions()
@ -148,9 +148,9 @@ void FWorldStalkerEditorModule::AddToolbarMenuEntry(FMenuBuilder& MenuBuilder)
---
## Build Configuration
## 빌드 설정
Ensure `WorldStalkerEditor.Build.cs` includes these dependencies:
`WorldStalkerEditor.Build.cs`에 다음 의존성이 포함되어 있는지 확인하세요:
```csharp
PublicDependencyModuleNames.AddRange(new string[] {
@ -169,63 +169,63 @@ PrivateDependencyModuleNames.AddRange(new string[] {
});
```
**Note**: Most of these dependencies likely already exist in your module. Only add the ones that are missing.
**참고**: 이러한 의존성의 대부분은 이미 모듈에 존재할 가능성이 높습니다. 누락된 것만 추가하세요.
---
## Summary of Changes
## 변경사항 요약
### WorldStalkerEditor.h
- **Lines Added**: 2 method declarations
- **Purpose**: Declare menu registration methods
- **추가된 줄**: 메서드 선언 2개
- **목적**: 메뉴 등록 메서드 선언
### WorldStalkerEditor.cpp
- **Lines Added**:
- 1 include directive
- 2 lines in StartupModule()
- 2 lines in ShutdownModule()
- 2 complete method implementations (~24 lines)
- **Total**: ~29 lines added
- **Purpose**: Implement Tools menu integration
- **추가된 줄**:
- include 지시문 1줄
- StartupModule()에 2줄
- ShutdownModule()에 2줄
- 메서드 구현 2개 전체 (~24줄)
- ****: ~29줄 추가
- **목적**: Tools 메뉴 통합 구현
---
## Testing After Merge
## 병합 후 테스트
1. Rebuild the WorldStalkerEditor module
2. Launch Unreal Editor
3. Navigate to `Tools → WorldStalker → Export Assets to JSON`
4. Configure settings in `Edit → Project Settings → Plugins → Asset Export to JSON`
5. Run export and verify JSON files are created in `Content/Exports/`
1. WorldStalkerEditor 모듈 리빌드
2. 언리얼 에디터 실행
3. `툴 → WorldStalker → Export Assets to JSON` 메뉴로 이동
4. `편집 → 프로젝트 설정 → 플러그인 → Asset Export to JSON`에서 설정 구성
5. 익스포트 실행 후 `Content/Exports/`에 JSON 파일이 생성되었는지 확인
---
## Rollback Instructions
## 롤백 방법
If you need to remove this feature:
이 기능을 제거해야 하는 경우:
1. Delete the four new files:
1. 새로 추가된 4개 파일 삭제:
- `AssetExportSettings.h`
- `AssetExportSettings.cpp`
- `AssetExporterToJSON.h`
- `AssetExporterToJSON.cpp`
2. Remove changes from `WorldStalkerEditor.h`:
- Delete the two method declarations
2. `WorldStalkerEditor.h`에서 변경사항 제거:
- 두 개의 메서드 선언 삭제
3. Remove changes from `WorldStalkerEditor.cpp`:
- Remove the `#include "Utility/AssetExporterToJSON.h"` line
- Remove UToolMenus registration from StartupModule()
- Remove UToolMenus cleanup from ShutdownModule()
- Delete the two method implementations
3. `WorldStalkerEditor.cpp`에서 변경사항 제거:
- `#include "Utility/AssetExporterToJSON.h"` 줄 제거
- StartupModule()에서 UToolMenus 등록 제거
- ShutdownModule()에서 UToolMenus 정리 제거
- 두 개의 메서드 구현 삭제
4. Rebuild the module
4. 모듈 리빌드
---
## Contact
## 연락처
For questions about merging these changes:
- Author: jinilkim@actionsquare.com
- Project: WorldStalker (DungeonStalkers)
- Module: WorldStalkerEditor
변경사항 병합에 대한 질문:
- 작성자: jinilkim@oneunivrs.com
- 프로젝트: WorldStalker (DungeonStalkers)
- 모듈: WorldStalkerEditor