adhit-r / adhit-r/holocron

Lightsaber colors per Force user

Ouverte
#1 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
area: 3d good first issue lore-heavy
Langage dominant
TypeScript
Étoiles
0
Forks
1
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

> **Skills:** TypeScript · Three.js shader-material basics · OKLCH color tokens
> **Time:** ~4 hours
> **Good for:** R3F beginners · Star Wars lore fans who know their crystal colors
> **Difficulty:** Beginner-friendly

---

## Context

The galaxy view's `` colors lightsaber blades hardcoded:
accent-blue for Jedi, alarm-red for Sith. But canonically, Force users wield
many crystal colors — green (Yoda, Luke post-RoTJ, Qui-Gon), purple (Mace
Windu's Hurrikaine crystal), white (Ahsoka after redeeming captured Inquisitor
sabers), yellow (Jedi temple guards, Rey's hilt at the end of TROS).

## Goal

Move lightsaber color from a hardcoded prop to a per-entity field, so each
Force user's hologram is correctly tinted.

## Where to start

- `components/galaxy/HolographicFigure.tsx` — the saber blade material is set
conditionally on the `side` prop today
- `lib/schema.ts` — extend `Entity` with an optional `traits.lightsaberColor`
(OKLCH string or one of `blue | green | purple | white | yellow | red`)
- Wire a small lookup table in `lib/data/lightsaber-colors.ts` keyed by entity id
- `data/build/kb.json` is regenerated by `npm run build:kb` — merge the lookup
into the build output

## Acceptance criteria

- Yoda's blade renders green, Mace Windu's purple, Ahsoka's white
- Default fallback to side classification (Jedi blue, Sith red) for unspecified
- Reduced motion path preserved
- A note in the schema documenting the field

## Lore reference

https://starwars.fandom.com/wiki/Lightsaber_color_crystal

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Start with components/galaxy/HolographicFigure.tsx and lib/schema.ts to trace the current side-based color and Entity shape. Add the lookup in lib/data/lightsaber-colors.ts, then run npm run build:kb to update the generated data/build/kb.json. Done means the named characters render with their specified colors, unspecified entities retain the side fallback, reduced motion remains intact, and the schema documents the field.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
react, three.js, typescript
Domaine
build-system, computer-graphics, data-visualization, frontend
Type d'issue
Fonctionnalité
Difficulté
3/5
Temps estimé
Une demi-journée
Activité
Calme
Clarté
Clairement spécifiée
Accessibilité débutants
68/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.