Add Allies and additional rule API

[Doc94]

Currently exists a "isAllies" method in NMS used for things like target/considerations in Entities, one rule of that is if two entities share a team then are allies, this API allow pass additional rules by Key, this its a good alternative for listen every time the Target Event or track Memory for entities who not use that event.

This allow things like.

player.getWorld().spawn(player.getLocation(), Warden.class, entity -> {
                        entity.addAdditionalAlliedRule(Key.key(TestPlugin.this, "rule_1"),target -> {
                            return target instanceof Player playerTarget && playerTarget.getInventory().getItemInMainHand().getType().name().contains("SWORD");
                        });
                        entity.addAdditionalAlliedRule(Key.key(TestPlugin.this, "rule_2"),target -> {
                            return target instanceof Player playerTarget && playerTarget.getInventory().getItemInMainHand().getType().name().contains("PICKAXE");
                        });
                    });

for

2026-05-02_11-00-58.mp4

[yannicklamprecht]

I would personally like to have the following.

player.getWorld().spawn(player.getLocation(), Warden.class, entity -> {
                        entity.addAdditionalAlliedRule(Key.of(plugin, "ignore_sword"), target -> {
                            return target instanceof Player playerTarget && playerTarget.getInventory().getItemInMainHand().getType().name().contains("SWORD");
                        });
                    });

So that you can remove the additional rule at any time using.

entity.removeAdditionalAlliedRule(Key.of(plugin, "ignore_sword"));

Advantages: Multiple plugins can declare and handle allies.
Dissadvantages: The whole logic would be O(n) instead of O(1)

[Doc94]

@yannicklamprecht sounds good, i make a change for allow that now... still require the user listen for remove/add entity for add the rule again when the entity was loaded (like when change dimension) but i feel its ok.