প্রকল্প সম্পর্কে

Dungeon হলো একটি Node.js অ্যাপ্লিকেশন থেকে পরিবেশিত একটি লোকাল একক-খেলোয়াড় টেক্সট অ্যাডভেঞ্চার RPG। এর জন্য Node.js 22.13 বা তার পরে প্রয়োজন এবং কোনো প্যাকেজ ইনস্টলেশনের প্রয়োজন নেই; .env.example কে .env-এ কপি করে একটি প্রোভাইডার কী পূরণ করার পর, npm start গেমটি http://127.0.0.1:4317-এ পরিবেশন করে। ইন্টারফেস এবং ক্যাম্পেইন টেক্সট স্বাধীনভাবে ইংরেজি বা রুশ ভাষায় সেট করা যায়। খেলোয়াড়রা বিল্ট-ইন বা কাস্টম অ্যাডভেঞ্চার টেমপ্লেট থেকে নতুন ক্যাম্পেইন শুরু করেন, যেখানে আলাদা সেটিং, পরিস্থিতি, চরিত্র এবং ঐচ্ছিক DM-কেবল গোপন বিষয়বস্তু থাকে। কাস্টম টেমপ্লেট data/adventure-templates.json-এ সংরক্ষিত থাকে, লুকানো নির্দেশ প্রকাশ না করেই সম্পাদনা বা কপি করা যায় এবং বিল্ট-ইন টেমপ্লেট রিসেট করা যায়। একটি পরীক্ষামূলক ভিউয়ার শুধুমাত্র স্পয়লার নিশ্চিতকরণের পরে রচিত DM গোপন তথ্য এবং প্রতিষ্ঠিত লুকানো বিশ্ব তথ্য প্রকাশ করতে পারে, ক্যাম্পেইন পরিবর্তন না করেই। মডেল কনফিগারেশন একটি Settings পৃষ্ঠার মাধ্যমে পাওয়া যায়। এটি Gemini, OpenRouter, OpenAI, Anthropic, DeepSeek এবং xAI প্রোভাইডার সংযোগ, কাস্টম মডেল আইডি এবং অফিসিয়াল প্রোভাইডার API থেকে প্রাপ্ত মডেল তালিকা সমর্থন করে, কোনো পেইড ইনফারেন্স ছাড়াই; তালিকা এক ঘণ্টার জন্য ক্যাশে করা হয়। অনুরোধকৃত ডিফল্ট হলো Gemini gemini-3.8-flash। একটি ঐচ্ছিক Artificial Analysis API কী মূল্য রেফারেন্স চালু করে, যা ছয় ঘণ্টার জন্য ক্যাশে থাকে, OpenRouter ফলব্যাক সহ। সব মডেল কল একটি লোকাল খরচের খাতা ভাগ করে, এবং অ্যাপটি কেবল লোকাল খরচ অনুমান করে, অ্যাকাউন্ট-ব্যাপী প্রোভাইডার ইনভয়েস হিসেবে কাজ করে না। গেমপ্লেতে একটি একক খেলোয়াড় চরিত্র ব্যবহৃত হয়। DM সেটিং এবং প্রতিষ্ঠিত ইতিহাসের মধ্যে বিবরণ উদ্ভাবন করেন। অর্থবহ চেকগুলিতে বেস অসুবিধা, লেবেলযুক্ত মডিফায়ার, ক্ল্যাম্পিংয়ের আগে মোট, সাফল্যের সম্ভাবনা এবং একটি বাস্তব d100 ফলাফল উপস্থাপন করা হয়; 0 বা 100 শতাংশ গণনাকৃত সম্ভাবনাযুক্ত ক্রিয়াগুলি নিশ্চিত এবং কোনো ডাই ব্যবহার করে না। খেলোয়াড়রা খেলার বাইরের প্রশ্ন করতে পারেন, রুলিংয়ের বিরুদ্ধে আপিল করতে বা সংশোধন/আনডু অনুরোধ করতে পারেন, উৎসসহ চরিত্র ও বিশ্ব জ্ঞান পরিদর্শন করতে পারেন এবং জার্নাল অনুসন্ধান করতে পারেন। সেভ এবং রিলোড স্বয়ংক্রিয়। ক্যাম্পেইন ডেটা data/campaigns.sqlite-এ, খরচ data/spend-ledger.json-এ এবং ব্যক্তিগত প্রোভাইডার ফলাফল data/provider-results-এ সংরক্ষিত থাকে। রিপোজিটরিতে মক প্রোভাইডার ব্যবহার করে npm test এবং npm run check ভ্যালিডেশন অন্তর্ভুক্ত রয়েছে, এবং DUNGEON_PLAYWRIGHT_PATH সেট করা থাকলে ঐচ্ছিক Playwright ব্রাউজার পরীক্ষাও থাকে। ডকুমেন্টেশন পাইলট নিয়ম এবং প্লেটেস্ট ফলাফল বর্ণনা করে। এতে বলা হয়েছে যে অবশিষ্ট কঠিন সমস্যা হলো শব্দার্থিক বিচার এবং এটি নিখুঁত DM আচরণ বা প্রোভাইডার গেমপ্লে মানের নিশ্চয়তা দেয় না।