서버 플러그인

개요

Fusion MMO 서버 플러그인은 개발자들이 사용자 지정 Fusion 공유 모드 서버 플러그인을 생성하고, 로컬에서 테스트한 후 Photon Enterprise Cloud에 업로드하는 방법의 예시입니다.

Photon Enterprise Cloud를 생성하는 데에는 추가 비용이 발생합니다. 자세한 정보와 Fusion MMO 서버 플러그인 다운로드 권한에 대해서는 저희에게 문의하세요.

Fusion MMO 서버 플러그인이 다루는 기능:

• 플러그인에서 네트워크 오브젝트의 생성/소멸 처리.
• 히트 처리, 피해 이력 추적 및 제한.
• 토네이도의 플러그인 권한 행동 – 이동 및 피해 입히기.
• RPC 처리 및 가로채기.
• 허용 오차 기반 속도 검증.
• 유니티와 플러그인 간의 데이터 구조 공유.

로컬 Photon 서버 테스트는 Windows에서만 지원됩니다.

다운로드

설치

1. (Windows 전용) 압축을 풀기 전에 right-click > Properties > Unblock을 통해 Fusion-MMO-Server-Plugin-2.0.0.zip 파일의 차단을 해제하세요.
2. 압축 파일을 Unity 프로젝트 내의 Fusion.Plugin 폴더에 풀어주세요.

MMO
├─Assets
├─Library
├─..
└─Fusion.Plugin
    

3. Photon 관리 화면에서 Photon 서버 라이선스를 다운로드한 후, 이를 Fusion.Plugin\Photon.Server\deploy_win\bin 폴더에 복사하세요.

서버 플러그인 실행하기

1. Fusion MMO 유니티 프로젝트를 엽니다.
2. Assets\Photon\Fusion\Resources\PhotonAppSettings.asset를 선택하고 Server 값을 127.0.0.1로 설정합니다.
3. Assets\Photon\Fusion\Editor\FusionPluginProjectSettings.asset를 선택한 후 Export Code와 Export Prefabs & Scenes 버튼을 모두 클릭합니다.
4. Visual Studio 또는 Rider에서 Fusion.Plugin\Fusion.Plugin.Custom.sln 파일을 열고 F5 키를 눌러 실행합니다 (빌드 및 실행). 만약 Catastrophic Failure 메시지가 나타난다면, 명령줄에서 서버를 실행해 보세요 (아래 지침 참조).
5. 게임 서버 로그 파일은 Fusion.Plugin\Photon.Server\deploy_win\log\GSGame.log에 위치합니다.

서버는 명령줄에서 Fusion.Plugin\Photon.Server\deploy_win\bin\PhotonServer.exe --run LoadBalancing을 실행하여 시작할 수도 있습니다.

Export Code와 Export Prefabs & Scenes 작업은 플러그인으로 내보내진 코드나 오브젝트를 변경한 후 반드시 수행해야 합니다.

플러그인 내용

Lib 폴더

Lib 폴더에는 Photon Fusion Server 플러그인을 컴파일하고 실행하는 데 필요한 모든 종속성이 포함되어 있습니다.
예를 들어, PhotonHivePlugin.dll은 일반 Photon Server 플러그인을 위한 인터페이스이며, Fusion.Plugin.dll, Fusion.Runtime.dll 및 Fusion.Realtime.dll은 Fusion 플러그인의 주요 라이브러리입니다.

Photon.Server 폴더

이 폴더에는 로컬 Photon Server가 포함되어 있습니다. bin 폴더에는 Photon.Server 실행 파일이 있고, LoadBalancing과 NameServer에는 서버 코드가, Plugins에는 서버 플러그인이 포함되어 있습니다. log 폴더에는 게임 서버 로그 파일(GSGame.log 등)이 저장됩니다.

플러그인 구성 파일인 LoadBalancing\GameServer\bin\plugin.config에는 Photon Dashboard에서 온라인 서버가 가져오는 로컬 구성 키-값 저장소가 포함되어 있습니다.

사용자 지정 플러그인 라이브러리는 Plugins\Fusion.Plugin\bin에 출력되며, 최종적으로 이 폴더가 Photon Enterprise Cloud에 업로드됩니다.

Fusion.Plugin.Custom 폴더

이 폴더에는 MMO 관련 플러그인 전용 스크립트, Unity에서 내보낸 코드 (PluginNetworkTypes.cs) 및 데이터베이스 (PluginNetworkObjectDB.Partial.cs + PluginNetworkObjectDB.json)가 포함되어 있습니다.

추가 자료

Fusion 플러그인은 Photon-Server V5를 기반으로 하며, Photon Server 문서에 설명된 워크플로우를 따릅니다. 자세한 내용은 다음 문서를 참고하세요: Photon-Server V5 단계별 가이드