CPotionMatterImpl

CPotionMatterImpl とは

CPotionMatterImpl はポーション効果を持つアイテムの検査を行う CPotionMatter インターフェースの標準実装クラスです。 open class として定義されているため、継承して拡張することもできます。

コンストラクタ

open class CPotionMatterImpl @JvmOverloads constructor(
    override val name: String,
    override val candidate: Set<Material>,
    override val potionComponents: Set<CPotionComponent>,
    override val amount: Int = 1,
    override val anyAmount: Boolean = false,
    override val predicates: Set<CMatterPredicate>? = CMatterImpl.defaultMatterPredicates()
) : CPotionMatter

パラメータ	デフォルト値	概要
`name`	—	CMatter の識別名
`candidate`	—	受け付けるアイテムの種類の集合
`potionComponents`	—	要求するポーション効果の条件セット
`amount`	`1`	要求する最小個数
`anyAmount`	`false`	`true` にすると個数計算から除外される
`predicates`	`defaultMatterPredicates()`	追加の検査ロジックセット

DEFAULT_POTION_CHECKER

CPotionMatterImpl.DEFAULT_POTION_CHECKER はポーション効果を検査するデフォルトの CMatterPredicate です。 CMatterImpl.defaultMatterPredicates() に含まれているため、predicates を省略すると自動的に有効になります。

処理の流れ:

入力アイテムが Air であれば true を返す
CMatter を CPotionMatter にキャストできない場合は true を返す
potionComponents が空であれば true を返す
アイテムのメタが PotionMeta でない場合は false を返す (ポーション効果の条件があるのにポーションでない)
basePotionType のエフェクトと customEffects を収集する
すべての potionComponents がいずれかのエフェクトに合致するかを確認する

val DEFAULT_POTION_CHECKER = CMatterPredicate { ctx ->
    if (ctx.input.type.isAir) return@CMatterPredicate true
    val potionMatter = ctx.matter as? CPotionMatter
        ?: return@CMatterPredicate true

    if (potionMatter.potionComponents.isEmpty()) return@CMatterPredicate true
    else if (ctx.input.itemMeta !is PotionMeta) return@CMatterPredicate false

    // Key: ポーション効果の種類, Value: エフェクトレベル (amplifier)
    val sources: MutableMap<PotionEffectType, Int> = mutableMapOf()
    val potionMeta: PotionMeta = ctx.input.itemMeta as PotionMeta
    potionMeta.basePotionType?.let { p ->
        p.potionEffects.forEach { effect -> sources[effect.type] = effect.amplifier }
    }
    potionMeta.customEffects.takeIf { it.isNotEmpty() }?.let { list ->
        list.forEach { effect -> sources[effect.type] = effect.amplifier }
    }

    return@CMatterPredicate potionMatter.potionComponents.all { component ->
        when (component.strict) {
            CPotionComponent.Strict.ONLY_EFFECT -> sources.containsKey(component.effect.type)
            CPotionComponent.Strict.STRICT -> {
                sources.containsKey(component.effect.type)
                    && sources.getValue(component.effect.type) == component.effect.amplifier
            }
        }
    }
}

CPotionComponent

CPotionComponent はポーション効果の条件を表すデータクラスです。

フィールド	型	概要
`effect`	`PotionEffect`	要求するポーション効果 (種類・効果時間・レベルを含む)
`strict`	`CPotionComponent.Strict`	制限の強さ

`Strict` 値	概要
`ONLY_EFFECT`	効果の種類が含まれていれば良い (レベル・時間は問わない)
`STRICT`	効果の種類とレベル (`amplifier`) が一致する必要がある

使用例

発光効果のポーション (レベル問わず)

val glowingPotion = CPotionMatterImpl(
    name = "glowing-potion",
    candidate = setOf(Material.POTION, Material.SPLASH_POTION),
    potionComponents = setOf(
        CPotionComponent(
            effect = PotionEffect(PotionEffectType.GLOWING, 200, 0),
            strict = CPotionComponent.Strict.ONLY_EFFECT
        )
    ),
    anyAmount = true
)

速さ II のポーション (レベル厳密指定)

// 速さ II は amplifier = 1
val swiftPotion = CPotionMatterImpl(
    name = "swift-potion",
    candidate = setOf(Material.POTION),
    potionComponents = setOf(
        CPotionComponent(
            effect = PotionEffect(PotionEffectType.SPEED, 200, 1),
            strict = CPotionComponent.Strict.STRICT
        )
    ),
    anyAmount = true
)

複数効果の条件

// 耐火 + 再生を両方持つスプラッシュポーション
val comboPotion = CPotionMatterImpl(
    name = "combo-potion",
    candidate = setOf(Material.SPLASH_POTION),
    potionComponents = setOf(
        CPotionComponent(
            effect = PotionEffect(PotionEffectType.FIRE_RESISTANCE, 100, 0),
            strict = CPotionComponent.Strict.ONLY_EFFECT
        ),
        CPotionComponent(
            effect = PotionEffect(PotionEffectType.REGENERATION, 100, 0),
            strict = CPotionComponent.Strict.ONLY_EFFECT
        )
    ),
    anyAmount = true
)

predicates を null にして効果なしポーションを許可する

// potionComponents を空にして predicates を null に設定すると、
// 種類のチェックのみ行い、ポーション効果は問わない
val anyPotion = CPotionMatterImpl(
    name = "any-potion",
    candidate = setOf(Material.POTION, Material.SPLASH_POTION, Material.LINGERING_POTION),
    potionComponents = emptySet(),
    predicates = null
)

継承して拡張する

// 特定の複数効果セットをあらかじめ持った CMatter を定義する例
class HealingPotionMatter(name: String) : CPotionMatterImpl(
    name = name,
    candidate = setOf(Material.POTION),
    potionComponents = setOf(
        CPotionComponent(
            effect = PotionEffect(PotionEffectType.INSTANT_HEALTH, 1, 0),
            strict = CPotionComponent.Strict.ONLY_EFFECT
        )
    ),
    anyAmount = true
)