1-Quick-Start-in-5min.md

شروع بازی در ۵ دقیقه

در این مستند، قصد داریم تا نحوه‌ی اجرای بازی AIC2021 را در تنها ۵ دقیقه آموزش دهیم. علاوه بر آن، راهنمایی‌هایی برای ادامه کد زدن روی کلاینت‌ها برای بعد از این شروع سریع نیز گفته می‌شود.

1. دانلود فولدر بازی

ابتدا باید فولدر بازی را از مخزن فولدر بازی رویداد دانلود نمایید. سپس، آن را unzip کنید. در این مخزن (ریپو)، تمامی موارد لازم برای اجرای بازی غیر از کلاینت‌ها قرار دارد. نقشه‌ها، آپدیت سرور و گرافیک بازی و ... از طریق این ریپو صورت می‌گیرد.

2. دانلود کلاینت مورد نظر

از بین ۳ زبان کلاینت موجود در مسابقه، یک زبان را انتخاب کرده و آن را از مخزن مربوطه دانلود نمایید. سپس آن را unzip کنید.

• کلاینت Cpp
• کلاینت Java
• کلاینت Python

3. اجرای بازی

در ویندوز، cmd و در سیستم عامل‌های دیگر، terminal را باز کنید. ابتدا با اجرای کد زیر مطمئن شوید که java را به صورت نصب دارید.

java --version

درصورتی که در جواب، ورژن جاوا نوشته شده باشد، به این معناست که شما جاوا را در دستگاه خود دارید. درغیر اینصورت و در صورت دادن ارور، بایستی با استفاده از این لینک جاوا را نصب کنید.
توجه کنید که حتما فایل map.config کنار فایل jar سرور باشد. حالا می‌توانید با اجرای دستور زیر، بازی را اجرا کنید.

java -jar /path/to/server.jar --first-team=/path/to/first-client --second-team=/path/to/second_client

منظور از /path/to/first-client، آدرس فایل کلاینت شماست. به طور مثال، اگر فایل کلاینت شما در مسیر /home/ubuntu/AIC_Code/client.jar بود، باید آپشن --first-team را به صورت زیر استفاده کنید:

 --first-team=/home/ubuntu/AIC_Code/client.jar

به طور مشابه برای آدرس کلاینت دوم و همچنین آدرس سرور.

• توجه: به جای آدرس‌های کلاینت اول و دوم، می‌توانید آدرس فایل jar یا binary که از کلاینت مورد نظر خود ساخته‌اید(نحوه ساختن فایل باینری و jar در داک سرور کلاینت موجود است.) را بدهید. پس از اجرای کامند بالا، مقداری طول می‌کشد تا بازی اجرا شود. می‌توانید لاگ بازی را نیز در همان ترمینال مشاهده کنید. بعد از اتمام اجرای بازی، فایلی به اسم log.json به عنوان خروجی در کنار فایل jar قرار می‌گیرد.

4. دادن لاگ بازی به گرافیک

با کلیک کردن بر روی فایل graphic.exe برنامه گرافیک بازی را باز کنید و با کلیک روی دکمه‌ی Browse GameLog، آدرس فایل log.json بدست آمده در مرحله قبل را به آن بدهید. پس از آن می‌توانید بازی را به صورت گرافیکی مشاهده کنید. توجه کنید که روی سیستم‌عامل‌های unix based، با اجرای دستور chmod +x /path/to/graphic/file آن را قابل اجرا کنید.
منظور از /path/to/graphic/file، آدرس فایل اجرایی گرافیک است. به طور مثال، روی سیستم‌عامل لینوکس، فایل Linux.x86_64 فایل اجرایی گرافیک است، پس باید مقابل دستور chmod +x، آدرس این فایل را قرار دهید.

5. تامام تامام

شما توانستید بازی را با کلاینت پیش‌فرض اجرا کنید. حال می‌توانید با تکمیل کد در فایل AI در کلاینت مورد نظر خود، کد دلخواه خود را برای هریک از نیرو‌ها بزنید و به همان شکل آن را اجرا کنید. هم‌چنین بعد از باز شدن امکان ارسال کد بر رو سایت می‌توانید کل فولدر کلاینت را زیپ کرده و بر روی سایت بفرستید تا رتبه خود را در اسکوربورد تغییر دهید.