플러그인에서 편하게 NMS의 메소드를 사용할 수 있도록 하는 라이브러리를 만들고 싶습니다.

이해를 돕기 위해 실제로 제가 맞닥뜨린 사례를 설명하겠습니다.

현재(1.19.2) 기준으로 Spigot API와 Paper API에서는 플레이어를 여러분이 원하는 대미지 유형(Bukkit의 DamageCause 혹은 NMS의 DamageSource)으로 죽일 수 없습니다. Damagable#damage(double amount, Entity source) 등의 메소드로 줄 수 있는 대미지의 유형은 항상 DamageCause#VOID 혹은 DamageCause#SUICIDE로 보입니다.

이를 해결하기 위해서는 NMS에 접근할 수 있어야 합니다. NMS의 LivingEntity에는 LivingEntity#hurt(DamageSource source, float amount)라는 메소드가 존재하거든요.

하지만 NMS의 LivingEntity를 상속받는 Player 오브젝트에 접근하기 위해서는 여러 난관이 존재합니다. 먼저 Bukkit API 버전명에 영향을 받는 CraftPlayer 오브젝트로 Player 오브젝트를 캐스트 해야 합니다.

net.minecraft.world.entity.player.Player getNMSPlayer(org.bukkit.entity.Player player) {
  return ((org.bukkit.craftbukkit.v1_19_R1.entity.CraftPlayer) player).getHandle();
}

만약 여기서 블록(선인장 등)으로 인한 대미지를 주려면 추가로 역시나 Bukkit API 버전명에 영향을 받는 CraftEventFactory를 만들어야 합니다.

void hurtCactus(org.bukkit.entity.Player player, float amount) {
  org.bukkit.craftbukkit.v1_19_R1.event.CraftEventFactory.blockDamage = player.getWorld().getBlockAt(0, 0, 0);
  getNMSPlayer(player).hurt(DamageSource.CACTUS, amount);
}

현재는 이 방법이 유일하게 플레이어에게 특정 유형의 대미지를 주면서, 동시에 이 대미지로 플레이어를 죽일 수 있도록 하는 방법입니다.

그런데 위 방법은 보시다시피 import 하는 클래스 이름에 Bukkit의 특정 API 버전명(v1_19_R1)이 명시되어 있습니다.  코드 유지보수 측면에서 이렇게 특정 API 버전명에 의존해야 하는 방법은 별로 선호하지 않습니다.

그래서 생각한 것이 아예 NMS 관련 메소드만을 전담하는 라이브러리를 만드는 것입니다. 가령 아래와 같은 모양의 클래스가 있다면 어떨까요.

public interface NPlayer extends org.bukkit.entity.Player {
  public void hurt(CustomDamageSource source, float amount);
}
public interface CustomDamageSource {
  // Wrapper of NMS DamageSource, only implements some of it though
}

실제 플러그인에서 사용할 때에는 그냥 Bukkit의 Player를 NPlayer로 캐스트 한 후에 NPlayer#hurt(CustomDamageSource source, float amount)를 사용하면 되는 겁니다.

다만 이걸 어떻게 해야 여러 버전의 NMS/Bukkit API를 지원할 수 있게 만들 수 있는지를 모르겠습니다.

한줄 요약: Bukkit API의 Player를 상속하는 새로운 클래스를 제공하는 방법으로 여러 버전의 NMS/Bukkit API를 사용 가능케 하는 라이브러리를 어떻게 만들어야 할지 모르겠습니다.