Almanac

Almanac

Welcome to Rusty's Almanac, your gateway to the enchanting world of Valheim!

Rusty's comprehensive plugin catalogs all the items, pieces, and creatures that is loaded into the game.

Explore the depths of Valheim with ease, armed with a wealth of information at your fingertips.

Moreover, Rusty's Almanac goes beyond mere documentation. With an integrated customizable achievement system and a leaderboard, users can shape their own unique experiences.

Achievements

Almanac lets you define custom achievements using.yml files in the Achievements folder.

These achievements sync between server and client, and are dynamically reloaded when edited.

Below are the available Achievement Types you can use:

| | | | |

|-----------------------|-----------------|------------------|-----------------------|

| Arrows | ArrowsShot | Axes | Bows |

| Consumables | CreatureGroup | CreatureTamed | Deaths |

| DistanceInAir | DistanceRan | DistanceSailed | DistanceWalked |

| EnemyKills | Fish | FoodEaten | ItemsPicked |

| Kill | Knives | Maces | Materials |

| MineHits | Pickable | PlayerKills | PoleArms |

| Potions | Recipes | Shields | Spears |

| Staves | Swords | TimeInBase | TimeOutOfBase |

| TotalJumps | TotalMined | Trophies | Valuables |

| Weapons | CollectItems | Achievements | |

Achievement File Structure

Each achievement is defined as a YAML file with properties like:

• UniqueID: A unique identifier string (e.g., Weapons.001).
• Name: Display name for the achievement.
• Lore: A short description or flavor text.
• Icon: The icon name from the game's assets.
• TokenReward: Reward tokens for completing the achievement.
• Requirement: The type, threshold, and optional group or prefab name.

Examples

• Defeating creatures from a biome: AchievementType.CreatureGroup with Group = Meadows.
• Reaching a milestone (kills, distance, etc.): set Requirement.Type to the relevant stat.
• Collecting all of an item type (fish, weapons, trophies, etc.): use collection-based types.

Tips

• Files can be added, changed, or deleted while the server is running.
• Server automatically syncs achievements to clients.
• Thresholds can be left at 0 for auto-detection (e.g., total number of fish).
• PrefabName is required for Kill and Pickable types.
• CollectItems type Requirement.PrefabName entry format: prefabname,amount;prefabname,amount

Almanac Bounties

The Almanac Bounty system lets players purchase bounty contracts to hunt special creatures.

Bounties are defined in.yml files inside the Bounties folder.

Admins can add, remove, or edit bounty entries at runtime — changes will sync to all clients.

Each bounty entry can define:

• UniqueID: Unique identifier for the bounty (e.g., Troll.001).
• Creature: The prefab name of the target creature (e.g., Troll, Serpent).
• Name: (Optional) Custom name override; if empty, a generated name will be used.
• Icon: Trophy sprite or icon for the bounty.
• Biome: The biome where the bounty will spawn (Meadows, Swamp, AshLands, etc.).
• Health: Override maximum health value of the bounty.
• Level: Creature level (scales difficulty).
• DamageMultiplier: Multiplier applied to the bounty’s attacks (e.g., 1.5).
• AlmanacTokenReward: Tokens given upon completing the bounty.
• Lore: A short description displayed in the Almanac panel.
• Cost: Item or token requirements to purchase the bounty.

Notes

• Costs can be AlmanacToken or regular items (e.g., Coins).
• If the bounty despawns or escapes the cost is returned.
• Bounties are subject to a configurable cooldown (default in minutes).

Tips

• You can reload or edit.yml bounty files while the server is running; changes sync automatically.
• Each bounty spawns a pin on the map when accepted.
• Default bounties include Boar, Neck, Troll, Serpent, Abomination, Wraith, Lox, Seeker Brute, Fallen Valkyrie.
• Use Lore to tell a short story or flavor text for each hunt.

Example Entry

UniqueID: Troll.001

Creature: Troll

Name: Forest Stalker

Icon: TrophyFrostTroll

Biome: BlackForest, Swam