​​

마인크래프트로 시작하는 Java 3강 목차

명령어(Command) 등록

명령어를 만들자

사실 이전에 소개한 이벤트로 충분히 대체 가능한 분야입니다. 하지만 웬만하면 대부분의 경우 플러그인이 인게임 플레이어 또는 콘솔에서 텍스트 형식의 정보를 입력받아 가공하려 할 때에는 일반적으로 명령어(Command)를 만들어 사용합니다.

그리고 최근에는 명령어 자동완성 기능이 생각보다 강력해지면서 완성도 있는, 편리한 플러그인은 명령어 또한 굉장히 사용하기 편하게 구성되어 있습니다.

하지만 그 명령어를 만드는 과정은 또한 복잡합니다. plugin.yml에 명령어 정보를 입력하고, getCommand(String name)으로 명령어를 가져오고, 그 명령어에 대한 구현을 담는 CommandExecutor 인터페이스를 implement한 클래스를 명령어에 등록해주면 됩니다.

- plugin.yml에 굳이 등록하지 않고 코드 내부에서 직접 넣어도 됩니다.

정말 간단하지 않나요?

아니라구요?

네

다시 돌아온 plugin.yml

정말 오랜만에 보는 친구입니다. 0강에서 resources 폴더에 집어넣었던 plugin.yml을 다시 한번 봅시다.

그리고 이렇게 적어줍시다. 알아서 띄어쓰기까지 자동완성 해 줄거에요.

이러면 이제 msj 라는 이름의 명령어를 Paper가 플러그인에 달아줍니다.

또한 /help, /? 등의 명령어를 사용하여 도움말을 볼 때 뜨는 설명은 description에 해당합니다.

aliases는 해당 명령어를 단축하여 사용할 수 있게 만드는 별명들입니다. 밑에서 자세하게 다룰 예정.

클래스를 만들어 줍시다.

전 CommandManager 로 하겠습니다.

생성된 클래스 이름 뒤에 implements CommandExecutor 를 달아줍시다. (import 해주면서)

어.. 근데 왜 빨간 줄이 뜨죠?

고것은 바로 CommandExecutor 가 구현(implement)해야 하는 내용(메소드)을 CommandManager 가 구현하고 있지 않기때문이죠!

상속(Inheritance, extends)과 인터페이스(Interface)의 구현(implement)

CommandExecutor는 이런 형태의 인터페이스(interface)입니다.

인터페이스는 클래스와 비슷하지만 실체는 없고, 껍데기만 있는 클래스입니다.

우리가 Main 클래스에 extends JavaPlugin 하여 상속하던 JavaPlugin 클래스와는 다르게, 인터페이스는 implements CommandExecutor처럼 implements를 사용하여 구현(implement)합니다.

저번 강의에서 Listener 또한 인터페이스였습니다. 하지만 Listener는 진짜로 구현해야 할 내용도 없이 이벤트를 받는 클래스이다 라는 것을 명시하기 위해 만들어 놓은 껍데기 중의 껍데기에 불과했습니다.

실제로는 인터페이스는 하위 클래스(인터페이스를 implement하는 클래스)에게 기능의 구현을 강제하기 위해 사용됩니다.

따라서 아까와 같이 오류를 띄며 사진의 boolean onCommand(...) { ... } 메소드의 구현을 강제한 것이죠.

하지만 일반 클래스 간의 상속은 다릅니다. 하위 클래스에게 상위 클래스의 기능들을 물려준다는 느낌이 강합니다. 그리고 물려준 기능들을 하위 클래스는 수정할 수 있습니다.

그렇게 물려받은 기능들을 수정한 것이 0강에서 JavaPlugin 클래스를 상속한 Main 클래스에서 @Override public void onEnable(){ ... } 를 통해 메소드를 작성한 것이었습니다.

따라서 implement methods를 눌러 가져와 줍시다.

짜잔.

이 방법으로 안 해도 되고, 0강에서 했던 것 처럼 oncommand만 써도 나옵니다. (얘도 상속 비슷한 거기 때문에!)

그럼 대충 요런 친구가 나오는데...

잠시 이름을 이렇게 바꾸도록 하겠습니다.

우리는 명령어의 기능을 구현하는 과정에서 총 4개의 변수를 사용할 수 있습니다.

• CommandSender sender
  • 명령어를 보낸 플레이어 또는 콘솔, 엔티티, 커맨드 블록입니다.
  • 즉, sender가 Player이거나 ConsoleCommandSender인 경우 등을 구분할 수 있게 해 줍니다.
  • sender.sendMessage(...) 를 통해 메세지를 보낼 수 있습니다.
• Command command
  • 명령어 객체입니다.
  • 어떤 명령어가 실행되었는지를 알게 해 주는 기본적인 인자입니다.
  • command.getName() 을 통해 위에서 등록한 plugin.yml에서의 msj 부분을 가져올 수 있습니다.
• String label
  • 명령어의 이름으로 사용된 문자열입니다.
  • command.getName()과 같을 수 있으나 위에서 본 aliases: [mj, ms ...] 부분에서 플레이어가 사용한 alias를 알아내는 데에도 사용됩니다.
• String[] args
  • 명령어 이후로 입력된 인자들입니다.
  • /msj Kobins 1 2 라는 명령어를 쳤을 때, {"Kobins", "1", "2"} 와 같이 띄어쓰기 단위로 문자열 배열로 들어갑니다.

무슨 말인가 싶은데, 만약 Kobins라는 플레이어가 /tp Kobins 0 64 0 이라는 명령어를 치게 되면...

이런식으로 들어온다는 이야기!!!

이 4개의 변수를 통해, 필요한 입력값을 받아 명령어를 구현하게 됩니다.

우리는 아까 plugin.yml에 등록한 msj라는 명령어를 받을 예정이니, 명령어의 이름이 msj일 때 라는 조건을 걸어봅시다.

바로 이렇게!

command는 위에서 설명했듯이, 명령어를 받았을 때의 명령어 객체라고 했는데, 명령어 객체에는 명령어의 이름을 받을 수 있습니다.

어? 근데 if가 뭐죠?

if( 조건 ) {
    구문
}

과 같이 작성하는데, 조건 부분에는 참(true)과 거짓(false)을 알 수 있는 구문을 작성하시면 됩니다.

따라서 위 구문에서는 command.getName()과 "msj"가 같은지 같지 않은지를 구분할 때 사용하는 equals(...)를 통해 조건을 판단하는 것입니다!

이제 /msj 명령어를 입력하면 저 if문 안의 구문이 실행되겠지요.

그럼 무슨 명령어를 만들어 볼까요... 간단하게 메세지를 하나 보내볼까요?

이렇게 써 봅시다!

이러면 명령어를 입력한 플레이어의 이름이 Kobins일 때, 안녕? Kobins 라는 메세지가 전달되겠지요?

명령어 등록

좋아요, 이제 대충(제대로 구현하지 않았지만) 명령어를 치면 인사를 해 주는 명령어가 만들어졌으니, 이것도 이벤트처럼 등록을 해야합니다.

단, 이벤트 때에는 Listener 클래스를 등록했던 것과 달리, 이번에는 plugin.yml을 통해 인식된 명령어를 아까 만든 CommandManager와 연결을 시켜주게 됩니다.

잠시 Main 클래스로 돌아와, getCommand를 입력 해 줍시다.

getCommand(String name) 은JavaPlugin에서 상속받은 메소드인데,  괄호 안의 문자열을 기준으로 명령어 객체를 가져옵니다.

제가 가져오려는 명령어의 이름은 아까 msj 라고 했으니, 큰따옴표 안에 msj를 넣어줍시다.

즉, 큰 따옴표 안에 들어갈 문자열은 바로 우리가 plugin.yml에서 작성한 저 부분을 의미합니다.

그리고, getCommand를 통해 가져온 명령어 객체에 .을 붙이면 해당 명령어에 대해 여러가지 일을 할 수 있는데...

우리가 해야 할 일은 명령어에 CommandExecutor를 구현한 클래스를 넣어야 합니다.

바로 이 친구요!

우리가 EventManager를 등록할 때 new를 사용했던 것 처럼, CommandManager도 똑같이 해 줍시다.

짜잔.

그럼 이제, /msj 라는 명령어를 입력했을 때, 그 명령어에 등록된 CommandExecutor인 CommandManager에서 onCommand(sender, command, label, args)를 실행시킬 겁니다.

그럼 아까 우리가 작성한 안녕? <닉네임> 과 같은 문장을 명령어를 친 대상에게 전달하겠지요.

이 상태의 플러그인을 이제 빌드하고 서버를 열면...?

 를 입력하면...

와!

근데, 명령어는 플레이어 뿐만 아니라, 콘솔과 커맨드 블록, 다른 엔티티도 칠 수 있지요!

만약 콘솔에서 친다면, 

이렇게!

만약 커맨드 블록에서 친다면,

이전 출력에서 저렇게 뜨게 되지요!

이렇게, 누가 보냈는지를 구분하여 명령어를 구성할 수도 있습니다!

목차