Rolling on a string. The string contact point on the axle is momentarily at rest, so v = ω r with r = axle radius + string radius. The cross-section shows this: the centre moves at v, the opposite side of the axle at 2v, and the rim of the disc at v (1 + R/r) at its far point.
Moment of inertia. I = k Md R2 + ½ maxle ra2 (solid disc k = 1/2, rim-weighted up to about 0.8; axle 4 % of the mass).
Equations of motion. M a = M g - T - Fair, I α = T r, a = α r. Without losses: a = g/(1 + I/(M r^2)) and T = M g I/(I + M r^2), always below the weight.
Energy. M g L = ½ M v2 + ½ I ω2; the fraction going into spin is (I/(M r2))/(1 + I/(M r2)). Fall time with throw speed v0: t = (-v0 + sqrt(v02 + 2 a L))/a.
Tied string. At the end the string leaves on the other side; angular momentum about the new contact point is conserved: ω' = ω (I - M r2)/(I + M r2) = q ω. Frictionless climb height q2 L.
Sleeper. The loop slips; I dω/dt = -μs M g r - c ω. A tug makes the string bind and gives ω' = ω I/(I + M r2); the yo-yo then climbs at v = ω' r.
Losses. String-axle friction torque μ T r (factor 1 -/+ μ on the inertia term, down/up) and air drag ½ ρ Cd A v2 with Cd = 1.1 (illustrative). Fixed-step RK4, 0.5 ms.
Independent checks. A loss-free copy of the integrator is compared with the closed forms: descent time, bottom speed, energy, tension from both Newton equations, angular momentum across the bounce, climb height q2L and the sleeper decay.
Simplifications. Constant effective radius (a real yo-yo winds string in layers), massless inextensible string, fixed hand, plastic bounce at the string end, illustrative friction constants. The yo-yo is drawn about three times larger than real size. Sprites rendered in Blender; the model core is the same file as in the 3D page.