Wiki Release: 2026.09.5 · UltimateOutpost: 1.27.1 · Documentation branch: 1
Advantages and interactions#
Advantages are ongoing benefits associated with outpost ownership. The supplied advantages.yml enables group-aware advantages and defines several built-in advantage types.
Included advantage types#
Experience drop (exp)#
Increases/changes experience-related drops for the eligible owner/group context.
Mining drop (miner_drop)#
Applies to whitelisted mining materials. The supplied whitelist includes common ores/resources such as diamond, iron, emerald, gold, coal, lapis, redstone and stone variants.
Wood drop (timber_drop)#
Applies to whitelisted log/wood materials, including normal and stripped variants.
Mob drop (mob_drop)#
Applies the configured ownership benefit to mob drops.
Increased damage (increases_damage)#
Provides an ownership-related damage advantage. Test it against a fixed target with owner vs non-owner accounts before changing the multiplier.
Fishing drop (fishing_drop)#
Applies to whitelisted fish types such as tropical fish, cod, pufferfish and salmon in the supplied configuration.
Potion effect (potion)#
Applies configured potion effects from the whitelist. The supplied file includes many Bukkit potion effect names.
Fortune (fortune)#
The config comment states that this advantage requires the Fortune enchantment (LOOT_BONUS_BLOCKS) on the pickaxe and limits eligible pickaxe materials through a whitelist.
Admin workflow#
Use /uoutpost advantages list, view, toggle, setmultiplier, whitelist and sync. Test every change with:
- current owner/group;
- non-owner;
- whitelisted/exception case where relevant.
That three-account test separates ownership problems from the advantage implementation.
Interactions#
interactions.yml defines additional ownership-aware interactions. The admin tree exposes list, view, toggle, setmultiplier, whitelist and sync under /uoutpost interactions.
When an interaction fails, test the exact Bukkit action/block/entity configured. Similar-looking interactions may be handled by different listeners.