PIN Examples
Quick implementation guide for Piece Identifier Notation v1.0.0 with direct assignment and state modifiers.
Direct Assignment
Basic Assignment
| State |
Character |
PIN Identifiers |
Interpretation |
| (none) |
K |
K, k |
First/second player king |
| + |
K |
+K, +k |
First/second player enhanced king |
| - |
N |
-N, -n |
First/second player diminished knight |
| (none) |
P |
P, p |
First/second player pawn |
| + |
P |
+P, +p |
First/second player enhanced pawn |
State Modifier Examples
| Character |
Inherited State |
PIN Result |
Usage Context |
| K |
Normal |
K/k |
Standard king |
| K |
Enhanced |
+K/+k |
King with special privileges |
| R |
Enhanced |
+R/+r |
Rook with expanded capabilities |
| P |
Diminished |
-P/-p |
Pawn with vulnerability |
| S |
Normal |
S/s |
Standard silver general |
| S |
Enhanced |
+S/+s |
Promoted silver general |
Traditional Games
Western Chess
| Character |
PIN Identifiers |
Interpretation |
| K |
K, k |
White/black king |
| Q |
Q, q |
White/black queen |
| R |
+R, +r |
White/black rook (enhanced state) |
| P |
-P, -p |
White/black pawn (diminished state) |
| N |
N, n |
White/black knight |
| B |
B, b |
White/black bishop |
Japanese Shōgi
| Character |
PIN Identifiers |
Interpretation |
| K |
K, k |
Sente/gote king |
| R |
R, r |
Sente/gote rook |
| R |
+R, +r |
Sente/gote promoted rook |
| G |
G, g |
Sente/gote gold general |
| S |
S, s |
Sente/gote silver general |
| S |
+S, +s |
Sente/gote promoted silver |
| L |
L, l |
Sente/gote lance |
| L |
+L, +l |
Sente/gote promoted lance |
Chinese Xiangqi
| Character |
PIN Identifiers |
Interpretation |
| G |
G, g |
Red/black general |
| G |
+G, +g |
Red/black enhanced general |
| A |
A, a |
Red/black advisor |
| H |
H, h |
Red/black horse |
| C |
C, c |
Red/black cannon |
| S |
S, s |
Red/black soldier |
| S |
+S, +s |
Red/black river-crossed soldier |
Many-to-One Examples
Multiple piece names can correspond to the same PIN identifiers when they share the same character:
| PIN Identifiers |
Possible Piece Names |
K/k |
King, Knight |
P/p |
Pawn, Piece |
+P/+p |
Enhanced Pawn, Enhanced Piece |
S/s |
Soldier, Silver, Stone |
+S/+s |
Enhanced Soldier, Enhanced Silver |
Note: Context determines which piece name is intended when multiple possibilities exist.
