From f935adb70e1dd3868eaeccf7a2a267fe2ce09e37 Mon Sep 17 00:00:00 2001
From: tresabhi <43380238+tresabhi@users.noreply.github.com>
Date: Sun, 11 Oct 2026 16:27:53 -0500
Subject: [PATCH] start of port

---
 .../index.module.css                          |   4 -
 .../TankopediaCharacteristics/index.tsx       |  21 +-
 .../src/components/TankopediaToys/index.tsx   | 229 ++++++++++++++++++
 packages/website/src/config/toys.ts           |  11 +
 packages/website/src/types/characteristics.ts |   5 +-
 5 files changed, 260 insertions(+), 10 deletions(-)
 create mode 100644 packages/website/src/components/TankopediaToys/index.tsx
 create mode 100644 packages/website/src/config/toys.ts

diff --git a/packages/website/src/components/TankopediaCharacteristics/index.module.css b/packages/website/src/components/TankopediaCharacteristics/index.module.css
index 3a25ee318..4f13ede57 100644
--- a/packages/website/src/components/TankopediaCharacteristics/index.module.css
+++ b/packages/website/src/components/TankopediaCharacteristics/index.module.css
@@ -135,10 +135,6 @@
             width: 100%;
             height: 100%;
 
-            display: flex;
-            align-items: center;
-            justify-content: center;
-
             background-color: var(--gray-2);
             outline: var(--gray-5) solid var(--space-1);
             border-radius: var(--space-3);
diff --git a/packages/website/src/components/TankopediaCharacteristics/index.tsx b/packages/website/src/components/TankopediaCharacteristics/index.tsx
index 8d0147d5c..0e8df4ea6 100644
--- a/packages/website/src/components/TankopediaCharacteristics/index.tsx
+++ b/packages/website/src/components/TankopediaCharacteristics/index.tsx
@@ -2,6 +2,7 @@ import { TIER_ROMAN_NUMERALS } from "@blitzkit/core";
 import { literals } from "@blitzkit/i18n/src/literals";
 import { useRef } from "react";
 import { characteristicsGroups } from "../../config/characteristicsGroups";
+import { toys } from "../../config/toys";
 import { useCharacteristicRenderer } from "../../hooks/useCharacteristicRenderer";
 import { DuelModule, useDuel } from "../../hooks/useDuel";
 import { useRankings } from "../../hooks/useRankings";
@@ -14,6 +15,7 @@ import type {
   CharacteristicReturnType,
   CharacteristicsGroup,
   ComputedCharacteristics,
+  ToyName,
 } from "../../types/characteristics";
 import { Heading } from "../Heading";
 import { SegmentedControl } from "../SegmentedControl";
@@ -107,7 +109,9 @@ function Group({ group, characteristics, rankings }: GroupProps) {
       >
         {group.order.map((item) => (
           <>
-            {"toy" in item && <Toy {...item} />}
+            {"toy" in item && (
+              <ToyAssigner characteristics={characteristics} {...item} />
+            )}
             {"label" in item && <Label {...item} />}
             {"name" in item && characteristics.has(item.name) && (
               <Item
@@ -257,15 +261,22 @@ function Bar({ value }: BarProps) {
   );
 }
 
-interface ToyProps {
-  toy: string;
+interface ToyAssignerProps {
+  toy: ToyName;
+  characteristics: ComputedCharacteristics;
 }
 
-function Toy({ toy }: ToyProps) {
+function ToyAssigner({ toy, characteristics }: ToyAssignerProps) {
+  const Toy = toys[toy];
+
   return (
     <div className={styles.toy}>
       <div className={styles.sandbox}>
-        <Text lowContrast>{toy} toy</Text>
+        {Toy ? (
+          <Toy characteristics={characteristics} />
+        ) : (
+          <Text lowContrast>{toy}</Text>
+        )}
       </div>
     </div>
   );
diff --git a/packages/website/src/components/TankopediaToys/index.tsx b/packages/website/src/components/TankopediaToys/index.tsx
new file mode 100644
index 000000000..52e548cff
--- /dev/null
+++ b/packages/website/src/components/TankopediaToys/index.tsx
@@ -0,0 +1,229 @@
+import { isExplosive } from "@blitzkit/core";
+import { useRef, useState } from "react";
+import { degToRad } from "three/src/math/MathUtils.js";
+import type { ToyProps } from "../../config/toys";
+import { DuelModule, useDuel } from "../../hooks/useDuel";
+import { useStrings } from "../../hooks/useStrings";
+
+export function RicochetToy({ characteristics }: ToyProps) {
+  const strings = useStrings();
+
+  const shell = useDuel("protagonist", DuelModule.Shell);
+
+  const container = useRef<HTMLDivElement>(null);
+
+  const normalization = degToRad(
+    (characteristics.get("normalization") as number) ?? 0,
+  );
+  const ricochet = degToRad((characteristics.get("ricochet") as number) ?? 90);
+  const explodes = isExplosive(shell.type);
+
+  const [rawAngle, setAngle] = useState(degToRad(-25));
+
+  const angle = explodes ? degToRad(-70) : rawAngle;
+  const doesRicochet = Math.abs(angle) >= ricochet;
+  const effectiveAngle = doesRicochet
+    ? -angle + Math.PI
+    : Math.sign(angle) * Math.max(0, Math.abs(angle) - normalization);
+
+  const armorPercentage = Math.min(999, 100 / Math.cos(effectiveAngle));
+
+  return (
+    <Box
+      onPointerMove={(event) => {
+        event.preventDefault();
+
+        if (!container.current || explodes) return;
+
+        const rect = container.current.getBoundingClientRect();
+        const x = event.clientX - rect.left - rect.width / 3;
+        const y = event.clientY - rect.top - rect.height / 2;
+        const angle = clamp(Math.atan2(-y, x), -Math.PI / 2, Math.PI / 2);
+
+        setAngle(angle);
+      }}
+    >
+      <Box
+        width="33%"
+        height="100%"
+        position="absolute"
+        top="0"
+        left="0"
+        style={{
+          background: `linear-gradient(to right, transparent, ${Var("gray-a4")})`,
+        }}
+      >
+        <Box
+          width="100%"
+          height="100%"
+          style={{
+            opacity: 2 ** -3,
+            backgroundImage: `url(/assets/images/tankopedia/visualizers/ricochet/armor-hash.png)`,
+          }}
+        />
+      </Box>
+
+      <Box
+        left="33%"
+        top="0"
+        width="67%"
+        height="100%"
+        position="absolute"
+        style={{
+          background: `conic-gradient(
+              at 0 50%,
+
+              ${Var("ruby-a2")},
+              ${Var("ruby-a1")} ${Math.PI / 2 - ricochet}rad,
+
+              ${Var("jade-a2")} ${Math.PI / 2 - ricochet}rad,
+              ${Var("jade-a4")} ${Math.PI / 2 - normalization}rad,
+
+              ${Var("cyan-a5")} ${Math.PI / 2 - normalization}rad,
+              ${Var("cyan-a3")} ${Math.PI / 2 + normalization}rad,
+
+              ${Var("jade-a2")} ${Math.PI / 2 + normalization}rad,
+              ${Var("jade-a4")} ${Math.PI / 2 + ricochet}rad,
+
+              ${Var("ruby-a1")} ${Math.PI / 2 + ricochet}rad,
+              ${Var("ruby-a2")} 180deg
+            `,
+        }}
+      />
+
+      <Box
+        position="absolute"
+        left="33%"
+        top="50%"
+        height="18rem"
+        style={{
+          transformOrigin: "top center",
+          transform: `translateX(-50%) rotate(${-Math.PI / 2 - angle}rad)`,
+        }}
+      >
+        <Box
+          position="absolute"
+          width="1px"
+          height="100%"
+          bottom="100%"
+          style={{
+            transform: "translateX(-50%)",
+            backgroundColor: Var("gray-a8"),
+          }}
+        />
+        <Box
+          position="absolute"
+          width="3px"
+          height="100%"
+          style={{
+            transform: "translateX(-50%)",
+            background: `linear-gradient(${Var("gray-a11")}, ${Var("gray-a4")})`,
+          }}
+        />
+
+        <img
+          src={alias("api", `/icons/shells/${shell.icon}.webp`)}
+          style={{
+            objectFit: "contain",
+            transform: "translate(-50%, -50%) rotate(-45deg)",
+            position: "absolute",
+            width: "2rem",
+            height: "2rem",
+            top: "6rem",
+            left: 0,
+            filter: "drop-shadow(0px 0px 0.25rem black)",
+          }}
+        />
+      </Box>
+
+      <Box
+        position="absolute"
+        left="33%"
+        top="50%"
+        height="16rem"
+        style={{
+          transformOrigin: "top center",
+          transform: `translateX(-50%) rotate(${-Math.PI / 2 - effectiveAngle}rad)`,
+        }}
+      >
+        <Box
+          position="absolute"
+          width="3px"
+          height="100%"
+          top="-100%"
+          style={{
+            transform: "translateX(-50%)",
+            background: `linear-gradient(${Var("gray-a4")}, ${Var("gray-a11")})`,
+          }}
+        />
+      </Box>
+
+      <VisualizerCornerStat
+        label={strings.website.tools.tankopedia.visualizers.ricochet.angle}
+        value={literals(strings.common.units.deg, {
+          value: radToDeg(Math.abs(angle)).toFixed(0),
+        })}
+        side="top-left"
+      />
+      <VisualizerCornerStat
+        label={
+          strings.website.tools.tankopedia.visualizers.ricochet.normalization
+        }
+        value={
+          doesRicochet
+            ? "-"
+            : literals(strings.common.units.deg, {
+                value: radToDeg(
+                  Math.min(normalization, Math.abs(angle)),
+                ).toFixed(0),
+              })
+        }
+        side="top-right"
+      />
+      <VisualizerCornerStat
+        label={
+          strings.website.tools.tankopedia.visualizers.ricochet.effective_angle
+        }
+        value={
+          doesRicochet
+            ? "-"
+            : literals(strings.common.units.deg, {
+                value: radToDeg(Math.abs(effectiveAngle)).toFixed(0),
+              })
+        }
+        side="bottom-left"
+      />
+      <VisualizerCornerStat
+        label={strings.website.tools.tankopedia.visualizers.ricochet.armor}
+        value={
+          doesRicochet
+            ? "-"
+            : literals(strings.common.units.percentage, {
+                value: armorPercentage.toFixed(0),
+              })
+        }
+        side="bottom-right"
+      />
+
+      {explodes && (
+        <Flex
+          p="3"
+          justify="center"
+          align="center"
+          height="100%"
+          width="100%"
+          position="absolute"
+          top="0"
+          left="0"
+          style={{
+            background: `radial-gradient(${Var("black-a7")}, ${Var("black-a11")})`,
+          }}
+        >
+          <Text color="gray" align="center">
+            {strings.website.tools.tankopedia.visualizers.ricochet.no_ricochet}
+          </Text>
+        </Flex>
+      )}
+    </Box>
+  );
+}
diff --git a/packages/website/src/config/toys.ts b/packages/website/src/config/toys.ts
new file mode 100644
index 000000000..2fdb6e8c4
--- /dev/null
+++ b/packages/website/src/config/toys.ts
@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+import { RicochetToy } from "../components/TankopediaToys";
+import type { ComputedCharacteristics } from "../types/characteristics";
+
+export interface ToyProps {
+  characteristics: ComputedCharacteristics;
+}
+
+export const toys: Record<string, (props: ToyProps) => ReactNode> = {
+  ricochet: RicochetToy,
+};
diff --git a/packages/website/src/types/characteristics.ts b/packages/website/src/types/characteristics.ts
index 730ccf9a4..a74da634e 100644
--- a/packages/website/src/types/characteristics.ts
+++ b/packages/website/src/types/characteristics.ts
@@ -11,6 +11,7 @@ import type {
 } from "@blitzkit/protos";
 import type { ReactNode } from "react";
 import type { characteristics } from "../config/characteristics";
+import type { toys } from "../config/toys";
 import type { DuelSide } from "../hooks/useEquipment";
 import type { TankEnvironment } from "../stores/tankopedia";
 import type { TankState } from "../tankopedia/tankState";
@@ -99,9 +100,11 @@ export interface ToyRenderConfig {
 }
 
 export interface LabelRenderConfig {
-  label: string;
+  label: ToyName;
 }
 
+export type ToyName = keyof typeof toys;
+
 export type CharacteristicsGroup = {
   name: string;
   order: (CharacteristicRenderConfig | LabelRenderConfig | ToyRenderConfig)[];