RunUo.Korean.Forum :: - 요청강의::wind0204님의 요청강의 입니다.

1. 무엇을 만들것인가?

인용글 :

케릭터의 스탯에 인기도를 추가시키고 [추천을 받으면 인기도가 올라가고 [비추천을 받으면 인기도가 내려가게요. 하루에 한번 [추천 [비추천 명령을 쓸 수 있게 해주세요.

즉, 일종의 게시물에서의 추천 비추천의 개념을 도입하시려 하는것 같습니다.
사용자에게 나름대로의 포인트를 부여하여 그것을 이용하여 어떤 것을
하시려는것. 맞습니까? 뭐 사용처는 어쨋든 좋습니다. 그럼 어떻게 구현해야 할까요?

2. 구현해야 하는 기능은 무엇인가?

우선 크게 2가지 관점에서 생각을 해봅시다.

첫째, 사용자가 명령어를이용하여 다른 사용자에게 포인트를 부여한다는점.

둘째, 사용자는 하루에 한번명령어를 이용할수 있다는것.

기본적으로는 이러한 기능이 핵심적으로 필요하게 됩니다. 부수적으로 다른 여러 기능들(포인트를 보여준다던지, 포인트에 의해 어떤 행동을 한다던지) 하는 부분에 있어서는 생략하기로 하고, 결론적으로는 저 두가지 기능에 의해서 강의를 요청하신 분께서 원하시는 기능이 이루어진다 하겠습니다.

3. 어떻게 구현할 것인가?

Step #1 변수 만들기

우선 우리가 다루어야할 파일을 살펴 봅시다.
우리가 다루어야할 파일은, PlayerMobile.cs라는 파일입니다.
플레이어의 구성과 운용에 대한 코드를 담고 있으며, 상당히 기인~
코드인것을 보실수 있습니다. 우리는 여기에 우리가 원하는 기능을 추가하여
새로운 기능을 구현해낼수 있습니다.

PlayerMobile.cs(이하 모바일 코드)는 기본적으로 Mobile 클래스에서 상속을 받은 서브 클래스로, 사용자의 몸에 대한 부분만을 특화적으로 다루고 있습니다. 여기에서는 사용자에 관하여 각종 데이터를 처리하고 있는 부분으로써 우리가 원하는 기능인 '포인트'를 관리하기 위해선 별도의 변수가 필요한바, 이 코드에서 작업을 하게 되겠습니다.

코드 :

in PlayerMobile.cs class PalyerMobile()

[CommandProperty( AccessLevel.GameMaster )]
public bool PublicMyRunUO
{
get{ return GetFlag( PlayerFlag.PublicMyRunUO ); }
set{ SetFla(PlayerFlag.PublicMyRunUO,value );InvalidateMyRunUO(); }
}

위 코드를 우선 살펴 보겠습니다. 기본적으로 MyRunUO를 통해서
케릭터 자료를 접근할수 있게 하는지의 여부를 선택하는 플래그 입니다.
우선 대괄호([])로 묶여있는 부분은. Attribute라고 하는것으로써,
자세한 언어적인 설명은 생략하겠습니다.

다만 여기에서는, 게임내에서 값에 접근할수 있는 권한, 즉 [props 명령어 등을 통하여 값을 변경할수 있는 권한의 최소값을 지정하는것이라고 생각하시면 됩니다. 위의 값은 게임마스터 이상만이 접근할수 있도록 되어 있는것을 볼수 있습니다. 우리가 구현하려는 기능 역시 특성상 게임마스터 이상만이 값을 변경할수 있도록 해야하기에 동일하게 처리하겠습니다.

public bool PublicMyRunUO이 부분이 게임상에서든 코드상에서든 값을 이용할수 있는 변수명을 지정하고 있는 선언부 입니다. bool형태(참/거짓)으로 지정되 있는것을 알수 있으며 권한은 public즉, 외부 코드에서도 (playermobile 외에서도)접근할수 있도록 되어있으며 이름은 PublicMyRunUO라고 되어있습니다. 언어적인 면이기에 그리 큰 어려움은 없으실것입니다.

이 구분에서는 변수가 get-set 형태로 지정되어 있습니다. 어려운 것이 아니라, 문자 그대로 get 은 변수에서 값을 얻을 때 취할 행동들이 되는것이며, set는 변수에 값을 설정할때 취하는 행동들이 됩니다. 위 코드에서는 플레그 여부를 리턴하거나 지정하도록 했습니다. 우리는 단순히 변수를 하나 선언하여 그 변수를 이용하도록 할것입니다.

그리하여, 아래와 같은 코드가 구성된다고 할수 있습니다.
(자세한 설명은 주석 참고)

코드 :

private int m_VotebyPl; //내부에서 이용될 변수명입니다.

[CommandProperty( AccessLevel.GameMaster )]
public int VoteByPlayer
{
get
{
   return m_VotebyPl; //내부 변수를 리턴합니다.
}
set
{
   m_VotebyPl = value; //외부에서 설정한 값을 지정합니다
}
}

private DateTime m_NextVotebyPl; //하루에 한번 투표하기 위한 변수

[CommandProperty( AccessLevel.GameMaster )]
public DateTime NextVoteByPlayer
{
get
{
   return m_NextVotebyPl;
}
set
{
   m_NextVotebyPl = value;
}
}

하루에 한번 투표를 하게 해야하기 떄문에 오늘 한번 투표 했다! 라는 사실을
기록해둘 필요가 있습니다. 여기서는 사용자가 투표한후로부터 24시간 후에 다시 투표가 가능하도록 처리해보겠습니다.

Step #2 변수 저장하기(Serialize / DeSerialize)

변수를 만들었다면, 그 변수를 계속 이용하기 위해선 데이터 파일에 저장을
해야합니다. 만약 서버를 다시 킬때마다 데이터가 사라진다면, 이는 무의미한것이겠죠. 그러하기 위해서 데이터를 저장해야하는데, 여기서 저장을 위한 Serialize와 불러오기를 위한 DeSerialize에 대하여 알아보겠습니다.

Serialize

PlayerMobile.cs 파일을 보시면 아래와 같은 부분이 있을껏입니다.

코드 :

public override void Serialize( GenericWriter writer )

바로 위의 부분이 저장을 담당하는 부분! 여러부분이 있습니다만, 우리가 주목해야할 부분은 아래 부분부터입니다.

코드 :

base.Serialize( writer );
writer.Write( (int) 18 ); // version
writer.WriteEncodedInt( (int) m_SolenFriendship );

아 먼저 참고로, 저장과 불러오기의 순서는 정확히 일치해야한다는 것입니다. 예를들어, A->B->C의 순으로 저장을 했다면 불러올떄 역시 A->B->C여야 한다는점입니다. 따라서 나중에 추가된 내용일수록 가장 먼저 저장하고 가장 먼저 불러온다고 볼수있으며, 위에서 m_SolenFriendship이라는 부분이 버전 18에 추가된 가장 마지막 내용임을 추측해 볼수 있습니다.

버전이 필요한 이유는지금 우리가 시도하는 작업과 같이 새로운 내용이 추가되었을때, 과거의 내용과 비교하여 새로운 내용을 적용하기 위해서 입니다.
만약 버전이 없다면, 아까 분명 저장하는것과 불러오는 순이 똑같아야 된다고 했는데 이것에 착오가 올수 있습니다. 즉 A->B->C순으로 저장을 했는데, D라는 내용이 추가되어 D->A->B->C 순으로 불러오게 되는 사태를 막기 위함이라고 생각하시면 되겠습니다.

그럼 우리는, 버전을 하나 높여서 19로 설정하고 값을 입력하도록 하겠습니다. 기본적으로, RunUO에서는 자료를 바이너리 방식으로 저장하기 떄문에, 자료를 입력할때 Encode를 시켜야 하는데 이는 관련 c#강좌를 참고하시기 바라며 여기서는 그저 그러한가 보다 하고 이용만 하겠습니다.

코드 :

base.Serialize( writer );
writer.Write( (int) 19 ); // version

//ver 19
writer.WriteEncodedInt( (int) m_VotebyPl );
writer.Write( (DateTime) m_NextVotebyPl );
//ver 19 end

writer.WriteEncodedInt( (int) m_SolenFriendship );

자, 이제 저장하기가 끝났습니다. 불러오기를 살펴보도록 하지요.

DeSerialize

코드 :

public override void Deserialize( GenericReader reader )
{
base.Deserialize( reader );
int version = reader.ReadInt();

switch ( version )
{
case 18:

위의 코드를 찾아보실수 있습니다. 아까 말씀드렷든, 서로 다른 버전이 존재할 가능성이 있기 때문에 상위버전부터 처리하고 있습니다. 그렇다면 우리도 그렇게 해야겠지요? case 18: 윗 부분에 case 19: 를 추가하여 우리가 저장한 값을 불러오도록 해보겠습니다.

코드 :

case 19:
{
m_VotebyPl = reader.ReadEncodedInt();
m_NextVotebyPl = reader.ReadDateTime();

goto case 18;
}
case 18:

아까 우리는, m_VotebyPl->m_NextVotebyPl순으로 저장되도록 코드를 만들었고, 읽어드릴때도 역시 마찬가지로 하고있습니다. 그리하여 버전 19의 처리가 끝나는데로 버전 18로 이동, 다음 처리를 하도록 하고 있습니다. 즉 이런 방식을 통하여 하위 호환성을 유지한다고 생각하시면 되겠습니다. 이러한 번거로운 절차가 필요한 이유는 다시 강조 드리지만 반드시 저장한 순서 그대로 읽어드려야 하기 떄문입니다.(순차적인 방식이라고 생각하시면 되겠습니다.).

ReadEncodedInt(); ReadDateTime(); 두 함수는 각각, 엔코딩된 정수형 자료값을 읽어오는 함수와, 날자시간 자료를 읽어오는 함수입니다. GenericReader 클래스 내의 함수이므로, 저장한 자료값을 동일 형식으로 읽어올때 사용됩니다.

Step #3 명령어를 만들어 봅시다!

이제 사용자에게 포인트를 보관할수 있는 변수도 만들었고, 그것을 저장하고 불러드리는 부분의 처리 또한 구현하였습니다. 그렇다면 이제 사용자가 하루에 한번 명령어를 이용하여 처리할수 있게 하는 부분이 필요해집니다.

별도의 파일을 하나 만들어서 거기에서 처리해보도록 하겠습니다.
여기에서는 VoteByPlayer.cs 라는 별도의 파일에서 진행해 보겠습니다.

Step #3-1 기초 클래스 설계!

기본적으로 우리가 구현해야할 기능은 간단한 설계로써 마무리 할수 있습니다.
우선 코드에서 주석을 통해 설명해보겠습니다.

코드 :

using System; //System 네임스페이스를 포함합니다. 기본입니다.
using Server; //RunUO 네임스페이스를 포함합니다. 기본입니다.
using Server.Mobiles; //RunUO에서 NPC나 사용자 관련 부분을 포함합니다.
using Server.Targeting; // 타겟을 이용하기 위해서 포함해야 합니다.

namespace Server // 이 클래스가 Server 네임스페이스에 포함됨을 의미합니다.
{
public class VoteByPlayer
{
   public static void Initialize() //서버 부팅시 1회 호출되는 초기화 함수입니다. 여기서 명령어를 등록하면 됩니다.
   {
      // 서버에 명령어를 등록하는 함수입니다.함수의 형식은 Register(명령어,접근권한,new CommandEventHandler(처리 함수));의 형식을 따릅니다.
      Server.Commands.Register("추천",AccessLevel.Player,new CommandEventHandler( CmdVote) );
      Server.Commands.Register("비추천",AccessLevel.Player,new CommandEventHandler( CmdDeVote) );
   }

   // Usage Attribute는 명령어의 이용방법에 대한 설명을,
   // Description Attribute는 명령어에 대한 설명입니다.
   // 문서 자동화에 이용되는 부분으로 선택사항입니다.
   [Usage("추천")]
   [Description("해당 사용자를 1회 추천합니다.")]
   public static void CmdVote( CommandEventArgs e)
   {
      // 여기에서 추천에 관한 명령어를 처리합니다.
   }
[Usage("비추천")]
   [Description("해당 사용자를 1회 비추천합니다.")]
   public static void CmdDeVote( CommandEventArgs e)
   {
      // 여기에서 비추천에 관한 명령어를 처리합니다.
   }

}

클래스 구조 자체는 평범하기 그지 없는 지극히 간단한 클래스 형태입니다.

Step #3-2 본격적인 기능 구현!
타겟팅

자, 이제 드디어 본격적으로 기능을 구현할 시간입니다.
일단 우리는 여기서 '타겟'을 사용해야 함을 생각해 볼수 있습니다.
즉 자기 자신을 추천하는것이 아니기 때문에, 타겟을 이용해서 상대방을
지정해야 한다는 것입니다. 코드에서 타겟을 어떻게 이용해야 할까요?

타겟팅(타겟을 지정하도록 클라이언트에 타겟을 뛰으는것을 말함.)을 구현하기 위해서는 약간 복잡한 절차를 필요로 합니다만. 그다지 힘든건 아닙니다. 다만 클래스에 대한 기초적인 개념만 있으시다면 아무 문제 없답니다.백문이 불여일견! 코드를 통해서 볼까요?

코드 :

(in code)
public static void Cmd( CommandEventArgs e )
{
// 타겟을 호출.
e.Mobile.Target = new VoteTarget();
}

private class VoteTarget : Target
{
// Target(허용거리,땅지정여부,타겟 속성(이로운,해로운,일반)
public VoteTarget() : base(5, false, TargetFlags.None )
{
}

// 타겟 선택시 호출되는 함수로 오버라이드 하여 사용합니다.
protected override void OnTarget( Mobile from, object targ )
{
   //타겟에 대한 자료를 처리합니다.
   //from: 타겟을 지정한 사람
   //targ: 지정된 타겟. object형이므로 원하는 형태로 케스팅해 사용
}
}

내부에 Target 클래스를 상속받아서 클래스를 하나 만든후 OnTarget함수를 오버라이드 해서 타겟 처리를 하고 있습니다. 언어적 이해가 있으시다면 그리 어려운 부분이 아니며, 잘 이해가 안되신다면 c# 관련 강의를 참고하시는게 좋겠습니다.

CommandEventArgs

위에서 잠시 함수 형태를 보도록 할까요?

코드 :

public static void CmdVote( CommandEventArgs e )

함수에서 인자로 CommandEventAgrs 라는 클래스를 넘겨 받고 있습니다. 과연 어떤 클래스 일까요?

CommandEventArgs는 .net의 EventArgs 클래스의 자식 클래스로써, 명령어가 호출될때 거기에 관련된 몇가지 정보를 포함하고 있습니다. 이를 통하여 명령어를 이용한 이용자가 누구인지, 어떤 인자가 전달되고 있는지를 확인할수 있는것이죠. 구조는 다음과 같습니다.

코드 :

public string ArgString; //인자들의 문자열 배열을 하나의 문자열로 리턴합니다.
public string[] Arguments; //인자들의 문자열 배열입니다.
public string Command; //실행된 명령어를 담음입니다.
public int Length; //인자의 총 개수 입니다. 인자란 [명령어 x y z 에서 x,y,z를 말함이죠. 인자의 개수는 얼마든지 가능합니다. 따라서 총 몇개의 인자가 있는지 이 변수로 전달하는거죠
public Server.Mobile Mobile; // 명령어를 호출한 이용자

시간 관련 클래스,함수 이용

게임내에서 시간이란 참으로 중요한 문제입니다. 이번 기능 구현에서 역시 '하루에 한번'이라는 기능을 구현하기 위해선 시간 관리의 문제성이 중요시 됩니다. 다행히 c#에서는 매우 편리한 시간관리 클래스인 DateTime을 제공하는데, 이것이 편리하다 한 이유는 [B시간에 대한 사칙연산,비교[/B]가 가능하기 때문입니다.

이번 역시 예제 코드로 살펴보겠습니다.

코드 :

// 현재 시간에 하루를 더합니다. +-*/ 모두 가능합니다.
// TimeSpan 은 시간 간격을 조절합니다.
// FromDays, FromHours, FromMinutes등등.. 다양한 함수가 제공됩니다.
DateTime.Now + TimeSpan.FromDays(1);

// 저장되어 있는 시간과 현재 시간의 앞서고 뒷서고를 비교합니다.
// 즉.. 큰 쪽이 좀더 미래의 시간이라고 생각하시면 됩니다.
if ( pm.NextVoteByPlayer > DateTime.Now )

자, 이제 본격적으로 구현해 봅시다

코드의 예제를 통해 설명하도록 하겠습니다.

VoteByPlayer.cs

코드 :

using System;
using Server;
using Server.Mobiles;
using Server.Targeting; // 타겟팅을 위해서

namespace Server
{
public class VoteByPlayer
{
   public static void Initialize() //서버 부팅시 단 한번 실행. 명령어를 등록합니다.
   {
      Server.Commands.Register("추천",AccessLevel.Player,new CommandEventHandler( CmdVote) );
      Server.Commands.Register("비추천",AccessLevel.Player,new CommandEventHandler( CmdDeVote) );
   }

   [Usage("추천")]
   [Description("해당 사용자를 1회 추천합니다.")]
   public static void CmdVote( CommandEventArgs e)
   {

      Mobile m = e.Mobile; // 명령어를 실행한 이용자
      m.SendMessage("누구를 추천하시겠습니까?");
      //타겟 생성 VoteTarget(추천=true,비추천=false)
      m.Target = new VoteTarget(true);
   }

   [Usage("비추천")]
   [Description("해당 사용자를 1회 비추천합니다.")]
   public static void CmdDeVote( CommandEventArgs e)
   {
      Mobile m = e.Mobile;
      m.SendMessage("누구를 비추천하시겠습니까?");
      m.Target = new VoteTarget(false);
   }

   private class VoteTarget : Target // Target 클래스에서 상속받습니다.
   {
      bool m_Vote = true; // 추천,비추천 여부

      // Target(허용거리,땅지정여부,타겟 속성(이로운,해로운,일반)
      // 자세한건 c#관련 강좌의 클래스와 클래스의 상속부분을 참고하세요.
      public VoteTarget(bool Vote) : base(5, false, TargetFlags.None )
      {
         m_Vote = Vote;
      }

      // 타겟 선택시 호출되는 함수로 오버라이드 하여 사용합니다.
      protected override void OnTarget( Mobile from, object targ )
      {
         //타겟에 대한 자료를 처리합니다.
         //from: 타겟을 지정한 사람
         //targ: 지정된 타겟. object형이므로 원하는 형태로 케스팅해 사용

         if ( m_Vote == true) // 만약 추천이라면,
         {
            //CanVote(PlayerMobile) 시간을 비교하여 마지막 투표로부터
            //24시간이 지났는지 파악

            if ( !CanVote((PlayerMobile)from) )
            {
               from.SendMessage("24시간에 한번만 투표가능합니다!");
               return;
            }

            //(PlayerMobile)targ
            //:: object형으로 넘어온 자료를 케스팅하여 형을
            //변환 시키는것입니다. 자세한 사항은 c#관련 강좌 참고.

            PlayerMobile pm = (PlayerMobile)targ;
            pm.VoteByPlayer++;
            //{0},{1}등은 c에서의 %s %s 하는 식과 비슷합니다.
            //즉, {0},{1}은 아직 정해지지 않은 값들이며, 이것을 ,,, 로 계속
            //변수를 지정하여 나중에 실행시에는 알맞은 값들로 채워집니다.
            pm.SendMessage("당신이 추천받은 총 회수는 {0}회 입니다.",pm.VoteByPlayer);

            PlayerMobile fromp = (PlayerMobile)from;
            //지금의 시간에 24시간을 더합니다.
            fromp.NextVoteByPlayer = DateTime.Now + TimeSpan.FromDays(1);
         }
         else
         {
            if ( !CanVote((PlayerMobile)from) )
            {
               from.SendMessage("24시간에 한번만 투표가능합니다!");
               return;
            }

            PlayerMobile pm = (PlayerMobile)targ;

            //0이하로는 설정될수 없기 떄문에 그 부분에 대한 체크를
            //해주어야 합니다.
            if ( (pm.VoteByPlayer - 1 ) <= 0 )
               pm.VoteByPlayer = 0;
            else
               pm.VoteByPlayer--;

            pm.SendMessage("당신이 추천받은 총 회수는 {0}회 입니다.",pm.VoteByPlayer);

            PlayerMobile fromp = (PlayerMobile)from;
            fromp.NextVoteByPlayer = DateTime.Now + TimeSpan.FromDays(1);
         }
      }

      private bool CanVote(PlayerMobile pm)
      {
         // 저장되 있는 다음 투표가능 시간과 비교하여
         // 만약 투표 가능시간이 더 미래라면
         // 투표가 불가능하다고 리턴하는 구조입니다.
         if ( pm.NextVoteByPlayer > DateTime.Now )
         {
            return false;
         }
         else
         {
            return true;
         }
      }
   }
}
}

지금까지 나누어서 설명했던 부분을 하나로 묶었고, 또 몇가지 필요하다 싶은
설명은 주석내에 포함하였습니다.

마치며..

온라인 상에서 직접 코드를 만들고 바로 설명해 가면서 쓴 글이라 코드에 에러가 있을지도 모르겠습니다. 다만 이렇게 하는 것이다 라는 방법을 설명하기 위해서 노력했고, 명령어를 추가하는 법, 타겟을 이용하는 방법 등등에 대한 설명을 담고자 노력했으나 필력이 모자란 관계로 어떻게 잘 보셨나 모르겠습니다.

사실 RunUO에서 도입하고 있는 방식은 스크립팅(Scripting)이라고 보기에는 무리가 있다고 생각합니다. 그래서 제 글에서도 의도적으로 스크립이란 표현은 배제하였습니다. RunUO에서 사용한건 차라리 플러그인 방식이라 보는게 타당하며, 따라서 소위 말하는 RunUO 스크립에는 언어적인 지식과 방법으로서의 접근이 필요합니다. 스피어나 다른 예물레이터 식으로 그저 명령어 몇개, 함수 몇개 익혀서 되는것이 아니라는 말씀을 드리고 싶습니다. 바람이 있다면, RunUO를 통해서 c#에 관심을 가지시고, 나아가 c#을 통해 프로그래밍에 관심을 가지셨으면 하는것이 바람입니다만.

모쪼록 강풍님에게 부탁받아 나름대로 관리자의 한 자리를 차지하고 있었습니다만 그동안 이렇다할 실적도 없고 해서 이렇게 부족하나마 한번 써보았습니다. 모쪼록 도움들 되셨길 바라며, 물러갑니다.

본 글에 관한 문의 사항은 irc내에서의 #ultimax 채널의 kkung이나,
kkungkkung@gmail.com으로 주시면 빠른 시일내에 답변해 드리겠습니다. 모쪼록 부족한 강의 참고하여주셔서 감사합니다.