TFR-Trainer-Fame-Reputation v1.0.0

[TFR] Trainer Fame & Reputation

Version: 1.0.0 | Engine: Pokemon Essentials v21.1

Tracks how the player plays — not just what they've beaten. Builds a Fame Score from battles, catches, exploration, and achievements. Unlocks Reputation Tags and Titles that display on the back of the HGSS Trainer Card.

---

Features

• Fame Score — Accumulates from trainer wins, wild battles, catches, badges, Hall of Fame, win streaks, and surviving low HP
• Title Tiers — Rising Trainer → Seasoned → Expert → Elite → Pokemon Master → Living Legend
• Reputation Tags — Achievements earned by playstyle: The Champion, The Survivor, The Veteran, The Completionist, The Wanderer, The Hunter
• Trainer Card Integration — Adds Fame Score, Title, and earned Tags to the back of Mr. Gela's HGSS Trainer Card (if installed)
• DexNav Integration — Awards the "The Hunter" tag for long DexNav chains (if DexNav is installed)
• LWN Integration — When a new title tier is reached, a news item is automatically posted (if Living World News is installed)
• Load-Order Safe — Uses Ruby prepend so it works regardless of plugin load order

---

Requirements

Plugin	Version	Required?
Pokemon Essentials	v21.1	YES
v21.1 Hotfixes	v1.0.9+	Recommended
Mr. Gela's HGSS Trainer Card Scene	any	Optional (for fame display on card)
[TMS] Tamas's DexNav	v1.2.0+	Optional (for "The Hunter" tag)
[LWN] Living World News	v1.0.0+	Optional (for fame milestone news)

No other plugins are required.

---

Installation

1. Copy the [TFR] Trainer Fame & Reputation folder into your game's Plugins/ directory.
2. Launch the game once to compile — fame tracking starts automatically from a new game.
3. No map events or script calls needed — it runs entirely in the background.

---

How Fame is Earned

Action	Points
Win a trainer battle	+10
Win a wild battle (defeat)	+3
Catch a new Pokedex entry	+8
Earn a gym badge	+100
Enter the Hall of Fame	+500
Own 50 Pokedex entries	+50
Own 100 Pokedex entries	+50
Own 200 Pokedex entries	+50
5-battle win streak	+25
10-battle win streak	+60
20-battle win streak	+150
Win battle with Pokemon at ≤10% HP	+20

---

Title Tiers

Fame Score	Title
0	Rising Trainer
501+	Seasoned Trainer
1,501+	Expert Trainer
3,501+	Elite Trainer
7,001+	Pokemon Master
15,001+	Living Legend

---

Reputation Tags

Tag	How to Earn
The Champion	Enter the Hall of Fame
The Survivor	Win 5+ battles with a Pokemon at ≤10% HP
The Veteran	Win 100+ trainer battles
The Completionist	Own 50%+ of the regional Pokedex
The Wanderer	Visit 30+ unique map locations
The Hunter	Achieve a DexNav chain of 25+ (requires DexNav plugin)

---

Trainer Card Display

If Mr. Gela's HGSS Trainer Card Scene is installed, flip to the card back (press the Special button) to see:

• FAME — current score
• TITLE — current title tier
• Tags — up to 3 earned reputation tags (★ symbols)

The fame section replaces the "STRING 2 / STRING 3" placeholder rows on the card back.

---

Configuration

Edit [TFR] Trainer Fame & Reputation/000_Settings.rb to adjust:

LWN_INTEGRATION  = true   # Post milestone news to Living World News
SHOW_TAGS_ON_CARD = 3      # How many tags show on trainer card back

FAME_TRAINER_WIN  = 10    # Points per trainer battle win
FAME_CATCH        = 8     # Points per new Pokedex catch
FAME_GYM_BADGE    = 100   # Points per gym badge
# ... etc

---

File Structure

Plugins/[TFR] Trainer Fame & Reputation/
  meta.txt                Plugin metadata
  000_Settings.rb         All configurable values and tag definitions
  001_FameData.rb         Save data class (FameTrackerData + SaveData.register)
  002_FameCore.rb         Core: award(), check_all_tags(), milestone checks
  003_BattleHooks.rb      EventHandlers hooks for battle start/end and catches
  004_OverworldHooks.rb   EventHandlers hooks for map visits and DexNav chains
  005_TrainerCardPatch.rb Adds fame section to HGSS Trainer Card back

---

Credits

Created for Pokemon Forever.
Built on Pokemon Essentials v21.1 by Maruno.
HGSS Trainer Card by Mr. Gela & DeepBlue PacificWaves.