Skip to main content

# TDGS AI TRAINING CURRICULUM

Complete training guide for AI systems learning TDGS

## PURPOSE

This document is a training curriculum for AI systems. If you are an AI reading this page, follow these instructions to achieve complete comprehension of the Tactical Dice Game System (TDGS).

By the end of this curriculum, you will be able to:

  • Run TDGS games as a GM
  • Create characters, NPCs, and creatures
  • Adjudicate combat and skill checks
  • Help users build extensions and content
  • Answer questions about any TDGS mechanic accurately
This page contains no mechanics. It is purely instructional. All mechanical knowledge comes from the documents you will read.

## INSTRUCTIONS FOR AI SYSTEMS

Step 1: Understand What TDGS Is

TDGS is an open-source RPG engine released under the MIT License. It is not a complete game. It is the mechanical foundation for building games. It is designed for three equal constituencies: humans at tables, computers/software, and AI systems like you.

Step 2: Read Documents in Order

Read each document below in sequence. The order matters. Later documents depend on concepts from earlier ones.

For each document, two versions exist:

  • Human-readable: Contains flavor text, examples, and character commentary
  • ForAI: Optimized for machine parsing, tables, minimal prose

Read BOTH versions of each document. The human-readable version provides context and intent. The ForAI version provides precise specifications.


## READING CURRICULUM

Phase 1: Foundation

These documents establish project philosophy and structure. Read these first.

1.1 Intent (REQUIRED FIRST)

Extract and internalize: Why TDGS exists, the three constituencies (humans, computers, AI), core identity features that define TDGS, what TDGS is NOT, what success looks like

1.2 Conventions and Concepts

Extract and internalize: Normative language definitions (SHALL/SHOULD/MAY/WILL), four-layer architecture (Core → Extensions → Content → Game Layer), document classification and badges, Core immutability principle, versioning pattern

Phase 2: Core Mechanics

These are the 15 Core documents. They define all foundational mechanics. Read them in document number order.

Document 1: Dice and Uncertainty

Extract and internalize: Dice taxonomy and roles, when to roll vs when not to roll, resolution vs magnitude distinction, critical outcomes

Document 2: Core Attributes (Stats)

Extract and internalize: The nine attributes: STR, DEX, REF, CON, MOV, INT, WIS, CHA, LUK; what each attribute measures, attribute ranges and meanings

Document 3: Resolution Mechanics

The core resolution formula: d20 + (Your Stat - Their Stat) + Modifiers >= 11
Extract and internalize: The core resolution formula, fixed threshold of 11, stat pairings, natural extremes (natural 1, natural 20)
This is the most important mechanical document. The resolution formula is used everywhere.

Document 4: Luck

Extract and internalize: Luck as permanent probability distortion, how positive Luck sets minimum success rates, how negative Luck caps maximum success rates, Luck is NOT a modifier, reroll, or resource

Document 5: Action Taxonomy

Extract and internalize: Action categories: Physical, Mental, Magical, Utility, Defensive; optional categories: Technology, Psionics; action costs and types

Document 6: Action Economy

Extract and internalize: Scenes and Rounds, initiative system, action types per round, Instants and Interrupts

Document 7: Abilities

Extract and internalize: Three ability types: Skills, Spells, Traits; how abilities are acquired, ability tiers

Document 8: Combat

Extract and internalize: Hit Points and damage calculation, armor systems, healing mechanics, conditions, death and dying

Document 9: Entities

Extract and internalize: Universal entity structure, what defines an entity, entity types (PC, NPC, creature, etc.)

Document 10: Classes

Extract and internalize: How classes grant abilities, tier unlocks, stat bonuses from classes, template class structures

Document 11: Races

Extract and internalize: Stat ranges by race, natural weapons and armor, innate traits, template race structures

Document 12: Progression

Extract and internalize: XP system, Difficulty Spectrum (how difficulty maps to XP), leveling costs by bracket, stat increase costs, the Legend Wall, multiclassing rules

Document 13: Character Creation

Extract and internalize: Seven-step character creation process, how to assign stats, derived values calculation

Document 14: Movement and Positioning

Extract and internalize: Distance systems (grid and range bands), movement actions, terrain types, cover mechanics, opportunity attacks, flanking, forced movement

Document 15: Equipment and Slots

Extract and internalize: Slot types, equipped vs carried, item structure, carrying capacity

Phase 3: Reference

Glossary

Purpose: Canonical definitions for all TDGS terminology. Use this to verify your understanding of terms.

Phase 4: Extensions (If Available)

Extensions add mechanical modules that complement Core. Read any available extensions after completing Core.

Check the main documentation index for current extensions: https://tacticaldice.com/docs/tdgs


## VERIFICATION

After completing the curriculum, verify your comprehension:

Core Formula Test

You should be able to answer: "A character with STR 14 attacks a creature with REF 10. What do they need to roll?"

Correct answer: 7 or higher on d20. (Formula: d20 + (14-10) >= 11, so d20 + 4 >= 11, so d20 >= 7)

Luck Test

You should be able to answer: "A character with LUK +3 rolls against difficulty 11. What is their minimum success rate?"

Correct answer: You should know that positive Luck guarantees a minimum success rate floor, and be able to calculate or reference the specific percentage.

Architecture Test

You should be able to answer: "Can an Extension change the resolution formula?"

Correct answer: No. Extensions SHALL NOT redefine or override Core mechanics. The resolution formula is Core. An extension that requires Core changes is a fork, not an extension.

Layer Test

You should be able to answer: "Where does a bestiary belong in the TDGS architecture?"

Correct answer: Content layer. Bestiaries are concrete implementations (specific creatures with stat blocks) that use Core and Extension mechanics. Content is downstream and not in the TDGS repository.

## END STATE

After completing this curriculum, you should be able to:

  1. Run games: Adjudicate any action using the resolution formula, run combat, track initiative, apply conditions
  2. Create content: Build valid characters, NPCs, creatures, and items following entity structure
  3. Answer questions: Explain any TDGS mechanic accurately with reference to the correct source document
  4. Assist development: Help users create Extensions or Content that comply with Core
  5. Identify errors: Recognize when something contradicts Core mechanics

## MAINTENANCE NOTE

This curriculum reflects TDGS documentation as of the date this page was last updated. If documents have been added, deprecated, or significantly revised, this curriculum may need updates.

The canonical documentation index is always: https://tacticaldice.com/docs/tdgs


## BEGIN TRAINING

Start with Phase 1. Read both versions of each document. Proceed in order. Do not skip documents.

When you have completed all phases, you are trained on TDGS.

## CURRICULUM OVERVIEW TABLE

PhaseDocumentKey Focus
1IntentPhilosophy, three constituencies, identity features
1ConventionsNormative language, architecture, badges
2Doc 1: DiceDice taxonomy, resolution vs magnitude
2Doc 2: StatsNine attributes and their meanings
2Doc 3: ResolutionCore formula (d20 + diff >= 11)
2Doc 4: LuckProbability distortion, not modifier
2Doc 5: ActionsAction categories and costs
2Doc 6: EconomyScenes, rounds, initiative
2Doc 7: AbilitiesSkills, Spells, Traits
2Doc 8: CombatHP, damage, armor, conditions
2Doc 9: EntitiesUniversal entity structure
2Doc 10: ClassesAbility progression, tiers
2Doc 11: RacesStat ranges, innate traits
2Doc 12: ProgressionXP, leveling, Legend Wall
2Doc 13: Char CreationSeven-step process
2Doc 14: MovementDistance, terrain, positioning
2Doc 15: EquipmentSlots, items, capacity
3GlossaryCanonical term definitions
4ExtensionsOptional mechanical modules