2019년 10월 10일 개최된 아이펀팩토리 데브데이 (Dev Day) 에서 장수원 시니어 프로그래머가 발표한 아이펀 엔진으로 개발된 게임에 운영툴 (아이펀 디플로이) 를 연동해 손쉽게 운영툴을 제작하는 방법에 대한 설명입니다.

1. 2019 iFunFactory Dev Day
‘아이펀 엔진으로 MO 게임 서버 개발하기’

2. ‘아이펀 엔진으로 MO 게임 서버 개발하기’
2019 iFunFactory Dev Day
2
장수원
소프트웨어 엔지니어
아이펀 엔진 운영툴 연동하기

3. 2019 iFunFactory Dev Day
1. 목표
2. 큰 그림
3. 기초 작업
4. 구현
1. 기본 유저 정보 확인
2. 인벤토리 조회
3. 아이템 지급
5. Q & A 3

4. 목표
4

5. 2019 iFunFactory Dev Day
목표
• iFun Engine 을 이용해 간단한 웹 운영툴 기능을 실제 구현
• iFunFactory 제공 운영툴 + iFun Engine 컴포넌트를 이용한 간단한 구현
• UI, Web 작업 X
• 이전 세션을 통해 친숙한 API 그대로 사용
5

6. 2019 iFunFactory Dev Day
구현할 내용
• 기본 유저 정보 확인
• ID로 사용자 검색
• 사용자의 게임 내 기초 정보(HP, MP, 경험치, 레벨) 확인
• 로그인 여부 확인
• 인벤토리 조회
• 사용자가 소유한 아이템을 운영툴로 확인
• 아이템 지급
• 사용자에게 아이템을 운영툴로 지급
6

7. 큰 그림
7

8. 2019 iFunFactory Dev Day 8
큰 그림
운영툴
Web
서비스
iFunFactory
제공
HTTP REST API
로그 DB
(Mongo DB)
RDBMS
엔진 서버(town)
게임 구현
운영툴
구현
iFun Engine
프레임워크
고객 지원
운영자 / 통계
Redis
엔진 서버
(field)

9. 2019 iFunFactory Dev Day 9
큰 그림 - 알아볼 내용
운영툴
Web
서비스
iFunFactory
제공
HTTP REST API
로그 DB
(Mongo DB)
RDBMS
엔진 서버(town)
게임 구현
운영툴
구현
iFun Engine
프레임워크
고객 지원
운영자 / 통계
Redis
엔진 서버
(field)

10. 기초 작업
10

11. 2019 iFunFactory Dev Day
구현 개요
1. 엔진 : MANIFEST 파일 수정
• 운영툴 연동 컴포넌트(DeployApiService) 활성화
2. 엔진 : 운영툴 연동 코드 추가
3. 운영톨 : 서버 URL 설정
• 운영툴이 접근할 게임 서버 URL 을 설정
11

12. 2019 iFunFactory Dev Day
• DeployApiService 컴포넌트 추가
12
엔진 : MANIFEST 파일 수정
• ApiService 컴포넌트 설정된 포트를 사용
MANIFEST.town.json
MANIFEST.town.json

13. 2019 iFunFactory Dev Day
엔진 : 운영툴 연동 코드 추가
• DeployApiService::DeployApiHandlerBase 를 상속한 클래스 생성
• 필요한 메써드를 오버라이드
• 서버 시작시 핸들러 등록 코드 추가
13

14. 2019 iFunFactory Dev Day 14
엔진 : 운영툴 연동 클래스 구현
ops_handlers.cc

15. 2019 iFunFactory Dev Day 15
엔진 : 운영툴 연동 클래스 등록
town flavor 서버가 실행될 때 클래스를 등록
devday_server.cc

16. 2019 iFunFactory Dev Day 16
엔진 : CMakeLists.txt 수정

17. 2019 iFunFactory Dev Day
운영툴 : 서버 URL 설정
• ApiService 에 설정한 port 번호를 이용해 설정
• 외부 →게임 서버 해당 port 로 접근할 수 있도록 방화벽 설정
• ‘API 연동 상태’ 기능 활용
• 연동이 잘 되고 있는지 확인 가능
17

18. 2019 iFunFactory Dev Day
운영툴 기능 구현
• API service handler 에 메써드 추가 = 운영툴 기능 추가
• iFun Engine API 와 게임 로직에서 구현했던 기능도 그대로 사용 가능
• 개발 싸이클
1. API 연동 상태 확인
2. 원하는 기능에 필요한 메써드 문서를 통해 확인
3. deploy_api_service.h 에서 메써드 원형을 복사
4. 메써드 구현
18

19. 기본 유저 정보 확인
19

20. 2019 iFunFactory Dev Day
기본 유저 정보 조회
1. 유저 검색
• 검색 방식 목록 가져오기 : GetUserSearchConditions 구현
2. 유저 검색 결과 목록 확인 - 확인할 유저 선택
• 조건에 맞는 유저 목록 검색 : SearchUsers 구현
• 유저가 소유한 캐릭터 가져오기 : GetCharacters 구현
3. 유저 정보 및 유저 캐릭터 정보 확인
• 유저 정보 가져오기 : GetUser 구현
• 캐릭터 정보 가져오기 : GetCharacter 구현
20

21. 2019 iFunFactory Dev Day 21
엔진 : 유저 검색 방식 지정

22. 2019 iFunFactory Dev Day 22
엔진 : 유저 검색 연동

23. 2019 iFunFactory Dev Day 23
엔진 : 유저 검색 연동

24. 2019 iFunFactory Dev Day 24
엔진 : 유저가 소유한 캐릭터 목록

25. 2019 iFunFactory Dev Day 25
엔진 : 유저 정보 가져오기

26. 2019 iFunFactory Dev Day 26
엔진 : 캐릭터 정보 가져오기

27. 2019 iFunFactory Dev Day 27
엔진 : 캐릭터 정보 가져오기

28. 2019 iFunFactory Dev Day
로그인 여부 판별
1. 특정 유저가 현재 로그인 중인지 표시
• IsLoggedIn 구현
28

29. 2019 iFunFactory Dev Day 29
엔진 : 유저 - 로그인 여부 판별

30. 인벤토리 조회
30

31. 2019 iFunFactory Dev Day
인벤토리 조회
1. 특정 캐릭터가 가진 인벤토리 목록 가져오기
• GetCharacterInventoryInfo 구현
• 캐릭터 소유의 인벤토리 목록을 반환
• (타입, ID) pair 의 vector (e.g. {{“bag”, “1”}, {“mailbox”, “2”}})
2. 인벤토리가 가진 아이템 목록 반환
• GetInventory 구현
• 인벤토리 타입, 인벤토리 ID → 아이템 vector
31

32. 2019 iFunFactory Dev Day 32
캐릭터 인벤토리 목록 가져오기

33. 2019 iFunFactory Dev Day 33
인벤토리 안 아이템 목록 반환

34. 아이템 지급
34

35. 2019 iFunFactory Dev Day
아이템 지급
1. 지급 가능한 아이템 목록 지정
• DeployApiService::SetGiftableItems 함수 호출
• 아이템 ID, 아이템 이름 vector 반환
2. 특정 캐릭터에게 아이템 지급
• GiveGift 구현
• 지급 방식(e.g. 우편으로 발송 등)은 선택 가능
• 가장 간단한 직접 지급으로 구현
35

36. 2019 iFunFactory Dev Day 36
지급 가능한 아이템 목록 지정

37. 2019 iFunFactory Dev Day 37
특정 캐릭터에게 아이템 지급

38. 경기도 성남시 분당구 대왕판교로 660, 유스페이스1 B동 606호
info@ifunfactory.co
m
070-4923-6566
www.ifunfactory.co
m