FarmPoints
One scale for every kind of work. What farmpoints.yml holds, how the mixed event uses it, and where the lifetime FarmPoints stat comes from.
FarmPoints turn mining, farming, logging, fishing, enchanting and combat into one number, so a miner and a farmer can compete against each other. The FARMPOINTS event scores with them, and every player has a lifetime FarmPoints total that /event stats and the placeholders show.
farmpoints.yml
track-always: true
mining:
default: 1
materials:
DIAMOND_ORE: 25
ANCIENT_DEBRIS: 40
farming:
default: 2
materials:
SUGAR_CANE: 1
logging:
default: 2
materials:
CHERRY_LOG: 3
fishing:
default: 5
materials:
TROPICAL_FISH: 12
enchanting:
per-level: 3
combat:
per-heart: 1| Key | What it does | Default |
|---|---|---|
track-always | Count FarmPoints all the time, not only during an event. This is what the lifetime stat uses. Off, the stat stays at zero. | true |
mining.default | Points for any block not listed under mining.materials. | 1 |
mining.materials | Blocks worth something other than the default. | ores |
farming.default and farming.materials | The same for crops. | 2 |
logging.default and logging.materials | The same for logs. | 2 |
fishing.default and fishing.materials | The same for catches. | 5 |
enchanting.per-level | Points for every level spent on an enchant. | 3 |
combat.per-heart | Points for every heart of damage dealt to a hostile mob. | 1 |
A block is sorted into mining, farming or logging by what it is. Logs, wood, stems and hyphae are logging. Wheat, carrots, potatoes, beetroot, nether wart, sugar cane, cactus, bamboo, kelp, melon, pumpkin, cocoa, sweet berries, torchflower and pitcher plant are farming. Everything else is mining.
This file is never touched by an upgrade, so nothing you delete comes back.
The mixed event
An event with type: FARMPOINTS counts every kind of action at once using these values. It has no targets of its own. The shipped all_rounder is one, and its action line tells players everything counts.
The same fairness rules apply as in every other event: creative mode, the bypass permission, disabled worlds and placed blocks are worth nothing. See Scoring rules.
The lifetime stat
With track-always on, every counted action adds to the player's lifetime FarmPoints whether an event is running or not. The total is added up in memory and written to the database once a minute, and when a player leaves, rather than on every block, so a busy server does not hammer the database. /event stats shows it, and %eventpulse_farmpoints% exposes it. See Placeholders.
Events file
Every key an event can carry in events.yml, what it does, its default, and what the plugin does when one is written wrongly.
Messages & language
Editing every message the plugin sends, switching between the shipped languages, adding a translation of your own, and the colour formats that work everywhere.