diff --git a/CHANGELOG.md b/CHANGELOG.md index 9d39dc8..ec377ed 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -43,6 +43,9 @@ Conventional Commits. - Project skills for 4D geometry, headless visual verification, and production readiness. - Shape catalog documentation (`docs/shapes.md`). +- **Wave 5 — scripting + audio integration:** `ScriptSystem` (`src/systems/script.rs`) owns a `ScriptEngine` and an optional `AudioEngine4D`, drives `on_init` / `on_update` / `on_fixed_update` / `on_shutdown` from the app loop, and runs a fixed-step accumulator. `update` runs before `SimulationSystem` so scripts set velocities/transforms before physics. `AppConfig` gains `GameConfig` + `AudioConfig`; `--game
(*5D^bG=mFc4KtXID;pm^KI *f zA_oKx-#*E4< 1dDi1E z4z4?pdHCJQ%a^Mjh`rzUuawVO)=I0(q~H3cor&EV%TB`pwapTJoL7F |X*<+*#O_q!Wxe~NZ#DmvadS%jP%AaOVX?+$v(0;pxrT=7p;Fhl=l+@d_SpSz zmtUSTII4E|)sci#dY4b$D|r+4yN>IR#B rQ>W#B $S|I*gG>t6l*v620?=n z>P~DwI^`JW=`)v-?#jQi_;HHut;jyb0-XqxpB7wJ73Kwofg0;&T=-uw zG=BQ>MEd6D^Fb%$j dO__J+wt<_g{L=PI(bL%< 4j>n`sF4I&Eidu8z^hO zmpd!e$ola6kyrojd0%xq7kBF7$rWd|T$*xw=d*&(Zy6%_?n-S?Rn^;O%w_i1WPyRD zrh|N_usPe#9~)nPx^H?-;ym|h|5NYI?7x(B+wa-sPwEWiyl*5AsJQ8VH7YipX;Nz7 zt=TJoL-++-@6Xw99zBq|{_6a$)8|i_pFMlY 5`Aj|Lx%xk$A4urCns`XmZ+E z!XQOcTH%t29f#KM)OULxy}HqJQT*(s(-+Tvy7c>Qmv5Z~s2w(h>isxK?X}!7}4S z (&-PPrlgwOI z9i4Cb2Mp@;LNuo;?i0`BiC}R2^85wUeZA|iE_R&Pzi|1o<*nb3dfqzzjAvC7ydiy3 zB}Y44-`l`S&sB4eqLjpU9(G3Vulrx#y#Mq1>`NjS`Y!yttbc3wBdNE`ek^7Q6=0D5 zuDn)jyWSQ3&$`B%4;2d~YI!#^Ui>=w)%pjAZ}?nZc;Vdzoh$0M>K?6m!}sGga|gec zl)CbJO>w;#{Z+bhnv6 qHOq7#=_Tm0YsxE$N!IfHXA1dl`X=;I@U691_Fdd^vHyzVErCaOUcda-!t|B5 zRiaC=MB}PXx}LD^TMbL4WXT_V^O*&HFuhfKEO|Tjs_!MqOGmCK-Mag*@^#F&YmA1x z+r;-NY*#nYd82zo=YmFn(i+KpejAokKhC`U^7#I3zH4_cHC+0AMeWwQhf=REf7NEp z=XojiS^l@$B<+0N5}l12DN3ItAMsyfY4|z$-GL{I@9e#nclpI7)2n*7njh|e<@>dn zVFS0kn3lYQ+DEOAI*K~|8l_4mQb7Vatj510-giAsyPJFc|K*^|1y?O@ML$e`b^6PL z|6jPmMU&;)RQ i1-BOt`Z5^17=ow@e=jz4G~D z|KFNxlE_@yvnp#fKWUe1yJ++(t(Q_4>|>ko`_>1E=P&M^zM*_o^UAxcA-9Ad9(;N6 z^TL0voacpa%801&XclS9YfEcPReCPfBPhjg`Dfb4JI|Njue`bS>hvoH*V1l%eNg-| z@-zFtOB{T{;xaMHSsEX-j%j^RpQR)t{Z4QZ`-49LpXR+teV~5J;~Lx5;%im6Za&a_ z`Q%f = zx7r`bzcBe|^1F^TpFd6Fs=TXeyvApZZ))92-=&ucOLKktf9k8p8 Rc@(I)Yz}qpd=;pMR)>ND?`b*e{Xg^(Yd$x=H~1A zH#BbNKUn*`;DhEbI~HEPpJF9)tSX`E`Wmfj#Y$E(_9BejqKwktH@?k%di7qwEsY!X zH+*lWKd5{z^kL=CMa&7ju3|@J)0EGvomTf$OI8Y(X%{KrUd(vld*VC!XSMgA+?sde z!i|#Ki4WYL?|85MlaqNX&ty??+2cx{YH8{`YJp0HGG|0?bL%lB{SbJ6{+Y^yirb<$ zm2S?x9rr-;dBXb*KZ==ncpi&n$!IDaR%K8>t7@avDZ?k~%(IP&@#miRb)I8BhPlfJM!J1@i14Xu&DG~g>5Q^YM!dRN*iQ4MY(zRGMoS6`*{6@$RoqM zwYL;+soY6@Fz;FJyWsB!8I-v03*|@!D(I`6RAp2Bq P-TRt|v-2Uju z-EX%lZ-w5;c~JdK@!gYeW(+Ny=0Zm$x5}?jj#oXPa#iuH%n#9HygONve@A@Md=>RL z{9gX;OSd}ils<@hcJpoJxAp&Da7+}Gmz0!ORQ{?`sj^M+x{QvPJf9Kk*WW)sU3m5T z@ymNJZ|mINbEn~f&9f O}~i0 zv3|<);NG1_x3%uhd%*Eb@U8n-jepAQtN6{tePnwSH!06i_ECHxvrSBjzn5+H-}7H~ zzPb5y?t_TC_IHx+Zg}wN>6JInzpVZ{fsKcMn%EW@Rz+9k0A)4BmooRo()oY0Dg8_T z8u7O5neM~Ocjw-jclXGHdrxP+>H1>umyxZ2@4KjsOr63FB_`#+3NK_>#W(Y(voHVm z_v^Q}g3tFp^t<=x&aJz*9-Mue^hW>7jz7h$*Lb5u+oXTUXDMw_x~%X-Mnn8J|9N)J z{}aDWdbj4e&!bcKqVI~|`}APnQ{6W=K0E(;!D7d|PvnDCk^FDP6s6?~_hmfA9Ry4{ zR{mH1uJhjY#qCF~_jlh7zsK`%Wy5FqOek>!gZMp@n(S; z9I6bPz8`&m_eJL81NUX_O~0q{aQV~IuMIvY{=UU5!qY8$LNZNGR`HOcr@~p87V#qj zKRM ^g;fMM;H&GV{b4 z1;aSS8BhKA@PYGH%aiR79^8|;pZ0L()1udtKXv`O%JhjVPH3@2jI5o4wBj@Q%`#iX zZ3Q=R_A& KSe$nyq^7Z-NR+~m)>9XaLQAa*NmU`{=CI_lhZ=5Njz94R=!Z7R(_() zUGdd|30#FtvA-67I`mrYndT#|2XF45e>n9i e`mLO_f}4Du z%v @jjpcK>$Cn?}Jdk}f=jp*$79Z#QC}wct=;psAdP<5%E=T^V zT%ZhxguPHO_ZH^czums%y*>DR=3|S8M<2L7TJ&_utKT0SelRfXWBJMd>Zr0|AX!Kt^XX@(s;KBAC>Tw zVV8R%`&e2<;;~REj|1!Ozfs?&zQ6gh;pv4(UmpH?bpENwE9nofzj^;V!upU$SJ+kJ zhV&ZQrLu>m)g;)2xAV+n)%|ztoAig6S3jScKX!Vg_4xi%vsW+Q&-wP`uQzKf&kCXA z;u+F`vZ=C*q}3$Ug}?LsWS#pj^811h_g@u0oA-F)qnO7ZpQ^pu`QHCq{ogArcequA zJjB0CeU(v>ZID)xa1%D=4PxW|fAzca$Hdn!pRqi7@Tl)G%QMMW-S1hxN&k&!iRNA? zcv`GoYNpI1nHXsWiDcmd-W6=+{{wz3{rK>8;`8h$29FOtmVCzhD&hT}ue<-eVZO^H zFX$&GE@dk-U&c&YTB1&P74ILmhyPFhQ2mtn=En0&PZ}Tpc&z`7`IY(mvad0Js+beG z<_laBT`u`RI$B0RT3BM5@Izidb`J)JpG!X7f8+PU>glD&dQaS+{eH>+-smgCA8zJn zoC*Trq85_P(qb|%q_`y33XAd0V_(a#^{3+J*tbVsEPSf+B=t$cv#&2-z5DQG>F;?= zIh>35?~0s|P?NqWy-$ik;*hWh-)nY3MvY%{Ki_<7^^)UR*^{|Xs-Jy)dE(uMFTTHx znZ9zU@h6K!N}QDHmYyQ@S^SD{C7(G*5#!8X;$K4Ft$UgO?BtW{Pi8!O|8n`e;xFHS zonox#Sk3oZ__cVpl#6tR)HCs?!pr#@I4&}B{O ^kP%Ka~Tk4+VCUG7SHGV(N$4uUTK72L*Q2m hI-miXUU&TzhfwnbWhl=d7=| z-|2r=_*wh^A?q`4ZNV5(bBSI_FUcZtWs%AJTwITs>;5`@pYrkS8|#;1&l{h$Jm-7$ z{Vl`i8$Xo(m$Q~|?-ckbazornQd}}hTtj3Fzblt9%Y(lgzO#L@eY@~w&hvxMRy~(| z_4MuKPm_O~_{Y!6!tEi@CQ>E-P2#bHgSeK+CH^|DCKktkGC#^ct$xe)>fm#x=a-(V zzPk2y#V7wCh5uHtOy#=4FD)V?zDi=9gqpav$b0@RTo+gt{A>U5?33iX>{sG1oS*-G zZv5)_+xky@KcxS;uxM~)@^2E}Cl)7BA;BrGEy5-6l1rNP@4xpyLO!>?JO3*8MeB2w z7f!Eszm52G?)&k-51IFH{^s)#P7o86aFlo>rYWK Xzp zt7|V uur5 ps`!D)Yc(H&Fk0JXK#{a)(eLM5< z@mtx~%U(`>`RdigxA7mvzGeMpW1PsgiCbKtQh2dwk=RYq$HMCc3VCwaKQc!B`TNcA zlgqo}*Kb}Pd&&BG@>} Zir;PQEsJ_4B2|>uGNdKkoec^j8AIRn|9LLHvh>*hGJbc8eYrJ|wV(=MH-t6ZhZ! z-+z2!elPc?@|Dgj+t;(+%6{zoy7U)6LnUh$*GIk#q3t5OMUzA~3!fCY!XwCWjw$i4 z+>fZwiSLWw?0=Q;D*E+;w_G1nzNY;;_+O4ylWPJWuTZ8)t*E8wLgDiQA9-9kM47k! zt^Tp=^ZxfI->|)&@~ZOn^0z-f*nHLcRr3ER%PCGnzRiMCB6gyDqP@ab1bBJNIii?3 z|K0c@^+o1`+*`lbCtuBcz5ea1529b+|J3-O%aYA`i8o5{wD5nC$0C)&*9A0qmvhWz zj{0Z(v+_&jhoZMrU;lr#>-CPecRqahvi0Y^f8s2BoF%-Bg0;d2M7E103*QiM WtT?cLX=uW!FT{Pz5ZvtR0dPWyL=c@u{i?+O7u;YN{e5g*~30uj8- zoN_Eb|2_R_^3~v@^gER|Ij{e{KL7T}ht*#^e)|8*XO7_5#S %lJedzuo{FC#aEb~A1c%C2p6NMN>3`C@buL?Br zMsUt#ne>0suUB86emwMU%bVM;UEjQZyYWNrmj^$N{yoFAjGcvNA-}WG0bxcFM&U~W zQ+XRWudv+t|NNKBH@i=w@Bh3Jev|d)*V|Pe0=}&O(fqfT$)9}{w>SS+!3N<=!q0`y z3M}Vc&dJNF!eI4#&bMiwGTytq^?5Vl4cEJ+A56Z~|8V-N&-9Zmi2EzwazT6HMZ%|r zjtgw(J;UkBn$6Jj`^&d?pLV_Pe%tzH+Z&m83qDAF3H-tQ_Yva~wqIQH`Jx2>2^9&i z6FMMpjQ0a)4eJJmJHNfYyME^RaQW@NH+SFYznlAk@r&w@qkpC|2CyyW^5WwW+$-cL zJW*)7z-3+`t_`eT8Fc iA~zIXodWBkYJ%k_ %*1L7ry)bVPjm&`h#;3Z;^nN z&^@7Gp~V8Pc!Rja*eV&1{c-={`i0@+>UTMB!{6q-oBiRy=M~>Y|LkXoWnIGQNl% zLvXc_vCs^G&%6a(ZfrXlh5pX^G4o5n$4~E;y={Ek{BG`twVxZm-~C<5z{eWE`IqM= z|8~I&At9k|f#1A6T%~N^8Dsvw{_*C^f{#}3AHH4vcGkNEA7+1!`M&(ODZ>Gle;liM zdihHQU4=dh)(SB3E$3RqX2P`euk}y6ukSxLzL$A-?d_&_OFndew)kH3`}6-2mbDyF zJdXUvf`tppAWwFeB%Ew`JL{&XYba3$ou^D8_(~e|M!@A zId*Zc=G!2!Qm{kNPk^8A1D6u}W2W+dD!&ZA-TV~x;oQ5ZcMR{he@Og%_1o=V#{Z`= z?`O~EPT 2Z*v=I>GW99Z@mtx-iui#hxH}%hRKXAQoe<$;P|A(;8+rO>(_3fV@ za}m2Nw-}$UfP fidjRv_f4hF2{Z{<>@dvl}Ti#i`Kk>om^Q>=mzjpoO zU{+;6&vl0PH9xnYq@b995T7phRQ6V8yZJSMpyK_$ bKQTR-)Y~uzvO@1_g?UQ@%wuptUsrGQ~Txm zua2po&78}UH-mqHz*&K}{Cs@=+_%|ZGw=OB`S+&pVPCd>{Po`c{lxdLKA3#={`Ti5 z?>}oMH@4TDA9>XIvjmn2T<7QJi{t*wF3s}m|E=GDzAyOl>!aC+y!RX4|M;N)+4$R) zpV$8WV*JaxkaH!^Gd>f6I)MZH?0mW0G92D4W(@Lw+ 3v4OCdw@pZ*_4Ut2z{`*8OC$M>Qi)jzX; zYx|k=w~DcVm5)=3Cx!1gzplVU{@=W<+z}khSXMDC`*ZC__16=hUVZrcUhsqJN7c`t zzb5^({A YKB=i#qBpVdC @Hy#Y+=tK)?jKb? zpZ_ZJ^ZK8|42xLIIXt)*^D6Ui 9SjL9AK96>lX>6pwexH8-{4)veUQVKwUu$%-?u-feY^Jg=EnmcW`D@} zsQ!7~*V{iT|M)S;v8-X=$ED1>jW33um;Ws92JRaiC9FFcpZqoWb^Dvd7tv22KkWO^ z@KN*gg0Fji`1}!LxW}BqUd8o olB{7e3O)R(|dN*^D6 znEFxo^W?Ade<=RB|9?KS3cDHCQXUUJHvTJoTX=VJGjr}^m0^nhx8+yz_c>pBK81W_ z|G4U-(dYKB%|E{VUim+P`61h9&NLoDzT14;`IhtU nk;`qytHo!-m&tp8JBBlfjfuJB|GVF-f871L z`Lpk*BOm2Hg?*0v%J#$f_v(M pAtR?fBpEK|9ADj|BOkj`5d3QPVijh{mtvfyNA1+b2eKT^WFbxe>8ta zeN+Fk>66f>z)#tq{l4D${^pnOzvGOmtOgw0xhC-}=Do#h%)67jg>xHQ9Wy_}f x ;p`n>Ve-cNHsJAa+}J@?nVzn>W_S*+Pla_-`O#}mx^m}d$18cs=eQI-n~ z4S&Obb$xgJy5{rEPd7iU{_OO%^?SgtlD`KS7+DzD`#D><5AYc9p5>X#y_r*=-Gb#G z!`8o(ejWW@_x0Xqrq5qL?fUHWwfwvBFQ32t3@4e7vW0T`aZl#q<=xIRm3tSb3wsoc z7UQeGr++d0*!ET6i}q)s&nG{-e9inW@k{k@9K%HBZZ>I7N$ymhS3C=Ndbkg8MzB}0 zgfYtfWBG0M T61f2e*d`BMAY@AIqA9$y2$KmB>@4+Dc5vn1O}j`dueJd1b=c`CV2a@Ml% zWLeGF{IB@;njbOWmVH_FIp_1A&puz>zMuWM?a$@^ADJGo7IIW^-R7?2iR8)SKEv6^ zex2nC (>D%=$=RbFU=KB)x)%N?=pOgM9`@ffIC94&O8`oOyC>{r%B<}N^ z^Vq+z{APUm@BVL@pC`X@e*O7*)n|n-p Z|gXlb?;hM19ry-u2V}kN^J&CL7i>?Dsf>xCMB4c|5r< za_(W*X7yll`tR|l>!->0?5{pwUVe7}lK55Sd)ZI@KdS%Lnb=vUvajM);eO5incIf@ zBIikVSJqsng8wyt4*bmgKId!M7tSxyUoyVReNXx+@aNCJZ;Y2%64=W*zi}PozR9h} zeSz~DdmQUTrnu{rUQH-uJU#7kttDQt+kVtK|29pC5l;{&$>l9*Z`+3+G9$1>F0% z<+;yuK4dRr-NJP8|ARkTzb<|M_x02luP?1%D!z(*xBGeJ_nLn*7_(Tuu?cd{=Bnmi z%q_rumh%mJAM16dFaHJq#{FXZq4({}m#i ^ zw{tUapW^(+zJ&D$lPrVN-$}nLf5d&0{o4Iy B zcQ*G2u49}G9J^R0nB5o({~rC7`=jrh``5K!j(?f@mFqj-&&J=@{{$GXGDovja|m;B za{F`N=Q_m6!Euh&f;pdI!Qbz{=Kt9Dt?=u)FZaGI_{#B};b;19@qbSlmN09ud2u}B ze9UFUeU57{rvS$z)^O%&4Cnr8{=WF*?YG%qKYaQ6WzAQP@1KA8{r>WI7efj2HiG zot%5QM7j5HZRZr@_{v(syqDqk->BcrKV`ok{VMpC_v? & E;VzDs-y`)c>~(pS#!=YMegp7_^};U!ZF zYX`eAr#IJLt`@FEoN62zY$up?80-JN{5|#O%I{9!D!zt&eejk0`_Uhte--`}XV}AJ z!WzNO&Z)vRpR0gt7N-`61>0lh0LGR7#Qz-qdHs9Nw^?8FzrOp*`+d)kd%uGIe*E9h z#LBA4ew*VTXCqe(*F;WT4tKUc%tefs{<;47@{{$))Ngygc7FZ)Rp9&PAE$nq{yqIa zndutKFShj@H#n2IJh(bI4LCyCL|LXV{{C0=NBNi0kNw~7e_i~Q=bOm))jziXlK8vq zzXj6@mNRV49Gf^@xs18$IE^@x*mPO8GAjR{|0nQQ{Ervkn7-}(D*a9J`;s3^fBpW` z^q-HZie(;K1V=Zg8kZbb38yhf9-9lxRYvdsr~lOd>iHq~UG>}buR7o4zR&wH<=2Bh zasQt(`mz+V>2RcSvU728WpWyGRIx>|d|@p7|LxD(Ups$TefRkG@vF@@(|pC$=|cT@qF|BrulvHkK$je z|49Cy%=ndAob5WhB W&17ov-^ABH}!Av-weL@{Yd#W z>CcaUIgF>6U$d@Z|ID$H^BAWqrvb-IwizsbOb`B-{5AS*`*X|pjo+NU6?`-Q-u)x= zSJj{E|6Cd8Gw)|@Vn55##kro-f>V!U5!-5(EGA}#xqoASXZ*bL{mQqvZ_VHAzjyrb z_?7%;`#*WcQs&955$wx3vN>mPYIEvvtYX{C(#E95aP)7-@5w(|e|-N|^=;}m_wTJg ztbh6Znep!@gAa2Cs~&qJhc{;fr!1!i$40jEEDM-C7~cNf^n345ogY%)r+!=UE#Q0e z54~Szf2#gnWl(0eV`XKJ=FsNM;N<62;n>0UfMpj`7K6yYJHMa*4EbUEedD*?-=e-Z z{ZRg;_$TJy28LfuBCL1VOgXqY12`Et6*%^>ePFr5)Wu-+kM)n>ubLkT-_LzJ|1J4@ z(+`PXJb&!}^)g&$dd0GtO@QMKhXv Ai`9sko$<`SrGK{klKA=hyTf;d z@BQCfe|-LV@b~4vYz&r6o-D#_)$BPOS2;FvFmYUFGiP;YR$+Yq@64Y&zwCbU{fPN) z`hE8IjvudoZuq_P@ALm6Oo}Y8S;N_VIQDQX;P}mcmCczohS`Bp=>Mlb%)e8A8vLmI z?)`nm_wFB0elGaE@bB^e9~gfzA7wRS*Wp;q(a-Uj{W_Z;Yaw$Cqsf2qzgoY$eg^-T z_C4YI*6)2k?){wbyYuhL|7RJmFwbM zFH8U$VVn&*#YDc*uT}Etz#X^CZU7|A~Lge_#7K z{l|sxJ>M^UpZ4SO&*I eqa3k-uKx*&i_pP?fN(1e=1`NvkvP*wl(ZF9PS+F*l)6xvF>I*%DDCaiob_` z%m2FbgZszM?{B^@_;LDY#BYPYCjVU+9hli!>)3kOl{ic}j e; z|91KH?}x^Z3*Uc#U-skpPw(H-e AsF*E*P+Q(wf=F9$;ou6Yp`xUlc);G+&OneOd z|MdU#{Br!6^yBY$$se149QtYU`}3d2{~j}3Wtznz!lui9nf*8W681}MlUaW=t1xLZ z82$_Xv*B0r&-x#tKQw>r`f=c=*6)XZPX0T>u$ifh @(QUv(04XVzFX! zX9)aP_UH1imY;Kf==`w!ap=eXp9;Uv|Jm?wDZ@mjV3zZ&@7U(CUt#ZIKf^YkRe~je zDVd?@-^@SXel7jE>xc6X&mX6L?E5M9d+(na|JoVynG9IgvYuyaW lF{>&| zDpMW9#DBa0Nd7+d^ZJkIACW&U{n+=D_xGAV4gazj{Fr!Ix>?t=WwNhkFJ?c?wu04& zrIKkT!^VGi|5*Qi{`1R^;vZQ*ZvWW#llAwUKN o7f}Scd@N! z^<-JVbcW&WKl#7)zcqg8{ao~;=f}Gr2Y!D0Rr|;0pD4pS#udzJtU+v&?78gT>|5A2 zv4*g0VtUHJ{omp5!rvahynpWcG4IFsABTQ^_?7oZ?ceYJ=Na3XSy_$Q{;@@{+p@1? z+rk>pa)jwGgU0`azlVNj{L1)w>BssXOh1qOeEBQkkKn(D|2HtEF+XJyWqZu#%&yPA zf^8dXCd*YOQAXGQ^?x7#?)cUE^YxE|KX`r~`}yQo@SnebkNuy-=*E16 DPr09NKX3j#|4ZV}{J%c`nHg6xsk0=o zI LhK|k;PJo}69Pv2kD|1TJNnK)RS zSvA?#upMD5VB5+%pT(YeHRHek0sr>>N%-yiYwAyzpYcDR{5
_?bt#Jv^L|EAhMa$Q{?z@>{I&LH_|Kf5FMpo=_4{|;U(WxV8G@M3 zFmteeVQpYr!WPH2k#!YI1oK5kU51W-zy8em-TLd;a%7Ki~g6{_E54xW8Zi&15iT zTF3mF &ttz{{r3NR|6c=x zB-2FZ^DO&WL)e m7`u +x^Lzo-AD zGyG*NVcx{Dl+}){h|QjD1?zT}YG!t(B8D6P0{(vfed8DZucbd1{bc!d?APtz#(%f} z^JjR(7|uM6rJGfqEs@QHZ7J(+mR4qQrVfTr|8o8c{Q3M#{nyT)8-8;CI`-@8Z?(Tm z{+TlzXS8CjVku-5WD8)^WLv o1aV+7izgg|r 0c*)o&3%7 zxBed|!z4x~W+xU~)+emGY{G2QSr4%+WOidZ&S3k0-`|u!F24(Yef@d+r}D2;zYhOq z_?!Fh^ZyFQ=S=D>Dy-*NrP Zi`HGr#uz z{`x28-`)T5jAxj*S-4ntuyV2eX6 -Vca-v5sOcVpbh^nv*!%R<&4tnXRdS&y;oWG-Z4Vr==(`)}KyDZh98GWx~w%kI~O zU)z4)|6~1c(| -=zQN84Q?mnTuJBSm&{>XH8{2%5sx=JySH}r~jS*EdGl8(f>XD zSJ n{v9PgLvQA+QV?D(3nE5DEHKP>6j(=Hy-TuV= zKJcsTSL?4gzn1)7^ylhd?f< G}Qg*Ysa=etrM7`1h1Qd;W6#Ph!~4_<`vc^AQ$D)@)W=*4-@cm>)5%U<_gS^KbLt z34fOS{`+hBujRk~{#x|A@6U$6-~ahBEMUCB^oV&Ki#}@%s|o84mXFM@nYJ^gGYI`Z z{ddKmUB88X@A$R(7xV8$zdQac{rmi%6+ S_kZv| COWfseGmS-%}SpG7r zGD|VNW!U_`_Fux^+&`Ot+x-^%ZS#Bm@3cP=e~bSu|Nnr2n@N=U9dkR&4VK$16IuQ; zYcZ=Z{b4xvf6~9QzfFIR|Mvf_{M+UCrr#-l0{*7`oA&<X3)nBK7Y5ylPY-ilhG@IF$Wj4!t zmP(di%r?y4Os0(743Gbv{(Jq8*q_P2BYvm g` znJn2X- WDx{l5M?`j5n4mVW~OH5nWkU6_=a&okSx zWU=_Myk+)du41ZV%w`Ds@BA jF uEVs2-e!q~x3`aknu#ozURr2icIz4iBt-?4vq{=WMA>ff*bT#Q^yFPUaC z3$VDdn6W%z4rcCUn#VYeq3wUozwW<>{^ !iXS~ML z&dk7K$)d;dfH{PDGSdpiB@EO4_y3#s_sSpJKaYN&{Qc#3!XMVZxBg!Gcjy0eh9``N znaY?yGV8FYvfN<~VV=RXiE$&t^8X9}ZT$P}kKdmUzpwoM{X6Lo)8ET~kNrFQ{~E(3 z#*IuV%nz9rSY%mlFo!bFW!l5Ik74`&&Hs-4{rM;E&%fXIe>46``NQz{%-`Mr_WeJ~ zu%B@rQxNkdW?>c)mdnhc%!` KzsvqD z`oDx>4r3*g0rMv2U(8G_r 0)5C-YI}5axAE_ZUAgeE$FaAJ0FBzYG7E|Ka*0`zP ?tF|1V+4V02;n!_>ljh4~rtF6JQStxRtj*% wCFOa6QCPsks|KRSO(|9tzi z;&1)Gy#J{T;f%&iubE1jk2Bw8-ohNnyo2crqadR!gT{Y{f2Dsf{Ym N&lw*{q(2qkMkdwKMjAr z{F(VT^`F;&O9oZO|BO4C+?f|J?`K}b?9F_DiG#_2(Ul?mfAPQNf0_RF{_+3g^QYy{ zmp@bg#{RSWugxIF_?~eElLhl+=B> A#(#c>Zw%)cJD4PyE14HE_cOaNA7zqc@?p$kX#T(W-_5^ D(WUgjodJLcm|%1p70O$_t@ANu$6Z{Xj{e>(q^ z{h9OU$Dh`}mj5{azx;oaVIE@y(_5w>=4R$ NF|!5p2__w;JjNLeyZ=A@C;2b`@B2Rs z{&WELXW5_Me;WSk{QLIr;{UY_^^BHG=b0>+^O$p(O_)zG88DSHE@n9K|NTFWfAxR= z{#o;9;-58t{{E@^tN!opzoY->GZZjtG96&jW=>{KWj0_w!DPZz%eao=>i>WL%>VWM z<^H?lV2{`~(_^H=fTlYcw^Ph?1Blw#V%B*z@d9Luc3e1ge>sfBR|!=wK^|K0!1 z{VVzR$e+c3cKl)dTlH7w-|c^E|2H!PF>*64W)fufV-921U_QZQ&D70!h~eFT>HlH> zR{vH1d*RQTKYRZ$|E>Hh{_pa?MgPkfoEiTxPGw?Yc4qctR$)HQWXCj#@eISS|C;|( Z{_Xl}`uEPCt$&XEVf$P0SLomAe*pcXPL==w literal 0 HcmV?d00001 diff --git a/games/demo/assets/generate_cues.py b/games/demo/assets/generate_cues.py new file mode 100644 index 0000000..4e7487b --- /dev/null +++ b/games/demo/assets/generate_cues.py @@ -0,0 +1,78 @@ +#!/usr/bin/env python3 +"""Generate the two tiny CC0 WAV cues for the Rust4D Lua demo. + +Run once to (re)create the committed assets: + + python3 games/demo/assets/generate_cues.py + +Produces: + * blip.wav — a short 880 Hz sine "enter" cue with a fast exponential decay + * tone.wav — a low 220 Hz sine "exit" cue with a soft envelope + +Both are 22050 Hz mono, ~0.4 s, well under 50 KB, public-domain (synthesized +from a pure math function — no third-party audio). Uses only the Python stdlib +(`wave`, `struct`, `math`) so it runs anywhere Python 3 does. +""" + +import math +import struct +import wave +from pathlib import Path + +RATE = 22050 # Hz, mono +AMPLITUDE = 0.6 # 0..1 + +def write_wav(path: Path, samples: list[float]) -> None: + with wave.open(str(path), "w") as w: + w.setnchannels(1) + w.setsampwidth(2) # 16-bit + w.setframerate(RATE) + frames = b"".join( + struct.pack(" list[float]: + """880 Hz sine, 0.35 s, fast exponential decay (bright 'enter' ping).""" + dur = 0.35 + n = int(RATE * dur) + freq = 880.0 + out = [] + for i in range(n): + t = i / RATE + env = math.exp(-t * 9.0) # quick decay + out.append(AMPLITUDE * env * math.sin(2.0 * math.pi * freq * t)) + return out + +def tone() -> list[float]: + """220 Hz sine, 0.45 s, soft attack + release (mellow 'exit' tone).""" + dur = 0.45 + n = int(RATE * dur) + freq = 220.0 + attack = 0.02 + release = 0.18 + out = [] + for i in range(n): + t = i / RATE + if t < attack: + env = t / attack + elif t > dur - release: + env = max(0.0, (dur - t) / release) + else: + env = 1.0 + # Slight decay through the sustain for warmth. + env *= math.exp(-t * 2.5) + out.append(AMPLITUDE * 0.8 * env * math.sin(2.0 * math.pi * freq * t)) + return out + +def main() -> None: + out_dir = Path(__file__).resolve().parent + out_dir.mkdir(parents=True, exist_ok=True) + write_wav(out_dir / "blip.wav", blip()) + write_wav(out_dir / "tone.wav", tone()) + for name in ("blip.wav", "tone.wav"): + p = out_dir / name + print(f"wrote {p} ({p.stat().st_size} bytes)") + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/games/demo/assets/tone.wav b/games/demo/assets/tone.wav new file mode 100644 index 0000000000000000000000000000000000000000..22b366d3013a81fe6d3eb81395253be0d39b1247 GIT binary patch literal 19888 zcmWFXbaPwb%fJxs80MOmTcRMqz`(%Bz{sE!#=zjRhJk^JL4YA8u_Up@mw^Gq<6sbG zP-ZY=@MFki=ww*UaDm|`g9>8+V?E<~#s`doOioNCOiP$9Gcho0GY2zQGS6b(!F-AN zIrDdBCKh%UHkSX)ADQnmA7Wm}T*2(gEX;h3X%dq=(|5)NjLwV?7%CZf80P#}|G(~^ z@xQHqP5*BGWB6zNZ@u5^ei{7Q^3&$$@gEUC-hS`=uKoS$x3+H%- (_#> zX {K z2?hyT3knHd6X+1o5ZKCZz(0%c6R#z20nc>q^;|nRw{R?GZ)ZzjHDLM1w2iTVLGAzb zzwLiae?R#-?T6QQmTyPCbbpTiWcE?!1OI!$cS>(v-ju)I`%3Ip>r2j;i(dr4ka_Xv z`IqNxFAQE3zc}~8`Q?R|Wv`51bG-Td=IdLY_vRl;KOX(0{$<8j@$XB1*!;TpyYsKr z|Mv_lnNnEf*>14+a@ue|;c4a*7nm<7A>1f(LsUlGM ^d${|N$CJ-b_dH+ta>48EZ=bwZ`BeVp);G_e zM}E8iJI4^s{DQTZ<0n@o?|c48p)Df+#7rearDJ8i
mnyj!uu1h9Vib-O!D7SEqz)s#TTnZfa ztYJ)P|BL?A{p|U+;PajjPu@zsPJFTFss7{L50dX`-x0nge MMGe?_S(-;n4X% z=hDtGo;!c`{8^@R>E{^EpE`g1!q 9)?Yzfd7rA2#zL*@I*;`Z8Wb44H?}ej zGBY;6XC7$LW6@_3Zt=|A);!wG(e#6HrqNo1{d)6s{IxErYpF&m1 a0nzOyN(-<{lW zV&(DM$J~y+K6?7-)1y|$P9B?heA0>2C#_E3JG1TFz6;+k#aw-Red(>{yUh<4KfeFW z @lbfShuVSZuP19MYS#OF#sgbhD z9Mk(|ug&*aL|X2&d|-LTvflE$g}H^TIj`9=6E0(GLo0nQ-L+b38l|cWlvc=3kcpP$ z6I&%@!oQANmZOE`IfK{V^*^P*P5318e&y?+7s5|JJbZnR{f@`Y4cDBm{J;46Jjc24 zGq+AnKG}3)<#EpAi;k5ZYdUuFnCEe(6JJiqo~l00fA-qBa~Hl|^16ERdf_emyZR68 zA7?+?^pfvw-G@J)+rLZw-t^Ct=>cm2=Qo}Lfg8d);+az2vi%Ch%0_CZHLSJkb*JiA z8yXmIF!^IDWd7cKss)p!sinT zGG`_G#4Lp`@JH}m;c#c&%Bb{j!Y|hEO`mx_EPE63Qu5i)M_=y?-3`9A^SZ}XrpvD` zFrN23d-QbaspyjxC(a&^I<9zJ@p#nn)5ptBM4T)Ot~*`MbgUifjz=IZL}PPhKw zxqtuuqd!kgUN*gX{66&aq^WvX-Bhbq zXS!aqft}GYV<}ThGez@@=AIUv785MuEIykDn3tNRn97 j;xzdWs+ENrz*U;pL)e)T>73&Y0+Z-ZaSJpcFj?*r+3(YFuW@V&-- z<@v=Q=dI4IKNEi1 5~Vq*bHw zPc>3`g2D>fg;EXT9wNU5=JFbG?PYUhKK$SH&*>i#Uq5`D_RjCM^b3ZkjE@xVC)_!5 z)Bift)kl}!UC=r| &8ebTwE zHBm!Ztxx%?!XH^y=}+P(L^=g6`EGF)vNN*uFi8Gg{?q2$?N1%=UEhek{Qs2kvC@O2 zyGL*N-S~g?_T|SHB`-9blQ{e2^pjIkr`k?xo@72Lax(Vhos*MJ)t#Pq=F{1V^ZFM> zFKb*)yME?o Y&7PTBn1+~G8^1FwFgU39 zSm%b;A`KU{{mNpBK5{A22@)=%!a^7L>bMm-cC!RAzW7`JOXmCG&!rzM-txWr_3Zy+ zg@=jvj@;3oqTpO{M7$bcTT@OV{~ri z`GAXRmo=}3UtfDu`_7qreGl`WWIu0swd(Ej4@O@)zrXzD`)?DYIBO}#X>L*e0HF%e zE{PWDL^%b;eahx)T^gIUHtDqJsTs^PylM2zc)v-q=|xjcGcL2Mrdg(^OuiVuGFoeB zXE0yyqRus~^%{w4ua$!or_1e=J}I$VbcRq8zbwybjzU%;rcM8XfB*Qt>`VMd^>>V~ zKR*BYMCMW4{R4O0Zhg9b{OYmGpDy}bxPETZ*~T-APyasEe#-Nd)2V_}S5D=fwmoBi zw)EVc^CcIpF6& OdXjo#62c$&xAPQnDzlwus`#(;=faQHudbhj z-hX`k^u>p#qL0HL?7C}z`{j*Y*S1}`d&%(Pmh+kC{Lf~b*?QXi^t)5HPW?F*eERx{ %{8a)z>lfGBPuMYg}k@z~rXMK9gLN z7sh(VPDV +*+ON^CW~s7IQAs{crcZK?*c9PP0bgEWt_y5!%$5vq|1AEQ z@J;RWulM)fTz&cY8P^lPha2vh-nn~o&Gp4sk6jkIH0grfd6{#%XA90eKRx+$$?4A1 zmrn e?8;ow%eNb_B|+m?EFmcrT!b2_gSCje!cxe{!hmL z^-Nz`O*pf8rtq&7+9JACqDI<6?y5qN@+#Fk>d!TgYgg$q=!YBB8WtKE86Pl~GO;%? zFnMEKVtmr*mElc;>H4aAtvWlk4r(k^i&A-~m?*zR=9MIyIFHC*fqT3gxhmPMSiUoC z`CIhM>^sYsyC06dJ@o4G^FL1 {q zd}qYZgq}HeCi|@OIiK_G7d~F>y6k_|{(8jC>9>F1ZG52q_|?;6FLu2?^zQaYrmrSH z@_w)R_nJ|IHG!j_dlTPr!IL7}#CxRNWFO1NEA3Qyr}jtVf!0hNRlO$t4F+os%Z>Pr zON^HoFEq|F{%@3MG{LafAWHwcZko $zuV zz0N*3v+B(9GdIrIoV{{(-np6Qk6lo_wEA-5Rj2FTH*0QRyzBYk!J{cplV5ngc6k^0 zG3U#q?+1T<{j0?o&(hDno$Ctk6M;v U}@)&B~WIo+&(OdB}c$^_}8di8soxZNH*?dH2Pp z3zg>=p8I{a{jA$ri?cCjx16;<_xs$-^XwNxE}g$zcGcs$^UajotM7_DnDfZ#Df5dv zuTH%^_2K5{uiqqpIseULn8kdE?J?&s9u|RrLQh1uNMuX1$u%q7SCUZGRu|X2rB$eN zTUSC~)qv4(jiIVhj!}bAq7lDQx8XH|_xd;VCh5xQ)M;(eIH0ynC0&VCp+)wol(s~q zXrWL!e;!XHrxlwh^Sl4Y|1AF5`mOMD)`#M^{jUx@=XzT3==1$)cVljQ+>E+D_3H1- zeV6<$+Fpn~zxJH|xyNTuo_%yy@7(HhQRl5LcwOwg^!0Mz)xhhvHv?{W+ #LWj?`H7Jpw{r5;XA`yhEomY49g7W=ug&*(fy{Ks ++FY;1swxo&7Mmau3FXbfF zP;~{(Ls}L(O}g{+y7fH_t{NB^Mi~YhN*S&<5H|48_t8_*J+1AbHA~}&+HsYoN(l fSI$mCXX7}XK!_@m4clmEi z-SoY_@~Xj=$CnOYymUeELj8I9^Y71nJg0iT^Ss=JCl_v9{C&y$%JHjt*KKba-}bxP zbN|)Dv?u?bt$$heCh)z@C)2N%KU{u?{7YdhVQFA*=BnXM7jP8j5ZfUUAbna^Qz1>M zQKekXP2-JbhV~Af+qxI@rs?Y#OfoobaLQn=ft|qy{f~Ogde3#{YHMh9Y8+I%q_R(` zL%~pPx3rdIgV=uIR|2ejLfj%8ysS)2-~PS+{rJb@uWvuGe$aiJ{%Xf_rKigtc|730 z_x|>eo9Z{}uQ6O*bGhwO@5RFxG%oBr-*UeC{G#)}&NpAMzNmc3;&RoM7grmvJKfa0 zZFV>9{ X7fVBXEPgL5^{ME-OkEzuj|c~UQB z+~r#p7b?$E%~2QEoT>F*TT)j{?}=WE{%3t714jdSgERVG`ZM&l>#o$v)n?Nw)!40e zOXaH48ii!J-_qrhx5U&$;sjgx=5nv(Sj)PGY32W=f0q7S^KH-Pn;%%;IlrF%g6UcN zW6g)J@14DK<<|cjLD$b;ExqD#+5J-K#fukWFGyZsy`Xp@_rj|SQ!nOUD!;tu3eUA^ z*FA44-&VToe827C^T#RAe!W=nI_sV7M};qZ-&uY!{$*hJ&-9!1BgZ}NeS8xH14Mp{ z^-FTfq{}T+IHI&)WvZHs#%WD;?FgM1T_e3)dcpd0^|$HI*N@bHtY@p2rJJE+rTtJd zPGghWeU;}*XB8&OnadoIG!X9;IV;G(ugqi3>B$zz9L5myH|1C1_l_^CKHhpK^QP$K z{by-UI3At6zv}L~+t+TY-k5XE_A2KU#>?uLsxJP$u mfH4ZVTR3xgYs(?PHl|%U-y@{`>aGhuNR&zGeT6`xElti^+~vmqUd6J?|cY zN?}E@%@R7&ow6t8Un)LR-mhAu{#PSjYr6I#okm?lz0G=T`da$(`cL$#^d9O;>8k3m zYVXu^)>x|cK;^sAD}_CB`7&%$&EhXaEQQMXm+_q7e8~2hnURtIpZss*9|2#>KdpKH z>5ccRUC*7KK6$kCLCd|iJF9PfyODXF<=V+ByD#6kq (w9oey{#Fld+8@kKK<; zh4&5r5+N_qTjGII>tx=^@hkExzgAhKW~4Dw^P1L6?ejVvy25$|dh_(=>gDS3>ow_~ z(0QnRR;yoAO=FtceHCV9X2r*HOJqExE{Z#gE)aUfufiL|RmwhrWd-BDe^-Bh{2}tq z@pJWuBX1R7PkJH!Y~SO$hq3o#?$+NvcGKj>scW5AORjWXK6}ab(w&PdFD|)w?xOmo zwU?4EJ6{R7+HvjW_2Qe#w}0OGc#r#`^W&LMIbTe8rT6yU`+1+TzdHX=`py3D4Z}s| zjcnbVF+B48R|LyMn8hn4uStu^StwX4NvK>_O;^97A+BYhEvs{1r CED$^z @gyfBEs*)F+{jj2{@@3%E1o*1sG5*FCT4T(!PZcKP0=;!9?i)GxVR zntX}x^0v#}SGuomyT)~+?WX4Kk9Y3ed-*`*aqQCrhmbc~kIS_0x+lTfcYzO8e`? zAkX}h^(@D9?l3+!!KK0mVoM|#q#b0F< XjW+DXq)O>(s9&n)}5|f zt81ovP)A-TKs#K^Nb`w$zS<=fL1kSPEFN1tas)q2eSkomsC-Nf6+ZwB9Bzy9Rvn=A5H>MwI&K5}XG zr306kE*D j)+$*a$<>D`!n)A;t=JE!lRdhp_r%G0XnFJI=pVSm5jW5yTl@85r( z{4?)=5t9q6AjdVX3A{D}*M;ImFNy0&<;qNuo1##mWT|ph)kl4n#sSUUT0Po^IxBU) z=m_gF>mJvM)j6)ssx6_#pm{(&T 5u5(Lr2C=m; zZ((@ySM;~{kIt``K52gFf6MWD+6$X!e;(g_c;){4yE=FJZi(GIdVS8dxmQnIQMj`B za`0t?%T|{QFJHZ!dPVUn$2H08Avd<&w7>o4&fa_L9~^k}{)y%D*)K)jEPQAG@y+L@ z-_n2T|M~Op1mk3uNOlRXvpgmIJVKL1n8afwXG`ywJu1IiF;AIawNve`I;SSL)?=*+ z+JZW%I=wobI^jA$wez%hXkFJlqcKC>Ms1ghu(GFOoP4mXmh^LpZZQdwiGn})0(s_g zK46n!31RH{cjPzYPuFi#KEL}A@$Sm&)R#QZ&pcW2Xwie+_rBc;xqahi m$zPiblK|4{ww)cy{`FRueovQrtj@{cQ)Od{$Tc_y-$8U3w*inwf(zG zA4)zeeY^c**6+A~N{mmLm$Joi^73rpa}hi)Y%10(aYpK+%y+r_3d@u{RZgfXst0LA zYg%c&*Q(IIrp>OytMg2IlD3F;rq&eAX&QOz@@lJ81eAjnOXSOBqokE3FN@`fd=yOP zKh7h|mBqfE z{$7*1mUQ*Xm7*&)SB$O%Us-rX>gxWheb?HqFTe5OX8i5XcUInOdQkbO|H*-8Traa< zKYW| ^YcAoqLTdV&8!*`f!<8KhKXbmT-8?kTn^bEu}O z%~4;iF-g-;>%NwocBA$L?P6_h?d@8US^=7|8cymAYSUG?lp_^8 8g z6*|pt$vcbdBfC9oC)36M5`U9_ZT`;lwcyjE_bG3GzFPbu^_k-n%SZkXTJPPx6LI^; z&3!l4Tt9q``C9H(rmKgqtiN*X3g^}Gs{+@qTsv_6>J7nL#kYUmS#q!7LG+`PCmqj@ zy^wj`_Lk{G|0m6_XTMkd()s)F|5PS-*3axSxD0vs@>>Zl7WpA&CK)B2B )TkgyRgW9CI$i-oO06Q-2)!s`Gi#2aR|8UuVD6d(QQg>9N>Dulw`w zirv|CtN3R0jqK}7uCZO4eAVl!?p3R+#aFLgO}Qq0{m*rln P-; 2=HNTdzf5)4ry9&GXvyYy8(YT(7*5b+hT#f!m6A zm)-MuApGe2 P@8O;Mp7(Cv>A9VJEAeLAjZ4?vu0Of9`r4dp+phh(mVW*3_1!lX++1_( z-ffe+Ywo!{V0d)n@!6-hpEJF(d(;2!!-vGr_r9k6`1-5kuN=c>CO6hA?2%koc%1kb z3ceLq6Z4P=lyZ;}k~=0JrFce3M#W9lM@>upk$R!Vbqx_s4NYOqD;l{PchptXUDWJU zg;WkH1t{*8=a4g#ahI}}kP~|@JV(%;{|Zku*G+am*8NO6472}o|8D&8?`!L4$&Y*9 z6~3{0CGmp)nZgs_M>8HU-S4|=dq?0l`z^Jb**9)n&%3U3UHH1n^| X%YL}X)`h9gjjma7tG?r=1pNj&X?<7zj|x-VbZ5RUkbm!`&szs$G CBH=BRGz7sq@zG9}xU3EF>l+!6o%TdX}uI{6+;{B{$`06(3b`wLNN9>J!xWsUKBe zq8_FGQY}brvg&%3Wy+OGT8ca6HRP&f)=8a^I4QP8q)W(GfPrrbw;ks>wg{HHjEVoB z{mK3H`}>5i2A}VJnDs8>jn^xu7eUWzo*a6l`f&MuuY3G=zu#uLZF;NsCeO`{H|lN_ z- (yIGrKfbCC@279zk2-DA6SGAW04B$1;s_3<~jzbCk9#uT`m2)lyrp#;fk4 z9-?le{zq+^8i!hlYPCwOa*UFM;%0e0xo(-$QXeG#h ci|y> C2px4Upfg@I_HrnP26Z$_!Oi zwQjXjYLC<|tIbt&RNJd6qUxp+tZb{qqPR-lP;REo6Dd(i9dTVz3E>X{+xhZ&q`CI8 zhqJz6s%H@Tx9qpw&wJn6zgU0z_x{4$t*_U=-2eQ=Q|%{RkJukBzMpW<{;tEFwA&kQ zDc;(Cv*c#@&BU9NZ@#{nd5ib
hl!5`p5A)4_r>;C$KSkqC-*Vo z^M reJ;LFvPN1~c99&rf{$W>QlYY+ z3cKnoRSq?OwF0#)HCwe;s)eeTRQOcXl% $6X*KQz9}c$4(1_{HpJcb`~4-ulq*0sH-jckkW# zciZXq>RVQ~-rqcR^YqQnH=S;6yXAkI@6N|N-|ouYPk(UXVff?UPj)_=^rG=q+nf3C zPJUqe?D2KR_m4jV{%rmy##q68oz;M&f$JF0e?ARC2VqxH6LB8NQ&M>{Uu0wDmnoc6 zyrQ&Sxl~0!wMF%^>L1nrs&`Z;sVb}Xt6Ww7q4Y!Xs=_3BJ-M|q{L*2P&EhjfX9~9o zCi3g>zUG?G;l=izc><&1|4V<$ekuI8^tJDE_(#3>;%|jttGx7i-uLw7 c()TRxmp!=hFyQfvCv%= TpDl+)glW(J q&+)cT2;I`xK=eIWAT6Am2t M!rX3wqmDJu<|eET9w->BB~myVygF5npK!p;*_T y)%H+)O>F=W7VLt`GU;DE3Q}c&{cX@9bU#)!c@|n}q z?T_6beS2`^{^om!?|!}Gedp-y %pUk9*<8y z$$X~x;^WI}uP?m4`~K%g (G}| zp1*k-|K#nXnGcg6_}-7a*LL^n9nU)tZqL45eY@fIs@p$qXWe1AyYueUdz0>Oc<}b2 z$KwM}LY^_cIQDYU>q&2?ykGwD#OJSHb$(?3TL0(!KRd=&=98>!95!5OJgt0F1SSjB zi-d`ZOYE2Ql|CRNCg&@kst~Jar1Vs&O!<+rmWrQ>uZo7sedR*s2TD3hp^C8zuJXKc z+hts&w@LCz_=%N^^a}M0H1ehL*l=-joMY`{_F`oFfACM^FSj4U-(Gz_`*HvKgKw|C z{`b=E#nfkPPbWRLe#G?f#r=2p#O@{BJ##1aj^Le_x1Zi-yW@Rl%N>WiAMPH!x8?rv z2frSAKi=`g@!6B-^IsOc4twkOKH_8k=P6$gegFB>>`(c>?F>Jd%vkf;7jPcue#HBp z|Bc{v;dP>U;^LCarDSAEWjDy3kw31mNHJRJlTxbk7Uc)ZFO*L!cPpzY&sX}QsG(@3 zpd =l`9iyBhc2 z-@9@D;RDV`0gpF7F?@FNdDTnD*RpSU-t&Bv`fT0(z!{t1Z)O7ipb{@}XCv6`)l#f6E7;o9E?zw>{(epmU* z` 7M-kfA{}BkbV^Yc>NQVXPcf!ycB)?{LPtnhd!M6bo *2_A>P_ME}$I!|?0Y z_q|_NeO~-=&HE#7-@n#>)$-!gvx=vZPp&`O^l NQJXLFugzI^j)%bWgpH6JQJHGi4$ZTpYAzc~Jy{!eC{ zz`T?74*L&IP98o!R)N=o2ZS3$wZ->ISV+x~z9Yjd$0Pq$exE{`;# Z(Cce4&O6}#O=i<+{Jt=(b@yPCB(1W)7x9 AABhC1mD1N`p3B~pTO*&K@JS&> zakJt>#kY#r73V3sD4tZ%QOK8{EH^{8UdBuMr(~Z5w|If*0pUM_>H>~@zC1o$P8|Ad zVk|!yZ~x!>cj52OpB3K=z7~IO`ncfzxwrgpQeK^Z5%m1+(?w589w$A@eK_O6qx-)1 zZ`^CW7ktm Fj*ft75O{z zr3!BpoE0k+yA^8{eHDKzbSQk4caqPStCh`@ahCogIa@+ee1hmJVFRILfi}L`Jd3#& za7<-uX31p=Ww8CH{zv2&`w!-CoL{6qS$)WQx8@Dw>ztQwpSL};ddl(S)1zMx6&|KO zICbCu{ H`cZI$3Lh_z+iL%i$R?>eYmr9t5uM-s%Nf4SVaFXvC z&o{0=96#9JvD{}m%dq?3sy}mnP5CkT+ng^OK3)32^4{(3oY!ox+Fr;#KmT<0lcvXQ zk5)W<@xcAT@%w4_)$eoO=eciizx4jC`w0)&9-e-$P?kXP&S;3x9s-h0CiuuRGs* zychrY?bE|AH@;o}aqriwKR^GmGm0@QvZ}MIaY}Qu@;>6*Ado90F0xisSA3epGf5d~ zGZ_ RQcSt3mQk!Xa- zP9Y9KSN;;-sobkLx3TYH-O0R#aoztFf0z7T`g6_qJzuYV{`1lBL)p7CZ_HkAed+z; z$FqG;=RcYAc $Fec<`v&;1MckKDg;pZ7u1gX<5nAId&@_vp^!XHR&Zc|TwL zLip8;*G6yeznl9Z>yzsjoo_NfM1BeV5&0+1AjKrZBFV =}Po7WVulyPLYI$z?YPqwrjI!b~Led{4w@D<6 z{}3$~c_d^h*ucM?_W}1`PC*VCHYFBiCM5>te=2`8f0_R9_?G&m@6*u_-0zd#o_X!{ z>i&za=l;)hpQ=5vew_Dc-$R{;yB?%JFnOT(K<`2HgB1@%9?pO0`AG2bx5wX}2tD(B zKK;eNmsPL1->!d`@ {pU=0x9{#@N=jz|f{x12ykZ~^aRMrmmV$Kk5E#6OjYXm}s zUJ2)j-VoE3$dc@pnkwBS6C}$bH$#qBK3RU2{08~u@^$j2@@M7T 3w+ham(lKuQ}hte!Bg({%iDKlTm?Lgq4Z?6~_s#**r;n zQUV7B!-a2(xQWdbzb(Ni#UuS!`l3vStfJf;xgT<-@ SOeed|X Ny4k;9{iN4<|8JPLSx z_i@`3@26VNl%Jcvh<`c%)z{Z?Z*RRz|G@ld?dRmL%HQAo*z;?`pNxMF3=&N5m=Caa zv-@*$a&PB};Cs!VD|k=HTBJpEo7g4ss}ct!CrG(U- `pKgC*@#Na$36IksM?KDZJpJ** z$8JwfJV|{j^X%=j8_#dO`0`Tub^4qAZ#Ca9{-FEm$mjI0qTf&d==kOJN8sP}|8p6W zm{nNsvrXZ!=X$_h%KL|}Sm2hRzHq+CY|%|(8^vcxq)AFiZIv>So-Tb~np;L%hEL|H z^a5#n>BCaGQZ %>DQ9 zkNWT8pU1u{ee3x0^Haq~whv3*g}jw`^ZwPHm-k=%e6I7n;@Q2Y@lSs}+3=+4Nx_rK zC-a`%e`5V~<5Q<+Z=Y>^-ut5AW!I}!ukXH5c~|rP$%mLv4?h=u<^8_#NAxeAKl}fd z{?}r>$25V(hV2o1J*N=&Y#uSbCjR>Z+CnM9ogy ?-2RVH;%>XQ_^ zG^6x=sl`%0Qnw}jC09$l6PFOz5z`VC5_vAPQZQ2BCto)&KTkW?SB@z59jt;ZX-qpA zc>gE--TqtnSILii-vYm${~Yz{^M~2*L*B{1{rCFAs~<1LUi!S4`JCZ-{WFPYXP(Y{ z+Vr&b>7u8%p6WiE`Aq)#-sdGRoL_3ZQhsgpChTp`yUXvjK2G?={H5tD_xHI!%zj<@ zUG`V{|9*yKCKi^3tQPFYIefWJa$E4u;(NodFPI=yC)_DgCmJWFE`C$INaC|Zl;ldu zyOQ4}zf0bgTqzkX`9-2w; F)=me1t;ankmK?Z?Md?CEAxJ$UcaAdRJW_4v* z%_P8B^8dzP`#&pxN&TGkUFh4~FD9R_f9(3;^IrZP%iF)NxnAqMN`1NIh4hPA&kdhH zdbZ}-glE0a7C*c4O!j&G^Iy+ kne@ncp$J6?tR*y6n}7mj*A_ zy>NZ;`T4HrGoMd (RN4)WR>;EqGeb0x3A6Y+#ecAL? z@_WaRe?O~!|N2w&kAb0?k(IfH tJo%loXJ>vD^TH^b}Y{V9eei1Pgi4@KkDill>aN!r@yUjC++m7oY zM-@8{+e{Wk=H-mq3>*HL{oViD=huTD)!*g6o&D1O+3%CmN45{Y-u-_o{?_SD |X7C8T^vr<>43eUrc;4=f&O^-(R@DT=!D@)&5uMuT|cBeRK2e`FGdezx^Qm$^CQt zmrGwYzPJ5&{WI+Mu|F37*8G=eoXEt;lEZq5&48ng^AeX3k2`NJUn_sFK&xPukgf0^ z;pHN>qI*R(#A?KLi9HbeAofD+l-N`;53y&Wd7=+QY(?6H_Xyn={2=g={~_OD-swE? z+%jC}IV#y@*mkl6F~4A}VG#Vk?62LQTfeG*D*w3ht?z5l7v;~4pWc0V`TpxW;djn& zTi@Jy?e_ZEtC&~puTH#N@Urja iN9q%lEG~-@AU?`)T=m#-Cq* l3f$ylQ{d_G-?nW3Sj>$GkrF+U3pFH&t(q-u-@e_5J=2 zJ3k)ybmjBcFACp6zfb;g{io9J!aqm;O8n1ZIKU{xoXE18^*x&oM bfde!U4uMOTze8c*-=dIeii|_j0 zM}IK?sPswtv*H({uYTW3zAyZ7?Wf@HfIpM}-uNfWkj%J@={d6sYcyLo`xcHXoG-aP zbARM{#CwEq27j~wpWp^T2cf+}>cVxx2ZcWh^N0wGu!%esUN4*`%q2WaNJ6MZ@V e?^}P|`pNp+>`&(3`Twr{=V5eWDq&v2a*p*A8$X8% zr#_cHw+at0?+f0oe8v1q0tW =Ja_ABD2;}4_n zI^PVw+JA}u-27?h$A2G!K5Toh^?t)Uw|DQ~u6|qbHu9~{+n~2uZ>PPz{8r^%>${)t zYTpZe*#05=qwc4FpKgCX@@2=@ZQu5NKl|hHPln%$e_a3O{G0lJ55p5iPG)Tu57q>> zBKB&I8qQ*_cy4 GnsHk8?hVe3<>-`2F2?)88e(b9`s`&gh-nyX<$1-o1Y3 z@_yZW%@3PD_ ^_!S4c_ z1!4uh^EdJT;mhDV#w*Gj!PC#Zi|aP$Ck_S k!-`8WF?{=bs{RR0?=*f6>? z`7;Nz1he|GIk4++2ynjQ+{IPTZNc-Dr-fIHZx$aPe+mC7etrR0fh>V~fo6d+fk*)z zfp`21_?`K$^F{Mr; v;!~6d)|2_Nr z GRW1VV|yiO#Jxg!}1S_AGANPet7@>)%!2+ z`9D~GDE_ebgZRh#k6%Aled77N`g7P9-mmAr&ia=B-RFnFPnlo5znT90`SauNw|`&% ze`5H+_?qc4^L3V^tn1kN*)ut;IGMQia}{z+@ND97;N8z_$TyYm6`wwT8h;P}V*b_q zi}<_vlliszpYl!M)8X62Yt6fkM}#Mzdmk4wmmOyT$4vI!Y}Z-evixJ_VHRVOXH;h} z_;2~o3n{PAU z8NO?Lm-zPa&Ed=D)8@O!+r%r$yO>9jXA<`hu3)YuoUb{wI1<<=u 67{A6`$3 `7W;0~}z`l$lg!2dIBrZknrQEVSojfmiEP3mA zxANZO{lUx1$HMoO_d4$y-eO)|-kUs?JUl#;x%s&pxSnx3b57%U$gaYk$Tpqz1j`p@ z8D=M@RK^a5)&I}^`}9}huhXA`--~|T`YHJ{{>Pf{Oy85fo&IY7b>A0{FZVt-eAfT` z`qS1=-Jc3RC4EZ#l>e#g)22@^K52ih{(Swj! GL%lQWs?Ay+8(UT#UA zOrEtok9l}`HF+&~t$6i##dtsP?B%KDG32?)UCPbM-Oa_uRnB>z!;WJr`%^YOwnEl* zEH9X4nFE*_7}qo0|Ihc|{$JtWWqIwi`$a>9#=UR8&@|cJ7*Qg6Lxp@#cV%V z-B~BHTxXVKj%1p~c!`0R!SjFHzaxKH|9bwJ@cZsB{a@`rpZ)OpvFp3R_YL1Hzn%G- z^;PKW(Jw7u{JyAsVgK^=^ZU==K689g{}TA6 oPH{doAJ z;iu}a^S|nU8~=IrXX)R>fAatD{h!Sc$tcQno~f1Dg5?>@1Xg3V3v6lZU)ZZSesJV) zUgI?9>gBr0CCTl_UBNw#dnNaJ?p55gxNEsXxs|w|aLwj&=X%N6$SJ@%l|z`LgZ@ zEZaU-N!9|EL(GEAu}sSt-!Ygm)c-&JPw-#t-!*^!{SN)T;g{gA%Ae1F#QeDRJ^uT< zZ*AYyzg_;?@zwLI$k$h2&V1SVW#gBvUygja_l5bZ@z?yXTfVY&-xYr> z|6%;|*w2Jt|9>s|?e*vDpT&QJ|FQnx{y&pJn(;Ja6_YCSIp!i3LDn^_4s7SxLfNmd zdvomKP~fcLJkKe?70%VowT0_4*K@A-TyMD^aGl^<%2m!~&-IscBWE<{Z;r_v${efM zwb&Q4iLy1ZzGU%cS;@@89K*DUk&Q8mVcmbG|Kb1E|K<3b`sdhh?cY;>vHq(0`Qu0J z4~`#mzgvF4|E=$v+c(Z{SHG_L+WWQgYyQ`QuQgvMeck-^-dEvoLEmP5d-Kix`|9uF zKe~Ug{p|QD@N3>L!`~-=r~YC2yX>#mzYqVW{kLIw#L&*D&2)w-i NyZ9>8~-i-&-nN2Z~Wh5e+>UD_$~aq=NH$n zzMqmm*Zgq(@%;P5@6O- ?nb; igO6 z8b7*!eEpIB^WM*xU-y5d|Ni{D`H%SDwSV3IJ@{AsUzA}zgD2x7#tJ4L<~ht7EE`x% zSU0k2vdv;+WzS$g!Y;v)!m*s=A%_sB6=x)89%mJ24QDB53a1yR8s{&LBOGlU_8cGB zXR=$dUuDZ+`^H+w%D`I7@{Ku%`5u!m({4s}#z_o+|7ZNa^3U<#hQEq`r~Tpk)BT(0 z_oQEPzc&2z{Q2TX{}0 `M>esufJt~zy2xv z^XGTlZ;{_CemVYn@U!)&;m;>O=Ko0iq4nd>_p9Hxe_!-{>h}rXr+i=Vee3s2-@kuX z`4RbJ>W`a0RDPEIJoi)g*Ti4Her5c={X6K-nLnO?PyY4#clKY<|7-uF816A7GCpEV zWV*)`!F-O{fn_a=7;7c#byhvL2DVddeC%HA_3UfeFR_1MXXOy)kl+yG;O6+jewTe0 z`vmqlb`|y~Y;)QC*?zMwWOZV_%TmI^#xj*zfq4a!9@8d96UJ=}W(+(2Tm9ej&*9(E zzkYvj{z?Dy>-U7;+P}~ID*Pq;>)g+_pDsVSeqQ^r>PPF3j2}TiTz=U7aQNZ%Bl<_l zkEuWQ{&@34>1X`U#XsNtwD~pZ*V|t{zc>Dt{L}j9>!0+$cm4+dJN?h)|Gxj`3>z3U z85b~$GIcQhU`k~^&uqdnmE|Lg2kR`>XRO+6*=$SLuCXz)tFk+>hqI@$=dfq9C$R^y zTeHiue`h<*HiIpWO^)pbYY(e6>r<947A= 8_t&~#slSwdJ^i`vXYJ46p9Vige*XXQ@yDwluYP>| z@&AYDPs5)fKkI(3`}yRj;;-aitAG9Y<@I~v@87?p{_Odq__y=#=fCm)&i=Fhzxux< zLkGh*hGfQbjOI-9n3$N8nGZ5cvE;MtXW?cIWSzu%mX(RkkS&U>hHVDh8n)eRhu99Y z?O|KbHixZ|Es@QNjfd?f>jKt9R$107EbT0&EccmPnKhV?Go>;yFwJB%U_8zc%kbrY z_kX4TyZ#0Ld;hoRukPOqf6D(T{<-kG`M1^Y@4t5bYWU^*Oa9l7pVxox`MLb(%%2l~ zPWU L>p%%U_wl=Ks3&OX_$0@0Gv5{r31X_s`cqfq&Qi<@;Cg@A5zM z|8xE`Fr+Y?V9;jlWqix%#k7p+A5$>%Qs&RhHY`mnhgklxn6Rd?PGsHAdV}>7D;t{# zn+%&An Vp+$M%c9P5k9i`q1M^#^X-sxZj~Uw-H5gAa zWHE3ttoiTz|NXy7|IGj0``iB4`0t}XQ~r4VVg7UQck^$r-(tU?|JwU?j>3BP=P z+5Iy6W&F$hm%}grUn#%pf6e=K )48GbSZGA?KQ!|2B}kLfj&DRT|;e&&D7mMr-!3t7&wd}onjwO|ck zO=c}*tzxZVtz<1^O=b;XwP2NE{lRj9WeH0$i!BQa%W>v5W=G~ (8~{%YRq@4*hNXTm1L` zUvGZh|8?!x HZV@$LJ6DpO?Q+ z{oe3<*6+^WHNQ)K7yK^#UH-fAcmMB2zjyt<`upo|$v+N%vj5EbbLJ1@U(3HGe>eX9 z@YnEP$-f={{{D0R-}(Q-e=&wwhQ$mo7<3r(88 z<95bMMk~gj3_BRg7)%&G|KIq(;J^O=5C1m)EB$BnkMZBBzf=Dv|26r`@%R3poqwkN zDgP7m$MuilAH_eSe|Z0J{o(q<_eboH(jTKgu76_wl>eFbXZxQ!e^~zN|Be0I`*;7} z&wsW4CH }e8`R~rZ zkN)!fv-p?xZ`!|O|9$;{T)nfBx5DNMM-EaFpR2gBoKfV-w>##_Np#8C94( zm@=8#nHDkaX1d7qgy}026EhF9Fta$bII}1-KQlY?Z>G0Qx0#MJZD5+lRK*m-WX&YO z^qKK2<5I?I#sEfT#%~NK7-lkLF<3KjGu-{Z?tjDop#Q4>fBrlFZ|T3 uSQ!7&&Q!7&=Qx#JoQz}z9lRJ|slL8YL(?`bZ zjJp`;GS)H1GFmfAFn(dUz_5y;l_8$Nf t6)llsU0@B7~ufA9Rg^!N1Nqkj+mJ^1&~-(!Ez{Jrw`-rrY$fBfbAC;d Oa;@{JMEdN#hyZlf6-~NB)|I`29{O4uRX9!>@WSGdXk>NbUTLw-> z6-GP8aK=2w7RDKjs~C4No@Bhr_<->x;|IpCj6WEEGJa?L!uX!?1>*z8tBfZYcQLMF zoXOb6Si~5^=*p eXf{kQqw!haM0HUBIBm-8>_U-ZAwe*ype{`vm%`xp2x^k4M9 >EEk=PyXHicl+Osf7kzA`*;1{&3||PJ^1(Z- Vz|L@m*D}!V}_>;&lsLFJY#sm@QC3a!!3rZ z4Cfh6FdSsq$*_T8Im29r$qXF~wG4#}sSJ?}z6=fwCJgEfQVe_yj11rYzxsdg|K Ho_A^Z!r#-}k@mfBpZ8|Hc1v|7ZSB{htKb|M>s0|6{-~_J7>}g#XF^)Bb1u z&;MWYzw&?m|JMIK|0n;S{eRK_RsT2r-}V3S|I`1k{J-=6>Hl~Czy1IBpOt}^L6kw3 zL4`q^!H~g%!Ir_9!GpnAA(kP5A(0`8AsGyl7!ny07~&XW7@`=$8A2EW z8GIQ$8C)408EhFW7)%)S8MGMG7!(;~7{nQb8Tc5u7+4t?8UFqM_5a)d&;LLCfBXN{ z|L6ao{(t=c;s5*p@BP2~|IYtA|8GO#o&R_L-~E5@|AYSz|3CWw games/demo/scenes/demo.ron +# [game] game_dir -> games/demo +# `--game games/demo` sets game_dir on the CLI; the scene path is set via env: +# +# R4D_SCENE__PATH=games/demo/scenes/demo.ron cargo run -- --game games/demo +# +# (Keeping `config/default.toml` unchanged so `cargo run` still boots the +# default scene; see games/demo/README.md.) + +[scene] +path = "games/demo/scenes/demo.ron" +player_radius = 0.5 + +[game] +game_dir = "games/demo" +scripts_dir = "" # main.lua lives at the game_dir root +hot_reload = false # flip to true for live Lua editing during dev +audio_enabled = true + +[audio] +master_volume = 1.0 +sfx_volume = 1.0 +music_volume = 0.0 # demo has no music bus +ambient_volume = 0.0 \ No newline at end of file diff --git a/games/demo/main.lua b/games/demo/main.lua new file mode 100644 index 0000000..7d028e0 --- /dev/null +++ b/games/demo/main.lua @@ -0,0 +1,146 @@ +-- games/demo/main.lua +-- +-- Rust4D Wave 5 — Lua demo game entry point. +-- +-- Run with: +-- R4D_SCENE__PATH=games/demo/scenes/demo.ron cargo run -- --game games/demo +-- +-- This script drives a curated scene (games/demo/scenes/demo.ron) of six 4D +-- primitives in a ring around a central trigger zone. It exercises the full +-- Wave 5 scripting surface: +-- * ECS bridge — world.find_by_name / entity:get / entity:set("transform") +-- * Math — Rotor4.from_plane (W-involving planes morph the slice) +-- * Input — input.is_key_pressed (W-slide indicator) +-- * Audio — audio.load_sound / play_oneshot_spatial (spatial cue) +-- * HUD — hud.text / progress_bar / flash / screen_size +-- * Triggers — 4D AABB detection in on_fixed_update +-- * Tweens — manual sine scale-pulse (TweenManager is not Lua-bound) +-- +-- See games/demo/README.md for the feature matrix and controls. + +local Rotator = require("scripts.rotator") +local TriggerZone = require("scripts.trigger_zone") +local Hud = require("scripts.hud") + +-- Per-primitive spin config: plane (a W-involving bivector) + speed (rad/s). +-- Distinct planes make each primitive's 3D slice morph differently. +local GALLERY_SPIN = { + tesseract = { plane = "XW", speed = 0.60 }, + pentachoron = { plane = "YW", speed = 0.70 }, + hexadecachoron = { plane = "ZW", speed = 0.50 }, + icositetrachoron = { plane = "XW", speed = -0.45 }, + spherinder = { plane = "YW", speed = 0.55 }, + duocylinder = { plane = "ZW", speed = 0.65 }, +} + +local rotators = {} +local trigger = nil +local blip = nil -- SoundHandle for trigger-enter, or nil if audio unavailable +local tone = nil -- SoundHandle for trigger-exit, or nil +local frame = 0 +-- Observable counts (globals so the headless smoke example + tooling can read +-- them back through engine.lua()). +gallery_count = 0 +trigger_enters = 0 +trigger_exits = 0 + +-- Look up a scene entity by name, failing loudly if it is missing. +local function must_find(name) + local e = world.find_by_name(name) + if e == nil then + log.error(("[demo] missing scene entity: %s"):format(name)) + end + return e +end + +function on_init() + log.info("[demo] on_init: building gallery rotators") + + for name, cfg in pairs(GALLERY_SPIN) do + local e = must_find(name) + if e then + local t = e:get("transform") + rotators[name] = Rotator.new(e, cfg.plane, cfg.speed, t.position, t.scale) + gallery_count = gallery_count + 1 + end + end + + -- Trigger zone at the ring center. + local zone = must_find("trigger_zone") + if zone then + trigger = TriggerZone.new(zone, 1.5, on_trigger_enter, on_trigger_exit) + end + + -- Audio cues. load_sound returns nil when audio is unavailable (headless / + -- no device); the demo degrades gracefully — cues are skipped, the trigger + -- still flashes + pulses. + blip = audio.load_sound("games/demo/assets/blip.wav") + tone = audio.load_sound("games/demo/assets/tone.wav") + if blip then + log.info("[demo] audio cues loaded (blip + tone)") + else + log.info("[demo] audio unavailable — cues will be skipped") + end + + log.info(("[demo] on_init done: %d rotators, entity_count=%d") + :format(gallery_count, world.entity_count())) +end + +-- Trigger enter: spatial blip + HUD flash + (pulse handled in update). +function on_trigger_enter(self) + trigger_enters = trigger_enters + 1 + log.info("[demo] trigger ENTER") + if blip then + audio.play_oneshot_spatial(blip, self.base_pos, 1.0, 25.0, "sfx") + end + hud.flash({0.30, 1.0, 0.85, 0.25}) +end + +-- Trigger exit: low tone + reset (pulse reset handled in update). +function on_trigger_exit(self) + trigger_exits = trigger_exits + 1 + log.info("[demo] trigger EXIT") + if tone then + audio.play_oneshot_spatial(tone, self.base_pos, 1.0, 25.0, "sfx") + end +end + +function on_update(dt) + frame = frame + 1 + + -- Drive the gallery rotation. Each set("transform") marks geometry dirty so + -- the render cache rebuilds and the motion is visible. + for _, r in pairs(rotators) do + r:update(dt) + end + + -- Trigger pulse / reset visual. + if trigger then + trigger:update(dt) + end + + -- W-slide input for the HUD indicator (demonstrates the input binding). + local w_sliding = input.is_key_pressed("Q") or input.is_key_pressed("E") + + -- HUD readout. Player position comes from the audio listener, which the + -- engine updates to the camera/player position each frame. + local player_pos = audio.get_listener_position() + Hud.draw({ + player_pos = player_pos, + entity_count = world.entity_count(), + trigger_inside = trigger and trigger.inside or false, + w_sliding = w_sliding, + }) +end + +function on_fixed_update(dt) + -- Trigger-zone AABB check runs on the fixed timestep for stable detection. + if trigger then + local player_pos = audio.get_listener_position() + trigger:tick(player_pos) + end +end + +function on_shutdown() + log.info(("[demo] on_shutdown after %d frames"):format(frame)) +end \ No newline at end of file diff --git a/games/demo/scenes/demo.ron b/games/demo/scenes/demo.ron new file mode 100644 index 0000000..ba7d194 --- /dev/null +++ b/games/demo/scenes/demo.ron @@ -0,0 +1,124 @@ +// Rust4D Wave 5 — Lua Demo Game scene. +// +// A curated gallery: a floor, six 4D primitives arranged in a ring around the +// origin, and a small "trigger zone" hypersphere at the center. Lua scripts +// (see games/demo/main.lua) rotate each gallery primitive in a W-involving +// plane so the 3D slice morphs over time, detect when the player walks into the +// central zone, and drive a HUD + audio cue + scale pulse on trigger. +// +// Load with: +// R4D_SCENE__PATH=games/demo/scenes/demo.ron cargo run -- --game games/demo +Scene( + name: "Lua Demo Gallery", + entities: [ + // --- Floor --- + EntityTemplate( + name: Some("floor"), + tags: ["static"], + transform: Transform4D( + position: Vec4(x: 0.0, y: -2.0, z: 0.0, w: 0.0), + rotation: (s: 1.0, b_xy: 0.0, b_xz: 0.0, b_xw: 0.0, b_yz: 0.0, b_yw: 0.0, b_zw: 0.0, p: 0.0), + scale: 1.0, + ), + shape: ShapeTemplate( + type: "Hyperplane", + y: -2.0, + size: 24.0, + subdivisions: 24, + cell_size: 8.0, + thickness: 0.001, + ), + material: Material(base_color: (0.36, 0.36, 0.40, 1.0)), + ), + + // --- Gallery ring (6 primitives, radius 6 in the XZ plane) --- + // Each is tagged ["gallery", " "] so world.query("tags") and + // world.find_by_name both locate them. Lua rotates each in a distinct + // W-involving plane so the 3D slice morphs as it spins. + + EntityTemplate( + name: Some("tesseract"), + tags: ["static", "gallery"], + transform: Transform4D( + position: Vec4(x: 6.0, y: 0.0, z: 0.0, w: 0.0), + rotation: (s: 1.0, b_xy: 0.0, b_xz: 0.0, b_xw: 0.0, b_yz: 0.0, b_yw: 0.0, b_zw: 0.0, p: 0.0), + scale: 1.0, + ), + shape: ShapeTemplate(type: "Tesseract", size: 2.0), + material: Material(base_color: (1.0, 0.82, 0.32, 1.0)), + ), + EntityTemplate( + name: Some("pentachoron"), + tags: ["static", "gallery"], + transform: Transform4D( + position: Vec4(x: 3.0, y: 0.0, z: 5.196, w: 0.0), + rotation: (s: 1.0, b_xy: 0.0, b_xz: 0.0, b_xw: 0.0, b_yz: 0.0, b_yw: 0.0, b_zw: 0.0, p: 0.0), + scale: 1.2, + ), + shape: ShapeTemplate(type: "Pentachoron", circumradius: 1.3), + material: Material(base_color: (1.0, 0.38, 0.34, 1.0)), + ), + EntityTemplate( + name: Some("hexadecachoron"), + tags: ["static", "gallery"], + transform: Transform4D( + position: Vec4(x: -3.0, y: 0.0, z: 5.196, w: 0.0), + rotation: (s: 1.0, b_xy: 0.0, b_xz: 0.0, b_xw: 0.0, b_yz: 0.0, b_yw: 0.0, b_zw: 0.0, p: 0.0), + scale: 1.2, + ), + shape: ShapeTemplate(type: "Hexadecachoron", circumradius: 1.35), + material: Material(base_color: (0.55, 1.0, 0.48, 1.0)), + ), + EntityTemplate( + name: Some("icositetrachoron"), + tags: ["static", "gallery"], + transform: Transform4D( + position: Vec4(x: -6.0, y: 0.0, z: 0.0, w: 0.0), + rotation: (s: 1.0, b_xy: 0.0, b_xz: 0.0, b_xw: 0.0, b_yz: 0.0, b_yw: 0.0, b_zw: 0.0, p: 0.0), + scale: 1.1, + ), + shape: ShapeTemplate(type: "Icositetrachoron", circumradius: 1.5), + material: Material(base_color: (0.72, 0.45, 1.0, 1.0)), + ), + EntityTemplate( + name: Some("spherinder"), + tags: ["static", "gallery"], + transform: Transform4D( + position: Vec4(x: -3.0, y: 0.0, z: -5.196, w: 0.0), + rotation: (s: 1.0, b_xy: 0.0, b_xz: 0.0, b_xw: 0.0, b_yz: 0.0, b_yw: 0.0, b_zw: 0.0, p: 0.0), + scale: 1.0, + ), + shape: ShapeTemplate(type: "Spherinder", radius: 1.05, half_height: 1.25, subdivisions: 2), + material: Material(base_color: (0.28, 0.95, 0.88, 1.0)), + ), + EntityTemplate( + name: Some("duocylinder"), + tags: ["static", "gallery"], + transform: Transform4D( + position: Vec4(x: 3.0, y: 0.0, z: -5.196, w: 0.0), + rotation: (s: 1.0, b_xy: 0.0, b_xz: 0.0, b_xw: 0.0, b_yz: 0.0, b_yw: 0.0, b_zw: 0.0, p: 0.0), + scale: 1.0, + ), + shape: ShapeTemplate(type: "Duocylinder", radius_xy: 1.0, radius_zw: 1.0, segments: 32), + material: Material(base_color: (0.40, 0.65, 1.0, 1.0)), + ), + + // --- Trigger zone (small hypersphere at the ring center) --- + // Lua detects the player entering a 4D AABB around this point and + // fires an audio cue + HUD flash + scale pulse. Semi-transparent so the + // gallery ring is still visible through it. + EntityTemplate( + name: Some("trigger_zone"), + tags: ["static", "trigger"], + transform: Transform4D( + position: Vec4(x: 0.0, y: 0.0, z: 0.0, w: 0.0), + rotation: (s: 1.0, b_xy: 0.0, b_xz: 0.0, b_xw: 0.0, b_yz: 0.0, b_yw: 0.0, b_zw: 0.0, p: 0.0), + scale: 1.0, + ), + shape: ShapeTemplate(type: "Hypersphere", radius: 0.6, subdivisions: 2), + material: Material(base_color: (0.30, 1.0, 0.85, 0.55)), + ), + ], + gravity: Some(-20.0), + player_spawn: Some((0.0, 1.5, 14.0, 0.0)), +) \ No newline at end of file diff --git a/games/demo/scripts/hud.lua b/games/demo/scripts/hud.lua new file mode 100644 index 0000000..6b5060e --- /dev/null +++ b/games/demo/scripts/hud.lua @@ -0,0 +1,65 @@ +-- scripts/hud.lua +-- +-- Per-frame HUD readout for the demo. Calls the engine's `hud.*` bindings to +-- draw the player's 4D position, entity count, trigger state, and controls. +-- +-- NOTE: as of Wave 5 the `hud.*` bindings are API-complete but render to the +-- log only (they are not yet wired into the render HudContext). The calls are +-- valid and exercise the full HUD API surface; a future wave that plugs a +-- HudContext into ScriptSystem::update will make them visible on screen with +-- no script changes. See the demo-game report's "Engine limitations" section. + +local Hud = {} + +-- Draw the HUD for one frame. +-- state = { +-- player_pos = Vec4, -- from audio.get_listener_position() +-- entity_count = number, +-- trigger_inside = bool, +-- w_sliding = bool, -- whether Q/E is held this frame +-- } +function Hud.draw(state) + local sw, sh = hud.screen_size() + + -- Title + hud.text(16, 16, "Rust4D — Lua Demo Gallery", 22, {1.0, 1.0, 1.0, 1.0}) + + -- Player 4D position + local p = state.player_pos + hud.text( + 16, 48, + string.format("player pos x=%.2f y=%.2f z=%.2f w=%.2f", + p.x, p.y, p.z, p.w), + 16, {0.6, 0.9, 1.0, 1.0}) + + -- W-slide indicator (demonstrates the input binding) + local w_txt = state.w_sliding and "W-slide: active" or "W-slide: idle" + local w_col = state.w_sliding and {0.4, 1.0, 0.7, 1.0} or {0.5, 0.5, 0.55, 1.0} + hud.text(16, 70, w_txt, 16, w_col) + + -- Entity count + hud.text( + 16, 92, + string.format("entities: %d", state.entity_count), + 16, {0.75, 0.75, 0.78, 1.0}) + + -- Trigger state + local trig_txt = state.trigger_inside and "TRIGGER: ACTIVE" or "trigger: idle" + local trig_col = state.trigger_inside + and {1.0, 0.85, 0.20, 1.0} + or {0.55, 0.55, 0.55, 1.0} + hud.text(16, 114, trig_txt, 16, trig_col) + + -- Trigger status bar (demonstrates hud.progress_bar) + local prog = state.trigger_inside and 1.0 or 0.0 + hud.progress_bar(16, 138, 220, 14, prog, + {0.18, 0.18, 0.20, 0.9}, {1.0, 0.85, 0.20, 1.0}) + + -- Controls hint along the bottom + hud.text( + 16, sh - 28, + "WASD move · Q/E slide W · scroll = slice offset · walk to the center to trigger", + 14, {0.5, 0.5, 0.55, 1.0}) +end + +return Hud \ No newline at end of file diff --git a/games/demo/scripts/rotator.lua b/games/demo/scripts/rotator.lua new file mode 100644 index 0000000..e2db267 --- /dev/null +++ b/games/demo/scripts/rotator.lua @@ -0,0 +1,56 @@ +-- scripts/rotator.lua +-- +-- Per-entity 4D spin logic for the demo gallery. Each Rotator advances an +-- angle and writes a fresh Transform4D to its entity every frame, rotating in +-- a single bivector plane. Rotating in a W-involving plane (XW, YW, ZW) makes +-- the 3D slice morph over time as the slice hyperplane cuts different +-- orientations of the 4D shape — the signature visual of this demo. +-- +-- Usage (from main.lua): +-- local Rotator = require("scripts.rotator") +-- local r = Rotator.new(entity, "XW", 0.6, base_pos, base_scale) +-- r:update(dt) +-- +-- The transform table form {x=,y=,z=,w=,scale=,rotation=} is accepted by the +-- ECS bridge's transform setter; rotation must be a Rotor4 userdata. + +local Rotator = {} +Rotator.__index = Rotator + +-- Create a rotator bound to an entity. +-- entity — LuaEntity from world.find_by_name +-- plane — one of "XY","XZ","XW","YZ","YW","ZW" +-- speed — radians per second +-- base_pos — Vec4 userdata (the entity's authored position) +-- base_scale — number (the entity's authored scale) +function Rotator.new(entity, plane, speed, base_pos, base_scale) + local self = setmetatable({}, Rotator) + self.entity = entity + self.plane = plane + self.speed = speed + self.angle = 0.0 + self.base_pos = base_pos + self.base_scale = base_scale + return self +end + +-- Advance the rotation and write the transform. Returns the new angle. +function Rotator:update(dt) + self.angle = self.angle + self.speed * dt + -- Keep the angle bounded to avoid float drift over long runs. + if self.angle > math.pi * 2.0 then + self.angle = self.angle - math.pi * 2.0 + end + local rotor = Rotor4.from_plane(self.plane, self.angle) + self.entity:set("transform", { + x = self.base_pos.x, + y = self.base_pos.y, + z = self.base_pos.z, + w = self.base_pos.w, + scale = self.base_scale, + rotation = rotor, + }) + return self.angle +end + +return Rotator \ No newline at end of file diff --git a/games/demo/scripts/trigger_zone.lua b/games/demo/scripts/trigger_zone.lua new file mode 100644 index 0000000..5ef529d --- /dev/null +++ b/games/demo/scripts/trigger_zone.lua @@ -0,0 +1,96 @@ +-- scripts/trigger_zone.lua +-- +-- Trigger-zone logic for the demo. Detects the player entering/exiting a 4D +-- axis-aligned bounding box centered on the zone entity, and on enter fires an +-- audio cue + HUD flash + a scale pulse on the zone entity itself; on exit it +-- resets the scale and plays a low tone. +-- +-- Player position source: `audio.get_listener_position()`. The engine updates +-- the audio listener to the camera/player position each frame (see +-- ScriptSystem::update), so this is the live player position — one frame stale, +-- which is negligible for a trigger. When audio is unavailable (headless / no +-- device) the listener position reads as the zero vector; see the report's +-- "Engine limitations" section for why that is an acceptable degradation. +-- +-- The scale pulse is a manual sine tween (`scale = base * (1 + 0.3*sin(t))`). +-- The engine's TweenManager is not exposed to Lua (no binding), so the pulse is +-- implemented by hand here. + +local TriggerZone = {} +TriggerZone.__index = TriggerZone + +-- Create a trigger zone. +-- entity — LuaEntity for the zone (find_by_name("trigger_zone")) +-- half — half-extent of the 4D AABB around the zone center +-- on_enter — optional callback(self) fired on a fresh enter +-- on_exit — optional callback(self) fired on a fresh exit +function TriggerZone.new(entity, half, on_enter, on_exit) + local self = setmetatable({}, TriggerZone) + self.entity = entity + self.half = half + self.on_enter = on_enter + self.on_exit = on_exit + self.inside = false + self.t = 0.0 -- pulse accumulator (seconds since enter) + + -- Cache the authored transform so we can pulse scale without drift. + local base = entity:get("transform") + self.base_pos = base.position -- Vec4 userdata + self.base_scale = base.scale -- number + return self +end + +-- AABB containment test against a player position (Vec4 userdata). +-- Returns true if the player is within the 4D box. +function TriggerZone:contains(player_pos) + local h = self.half + local p = self.base_pos + return math.abs(player_pos.x - p.x) <= h + and math.abs(player_pos.y - p.y) <= h + and math.abs(player_pos.z - p.z) <= h + and math.abs(player_pos.w - p.w) <= h +end + +-- Run the enter/exit state machine. Call from on_fixed_update. +-- Returns "enter", "exit", or nil for this tick. +function TriggerZone:tick(player_pos) + local within = self:contains(player_pos) + if within and not self.inside then + self.inside = true + self.t = 0.0 + if self.on_enter then self.on_enter(self) end + return "enter" + elseif not within and self.inside then + self.inside = false + if self.on_exit then self.on_exit(self) end + return "exit" + end + return nil +end + +-- Per-frame visual update. Pulses scale while the player is inside; otherwise +-- restores the base scale. Call from on_update. +function TriggerZone:update(dt) + if self.inside then + self.t = self.t + dt + local s = self.base_scale * (1.0 + 0.3 * math.sin(self.t * 6.0)) + self:_write_scale(s) + else + self:_write_scale(self.base_scale) + end +end + +-- Write a transform that preserves the authored position and rotation but +-- swaps in a new scale. +function TriggerZone:_write_scale(scale) + self.entity:set("transform", { + x = self.base_pos.x, + y = self.base_pos.y, + z = self.base_pos.z, + w = self.base_pos.w, + scale = scale, + rotation = Rotor4.identity(), + }) +end + +return TriggerZone \ No newline at end of file