Devil Fruits on NPCs¶

`/akumalib npcfruit`¶

Since 5.0.0. An operator command (level 2) to test fruit-using NPCs: it gives a Devil Fruit to an NPC the way the base mod gives one to its captains.

/akumalib npcfruit <targets> <fruit>    the fruit, and an AI goal for each of its abilities that has one
/akumalib npcfruit <targets> clear      the fruit and its goals taken off

Every registered fruit is offered, an addon's as well: an addon has nothing to add for its fruits to appear.
The goals are those of MobsHelper.getDevilFruitAbilities, at priority 2: one per ability given a goal wrapper (addGoalWrapper). The answer lists those abilities, or says there is none: then the NPC never uses the fruit.
The goals of the fruit the NPC had are taken off first.
Players and entities without an AI are refused.
Under "One Fruit per World" the command still gives any fruit, a taken one included: a test tool for operators. It does not write the fruit in the One Fruit list either. The base mod's own random draw for its NPCs skips the taken fruits (fixProtectionRules).
After a save and a reload the goals come back (NpcStyles, with fixSaveLoad on), on any NPC: the base mod's own captains and notorious NPCs, and any other mob given its fruit by the command.

The same from code: NpcStyles.giveFruit(mob, fruit) and NpcStyles.takeFruit(mob).

Zoans on mobs that are not humanoid¶

Since 6.0.0. A Zoan's hybrid and partial forms are drawn over a human body. A mob without one (a creeper, a spider, a wolf) may only take the full form of a Zoan (the whole animal).

Humanoid means a Mine Mine no Mi NPC, or a mob in the entity type tag akumalib:humanoid_fruit_users (zombies, skeletons, piglins, illagers by default). A data pack can add more.
A Zoan given to any other mob goes to the addon that knows its full form: it registers a NpcStyles.BeastFruits at its set-up (NpcStyles.registerBeastFruits). give returns the abilities the mob will use, or null for a fruit it does not know; take takes it all off again (clear).
A Zoan no addon knows (the base mod's, for now) is refused on such a mob, with a message: giveFruit returns null and gives nothing.
Fruits that are no Zoan are given as before.

Troops with Devil Fruits¶

Since 5.0.0. Grunts, brutes and snipers of every faction (pirates, Marines, bandits) may spawn with a Devil Fruit, as the base mod's captains do. Off by default: two chances in akumalib-server.toml, 0.0 to 100.0 %, decimals allowed.

Key	NPC	Tiers it may draw
`troopFruitGruntChance`	Grunt	1 (wooden box)
`troopFruitBruteSniperChance`	Brute, sniper	1-2 (wooden, iron box)
Mine Mine no Mi's "Open World Fruit Users Chance"	Captain, bandit leader, vice admiral, notorious captain	1-3: the base mod's own draw, unchanged

Troops are many: in a new world (a pirate ship, a Marine base, a bandit camp and twelve stops), 127 grunts and 24 brutes or snipers spawned for 6 captains. The same chance as the captains would give troops about 25 times as many fruit users. Values to start from: grunts 0.5 %, brutes and snipers 2 %, about one fruit-using troop for every 6 captains.

The tier is the fruit's own, AkumaNoMiItem.getTier(): the caps hold with fruitBoxMode = MIXED too.
A fruit is drawn among those with at least one ability given a goal wrapper (addGoalWrapper), as for the captains: an addon has nothing else to do for its fruits to reach the troops of their tier.
Drawn once, at the end of the troop's finalizeSpawn: natural spawns, spawners, /summon, spawn eggs. A troop read from its save keeps its fruit and its techniques (NpcStyles.giveFruit) and never draws again.
Under "One Fruit per World" the taken fruits are skipped, and the troop's fruit reserves nothing. With no fruit left in its tiers, the troop has none: it never draws from a higher tier.
No fruit is dropped on death.

Logia are rarer on NPCs. Since 5.0.0. A Logia counts a quarter of another fruit in every NPC draw: captains, bandit leaders, vice admirals and notorious NPCs ("Open World Fruit Users Chance"), with or without "One Fruit per World". A player without haki cannot touch a Logia, so a Logia NPC stays a rare boss. The base mod's Logia are all tier 3: troops never draw one. With fixProtectionRules false the base mod's own draw is used, Logia as often as any fruit.

The draw from code: ProtectionRules.freeFruitDraw(mob, maxTier); the weight is ProtectionRules.LOGIA_DRAW_WEIGHT.

Any mob with a Devil Fruit¶

Since 6.0.0. Any mob that spawns naturally may have eaten a Devil Fruit: zombies, skeletons, creepers, spiders, endermen, but also cows, pigs, chickens, and other mods' mobs. One key in akumalib-server.toml, section npcFruitUsers:

Key	Default
`mobFruitChance`	`0.01`	chance in %, 0.0 to 100.0, per mob spawned; 0: off

Mobs spawn by the thousands: 0.01 % is about one fruit user for 10,000 mobs, a real rarity.

Natural spawns only: the world's spawning and a new chunk's animals. Spawners, spawn eggs, /summon, breeding, jockeys, raids, patrols and structures give none.
Never: a boss (forge:bosses), a mob that spawns in water (fish, squids, drowned, guardians, axolotls: a fruit user cannot swim), or one of Mine Mine no Mi's NPCs, which have their own chances.
Tier 1 fruits only, as a grunt's (ProtectionRules.freeFruitDraw): under "One Fruit per World" taken fruits are skipped and the mob's fruit reserves nothing; Logia are rarer.
Zoans: a mob that is no humanoid takes a Zoan only as the whole animal, through an addon's NpcStyles.BeastFruits (#623). A Zoan it is refused is left out of its draw and another fruit drawn; with none left, the mob has no fruit.
A peaceful mob (a cow, a pig) stays calm and flees no more: whoever hits it, it turns on them with its fruit, and lets go once they are out of its follow range. Monsters and mobs that already strike back (wolves, golems) keep their own targeting.
Kept after a reload: the fruit and its techniques (NpcStyles.giveFruit), and a peaceful mob's fight-back (mark MobFruitUsers.MOB_FRUIT in its persistent data).
No fruit is dropped on death, and nothing shows the fruit before the fight (#589).

From code: MobFruitUsers.draw(mob) gives a mob a fruit by the same draw; MobFruitUsers.mayTakeFruit(mob) says whether one may have it at all.

Fewer Rokushiki for captains and notorious NPCs¶

Since 5.1.0. The base mod gives every human captain 3 Rokushiki (2 for a bandit leader), Soru first, and a notorious NPC 3 to 5: fights with them are hard to read. Now a captain (pirate, Marine, bandit leader) or a human notorious NPC (vice admiral, notorious captain) draws how many it knows, and uses them from time to time. Section npcRokushiki of akumalib-server.toml:

Key	Default
`npcRokushiki`	`true`	`false`: Mine Mine no Mi's own draw and cooldowns, all the keys below ignored
`npcRokushikiNone` / `One` / `Two` / `Three`	25 / 55 / 15 / 5	weights of knowing 0, 1, 2 or 3 techniques; a notorious NPC knows 2 at most (the weight of 3 goes to 2)
`npcSoruCooldown`	15.0	least seconds between two Soru (a player's Soru has 5 dashes in a row)
`npcRokushikiCooldownMultiplier`	2.0	their Rokushiki cooldowns against a player's

The techniques are the base mod's, with its AI wrappers: a captain draws from Soru, Shigan, Tekkai (7 each), Rankyaku (4, below 90 % health) and Kami-e (1); a notorious NPC from Soru, Shigan, Tekkai (5 each), Rankyaku, Geppo and Kami-e (4 each).
Kept after a reload: the ids drawn are in the NPC's persistent data (NpcRokushiki.KEY). The base mod draws again at a reload (a captain through NpcStyles, with fixSaveLoad on; a notorious NPC in its constructor): the saved ones are given back instead.
Only CaptainEntity and NotoriousEntity themselves: named bosses (Higuma, Morgan, Kuro, Jango, Sham, Buchi, Gin, Pearl, Don Krieg, Alvida, Cabaji, Miss Valentine, Mr. 0, 1, 3, 5) keep their kit and cooldowns, as do players and an addon's subclasses.

From code: NpcRokushiki.known(npc), NpcRokushiki.cooldown(entity, ability, cooldown).

NPCs break no terrain¶

Since 5.0.0. An NPC's abilities break or replace no block: captains, troops, notorious NPCs, any mob given a fruit. The ability still fires: it hurts, knocks back and applies its effects, and stays in the NPC's kit. One key in akumalib-server.toml, section npcFruitUsers:

Key	Default
`npcAbilityGriefing`	`false`	`true`: NPCs break blocks as players do

Players are not concerned: they stay under Mine Mine no Mi's own "Ability Griefing" alone. A projectile or a tamed creature acts for its owner: a player's projectile is a player's.
Only lasting destruction is cut. A block laid into air is still laid, fire excepted: an NPC lights no fire, neither by its explosions (setFireAfterExplosion) nor laid into air, since fire spreads and burns for good. A TemporaryBlocks group still raises its walls (over flowers too) and cuts its gaps: they come back. SpreadingBlockAbility zones, which give their blocks back, still spread. The base mod's own temporary blocks (Barrier, Room, string walls) are laid into air.
What is refused for an NPC: a block broken or replaced through NuWorld.setBlockState (both forms) and the base mod's block placers and queues, an AbilityExplosion's blocks and fires, Smash.through, falling blocks and fire or ice through ProtectionRules, Takt's lifted blocks, AkumaLib's tornado and the base mod's (which lifts nothing anyway while fixCombatChecks is on).
Not in a challenge arena: the base mod restores it.

Who acts is the entity a block call names, else the entity the server is ticking: the base mod's placers and queues are handed only the level, and an NPC's abilities run in its own tick, its projectiles in theirs. A block queued by an NPC is checked when it lands. The base mod's tornado is the one ability entity with no traceable owner that breaks blocks: its caster is read from it. An addon that breaks blocks with its own calls asks AkumaProtection.canBreakBlocksAt(entity, pos) for a change that lasts (a block melted, carried off, turned to another for good), and keeps canAlterBlocksAt for one given back or that breaks nothing. An addon's own temporary change made through NuWorld.setBlockState on an NPC's behalf goes in NpcGriefing.temporarily(() -> ...).