crimsonland 0.1.0.dev1__py3-none-any.whl

crimsonland-0.1.0.dev1.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.3
+Name: crimsonland
+Version: 0.1.0.dev1
+Requires-Dist: construct>=2.10.70
+Requires-Dist: pillow>=12.1.0
+Requires-Dist: platformdirs>=4.5.1
+Requires-Dist: raylib>=5.5.0.4
+Requires-Dist: typer>=0.21.1
+Requires-Python: >=3.13

crimsonland-0.1.0.dev1.dist-info/RECORD

@@ -0,0 +1,138 @@
+crimson/__init__.py,sha256=dij6OQ6Wctqur9P00ojTTZw6IaUNeZagPX4-2Qqr-Kw,367
+crimson/assets_fetch.py,sha256=z4vFH9h-RIwc2o6uKGzEtUaOdhUDSX6Art-WU6tNjd0,1864
+crimson/atlas.py,sha256=hEcCHhPvguXAI6eH_G9Q8rpiX7M5akZ8fgJjMogmYrA,2401
+crimson/audio_router.py,sha256=LLCYI9oUoPHbmh_pjW4Ey1Bk33_nNnYK5qwroCbnEPQ,4616
+crimson/bonuses.py,sha256=owwYIRHRu1Kymtt4eEvpd62JwWAg8LOe20vDuPFB5SU,5094
+crimson/camera.py,sha256=VxTNXTh0qHh5VR1OpkiXr-QcgEWPrWw0A3PFyQFqDkY,2278
+crimson/cli.py,sha256=UbDqUVPoOvh2udY_uxJ6yvQLpVEBkG-1YhBudKcoKDM,14485
+crimson/creatures/__init__.py,sha256=RJwwR_w98zC_kHF9CwkhzSlf0xjpiP0JU87W4awdAAM,233
+crimson/creatures/ai.py,sha256=oCuUkDe6Kxya1dThUthEy8GIuObAUjDv8WPfe17HYV4,6353
+crimson/creatures/anim.py,sha256=E7MAR9vFBrvmIYrOfPr36UohsfROZZL00jgRvZQf6nc,4971
+crimson/creatures/damage.py,sha256=pjKIX32nGDVPnFaWCce0LNZ-UZXZqJpNvwHwq-DCWbE,3211
+crimson/creatures/runtime.py,sha256=1FagJNwGWJuOXZEv4VaWak2IktNskSof82WCYJqui-U,40733
+crimson/creatures/spawn.py,sha256=ikgtr4sM2KdA2-eyxYdVmobcuZN6aA7xK7ceaIl7RSw,90059
+crimson/debug.py,sha256=vtfr0_HQHpiB5h57jAsl9cWyYxErSbZQ2uazcL1sJhU,127
+crimson/demo.py,sha256=rQG6Wdwy6t8sXZRt52vAmexpmgEyjRXuKs1sNx3wMoI,52500
+crimson/demo_trial.py,sha256=BuoKB1DB-cPZ8jBp4x9gmxWF6tvhXMYRqJ9hMYrhxH4,4651
+crimson/effects.py,sha256=6-v23jb5-Xs_gu3EezjRJLCGAU8obSUR6b2opdTLTvc,33999
+crimson/effects_atlas.py,sha256=Ko1O7z-1jGkH_KSeb8RrR2EtAs4V8vfo70ofhqbFak4,2104
+crimson/frontend/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+crimson/frontend/assets.py,sha256=JHxOID6Ti6bD2LercdRJ7sSSr0nRX3WWeuRPDQwwbsY,1343
+crimson/frontend/boot.py,sha256=BUT8O9DAsAKOARBpoc7VhUQsV7IzpKVmbYtaEwkxu7M,15288
+crimson/frontend/menu.py,sha256=2qqUdQ4UhjFViHUBVcsmitRXE2MU2UYXZuh4acY6aRA,26759
+crimson/frontend/panels/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+crimson/frontend/panels/base.py,sha256=bHmNUGeHm9Y69x75VKFfgK88Y0PK937ta2CPpkSkGaA,14697
+crimson/frontend/panels/controls.py,sha256=JhyylkqUIcq073VtxsrqhEaQYLU4Yf0yQ79ep5PLwpA,4763
+crimson/frontend/panels/mods.py,sha256=GI6KZID2UnWHVm6VcxH6-p3tUx46mJtRPpzV8DK0PU0,4144
+crimson/frontend/panels/options.py,sha256=0oBAGs9_nnP_H_JRa2hHZ6o-NaaavnuyzTSmeQyGUBA,15905
+crimson/frontend/panels/play_game.py,sha256=_Tqw-vFVzgDUd-H1Q8txyw-sTSZKCEDf3aU0Iw9B26I,24299
+crimson/frontend/panels/stats.py,sha256=jtIRRfffR4u_q6ayLvwCZ6u2YDdFC6Ei_ytQbxY-Bpo,12713
+crimson/frontend/transitions.py,sha256=-sAJUDqNZ943zXlqtvJ6jCg2YH8dSi8k7qK8caAfOKI,883
+crimson/game.py,sha256=_nPXvZDgu2sqEPk00ww9qx7nD8eQIXlIvU-yKfBuUA8,97537
+crimson/game_modes.py,sha256=qW7Tt97lSBmGrt0F17Ni5h8vRyngBzyS9XwWM1TFIEI,255
+crimson/game_world.py,sha256=088ZGsXdakFz_IDYc9hjQTNHCEy0niuPuCVcspdc0Yw,25961
+crimson/gameplay.py,sha256=Wvq5aeEZ-WHxOix7Bt_1V7pPn11mCn7pp9aDbZvmgl8,86812
+crimson/input_codes.py,sha256=PmSWFZIit8unTBWk3uwifpHWMuk0qMg1ueKX3MGC7D0,5379
+crimson/modes/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+crimson/modes/base_gameplay_mode.py,sha256=kmXJxkGnCKV5QZL_y5ML7r-p4bw7hMswKseG9XUn2jo,7555
+crimson/modes/quest_mode.py,sha256=hcq_n3Vi9CtED899ELi5JZKZWXWvzmDcIBBerVExz7w,19153
+crimson/modes/rush_mode.py,sha256=ZspTGjLIyjxXtP9lbEFXQJv_PQEyj52xTNicNEfRSBk,10932
+crimson/modes/survival_mode.py,sha256=kuY8s1wDWOII2wE4JfMmSB4_4kbkRxzOYeMbcJebELM,32691
+crimson/modes/tutorial_mode.py,sha256=fVYPSZbAsUARI95QP3GamPRMf-v6ix5SKfCoa_0nfAY,26422
+crimson/modes/typo_mode.py,sha256=JoiOqGjft922ZtjOzFpLeIy1hv35N7eHO-nsWVlSooY,17396
+crimson/paths.py,sha256=JCKauCxHJnP4IIy5ocgs6tvbaSMkMUByQ76Zoz2UGZM,653
+crimson/perks.py,sha256=JHNhKPOUq2w8h23gU7jpkx-erFKTO4Z8l8aHU8vrkO0,37068
+crimson/persistence/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+crimson/persistence/highscores.py,sha256=i3eU_Vlu-Bn6kZHDWNMzUoJXvzkqOnPp_UFOeZXclYU,13026
+crimson/persistence/save_status.py,sha256=s-FZONO6JVYRULewtlxoIwATTy3P7rLy-vsVBfSKPk4,7748
+crimson/player_damage.py,sha256=cECZO65NJwARoYdtsbvZBM8vQNs_8AVO4xa0omX0pGg,2215
+crimson/projectiles.py,sha256=HrT7peHvOAvXAmFyTDGZnn7gm7ZbDGz58WG0tDLCKU8,40104
+crimson/quests/__init__.py,sha256=pKCkH0o1XIGDN9h6yNNaqvWek2CybEZRpejYRooULj8,375
+crimson/quests/helpers.py,sha256=TeZWhIy2x8Zs9S-vYRBOEZ7pkHNMr5YJ-wi4vYQ2q2M,3625
+crimson/quests/registry.py,sha256=Cees1QBN0VYTB-XyQtvZ1b4SykB-i4tAnWF6WSV-1pg,1478
+crimson/quests/results.py,sha256=nwVk4CafEIqLvI2s8i4RueGiW48pnbwNmsoaoWPNebU,5279
+crimson/quests/runtime.py,sha256=r0ANBiaCe1sY3_OUesd9gbPqRF4yeTeR-nududZgF-o,2668
+crimson/quests/tier1.py,sha256=D4VQ0KqkTlp3j627a7hB13nB3WUJcviINCva9U6jrWc,17459
+crimson/quests/tier2.py,sha256=zNF1lVnO1C3Yzq3EdVtsmeTqUZwqN7DWZuMTwmcp5pA,18249
+crimson/quests/tier3.py,sha256=LzaQaxv3pb4JSwAS7BONtY8mBhrQBbcHuHhAFEt1r3g,16635
+crimson/quests/tier4.py,sha256=wInwikrYb02KHf3-eK17vTHDHj9dvZMBJptj0x5vBzA,19644
+crimson/quests/tier5.py,sha256=sZSz7VBxOpkwO-wQAMOvYgwstkvQ361_vQzux271bWs,23510
+crimson/quests/timeline.py,sha256=leK898fPt3zq52v-O6dK4c-wJBcY-E6v-y57Fk3kJ3Q,4021
+crimson/quests/types.py,sha256=iSrz8VSiRZh1pUDSyq37ir7B28c0HF8DjdF6OJ3FoBo,1772
+crimson/render/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+crimson/render/terrain_fx.py,sha256=MpBV6ukGwGqDluIO86BQhHRVWUvcFOi8MV-z_TfLsiw,2705
+crimson/render/world_renderer.py,sha256=T3aQFa9gonzypiN-jZk-aZtG-pU6I6GazuRuNSx_yLk,58589
+crimson/sim/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+crimson/sim/world_defs.py,sha256=xkf4NpgSCIR5zmK_sLnoej28XYvDVYSSLcbvxsB2FWQ,1907
+crimson/sim/world_state.py,sha256=kCaNJ28J5OGd_Pg-0Log5IsLjRSeKHeteSrIB7eHPhY,15607
+crimson/terrain_assets.py,sha256=X19LN3EZSkiz4uRvQfra3NtAXKAA8SMQ-nvOBlrspwE,670
+crimson/tutorial/__init__.py,sha256=SDDZKRpkQBqyVMU9U03DN242t8lo8ThLuWHmbVrP69k,333
+crimson/tutorial/timeline.py,sha256=aJDtASfkCSCL1RH4AZX-7xOZml9E4AORTAX6lI6A578,11307
+crimson/typo/__init__.py,sha256=PHh4jqD7i0aL8W8hXThczKcT4xsNZiXanBxOH5IOW5I,36
+crimson/typo/names.py,sha256=SslKyngsp81iHJPEdMJakvaenIkTskZIjLKuEmrt7d0,6320
+crimson/typo/player.py,sha256=2cnyiOY9WzJadxvvYdnc9BQhmUifFfdRCUjq5LLiby0,1119
+crimson/typo/spawns.py,sha256=63lYhgR8iFcE80YBYP_Z2Xvg7xKo1G1swRPLqM0JBS0,1852
+crimson/typo/typing.py,sha256=-h9udu7s-zGKlXxd6Xi7vbaiHj3pNuHqbL_0jqoTR9s,1284
+crimson/ui/__init__.py,sha256=0-of-3kMbUcm08RgaXNBkTaWHsqYtG0bk1b0ztpLyww,77
+crimson/ui/cursor.py,sha256=_6EJ7tnsW_Q4kPUrqBO5FInxhpHKUGGyVpDET5EG38I,2842
+crimson/ui/demo_trial_overlay.py,sha256=DugDImlPKx6DGe6gaXmA2s7dssjS6E9PMTi_3mOshx8,8724
+crimson/ui/game_over.py,sha256=hXgV0v4L9peohj2xUIipOSlY1gMRsmAPCxlToo8dj08,29610
+crimson/ui/hud.py,sha256=MnCBZGdI2nLMp9JOxaJBA0inErW2X7W95LtNb80vVIo,22283
+crimson/ui/perk_menu.py,sha256=FdbwG_B7UyZmPVdvZho0nJNvkAVc0VVHM2TSrY4eTfM,12740
+crimson/views/__init__.py,sha256=1UWCzBSsgIeOtcKxqM4Vf12JEfPHKfb9KRZgl2TB84Q,1880
+crimson/views/aim_debug.py,sha256=2ldQ1MJO8AeG0i9x4ZJ3YLyp1X-HY_nJ0E1mY8jFF7Q,10873
+crimson/views/animations.py,sha256=iI6uTpYS-lbjnpqz_ihETm5q09V6RqjO7YHqaGjovPc,10660
+crimson/views/arsenal_debug.py,sha256=MOpQObtuXN43W53GzFBr5l_BC0l7hfkee4237AGvXAQ,14554
+crimson/views/bonuses.py,sha256=dbGx0IBjMMpqrnuVjBUkscxHq6uErCxAkEAb3uDhFqQ,7454
+crimson/views/camera_debug.py,sha256=Vi6jANGQpXMK0bpL7hX_QQI_6Rl97ykElaoAuXd06YY,14025
+crimson/views/camera_shake.py,sha256=miYxPJcVChv5P2AdbAWTEsrjZR0SAszqClLMbmrgg-0,8148
+crimson/views/corpse_stamp_debug.py,sha256=1iLqiCQZpl8kbqfadgxbtVUiRFoGTnZfUwUXt3rVNq0,11716
+crimson/views/decals_debug.py,sha256=tE-WUZIJ-skPiDB0kByQfyWS3XP371y4u-s7DT2fl08,27841
+crimson/views/empty.py,sha256=ieyD6jk5KKqVdo90HXDm-ytewlIR087TJPj_7PmnaDI,358
+crimson/views/fonts.py,sha256=MkAQz4boPsYa0vUBV5t2ddLVT5pRa-JKiAd0VHYglAo,3890
+crimson/views/game_over.py,sha256=R7K7ENM7-ObcsZ5DqPHkrC8fuzAKLOFLZf3j7K5cvDE,4080
+crimson/views/ground.py,sha256=_QzsoFSPKA2qIj8OTvJFr2mqT_sM5_w05ucL4a9cCZQ,10226
+crimson/views/lighting_debug.py,sha256=T9ce224ZrJtztKTSFUn1G29MY0KYuHVhNdcDU7hlrFc,45502
+crimson/views/particles.py,sha256=z3nFPEyItv9aAY_RbByl-jDlwvH22fG30sIMWiaR1aM,10109
+crimson/views/perk_menu_debug.py,sha256=q4rn3R4tJASlep5jeAXwrBffj5_akJ4a4veq7FIpRiU,17831
+crimson/views/perks.py,sha256=Uac31DVvHZvjDmMrHpfvkg7LVpXw76xKL1BqwaLAsHU,15052
+crimson/views/player.py,sha256=pj1_hFZ7VRUDfZYdUI1b-EpA7FdoBhhKM3Jk4x4s-GI,16540
+crimson/views/player_sprite_debug.py,sha256=DDU6kl9sfhZ2nVXzBbsPSUKdIutHf5YNs2DrNQPRb2Q,11158
+crimson/views/projectile_fx.py,sha256=XIp3Zq82Pz6g-B30qa6-nlKF_dseLNoQNSUPhj9Y4i8,23148
+crimson/views/projectile_render_debug.py,sha256=kgfNXwd-p8htPXQRKwFOky9wSUnXeoQHoPUmgOFpm3Y,14889
+crimson/views/projectiles.py,sha256=k5zD_9614_-M4qYpnwKUS23fUUrjJS2Wzm7ZalOSKnU,8067
+crimson/views/quest_title_overlay.py,sha256=EbMvXvYqagLLXmhaM7PC0fhxxhHGYGYI2ytgYiWqAd4,3338
+crimson/views/registry.py,sha256=Kxc_aQMWOAjI6Uq_SRkb0AmYQxyVmM6rxT3UF74irzs,930
+crimson/views/rush.py,sha256=61XavUpHgwc6Kw9e9Y-OkDt_XfY6iHoDrcpxjMbe1ms,298
+crimson/views/small_font_debug.py,sha256=c-9qw7QL-nY-ajVOgDNjMGOnGqmVx_j-Iiy5DQhOlz0,7712
+crimson/views/spawn_plan.py,sha256=Xo2vw3VwNYqdbNJ6K8d3PJ81sJjLdrXhYEQLTwrxAdM,13378
+crimson/views/sprites.py,sha256=_DMjuXaRKvzgGRkv9gieaSubJFJraKNZ01C7iNg1niE,7372
+crimson/views/survival.py,sha256=6yuhPe6-bC4IDaAbv74PStiAX9cBbg7HFbSr12ytQAw,333
+crimson/views/terrain.py,sha256=ku3R7igsvtfLdeh_uBbY41Tumi9BaNa1C6IAe6vKUOY,4763
+crimson/views/ui.py,sha256=2gGyCiI_JnlHzG9CWH8nomQIgCthfLwP7bTsDyqAyx4,4294
+crimson/views/wicons.py,sha256=bGbmE25q_pYJZTiPt6Q5Sy1Ub667KvUIFp1a5rVxhi0,5783
+crimson/weapon_sfx.py,sha256=_JAFpXi-c7jFNz3hxKygAYwqAR6zC94QnNHQYDCHnOY,1717
+crimson/weapons.py,sha256=FSyOmOQbmGBS5KTZuyBQ5hd5prFp6V1LtIQRoGc8pqQ,23666
+grim/__init__.py,sha256=Cn4f7JY6bscS1gwjDPaWvIvj_vneuUXaiu7wdJB6EVg,262
+grim/app.py,sha256=Wae-tQcpDA0mI99GRupHXoxKnC5F6xfLGxVV8KOxcx4,2702
+grim/assets.py,sha256=k2rFqNYfcUZfRjFL7r_UBGf1RlcP-urChXCUJ6GzEsI,7661
+grim/audio.py,sha256=V_TrnfrCb_0e2jeOhN7_kGBu8uMdMsFbk-REoUeWY7Q,3189
+grim/config.py,sha256=eQk_3ls_na9AiQr1yqbdyNRc2venM3_NS7Cqz75V08g,9644
+grim/console.py,sha256=bdhAedOwMpk9yKqwMfMoUsoLG5RQqOET6Ya0Zu2eWro,26598
+grim/fonts/__init__.py,sha256=yd2yLa0C-LTfjzZHpBl_AglynL3-PmPHePkulMiqLh0,81
+grim/fonts/grim_mono.py,sha256=DdTAuzGyliJF9ufI5YP039yfYYMWnJp3b6j7u9yvd8Q,3587
+grim/fonts/small.py,sha256=8Fgqhs-iejqXLyPxo2if2jqfKy9YvM2AZRTBj91M4Rs,4495
+grim/input.py,sha256=kiJ0AcOIT7slGA8snkfiKeAP7GyGDMF0dvZz2ePcG4I,1156
+grim/jaz.py,sha256=HcuJR9cj0RLhANlv9fzDuyLh8U6ktYoCiSq8hqg6Sx8,2870
+grim/math.py,sha256=xf6K1NKduWNHpKV1KE3Oet_uZW4pF4w0HhaXk7eGMm0,343
+grim/music.py,sha256=UGZ8W3a3Hus78O2N6WRf24_BYn9Eg9mj7RLi6jB5feo,12760
+grim/paq.py,sha256=KKQRueYP4HiqF9hNEk7dSem-4bn0J4OH2TJDg2CjbnA,1952
+grim/rand.py,sha256=TTxAe2o92XLloLOdMwLbE0lwdHXd8LPgWsrZCX2-nVU,862
+grim/sfx.py,sha256=cpn2Mmeio7BSDgbStSft-eZchO9Ot2MrK6iXJqxlLqU,7836
+grim/sfx_map.py,sha256=FM5iBzKkG30Vtu78SRavVNgXMbGK7ZFcQ8i6lgMlzVw,4697
+grim/terrain_render.py,sha256=EZ7ySYJyTZwXcrJx1mKbY3ewZtPi7Y270XnZgGJyZG8,31509
+grim/view.py,sha256=oF4pHZehBqOxPjKMU28TDg3qATh_amMIRJp-vMQnpn4,334
+crimsonland-0.1.0.dev1.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
+crimsonland-0.1.0.dev1.dist-info/entry_points.txt,sha256=jzzcExxiE9xpt4Iw2nbB1lwTv2Zj4H14WJTIPMkAjoE,77
+crimsonland-0.1.0.dev1.dist-info/METADATA,sha256=haZKto26DpNaPBn-jCWBUGh1XcAECPOoe5q_rsNHOMs,243
+crimsonland-0.1.0.dev1.dist-info/RECORD,,

crimsonland-0.1.0.dev1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.28
+Root-Is-Purelib: true
+Tag: py3-none-any

crimsonland-0.1.0.dev1.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+crimson = crimson.cli:main
+crimsonland = crimson.cli:main
+

grim/__init__.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+__all__ = [
+    "app",
+    "assets",
+    "audio",
+    "config",
+    "console",
+    "fonts",
+    "input",
+    "jaz",
+    "math",
+    "music",
+    "paq",
+    "rand",
+    "sfx",
+    "sfx_map",
+    "terrain_render",
+    "view",
+]

grim/app.py

@@ -0,0 +1,92 @@
+from __future__ import annotations
+
+from pathlib import Path
+import shutil
+
+import pyray as rl
+
+from .view import View
+
+SCREENSHOT_DIR = Path("screenshots")
+SCREENSHOT_KEY = rl.KeyboardKey.KEY_F12
+
+
+def _next_screenshot_index(directory: Path) -> int:
+    if not directory.exists():
+        return 1
+    max_index = 0
+    for entry in directory.glob("*.png"):
+        stem = entry.stem
+        if stem.isdigit():
+            max_index = max(max_index, int(stem))
+    return max_index + 1
+
+
+def _view_should_close(view: View) -> bool:
+    should_close = getattr(view, "should_close", None)
+    if callable(should_close):
+        return bool(should_close())
+    return bool(getattr(view, "close_requested", False))
+
+
+def run_view(
+    view: View,
+    *,
+    width: int = 1280,
+    height: int = 720,
+    title: str = "Crimsonland",
+    fps: int = 60,
+    config_flags: int = 0,
+) -> None:
+    """Run a Raylib window with a pluggable debug view."""
+    if config_flags:
+        rl.set_config_flags(config_flags)
+    rl.init_window(width, height, title)
+    rl.set_target_fps(fps)
+    open_fn = getattr(view, "open", None)
+    if callable(open_fn):
+        open_fn()
+    screenshot_dir = SCREENSHOT_DIR if SCREENSHOT_DIR.is_absolute() else Path.cwd() / SCREENSHOT_DIR
+    screenshot_index = _next_screenshot_index(screenshot_dir)
+    while not rl.window_should_close():
+        dt = rl.get_frame_time()
+        view.update(dt)
+        take_screenshot = rl.is_key_pressed(SCREENSHOT_KEY)
+        consume_screenshot = getattr(view, "consume_screenshot_request", None)
+        if callable(consume_screenshot) and consume_screenshot():
+            take_screenshot = True
+        rl.begin_drawing()
+        view.draw()
+        rl.end_drawing()
+        if _view_should_close(view):
+            break
+        if take_screenshot:
+            screenshot_dir.mkdir(parents=True, exist_ok=True)
+            filename = f"{screenshot_index:05d}.png"
+            rl.take_screenshot(filename)
+            src = Path.cwd() / filename
+            if src.exists():
+                shutil.move(str(src), str(screenshot_dir / filename))
+            screenshot_index += 1
+    close_fn = getattr(view, "close", None)
+    if callable(close_fn):
+        close_fn()
+    rl.close_window()
+
+
+def run_window(
+    width: int = 1280,
+    height: int = 720,
+    title: str = "Crimsonland",
+    fps: int = 60,
+) -> None:
+    """Open a minimal Raylib window for the reference implementation."""
+
+    class _EmptyView:
+        def update(self, dt: float) -> None:
+            return None
+
+        def draw(self) -> None:
+            rl.clear_background(rl.BLACK)
+
+    run_view(_EmptyView(), width=width, height=height, title=title, fps=fps)

grim/assets.py

@@ -0,0 +1,231 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+import io
+from pathlib import Path
+
+import pyray as rl
+from PIL import Image
+
+from . import jaz, paq
+
+
+PAQ_NAME = "crimson.paq"
+
+
+def find_paq_path(assets_root: Path, *, paq_name: str = PAQ_NAME) -> Path | None:
+    """Return the first matching PAQ path for the given assets root.
+
+    The repo layout often keeps extracted assets under `artifacts/assets/` while
+    the runtime PAQ lives under `artifacts/runtime/`. Views typically point at
+    the extracted root, so we look for common sibling/parent layouts too.
+    """
+
+    roots = (assets_root, assets_root.parent, assets_root.parent.parent)
+    for root in roots:
+        direct = root / paq_name
+        if direct.is_file():
+            return direct
+        runtime = root / "runtime" / paq_name
+        if runtime.is_file():
+            return runtime
+    return None
+
+
+def resolve_asset_path(assets_root: Path, rel_path: str) -> Path | None:
+    direct = assets_root / rel_path
+    if direct.is_file():
+        return direct
+    legacy = assets_root / "crimson" / rel_path
+    if legacy.is_file():
+        return legacy
+    return None
+
+
+@dataclass(slots=True)
+class TextureLoader:
+    assets_root: Path
+    cache: PaqTextureCache | None = None
+    missing: list[str] = field(default_factory=list)
+    _fs_textures: dict[str, rl.Texture] = field(default_factory=dict)
+
+    @classmethod
+    def from_assets_root(cls, assets_root: Path) -> TextureLoader:
+        paq_path = find_paq_path(assets_root)
+        if paq_path is not None:
+            try:
+                entries = load_paq_entries_from_path(paq_path)
+                cache = PaqTextureCache(entries=entries, textures={})
+                return cls(assets_root=assets_root, cache=cache)
+            except Exception:
+                pass
+        return cls(assets_root=assets_root)
+
+    def resolve_path(self, rel_path: str) -> Path | None:
+        return resolve_asset_path(self.assets_root, rel_path)
+
+    def _record_missing(self, rel_path: str) -> None:
+        raise FileNotFoundError(f"Missing asset: {rel_path}")
+
+    def load_from_cache(self, name: str, rel_path: str) -> rl.Texture | None:
+        if self.cache is None:
+            return None
+        try:
+            asset = self.cache.get_or_load(name, rel_path)
+        except FileNotFoundError:
+            return None
+        if asset.texture is None:
+            return None
+        return asset.texture
+
+    def load_from_path(self, name: str, rel_path: str) -> rl.Texture | None:
+        if name in self._fs_textures:
+            return self._fs_textures[name]
+        path = resolve_asset_path(self.assets_root, rel_path)
+        if path is None:
+            self._record_missing(rel_path)
+            return None
+        texture = rl.load_texture(str(path))
+        self._fs_textures[name] = texture
+        return texture
+
+    def get(self, *, name: str, paq_rel: str, fs_rel: str | None = None) -> rl.Texture | None:
+        if self.cache is not None:
+            texture = self.load_from_cache(name, paq_rel)
+            if texture is not None:
+                return texture
+        if fs_rel is None:
+            fs_rel = paq_rel
+        return self.load_from_path(name, fs_rel)
+
+
+@dataclass(slots=True)
+class TextureAsset:
+    name: str
+    rel_path: str
+    texture: rl.Texture2D | None
+
+    def unload(self) -> None:
+        texture = self.texture
+        if texture is None:
+            return
+        rl.unload_texture(texture)
+        self.texture = None
+
+
+@dataclass(slots=True)
+class LogoAssets:
+    backplasma: TextureAsset
+    mockup: TextureAsset
+    logo_esrb: TextureAsset
+    loading: TextureAsset
+    cl_logo: TextureAsset
+
+    def all(self) -> tuple[TextureAsset, ...]:
+        return (
+            self.backplasma,
+            self.mockup,
+            self.logo_esrb,
+            self.loading,
+            self.cl_logo,
+        )
+
+    def loaded_count(self) -> int:
+        return sum(1 for asset in self.all() if asset.texture is not None)
+
+
+@dataclass(slots=True)
+class PaqTextureCache:
+    entries: dict[str, bytes]
+    textures: dict[str, TextureAsset]
+
+    def get(self, name: str) -> TextureAsset | None:
+        return self.textures.get(name)
+
+    def texture(self, name: str) -> rl.Texture2D | None:
+        asset = self.textures.get(name)
+        return asset.texture if asset is not None else None
+
+    def get_or_load(self, name: str, rel_path: str) -> TextureAsset:
+        if name in self.textures:
+            return self.textures[name]
+        asset = _load_texture_asset_from_bytes(name, rel_path, self.entries.get(rel_path))
+        self.textures[name] = asset
+        return asset
+
+    def loaded_count(self) -> int:
+        return sum(1 for asset in self.textures.values() if asset.texture is not None)
+
+
+def load_paq_entries_from_path(paq_path: Path) -> dict[str, bytes]:
+    entries: dict[str, bytes] = {}
+    if not paq_path.exists():
+        raise FileNotFoundError(f"Missing PAQ archive: {paq_path}")
+    for name, data in paq.iter_entries(paq_path):
+        entries[name.replace("\\", "/")] = data
+    return entries
+
+
+def load_paq_entries(assets_dir: Path) -> dict[str, bytes]:
+    return load_paq_entries_from_path(assets_dir / PAQ_NAME)
+
+
+def _load_texture_from_bytes(data: bytes, fmt: str) -> rl.Texture2D:
+    image = rl.load_image_from_memory(fmt, data, len(data))
+    texture = rl.load_texture_from_image(image)
+    rl.unload_image(image)
+    rl.set_texture_filter(texture, rl.TEXTURE_FILTER_BILINEAR)
+    return texture
+
+
+def _load_texture_asset_from_bytes(name: str, rel_path: str, data: bytes | None) -> TextureAsset:
+    if data is None:
+        raise FileNotFoundError(f"Missing asset data: {rel_path}")
+    if rel_path.lower().endswith(".jaz"):
+        jaz_image = jaz.decode_jaz_bytes(data)
+        buf = io.BytesIO()
+        jaz_image.composite_image().save(buf, format="PNG")
+        return TextureAsset(
+            name=name,
+            rel_path=rel_path,
+            texture=_load_texture_from_bytes(buf.getvalue(), ".png"),
+        )
+    if rel_path.lower().endswith(".tga"):
+        img = Image.open(io.BytesIO(data))
+        buf = io.BytesIO()
+        img.save(buf, format="PNG")
+        return TextureAsset(
+            name=name,
+            rel_path=rel_path,
+            texture=_load_texture_from_bytes(buf.getvalue(), ".png"),
+        )
+    if rel_path.lower().endswith((".jpg", ".jpeg")):
+        img = Image.open(io.BytesIO(data))
+        buf = io.BytesIO()
+        img.save(buf, format="PNG")
+        return TextureAsset(
+            name=name,
+            rel_path=rel_path,
+            texture=_load_texture_from_bytes(buf.getvalue(), ".png"),
+        )
+    return TextureAsset(name=name, rel_path=rel_path, texture=None)
+
+
+def load_logo_assets(assets_dir: Path, *, entries: dict[str, bytes] | None = None) -> LogoAssets:
+    if entries is None:
+        entries = load_paq_entries(assets_dir)
+    return LogoAssets(
+        backplasma=_load_texture_asset_from_bytes(
+            "backplasma", "load/backplasma.jaz", entries.get("load/backplasma.jaz")
+        ),
+        mockup=_load_texture_asset_from_bytes("mockup", "load/mockup.jaz", entries.get("load/mockup.jaz")),
+        logo_esrb=_load_texture_asset_from_bytes(
+            "logo_esrb", "load/esrb_mature.jaz", entries.get("load/esrb_mature.jaz")
+        ),
+        loading=_load_texture_asset_from_bytes("loading", "load/loading.jaz", entries.get("load/loading.jaz")),
+        cl_logo=_load_texture_asset_from_bytes(
+            "cl_logo",
+            "load/logo_crimsonland.tga",
+            entries.get("load/logo_crimsonland.tga"),
+        ),
+    )

grim/audio.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from collections.abc import Callable
+from pathlib import Path
+import random
+
+import pyray as rl
+
+from .config import CrimsonConfig
+from .console import ConsoleState
+from . import music, sfx
+
+
+@dataclass(slots=True)
+class AudioState:
+    ready: bool
+    music: music.MusicState
+    sfx: sfx.SfxState
+
+
+def init_audio_state(config: CrimsonConfig, assets_dir: Path, console: ConsoleState) -> AudioState:
+    music_disabled = int(config.data.get("music_disable", 0)) != 0
+    sound_disabled = int(config.data.get("sound_disable", 0)) != 0
+    music_volume = float(config.data.get("music_volume", 1.0))
+    sfx_volume = float(config.data.get("sfx_volume", 1.0))
+
+    music_enabled = not music_disabled
+    sfx_enabled = not sound_disabled
+    if not music_enabled and not sfx_enabled:
+        console.log.log("audio: disabled (music + sfx)")
+        console.log.flush()
+        return AudioState(
+            ready=False,
+            music=music.init_music_state(ready=False, enabled=False, volume=music_volume),
+            sfx=sfx.init_sfx_state(ready=False, enabled=False, volume=sfx_volume),
+        )
+
+    if not rl.is_audio_device_ready():
+        rl.init_audio_device()
+    ready = bool(rl.is_audio_device_ready())
+    if not ready:
+        console.log.log("audio: device init failed")
+        console.log.flush()
+        return AudioState(
+            ready=False,
+            music=music.init_music_state(ready=False, enabled=False, volume=music_volume),
+            sfx=sfx.init_sfx_state(ready=False, enabled=False, volume=sfx_volume),
+        )
+
+    state = AudioState(
+        ready=True,
+        music=music.init_music_state(ready=True, enabled=music_enabled, volume=music_volume),
+        sfx=sfx.init_sfx_state(ready=True, enabled=sfx_enabled, volume=sfx_volume),
+    )
+    sfx.load_sfx_index(state.sfx, assets_dir, console)
+    music.load_music_tracks(state.music, assets_dir, console)
+    return state
+
+
+def play_music(state: AudioState, track_name: str) -> None:
+    music.play_music(state.music, track_name)
+
+
+def stop_music(state: AudioState) -> None:
+    music.stop_music(state.music)
+
+
+def trigger_game_tune(state: AudioState, *, rand: Callable[[], int] | None = None) -> str | None:
+    return music.trigger_game_tune(state.music, rand=rand)
+
+
+def play_sfx(
+    state: AudioState | None,
+    key: str | None,
+    *,
+    rng: random.Random | None = None,
+    allow_variants: bool = True,
+) -> None:
+    if state is None:
+        return
+    sfx.play_sfx(state.sfx, key, rng=rng, allow_variants=allow_variants)
+
+
+def set_sfx_volume(state: AudioState | None, volume: float) -> None:
+    if state is None:
+        return
+    sfx.set_sfx_volume(state.sfx, volume)
+
+
+def set_music_volume(state: AudioState | None, volume: float) -> None:
+    if state is None:
+        return
+    music.set_music_volume(state.music, volume)
+
+
+def update_audio(state: AudioState, dt: float) -> None:
+    music.update_music(state.music, dt)
+
+
+def shutdown_audio(state: AudioState) -> None:
+    if not state.ready:
+        return
+    sfx.shutdown_sfx(state.sfx)
+    music.shutdown_music(state.music)
+    rl.close_audio_device()