Documentation › Mushrooms › Features › Achievements & Rankings

Achievements & Rankings

Achievements, titles and weekly / monthly ranking rewards.

Achievements

Each achievement pays a one-time cash reward and can unlock a title the player picks in the Achievements tab. The chosen title is shown instead of the level title.

Id Goal Reward Title
first_harvest Collect 1 mushroom $100
basket_100 Collect 100 $1,000
basket_1000 Collect 1,000 $7,500 Forest veteran
first_sale First sale $50
merchant Earn $50,000 $2,500 Merchant
perfect_25 25 three-star mushrooms $1,500
perfect_250 250 three-star mushrooms $6,000 Perfectionist
quests_10 10 quests $1,000
quests_100 100 quests $8,000 Reliable supplier
dryer_50 Take 50 off the drying rack $1,500
species_5 Discover 5 species $500
species_all Discover every species $5,000 Mycologist
lua
-- config_achievements.lua
Config.Achievements = {
    enabled = true,
    list = {
        { id = 'first_harvest', type = 'collected', goal = 1, reward = 100 },
        { id = 'basket_1000',   type = 'collected', goal = 1000, reward = 7500, title = 'veteran' },
        -- ...
    },
}

Types: collected, earned, quality3, quests, dried, discovered (goal = number or 'all'). Names: locales/<lang>.json → nui.achievements.<id> and nui.player_titles.<title>.

Rankings

The Ranking tab shows all-time, weekly and monthly leaderboards by mushrooms collected or money earned. When a week or month ends, the top 3 are paid (right away when online, otherwise on their next join) and can get a title.

lua
Config.RankingRewards = {
    enabled = true,
    rankBy = 'collected',   -- 'collected' or 'earned'
    week  = { { reward = 5000,  title = 'weekly_champion' },  { reward = 2500 },  { reward = 1000 } },
    month = { { reward = 20000, title = 'monthly_champion' }, { reward = 10000 }, { reward = 5000 } },
}

Config.UI.leaderboard.maxEntries sets how many players are listed.