상태 효과
사용자 정의 상태 효과를 만드는 방법을 알아보세요.
WARNING
This page is written for version 1.21.10. Documentation for older versions may be incomplete.
이펙트, 효과로도 알려진 상태 효과는 엔티티에게 영향을 줄 수 있는 조건을 의미합니다. 이는 자연적으로 좋거나, 나쁘거나, 중립적일 수 있습니다. 기본 게임은 이러한 효과를 음식, 물약 등 다양한 방법으로 적용합니다.
/effect 명령어를 통해 엔티티에게 효과를 부여할 수도 있습니다.
사용자 정의 상태 효과
이 튜토리얼에서는, 매 틱마다 플레이어에게 경험 포인트를 주는 새로운 사용자 정의 효과 Tater 를 만들어 보겠습니다.
MobEffect 확장
모든 효과의 기본이 되는 MobEffect 클래스의 사용자 정의 확장 클래스를 만들어 봅시다.
public class TaterEffect extends MobEffect {
protected TaterEffect() {
// category: StatusEffectCategory - describes if the effect is helpful (BENEFICIAL), harmful (HARMFUL) or useless (NEUTRAL)
// color: int - Color is the color assigned to the effect (in RGB)
super(MobEffectCategory.BENEFICIAL, 0xe9b8b3);
}
// Called every tick to check if the effect can be applied or not
@Override
public boolean shouldApplyEffectTickThisTick(int duration, int amplifier) {
// In our case, we just make it return true so that it applies the effect every tick
return true;
}
// Called when the effect is applied.
@Override
public boolean applyEffectTick(ServerLevel world, LivingEntity entity, int amplifier) {
if (entity instanceof Player) {
((Player) entity).giveExperiencePoints(1 << amplifier); // Higher amplifier gives you experience faster
}
return super.applyEffectTick(world, entity, amplifier);
}
}사용자 정의 효과 등록하기
블록, 아이템 등록처럼, Registry.register를 통해 MOB_EFFECT 레지스트리에 사용자 정의 효과를 등록할 수 있습니다. 이는 모드 초기화 단계에서 완료되어야 합니다.
public class ExampleModEffects implements ModInitializer {
public static final Holder<MobEffect> TATER =
Registry.registerForHolder(BuiltInRegistries.MOB_EFFECT, ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, "tater"), new TaterEffect());
@Override
public void onInitialize() {
// ...
}
}텍스쳐
상태 효과의 아이콘은 18x18의 PNG 입니다. 사용자 정의 아이콘을 다음 폴더에 넣어 적용할 수 있습니다:
resources/assets/example-mod/textures/mob_effect/tater.png
번역
다른 현지화처럼, 간단히 언어 파일에 "effect.example-mod.effect-identifier": "값" 포맷의 엔트리 ID를 추가하기만 하면 됩니다.
{
"effect.example-mod.tater": "Tater"
}테스트
일반적으로 엔티티에 상태 효과를 적용하는 방법을 살펴보는 것이 좋습니다.
TIP
For a quick test, it might be a better idea to use the previously mentioned /effect command:
effect give @p example-mod:tater효과를 내부적으로 적용하려면, MobEffectInstance를 효과가 제대로 적용되었는지 여부를 지정하는 부울 값을 반환하는 LivingEntity#addEffect 메서드를 사용하는 것이 좋습니다.
var instance = new MobEffectInstance(ExampleModEffects.TATER, 5 * 20, 0, false, true, true);
entity.addEffect(instance);| 매개변수 | 유형 | 설명 |
|---|---|---|
effect | Holder<MobEffect> | 효과를 나타내는 레지스트리 항목입니다. |
duration | int | 초 단위가 아닌 틱 단위 효과 길이입니다 |
amplifier | int | 효과의 세기를 선택합니다. 효과의 세기에 대응하지 않고, 오히려 위에 추가됩니다. 그러므로, 4의 amplifier => 5의 세기 |
ambient | boolean | 꽤 까다로운 문제입니다. 기본적으로 효과가 환경 (예: 신호기)에 의해 추가되었음을 지정하며 직접적인 원인이 없습니다. 만일 true라면, HUD에 있는 효과의 아이콘이 청록색 오버레이와 함께 나타날 것입니다. |
particles | boolean | 입자 표시 여부를 선택합니다. |
icon | boolean | HUD에 효과 아이콘 표시 여부를 선택합니다. 이 플래그와 관계 없이 효과는 보관함에 표시될 것입니다. |
INFO
INFO
사용자 정의 효과를 부여하는 물약을 만드는 방법은 물약 가이드를 참조하세요.