Achievements
Work in Progress
This documentation is still being expanded and refined. Features, screenshots, and descriptions may change until Talescape's public release. If something is unclear or you need help, please ask on the official Talescape Discord. We're happy to clarify or update pages as needed.
Achievements are collectible milestones that reward players for completing specific goals or discovering hidden story paths. They appear on your story’s page and provide an extra layer of motivation for Dreamers to explore alternate routes and endings.
1. Overview
Each achievement has three basic fields:
| Field | Description |
|---|---|
| Name | The title of the achievement shown to players. |
| Description | A short text describing how it is earned or what it represents. |
| Icon | The image displayed when the achievement is unlocked. |
Achievements can be tied to any story logic through Actions, Conditions, or Triggers, for example, unlocking one when a specific event or dialogue path is reached.
2. Visibility
You can choose whether an achievement is visible or secret:
| Type | Description |
|---|---|
| Visible | Shown on the story page with its name and description from the start. |
| Secret | Hidden until unlocked. Before discovery, the story page will show “(+X secret achievements)” to indicate their existence. |
Secret achievements are ideal for hidden endings, rare story branches, or easter eggs you want players to discover on their own.
3. Display on Story Page
Unlocked achievements appear on both:
- The story’s public page, showing what other Dreamers have earned.
- The player’s profile, tracking personal progress across stories.
Visible achievements are displayed immediately upon earning. Secret achievements only appear after being unlocked.
4. Creating and Managing Achievements
You can create new achievements in the Achievements section of the editor. Each one is stored globally for the story and can be referenced in Actions such as:
- Unlock Achievement
- Check if Achievement is Unlocked
Achievements are automatically synchronized with player data when the story runs.
5. Removing or Retiring Achievements
Be careful when deleting or renaming achievements. If an achievement is removed from the editor, it will also be removed from all player profiles where it was previously earned.
To avoid this, consider:
- Marking an old achievement as hidden instead of deleting it.
- Reusing the same achievement entry for an updated goal.
Removing achievements should be reserved for serious content revisions only.
6. Best Practices
- Use clear names and short descriptions that match your story’s tone.
- Keep icons visually distinct so players can recognize what they’ve earned.
- Use secret achievements sparingly to add mystery, not confusion.
- Avoid changing achievements after release unless absolutely necessary.
Achievements add replay value and give Dreamers a reason to revisit your story, rewarding curiosity, exploration, and dedication.