Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,18 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+pics/0.png filter=lfs diff=lfs merge=lfs -text
+pics/1.png filter=lfs diff=lfs merge=lfs -text
+pics/2.png filter=lfs diff=lfs merge=lfs -text
+pics/3.png filter=lfs diff=lfs merge=lfs -text
+pics/4.png filter=lfs diff=lfs merge=lfs -text
+pics/5.png filter=lfs diff=lfs merge=lfs -text
+pics/6.png filter=lfs diff=lfs merge=lfs -text
+pics/7.png filter=lfs diff=lfs merge=lfs -text
+pics/8.png filter=lfs diff=lfs merge=lfs -text
+pics/E1.png filter=lfs diff=lfs merge=lfs -text
+pics/E2.png filter=lfs diff=lfs merge=lfs -text
+pics/E3.png filter=lfs diff=lfs merge=lfs -text
+pics/E4.png filter=lfs diff=lfs merge=lfs -text
+pics/E5.png filter=lfs diff=lfs merge=lfs -text
+pics/origin.png filter=lfs diff=lfs merge=lfs -text

app.py

@@ -0,0 +1,219 @@
+import os
+
+import gradio as gr
+import numpy as np
+from PIL import Image
+import torch
+from transformers import pipeline
+
+from huggingface_hub import InferenceClient
+from moviepy.video.io.ImageSequenceClip import ImageSequenceClip
+
+from settings import EVENTS
+from player import Player
+from utils import PROMPT, INPUT_PROMPT, extract_after_final_answer
+
+# Initialize the HF Inference Client
+# It will automatically pick up the HF_TOKEN environment variable if it's set
+client = InferenceClient()
+
+# Define the models we want to use from the Hugging Face Hub
+LLM_MODEL = "Qwen/Qwen2.5-7B-Instruct"
+
+target_size=(1024, 1024)
+
+def compile_game_video(player, output_path="game_summary.mp4", fps=0.5):
+    """Compiles accumulated images into a video. fps=0.5 means 2 seconds per image."""
+    image_paths = player.get_images()
+    if not image_paths:
+        return None
+    
+    image_arrays = []
+    try:
+        for idx, img_path in enumerate(image_paths):
+            if isinstance(img_path, str) and os.path.exists(img_path):
+                with Image.open(img_path) as img:
+                    # 1. Force convert to RGB (strips alpha channel if PNG)
+                    img = img.convert("RGB")
+                    
+                    # 2. Resize to prevent MoviePy size mismatch crash
+                    if img.size != target_size:
+                        img = img.resize(target_size, Image.Resampling.LANCZOS if hasattr(Image, 'Resampling') else Image.LANCZOS)
+                    
+                    # 3. Convert PIL Image directly into a NumPy array and store in RAM
+                    img_array = np.array(img)
+                    image_arrays.append(img_array)
+            else:
+                print(f"⚠️ Warning: Skipping missing path: {img_path}")
+
+        if not image_arrays:
+            print("❌ Error: No valid image arrays collected.")
+            return None
+
+        print(f"🎬 Compiling {len(image_arrays)} arrays directly from RAM...")
+        # MoviePy natively accepts a list of NumPy arrays!
+        clip = ImageSequenceClip(image_arrays, fps=fps)
+        clip.write_videofile(output_path, codec="libx264", logger=None)
+        return output_path
+    except Exception as e:
+        print(f"Video compilation failed: {e}")
+        return None
+
+def start_game():
+    """Initializes or resets the game state when the app loads or restarts."""
+    initial_loc = 0
+    initial_player = Player('player') # Assuming your Player class initializes fresh attributes
+    initial_event = EVENTS[initial_loc]
+
+    initial_player.append_file(initial_event.filelist)
+    
+    # Format the very first event presentation
+    initial_story = f"### {initial_event.get_title()}\n\n{initial_event.get_description()}"
+    status = initial_player.get_attribute()
+    
+    # Return initial UI values + initial state values
+    return (
+        initial_story,                 # updates game_screen_ui
+        status['hp'],                        # updates status_ui
+        status['mp'],
+        status['coin'],
+        initial_event.get_images(),
+        gr.update(visible=True),       # ensures user input layout is visible
+        gr.update(visible=False, value=None),
+        initial_loc,                   # sets state_loc
+        initial_player,                # sets state_player
+        initial_event                  # sets state_cur
+    )
+
+def play_turn(human_response, loc, player, cur, custom_token, request: gr.Request):
+    """Executes a single turn of the game loop based on user input."""
+    if not human_response.strip():
+        return "Please type an action to proceed!", str(player.get_attribute()), gr.update(), gr.update(), loc, player, cur
+
+    chosen_token = custom_token.strip() if custom_token and custom_token.strip() else (request.token if request else None)
+
+    if not chosen_token:
+        yield "❌ **Authentication Required:** Please enter a token above or use OAuth.", "N/A", gr.update(), gr.update(), loc, player, cur
+        return
+
+    # 1. Process AI Model Response
+    messages = [
+        {
+            "role": "user", 
+            "content": PROMPT + INPUT_PROMPT.format(human_response)
+        }
+    ]
+    try:
+        response = client.chat_completion(
+            model=LLM_MODEL,
+            messages=messages,
+            max_tokens=500,
+            temperature=0.7
+        )
+    except Exception as e:
+        yield f"Error calling API: {str(e)}", str(player.get_attribute()), gr.update(), loc, player, cur
+        return
+    
+    processed_response = extract_after_final_answer(response.choices[0].message.content)
+    
+    # 2. Update Game State / Location
+    loc = cur._next(processed_response, player)
+    attribute = player.get_attribute()
+
+    # 3. Check for Game Over conditions
+    if attribute['hp'] <= 0 or attribute['mp'] <= 0:
+        loc = -1
+
+    cur = EVENTS[loc] 
+    if loc == -1 or loc >= 10:
+        # Final summary / Game Over screens
+        end_title = cur.get_title()
+        end_desc = cur.get_description()
+        next_image = cur.get_images()
+        player.append_file(cur.filelist)
+
+        final_story = f"### 🏁 {end_title}\n\n{end_desc}\n\n**The Journey Ends Here.**"
+        yield final_story, attribute['hp'], attribute['mp'], attribute['coin'], next_image, gr.update(visible=False), gr.update(), loc, player, cur
+        # Compile video now that game loop is terminating
+        video_file = compile_game_video(player)
+        
+        if video_file:
+            final_story += "\n\n🎞️ **Your adventure video is ready below!**"
+            yield final_story, attribute['hp'], attribute['mp'], attribute['coin'], next_image, gr.update(visible=False), gr.update(visible=True, value=video_file), loc, player, cur
+        return
+
+    # 4. Advance to the next event normally
+    cur = EVENTS[loc]
+    next_story = f"### {cur.get_title()}\n\n{cur.get_description()}"
+    next_image = cur.get_images()
+    
+    player.append_file(cur.filelist)
+
+    # Clear out the text box for the next turn while returning updated states
+    yield next_story, attribute['hp'], attribute['mp'], attribute['coin'], next_image, gr.update(value=""), gr.update(), loc, player, cur
+
+# --------------------------------------------------------------------------
+# LAYOUT DESIGN WITH INTEGRATED GALLERY BUILDER
+# --------------------------------------------------------------------------
+with gr.Blocks(theme=gr.themes.Soft()) as demo:
+    gr.Markdown("# ⚔️ RPG Sandbox")
+    gr.Markdown("## You can find your adventure recap below.")
+
+    
+    with gr.Accordion("🔑 Authentication Options", open=False):
+        with gr.Row():
+            gr.LoginButton() 
+            user_token_input = gr.Textbox(label="Or paste your HF Token (hf_...)", type="password")
+
+    state_loc = gr.State()
+    state_player = gr.State()
+    state_cur = gr.State()
+    
+    with gr.Row():
+        with gr.Column(scale=2):
+            game_screen_ui = gr.Markdown(value="### Setup authentication, then click below to wake up.")
+            
+            gr.Markdown("### 📜 Status Panel")
+            hp_ui = gr.Textbox(label="HP", interactive=False, value="0")
+            mp_ui = gr.Textbox(label="Mana Points (MP)", interactive=False, value="0")
+            coin_ui = gr.Textbox(label="Mana Points (MP)", interactive=False, value="0")
+
+            with gr.Row(visible=False) as input_panel:
+                user_input = gr.Textbox(label="Your Turn Action", placeholder="Type action and hit Enter...", scale=4)
+                submit_btn = gr.Button("Execute Action", variant="primary", scale=1)
+                
+            start_btn = gr.Button("🚀 Start / Reset Game", variant="secondary")
+
+        with gr.Column(scale=3):
+            gr.Markdown("### 🖼️ Story Scene")
+            
+            # UPGRADED: Gr.Image swapped to gr.Gallery to swallow flexible size limits
+            game_gallery_ui = gr.Gallery(
+                label="Story Plot", 
+                columns=[2],         # Display up to 2 side-by-side tiles automatically
+                rows=[2],
+                object_fit="contain",
+                height=800,
+                interactive=False
+            )
+            
+            # Added: Video output component, hidden by default
+            video_summary_ui = gr.Video(label="🎬 Adventure Recap", visible=False, autoplay=True)
+            
+
+    start_btn.click(
+        fn=start_game,
+        outputs=[game_screen_ui, hp_ui, mp_ui, coin_ui, game_gallery_ui, input_panel, video_summary_ui, state_loc, state_player, state_cur]
+    )
+
+    turn_config = {
+        "fn": play_turn,
+        "inputs": [user_input, state_loc, state_player, state_cur, user_token_input],
+        "outputs": [game_screen_ui, hp_ui, mp_ui, coin_ui, game_gallery_ui, user_input, video_summary_ui, state_loc, state_player, state_cur]
+    }
+    
+    submit_btn.click(**turn_config)
+    user_input.submit(**turn_config)
+
+if __name__ == "__main__":
+    demo.queue().launch()

llm.py

@@ -0,0 +1,37 @@
+from langchain_huggingface import ChatHuggingFace, HuggingFaceEndpoint
+
+HUGGINGFACE = {
+    'type': 'huggingface',
+    'param':{
+        'repo_id': "Qwen/Qwen2.5-7B-Instruct",
+        'task': 'text-generation',
+        'max_new_tokens': 512,
+        'do_sample': False,
+        'repetition_penalty': 1.03,
+        'provider': 'auto',
+    },
+    'model': 'huggingface:Qwen2.5-7B-Instruct',
+}
+
+HUGGINGFACE_LITE = {
+    'type': 'huggingface-lite',
+    'param':{
+        'repo_id': "Qwen/Qwen2.5-1.5B-Instruct",
+        'task': 'text-generation',
+        'max_new_tokens': 512,
+        'do_sample': False,
+        'repetition_penalty': 1.03,
+        'provider': 'auto',
+    },
+    'model': 'huggingface:Qwen2.5-1.5B-Instruct',
+}
+
+valid_LLM = [HUGGINGFACE, HUGGINGFACE_LITE]
+
+def setup_model(config: dict, callbacks=None):
+    if config['type'].startswith('huggingface'):
+        llm = HuggingFaceEndpoint(**config['param'])
+        model = ChatHuggingFace(llm=llm, callbacks=callbacks)
+    else:
+        model = None
+    return model

main.py

@@ -0,0 +1,31 @@
+from dotenv import load_dotenv
+load_dotenv('./.env')
+
+from settings import EVENTS
+from player import Player
+from llm import *
+from utils import PROMPT, INPUT_PROMPT, extract_after_final_answer
+
+loc = 0
+cur = EVENTS[loc]
+player = Player('player-1')
+model = setup_model(HUGGINGFACE)
+
+while loc != -1 and loc < 10:
+    print(f'Title: {cur.get_title()}')
+    print(f'{cur.get_description()}')
+
+    response = input("Human Response: ")
+    response = model.invoke(PROMPT + INPUT_PROMPT.format(response))
+    response = extract_after_final_answer(response.content)
+    loc = cur._next(response, player)
+    attribute = player.get_attribute()
+    print(response, loc)
+    if attribute['hp'] <= 0 or attribute['mp'] <= 0:
+        loc = -1
+    cur = EVENTS[loc]
+
+print('*'*20)
+print(f'Title: {cur.get_title()}')
+print(f'{cur.get_description()}')
+print(player.get_attribute())

nodes.py

@@ -0,0 +1,37 @@
+from player import Player
+from utils import *
+
+class Node:
+    def __init__(self, title: str, description: str, filelist: list[str], effect: dict = None, route = None, default: int = -1):
+        self.title = title
+        self.description = description
+        self.filelist = filelist
+        self.effect = effect
+        self.route = route
+        self.default = default
+
+    def _next(self, result: str, player: Player) -> int:
+        result = result.upper()
+
+        paired = self.effect.get(result, None) if self.effect is not None else None
+        if paired is not None:
+            for (change, attr, amount) in paired:
+                change(player, attr, amount)
+
+        if self.route is None:
+            return -1
+        if isinstance(self.route, dict):
+            next_node = self.route.get(result, self.default)
+        else:
+            print('Here')
+            next_node = self.route(player)
+        return next_node - 1 if next_node >= 0 else -1
+    
+    def get_title(self) -> str:
+        return self.title
+    
+    def get_description(self) -> str:
+        return self.description
+
+    def get_images(self) -> list[str]:
+        return self.filelist

player.py

@@ -0,0 +1,58 @@
+import random
+
+class Player:
+    def __init__(self, name: str):
+        self.name = name
+        print(f"Player's Name is {name} and initialize all his attributes")
+        self.hp = 75
+        self.mp = 50
+        self.coin = 20
+        self.items = []
+        self.frames = []
+
+    def reduce_hp(self, amount: int):
+        print(f'Reduce {amount} HP')
+        self.hp = max(0, self.hp-amount)
+
+    def add_hp(self, amount: int):
+        print(f'Add {amount} HP')
+        self.hp += amount
+
+    def reduce_mp(self, amount: int):
+        print(f'Reduce {amount} MP')
+        self.mp = max(0, self.mp-amount)
+
+    def add_mp(self, amount: int):
+        print(f'Add {amount} MP')
+        self.mp += amount
+
+    def reduce_coin(self, amount: int):
+        print(f'Reduce {amount} Coin')
+        self.coin = max(0, self.coin-amount)
+
+    def add_coin(self, amount: int):
+        print(f'Add {amount} Coin')
+        self.coin += amount
+
+    def add_item(self, item):
+        print(f'Add {item} to the item bag')
+        self.items.append(item)
+
+    def use_item(self, item):
+        if item not in self.items:
+            print(f'Could not use {item}')
+        else:
+            self.items.remove(item)
+            print(f'Used up {item} and there are {len(item)} items left')
+
+    def get_attribute(self) -> dict:
+        return {'hp': self.hp, 'mp': self.mp, 'coin': self.coin}
+    
+    def set_name(self, name: str):
+        self.name = name
+
+    def append_file(self, filelist: list[str]):
+        self.frames += filelist
+
+    def get_images(self):
+        return self.frames

requirements.txt

@@ -0,0 +1,267 @@
+acres==0.5.0
+aiofiles==24.1.0
+aiohappyeyeballs==2.6.1
+aiohttp==3.12.15
+aiosignal==1.4.0
+annotated-doc==0.0.4
+annotated-types==0.7.0
+anyio==4.10.0
+appnope==0.1.4
+argon2-cffi==25.1.0
+argon2-cffi-bindings==25.1.0
+arrow==1.3.0
+asttokens==3.0.0
+async-lru==2.0.5
+attrs==25.3.0
+Authlib==1.7.2
+babel==2.17.0
+backoff==2.2.1
+beautifulsoup4==4.13.5
+bleach==6.2.0
+brotli==1.2.0
+cachetools==5.5.2
+certifi==2025.8.3
+cffi==2.0.0
+charset-normalizer==3.4.3
+ci-info==0.3.0
+click==8.4.1
+clickhouse-connect==0.15.1
+comm==0.2.3
+configobj==5.0.9
+configparser==7.2.0
+contourpy==1.3.3
+cryptography==45.0.7
+cycler==0.12.1
+dataclasses-json==0.6.7
+ddgs==9.14.1
+debugpy==1.8.16
+decorator==5.2.1
+defusedxml==0.7.1
+distro==1.9.0
+duckdb==1.5.2
+duckduckgo_search==8.1.1
+emoji==2.14.1
+environs==9.5.0
+etelemetry==0.3.1
+executing==2.2.0
+faiss-cpu==1.8.0
+fastapi==0.136.1
+fastjsonschema==2.21.2
+ffmpy==1.0.0
+filelock==3.25.2
+filetype==1.2.0
+fitz==0.0.1.dev2
+fonttools==4.62.1
+fqdn==1.5.1
+frozenlist==1.7.0
+fsspec==2026.2.0
+google-ai-generativelanguage==0.6.18
+google-api-core==2.25.1
+google-auth==2.49.2
+google-genai==1.73.1
+googleapis-common-protos==1.70.0
+gradio==6.6.0
+gradio_client==2.1.0
+greenlet==3.2.4
+groovy==0.1.2
+grpcio==1.69.0
+grpcio-status==1.69.0
+h11==0.16.0
+hf-gradio==0.4.1
+hf-xet==1.5.1
+hnswlib==0.8.0
+html5lib==1.1
+httpcore==1.0.9
+httplib2==0.30.0
+httptools==0.7.1
+httpx==0.28.1
+httpx-sse==0.4.1
+huggingface_hub==0.36.2
+idna==3.10
+ImageIO==2.37.3
+imageio-ffmpeg==0.6.0
+inquirerpy==0.3.4
+ipykernel==6.30.1
+ipython==9.5.0
+ipython_pygments_lexers==1.1.1
+ipywidgets==8.1.7
+isoduration==20.11.0
+itsdangerous==2.2.0
+jedi==0.19.2
+Jinja2==3.1.6
+joblib==1.5.2
+joserfc==1.7.1
+json5==0.12.1
+jsonpatch==1.33
+jsonpointer==3.0.0
+jsonschema==4.25.1
+jsonschema-specifications==2025.4.1
+jupyter-events==0.12.0
+jupyter-lsp==2.3.0
+jupyter_server==2.17.0
+jupyter_server_terminals==0.5.3
+jupyterlab_pygments==0.3.0
+jupyterlab_server==2.27.3
+jupyterlab_widgets==3.0.15
+kiwisolver==1.5.0
+langchain==0.3.27
+langchain-community==0.3.29
+langchain-core==0.3.75
+langchain-google-genai==2.1.10
+langchain-huggingface==0.3.1
+langchain-milvus==0.1.7
+langchain-text-splitters==0.3.9
+langdetect==1.0.9
+langgraph==0.6.7
+langgraph-checkpoint==2.1.1
+langgraph-prebuilt==0.6.4
+langgraph-sdk==0.2.6
+langsmith==0.4.19
+lark==1.2.2
+looseversion==1.3.0
+lxml==6.0.1
+lz4==4.4.5
+Markdown==3.8.2
+markdown-it-py==4.0.0
+MarkupSafe==3.0.2
+marshmallow==3.26.1
+matplotlib==3.10.9
+matplotlib-inline==0.1.7
+mdurl==0.1.2
+milvus-lite==2.4.12
+mistune==3.1.4
+moviepy==2.2.1
+mpmath==1.3.0
+multidict==6.6.4
+mypy_extensions==1.1.0
+nbclient==0.10.2
+nbconvert==7.16.6
+nbformat==5.10.4
+nest-asyncio==1.6.0
+networkx==3.6.1
+nibabel==5.3.2
+nipype==1.10.0
+nltk==3.9.1
+notebook_shim==0.2.4
+numpy==1.26.4
+olefile==0.47
+orjson==3.11.3
+ormsgpack==1.10.0
+packaging==25.0
+pandas==2.3.2
+pandocfilters==1.5.1
+parso==0.8.5
+pathlib==1.0.1
+pexpect==4.9.0
+pfzy==0.3.4
+pillow==11.3.0
+platformdirs==4.4.0
+playwright-stealth==2.0.3
+posthog==7.14.0
+primp==1.2.3
+proglog==0.1.12
+prometheus_client==0.22.1
+prompt_toolkit==3.0.52
+propcache==0.3.2
+proto-plus==1.26.1
+protobuf==5.29.5
+prov==2.1.1
+psutil==7.0.0
+ptyprocess==0.7.0
+pure_eval==0.2.3
+puremagic==1.30
+pyasn1==0.6.1
+pyasn1_modules==0.4.2
+pycparser==2.22
+pydantic==2.13.4
+pydantic-settings==2.10.1
+pydantic_core==2.46.4
+pydot==4.0.1
+pydub==0.25.1
+pyee==13.0.1
+Pygments==2.19.2
+pymilvus==2.4.9
+PyMuPDF==1.26.4
+pyparsing==3.2.3
+pypdf==6.0.0
+python-dateutil==2.9.0.post0
+python-dotenv==1.1.1
+python-iso639==2025.2.18
+python-json-logger==3.3.0
+python-magic==0.4.27
+python-multipart==0.0.32
+python-oxmsg==0.0.2
+pytz==2025.2
+pyxnat==1.6.3
+PyYAML==6.0.2
+pyzmq==27.0.2
+RapidFuzz==3.14.0
+rdflib==7.1.4
+referencing==0.36.2
+regex==2025.9.1
+requests==2.32.5
+requests-toolbelt==1.0.0
+rfc3339-validator==0.1.4
+rfc3986-validator==0.1.1
+rfc3987-syntax==1.1.0
+rich==15.0.0
+rpds-py==0.27.1
+rsa==4.9.1
+safehttpx==0.1.7
+safetensors==0.6.2
+scikit-learn==1.7.1
+scipy==1.16.1
+seaborn==0.13.2
+semantic-version==2.10.0
+Send2Trash==1.8.3
+sentence-transformers==5.1.0
+setuptools==82.0.1
+shellingham==1.5.4
+simplejson==3.20.1
+six==1.17.0
+sniffio==1.3.1
+soupsieve==2.8
+SQLAlchemy==2.0.43
+stack-data==0.6.3
+starlette==0.52.1
+sympy==1.14.0
+tenacity==9.1.2
+terminado==0.18.1
+threadpoolctl==3.6.0
+tinycss2==1.4.0
+tokenizers==0.21.4
+tomlkit==0.13.3
+torch==2.2.2
+torchvision==0.17.2
+tornado==6.5.2
+tqdm==4.67.1
+traitlets==5.14.3
+traits==7.0.2
+transformers==4.49.0
+typer==0.25.1
+types-python-dateutil==2.9.0.20250822
+types-requests==2.32.4.20250809
+typing-inspect==0.9.0
+typing-inspection==0.4.2
+typing_extensions==4.15.0
+tzdata==2025.2
+ujson==5.11.0
+unstructured==0.18.14
+unstructured-client==0.42.3
+uri-template==1.3.0
+urllib3==2.5.0
+uvicorn==0.46.0
+uvloop==0.22.1
+watchfiles==1.1.1
+wcwidth==0.2.13
+webcolors==24.11.1
+webencodings==0.5.1
+websocket-client==1.8.0
+websockets==16.0
+wheel==0.47.0
+widgetsnbextension==4.0.14
+wikipedia==1.4.0
+wrapt==1.17.3
+xxhash==3.5.0
+yarl==1.20.1
+zstandard==0.24.0

settings.py

@@ -0,0 +1,155 @@
+import random
+
+from nodes import Node
+from utils import *
+
+EVENTS = [
+    Node(
+        "Dungeon Entrance", 
+        "A massive gate blocks the dungeon. A stone guardian awakens and says: 'Only those with strength may enter. What will you do to pass through it? \n\nAttack with sword, or magic, or even BRIDE it?",
+        ['pics/0.png'],
+        {
+            PHYSICAL_ATTACK: [(minus_attribute, 'hp', 20)],
+            MAGICAL_ATTACK: [(minus_attribute, 'mp', 20)],
+            SPEND_MONEY: [(minus_attribute, 'coin', 30)]
+        },
+        {
+            PHYSICAL_ATTACK: 2,
+            MAGICAL_ATTACK: 3,
+            SPEND_MONEY: 4,
+            LEAVE: -1
+        },
+        default = random.randint(2, 4)
+    ),
+    Node(
+        "Injured Warrior", 
+        "Inside the dungeon, you find a dying warrior. He carries a rare potion. What will you do? \n\nHelp Him, or Attack Him?",
+        ['pics/1.png'],
+        {
+            PHYSICAL_REFILL: [(add_attribute, 'hp', 5)],
+            PHYSICAL_ATTACK: [(minus_attribute, 'hp', 5)],
+            MAGICAL_ATTACK: [(minus_attribute, 'mp', 5)],
+        },
+        {
+            PHYSICAL_REFILL: 5,
+            PHYSICAL_ATTACK: 5,
+            MAGICAL_ATTACK: 5,
+            LEAVE: -1
+        },
+        default = 5
+    ),
+    Node(
+        "Magic Altar", 
+        "A mysterious altar offers power. What will you do? \n\nAttack this altar or Refill your stamina here?",
+        ['pics/2.png'],
+        {
+            MAGICAL_REFILL: [(add_attribute, 'mp', 10), (minus_attribute, "hp", 5)],
+            PHYSICAL_ATTACK: [(minus_attribute, 'hp', 15)],
+            PHYSICAL_REFILL: [(add_attribute, 'hp', 10)]
+        },
+        {
+            MAGICAL_REFILL: 5,
+            PHYSICAL_ATTACK: 5,
+        }, 
+        default = 5
+    ),
+    Node(
+        "Merchant Room", 
+        "A merchant appears and says: 'I trade only with survivors.' What will you do? \n\nSpend money, or Rob him?",
+        ['pics/3.png'],
+        {
+            PHYSICAL_ATTACK: [(minus_attribute, "hp", 15), (add_attribute, 'coun', 10)],
+            MAGICAL_ATTACK: [(minus_attribute, 'mp', 10), (add_attribute, 'coin', 10)],
+            SPEND_MONEY: [(minus_attribute, 'coin', 25), (add_attribute, 'mp', 5), (add_attribute, 'hp', 5)],
+        },
+        {
+            PHYSICAL_ATTACK: 5,
+            MAGICAL_ATTACK: 5,
+            MAGICAL_REFILL: 5,
+            SPEND_MONEY: 5,
+            EARN_MONEY: 5,
+        },
+        default = 5
+    ),
+    Node(
+        "Underground Lake", 
+        "A giant monster blocks the way. What will you do? \n\nAttack or Run?",
+        ['pics/4.png'],
+        {
+            PHYSICAL_ATTACK: [(minus_attribute, "hp", 30)],
+            MAGICAL_ATTACK: [(minus_attribute, 'mp', 20)],
+            LEAVE: [(minus_attribute, 'hp', 10)],
+        },
+        {
+            PHYSICAL_ATTACK: 6,
+            MAGICAL_ATTACK: 7,
+            LEAVE: 8,
+        },
+        default = random.randint(6, 8)
+    ),
+    Node(
+        "Ancient Library", 
+        "You find dragon history. What will you do? \n\nDestroy, or Rest, or Buy Weapon?",
+        ['pics/5.png', 'pics/origin.png'],
+        {
+            PHYSICAL_REFILL: [(add_attribute, "hp", 10)],
+            MAGICAL_REFILL: [(add_attribute, 'mp', 10)],
+            EARN_MONEY: [(add_attribute, 'coin', 20)],
+            MAGICAL_ATTACK: [(minus_attribute, 'mp', 15)]
+        },
+        {
+            PHYSICAL_REFILL: 9,
+            MAGICAL_REFILL: 9,
+            EARN_MONEY: 9,
+        },
+        default = 9
+    ),
+    Node(
+        "Dragon Prison", 
+        "A baby dragon is trapped. It is telling you the ORIGIN of DRAGON. What will you do? \n\nAttack, or Run, or Rescue?",
+        ['pics/6.png', 'pics/origin.png'],
+        {
+            PHYSICAL_ATTACK: [(minus_attribute, "hp", 30)],
+            MAGICAL_ATTACK: [(minus_attribute, 'mp', 20)],
+            LEAVE: [(minus_attribute, 'hp', 10)],
+        },
+        {
+            PHYSICAL_REFILL: 9,
+            MAGICAL_REFILL: 9,
+            EARN_MONEY: 9,
+        },
+        default = 9
+    ),
+    Node(
+        "Dark Corridor", 
+        "A shadow creature attacks. Its attack is fierce and fast. What will you do? \n\nFight back, or Run away?",
+        ['pics/7.png'],
+        {
+            PHYSICAL_ATTACK: [(minus_attribute, "hp", 45), (add_attribute, 'coin', 30)],
+            MAGICAL_ATTACK: [(minus_attribute, "mp", 35), (add_attribute, 'coin', 30)],
+            LEAVE: [(minus_attribute, 'hp', 20), (minus_attribute, 'mp', 20), (minus_attribute, 'coin', 20)]
+        },
+        {
+            PHYSICAL_ATTACK: 9,
+            MAGICAL_ATTACK: 9,
+            LEAVE: 9
+        },
+        default = 9
+    ),
+    Node(
+        "Dragon Chamber", 
+        "The ancient dragon wakes. Its eyes glow in the darkness. 'Another adventurer seeking my treasure?' What will you do?\n\nAttack and Rescue, or Run away?",
+        ['pics/8.png'],
+        {
+            PHYSICAL_ATTACK: [(minus_attribute, "hp", 30), (add_attribute, 'coin', 50)],
+            MAGICAL_ATTACK: [(minus_attribute, "mp", 25), (add_attribute, 'coin', 50)],
+            LEAVE: [(minus_attribute, 'hp', 15), (minus_attribute, 'mp', 15), (minus_attribute, 'coin', 15)]
+        },
+        route=check_ending
+    ),
+    Node("Perfect Victory", "You defeat the dragon without losing yourself. The dungeon recognizes you as the true successor.", ['pics/E1.png']),
+    Node("Exhausted Victory", "You defeat the dragon, but the battle drains every last bit of your power.", ['pics/E2.png']),
+    Node("You Survive", "You barely survive, but you lost everything", ['pics/E3.png']),
+    Node("Tyrant Ending", "Player seizes the dragon's power. Becomes the next monster.", ['pics/E4.png']),
+    Node("Game Over", "You have lost everything and this game", ['pics/E5.png'])
+]

utils.py

@@ -0,0 +1,98 @@
+import re, json
+from player import Player
+
+PHYSICAL_ATTACK = 'PHYSICAL_ATTACK'
+MAGICAL_ATTACK = 'MAGICAL_ATTACK'
+SPEND_MONEY = "SPEND_MONEY"
+LEAVE = "LEAVE"
+
+PHYSICAL_REFILL = "PHYSICAL_REFILL"
+MAGICAL_REFILL = 'MAGICAL_REFILL'
+EARN_MONEY = "EARN_MONEY"
+
+PROMPT = """
+You have to identify the category that the primary action described in the response belongs to. 
+
+Here are the strict categories:
+- PHYSICAL_ATTACK: Any action that causes or threatens physical damage, like stabbing, punching, firing guns, or weapon coercion.
+- MAGICAL_ATTACK: Any action that causes damage with spells or magic, like summoning a monster, striking a target with a flood or thunder.
+- SPEND_MONEY: Using money/coins to solve a problem, like bribing an NPC or buying an item.
+- PHYSICAL_REFILL: Any action that refills HP, offers medical aid, rests, or performs supportive/altruistic deeds (e.g., helping an injured NPC, patching wounds, resting) without spending coins or items.
+- MAGICAL_REFILL: Any action that refills MP, meditates, or channels spiritual energy without spending coins or items.
+- EARN_MONEY: Any action focused on earning money (like looting gold, selling items, or doing a job), provided it does not involve a PHYSICAL_ATTACK or MAGICAL_ATTACK.
+- LEAVE: Running away, retreating, doing absolutely nothing, or ignoring the situation entirely.
+
+The input format will be [RESPONSE]: "HUMAN RESPONSE"
+You must output your answer strictly in the following JSON format:
+{"FINAL ANSWER": "YOUR_ANSWER"}
+
+Remember: Identify ONLY the single most dominant primary action. If the action is purely a non-violent, helpful, or restorative interaction, classify it as PHYSICAL_REFILL. If the response is completely empty or completely irrelevant to the game, output LEAVE.
+
+---
+EXAMPLES:
+
+Input: [RESPONSE]: "I will bandage his wounds and help him stand up."
+Output: {"FINAL ANSWER": "PHYSICAL_REFILL"}
+
+Input: [RESPONSE]: "I see an injured traveler on the road. I will help him."
+Output: {"FINAL ANSWER": "PHYSICAL_REFILL"}
+
+Input: [RESPONSE]: "I draw my sword to threaten the shopkeeper, then summon lightning to strike him."
+Output: {"FINAL ANSWER": "MAGICAL_ATTACK"}
+
+Input: [RESPONSE]: "I turn around and walk away back into the forest."
+Output: {"FINAL ANSWER": "LEAVE"}
+"""
+
+INPUT_PROMPT = '\n[RESPONSE]: {}'
+
+def add_attribute(player: Player, attribute: str, amount: int):
+    attribute = attribute.lower()
+    if attribute == 'hp':
+        player.add_hp(amount)
+    elif attribute == 'mp':
+        player.add_mp(amount)
+    elif attribute == 'coin':
+        player.add_coin(amount)
+
+def minus_attribute(player: Player, attribute: str, amount: int):
+    attribute = attribute.lower()
+    if attribute == 'hp':
+        player.reduce_hp(amount)
+    elif attribute == 'mp':
+        player.reduce_mp(amount)
+    elif attribute == 'coin':
+        player.reduce_coin(amount)
+
+def check_ending(player: Player):
+    print('Ending', player.hp, player.mp)
+    if player.hp >= 50 and player.mp >= 20:
+        return 10
+    elif player.hp > 0 and player.mp > 0:
+        if player.coin <= 10:
+            return 12
+        else:
+            return 11
+    elif player.mp < 0:
+        return 13
+    else:
+        return 13
+    
+def extract_after_final_answer(text: str) -> str:
+    # re.findall finds every instance of { ... }
+    # [^}]* ensures we don't accidentally skip over nested structures
+    matches = re.findall(r'(\{.*?\})', text, re.DOTALL)
+    if not matches:
+        return None
+    
+    # We take the last match [-1]
+    last_json_str = matches[-1]
+
+    try:
+        # Replace single quotes with double quotes for valid JSON
+        valid_json_str = last_json_str.replace("'", '"')
+        data = json.loads(valid_json_str)
+        return data.get("FINAL ANSWER", "LEAVE")
+    except json.JSONDecodeError:
+        print(f'Could not fetch the keywords: "FINAL ANSWER" with the given response: {text}')
+        return "LEAVE"