Intro
About 672 wordsAbout 2 min
A focus is the main business direction of a company, and every focus has its own expertise tree. A company can only have one focus at a time. Learning expertises in the tree gives the company permanent bonuses.
The plugin provides two focus configurations:
| Id | Description |
|---|---|
none | The focus of a new company. The tree only contains one empty node and gives no bonus. |
mob | An example 14-node tree about mob loot, combat and company profit. The company needs $60,000 before it can be selected. |
The mob tree is only an example. The expertises inside focus/mob.yml can be added, removed, renamed or rewritten by the server owner, so the tree on your server may differ from the one described here. The default contents are listed in Mob Focus Tree. Server owners can change the tree or build their own progression in Focus Configuration.
Open the focus menu
Execute /myc and click Focus (enchanted book). Looking at the tree does not require any permission, but the actions inside it are controlled by position permissions:
| Action | Position permission |
|---|---|
| Learn an expertise | FOCUS_LEARN_EXPERTISE |
| Change the focus of the company | FOCUS_SET |
The menu shows 10 expertises per page by default. A learned node is marked as LEARNED and enchanted; a locked node shows its unlock conditions in the lore.
Learn an expertise
Left click a locked node. All conditions listed under Unlock Condition must be met at the same time. Conditions can require:
- a certain amount of company cash
- other expertises of the same tree
- a number of kills recorded by the company
When the conditions are met, the money part is paid from the company balance (not from the player), the node becomes LEARNED, and its actions run immediately. If a condition is not met, the click is refused with a message and a villager "no" sound.
Tips
A node that is disabled by an action still counts as unlocked for the prerequisites of other nodes.
Change the company focus
Click the Focus button at the bottom of the focus menu to open the focus list. The current focus is marked as learned; left click another focus and confirm the dialog.
The conditions of the target focus are checked before switching. For mob, the company must have $60,000, but the money is not deducted when the focus is selected.
Warning
Changing the focus resets every learned expertise of the old tree, and sets the internal store price group back to normal. Progress and money spent on the old tree are not refunded. The confirmation dialog warns about this before switching.
How the bonuses are applied
Focus bonuses are not potion effects or vanilla attributes. They are applied when a member of the company triggers the related action:
- Drop bonuses are applied to the drops of a kill when a company member kills a mob.
- Damage bonuses are applied when a company member directly hits a mob with melee.
The tree belongs to the company, so any member's kills use the same expertises. The bonus only affects the member who performs the action; it is not given to every online member at once.
Ranged kills still count for drop bonuses and for the company kill counters, because the shooter is the causing entity. The damage bonus only checks the direct attacker, so arrows and other projectiles do not trigger it.
Limits
- One focus per company.
- The expertises of a focus are defined in its configuration file, so the tree can differ between servers.
- Progress is stored per company and survives restarts. It does not survive a focus change.
- Kill counters used by conditions are stored per company and are not reset by changing the focus.
- The learned expertises do not cost upkeep; the company only pays when a node is unlocked.
Continue with:
- Mob Focus Tree — the example tree, costs and effects.
- Focus Configuration — add, edit or remove expertises.
- Conditions, Effects and Actions — the full syntax reference.