Home - Grim-/Talented GitHub Wiki

Welcome to the Talented Framework Wiki!

Talented is a flexible and extensible talent tree system framewirk for RimWorld mods.

Built with the same principles that RimWorld was developed upon, almost every system in Talented has Def classes and Worker classes that can be customized, overridden, or used independently.

Getting Started

Create your talent tree definitions using the visual design web app, where you can intuitively design your trees, upgrades, and paths:

Talent Tree Creator Web App

Head over to the "Getting Started" section to learn how to set up your own talent tree!

Example Previews

In-Game Example:

StarTree In-Game Example

Web App Example:

StarTree Web App Example

Features Overview

Tree Handler Types

  • Active Trees: Traditional talent selection system.
  • Passive Trees: Automatic unlocks based on chosen paths.

Flexible Path System

  • Mutually Exclusive Paths: Support for paths that lock out others.
  • Conditional Path Visibility: Define visibility rules for specific paths.
  • Hidden Upgrade Nodes: Unlock hidden upgrades based on specific conditions.
  • Custom Node Unlock Rules: Fully customizable rules for node unlocking.

Built-in Systems

  • Automatic UI Layout Strategies: Dynamic and configurable layout options.
  • Customizable XP Formulas: Define your own XP gain systems.
  • Configurable Talent Gain Calculations: Adjust calculations to fit your mod’s needs.
  • Skinning: Modify the talent tree’s appearance to suit your theme.
  • Resource System: Includes a basic system for abilities (e.g., hemogen or psyfocus).

Core Upgrade Types

  • StatEffect: Upgrade any pawn stat.
  • AbilityUpgrade: Enhance or modify abilities.
  • HediffEffect: Add or modify health effects.
  • OrganEffect: Implement organ-specific modifications.

Experience System

Experience Formulas

The framework offers flexible formulas for experience gain, allowing:

  • Customizable Experience Sources: Define various experience-gaining actions or events.
  • Ability XP Integration: Add XP gain directly to abilities using the XPExtension.

Skinning System

Talented includes a comprehensive skinning system for customizing the appearance of the talent tree to fit the style of your mod.

Upgrade Types

Sequential vs. Cumulative

  • Sequential Upgrades: Each level replaces the previous effect.
  • Cumulative Upgrades: Effects stack with each level.

Built-in Upgrade Types

  • AbilityUpgrade: Add or modify stats.
  • AbilityUpgrade: Enhance or modify abilities.
  • HediffEffect: Add or modify health effects.
  • OrganEffect: Implement organ-specific modifications.

Display Strategies

The framework provides several built-in layout strategies to organize your talent trees:

  • FixedPositionStrategy: Arranges nodes based on manually set positions, typically used with the web app.
  • VerticalStrategy: Arranges nodes vertically with branching paths.

Explore the rest of this wiki to dive deeper into the features, configurations, and best practices for building your talent trees using the Talented Framework!