FIRA Chovgan Simulation League · U14 / U19

Chovgan Simulation

شبیه‌ساز مسابقه‌ی چوگان، ورزش تیمی سنتی ایران، برای ربات‌های خودمختار. دو تیم، هر کدام با چهار ربات، در یک زمین مجازی با فیزیک واقعی بازی می‌کنند. پس از شروع مسابقه هیچ انسانی ربات‌ها را کنترل نمی‌کند؛ همه‌چیز را کد Python شما تصمیم می‌گیرد و گل، خطا و زمان به‌صورت خودکار و دقیق ثبت می‌شود.

مسابقه‌ی Chovgan در شبیه‌ساز رسمی
شبیه‌ساز رسمی CHOVGAN: تیم قرمز و تیم آبی، هر کدام چهار ربات، در ورزشگاه و کنار دایره‌ی مرکزی
این لیگ چیست

چهار ربات، یک توپ، یک زمین مجازی

هر تیم کدی می‌نویسد که چهار ربات آن را هدایت می‌کند. ربات‌های تیم آبی B1 تا B4 و ربات‌های تیم زرد Y1 تا Y4 نام دارند (در شبیه‌ساز به‌صورت قرمز و آبی نمایش داده می‌شوند). هر ربات GPS، قطب‌نما، چهار حسگر فاصله، گیرنده‌ی توپ و فرستنده/گیرنده‌ی تیمی دارد و فقط سرعت چرخ چپ و راست خودش را تعیین می‌کند. هیچ دکمه‌ی «شوت» یا «پاس» وجود ندارد؛ هر تعامل با توپ فیزیکی است.

مسابقه دو نیمه‌ی ۲ دقیقه‌ای دارد. هر گل معتبر یک امتیاز است و تیمی که گل بیشتری بزند برنده است. امتیاز جداگانه‌ای برای مالکیت توپ، پاس، زیبایی کد یا مصاحبه داده نمی‌شود؛ فقط نتیجه‌ی مسابقه. تیم‌ها در دو رده‌ی کاملاً جدای U14 و U19 بازی می‌کنند. در U14 یک قابلیت ویژه به نام Coach Board وجود دارد که در U19 نیست.

۴ رباتدر هر تیم، همه با امکانات یکسان
۲ × ۲ دقیقهدو نیمه روی ساعت رسمی شبیه‌ساز
۲ تا ۴ نفراعضای تیم به‌علاوه‌ی یک کاپیتان
Pythonبا SDK رسمی Chovgan 1.0
یک فایل ZIPکد هر چهار ربات در یک بسته
U14 · U19رده‌ها کاملاً جدا؛ سن مبنا ۳۰ ژوئن ۲۰۲۶
مهارت‌هایی که یاد می‌گیرید: برنامه‌نویسی Python، هندسه و مثلثات، کنترل حرکت ربات دیفرانسیلی، استدلال با داده‌ی حسگر، ارتباط میان ربات‌ها و راهبرد تیمی.
ویدیوی نمونه

نمونه مسابقه Chovgan

یک مسابقه کامل در شبیه‌ساز رسمی CHOVGAN: دو تیم چهار رباتی، توپ، گل‌ها و تابلوی امتیاز. این همان چیزی است که در روز مسابقه روی پرده دیده می‌شود.

ضبط‌شده از شبیه‌ساز رسمی، بدون تدوین.دانلود ویدیو
محیط شبیه‌ساز

شبیه‌ساز CHOVGAN چه شکلی است؟

تصاویر از نسخه‌ی Windows شبیه‌ساز (Showcase v1) و راهنمای دانش‌آموزی v1.3 گرفته شده‌اند. برخی صفحه‌ها هنوز نام قدیمی «CHOVGAN» را روی خود دارند؛ نام رسمی لیگ CHOVGAN است. ترتیب پیشنهادی یادگیری: Rules & Guide ← Robot Lab ← Training ← Competition.

شروع از صفر

از صفر تا اولین مسابقه: نصب شبیه‌ساز، گرفتن کد پایه، بارگذاری و تحویل

این بخش برای کسی نوشته شده که هنوز هیچ‌چیز نصب نکرده. مرحله‌ها را به ترتیب بروید؛ در پایان یک مسابقه یا پرواز واقعی با کد خودتان دیده‌اید.

چه چیزهایی لازم دارید

یک رایانه‌ی ویندوزی ۶۴ بیتی (ویندوز ۱۰ یا ۱۱) با حدود یک گیگابایت فضای خالی، و یک ویرایشگر متن مثل VS Code یا Notepad++. Python لازم نیست نصب کنید، چون داخل خود شبیه‌ساز هست. اینترنت فقط برای دانلود لازم است.

شبیه‌ساز را دانلود و باز کنید

از بخش دانلود همین صفحه فایل CHOVGAN-1.0.0-windows-x86_64.zip را بگیرید. روی آن راست‌کلیک کنید و Extract All را بزنید تا در پوشه‌ای مثل C:\CHOVGAN باز شود. داخل پوشه چیزی را جابه‌جا نکنید؛ CHOVGAN.exe باید کنار پوشه‌های python و sdk بماند.

شبیه‌ساز را اجرا کنید

روی CHOVGAN.exe دوبار کلیک کنید. نصب ندارد. اگر ویندوز پنجره‌ی آبی «Windows protected your PC» نشان داد، روی More info و بعد Run anyway بزنید. منوی اصلی با گزینه‌های Competition، Training، Robot Lab، Rules & Guide و Settings باز می‌شود. برای بار اول یک سر به Rules & Guide و Robot Lab بزنید تا زمین و ربات را ببینید.

کد پایه را دانلود کنید

از بخش دانلود فایل Chovgan-BaseCode.zip را بگیرید و آن را هم باز کنید، مثلاً در Documents\chovgan_base. پوشه‌ی chovgan_team همان کد تیم شماست: robot1.py دروازه‌بان، robot2.py مدافع، robot3.py و robot4.py دو مهاجم. فایل robot.py فقط تشخیص می‌دهد هر ربات کدام فایل را اجرا کند و معمولاً لازم نیست به آن دست بزنید.

اولین مسابقه را بدون تغییر کد اجرا کنید

در شبیه‌ساز Competition را بزنید و رده‌ی خود را انتخاب کنید (Select U14 یا Select U19). مرحله‌ی MATCH و TEAMS را پر کنید (نام دو تیم). در مرحله‌ی STRATEGY برای هر دو تیم روی Select team ZIP… بزنید و همان Chovgan-BaseCode.zip را بدهید. شبیه‌ساز کد را بررسی می‌کند و زیر نام تیم باید VALID بنویسد. بعد READY و شروع مسابقه. اگر این مسابقه اجرا شد، همه‌چیز درست نصب شده.

کد را کجا و چطور عوض کنیم

پوشه‌ی chovgan_team را در VS Code باز کنید (File → Open Folder). فایل robot3.py را باز کنید و یک چیز کوچک را عوض کنید، مثلاً سرعت حرکت را. ذخیره کنید. حالا باید دوباره ZIP بسازید: پوشه‌ی chovgan_team و فایل team_name.txt را با هم انتخاب کنید، راست‌کلیک، Send to → Compressed (zipped) folder. این ZIP جدید را در مرحله‌ی STRATEGY بارگذاری کنید و مسابقه بدهید. هر بار که کد را عوض می‌کنید همین چرخه تکرار می‌شود: ویرایش، ذخیره، ZIP، بارگذاری.

یاد گرفتن قدم‌به‌قدم

در chovgan_team/robot.py عدد LESSON را ۱ بگذارید، دوباره ZIP بسازید و در Training → Movement اجرا کنید. هشت درس داریم: فرمان‌های ساده مثل forward(2) و turn_left(90)، موتورها، حسگرها، قطب‌نما، GPS، سونار، توپ و پیام تیمی. توضیح هر کدام در آموزش از صفر است. برای مسابقه LESSON = 0 بگذارید.

تحویل کد برای مسابقه

همان ZIP مرحله‌ی قبل را تحویل می‌دهید: داخل آن پوشه‌ی chovgan_team/ و فایل team_name.txt (نام تیم در یک خط) باید مستقیم در سطح اول باشد، نه داخل یک پوشه‌ی دیگر. پوشه‌ی local_runtime را داخل ZIP نگذارید. محل و مهلت آپلود در کانال کمیته فنی اعلام می‌شود.

اگر به مشکل خوردید

اگر زیر نام تیم INVALID آمد، پیام خطا را بخوانید. معمولاً یکی از این‌هاست: پوشه داخل پوشه در ZIP، فایل بازیکنی که حذف شده، یا خطای نگارشی در Python. ZIP را باز کنید و مطمئن شوید chovgan_team همان سطح اول است. اگر حل نشد، در کانال کمیته فنی با ذکر کد خطا بپرسید.

ساختار پیشنهادی ZIP تیم

ChovganTeam.zip
  chovgan_team/
    robot.py          # راه‌انداز: بازیکن درست را انتخاب می‌کند
    chovgan_robot.py   # کمکی مشترک ChovganRobot
    robot1.py         # بازیکن ۱
    robot2.py         # بازیکن ۲
    robot3.py         # بازیکن ۳
    robot4.py         # بازیکن ۴
    utils.py          # اختیاری: توابع مشترک
  team_name.txt       # نام تیم
  logo.png            # اختیاری

راه‌انداز robot.py

from controller import Robot
from robot1 import ChovganPlayer1
from robot2 import ChovganPlayer2
from robot3 import ChovganPlayer3
from robot4 import ChovganPlayer4

PLAYERS = {1: ChovganPlayer1, 2: ChovganPlayer2,
           3: ChovganPlayer3, 4: ChovganPlayer4}

robot = Robot()
number = int(robot.getName()[1:])   # "B3" -> 3
player = PLAYERS[number](robot)
player.run()
پیش از آپلود چک کنید: هر چهار فایل بازیکن هست؛ robot.py آن‌ها را درست import می‌کند؛ team_name.txt واقعاً متنی است (نه team_name.txt.txt)؛ ZIP بدون خطا باز می‌شود؛ پوشه‌ی اضافی یا پوشه‌ی controllers/ وجود ندارد؛ بسته‌ی controller خود شبیه‌ساز را داخل ZIP نگذاشته‌اید.

دیدن بازی از زوایای مختلف

در جریان مسابقه، کلید Esc را بزنید تا منوی مکث (drawer) باز شود؛ در فهرست CAMERA هفت نما هست. میان‌بر صفحه‌کلید هم دارد: 1 Broadcast، 2 Sideline، 3 Spider، 4 Rider (سوار بر ربات)، 5 Behind Goal، 6 Tactical، 7 Free Camera. Space بازی را نگه می‌دارد و دوباره ادامه می‌دهد؛ Esc منو را باز و بسته می‌کند.

نمای Broadcast
Broadcast (کلید ۱). نمای پیش‌فرض تلویزیونی: کارگردان خودکار بین نماهای دور و نزدیک جابه‌جا می‌شود و همیشه توپ را در کادر نگه می‌دارد. برای تماشای عادی همین کافی است.
نمای Sideline
Sideline (کلید ۲). دوربین ثابت کنار زمین، مثل جایگاه تماشاگران. برای دیدن آرایش کلی دو تیم و این‌که کدام ربات‌ها عقب مانده‌اند.
نمای Spider
Spider (کلید ۳). دوربین معلق از بالا و کمی مایل (مثل دوربین عنکبوتی ورزشگاه‌ها). فاصله‌ی ربات‌ها تا توپ و خط‌ها در این نما خوب دیده می‌شود.
نمای Behind Goal
Behind Goal (کلید ۵). پشت دروازه‌ای که توپ به آن نزدیک‌تر است. بهترین نما برای فهمیدن این‌که مهاجم شما توپ را «به سمت دروازه» هل می‌دهد یا کج می‌رود.
نمای Follow Ball
Follow Ball. دوربین پشت توپ حرکت می‌کند و همیشه رو به جهت حرکت آن است. برای دنبال‌کردن یک حمله‌ی مشخص.
نمای Tactical
Tactical (کلید ۶). نقشه‌ی تمام زمین از بالا؛ همه‌ی هشت ربات و توپ یک‌جا. وقتی می‌خواهید بفهمید کد شما چرا ربات را به جای اشتباه می‌فرستد، از این نما شروع کنید.
نمای Free Camera
Free Camera (کلید ۷). دوربین آزاد: با ماوس بچرخانید و با کلیدهای جهت جابه‌جا شوید تا هر زاویه‌ای را که می‌خواهید ببینید.
نکته: کلید 4 (Rider) دوربین را روی یکی از ربات‌ها می‌نشاند؛ با زدن دوباره‌ی آن به ربات بعدی می‌رود. برای عکس‌گرفتن از یک لحظه، اول Space (مکث) بعد زاویه را عوض کنید.

تست کردن کد

۱) Training ← Movement: اولین تست هر کدی

از منوی اصلی Training و بعد کاشی Movement را بزنید. با Import ZIP همان ZIP تیم را بدهید و Start را بزنید. هر چهار ربات با کد شما در زمین خالی (فقط توپ، بدون حریف) اجرا می‌شوند. دکمه‌های Reset (برگرداندن ربات‌ها و توپ به جای اول)، Retry (اجرای دوباره‌ی همان کد) و Reload code (خواندن دوباره‌ی ZIP بعد از ویرایش) چرخه‌ی ویرایش→تست را کوتاه می‌کنند. در پایان، نتیجه به‌صورت یک فایل JSON (مسافت طی‌شده، تماس با توپ، خطاها) ذخیره می‌شود.

۲) Robot Lab: سنسورها را زنده ببینید

Robot Lab و بعد Open live sensor practice. یک ربات در زمین است و مقدار لحظه‌ای GPS، قطب‌نما، سونارها و گیرنده‌ی توپ کنار صفحه نشان داده می‌شود. با Motion Presets حرکت‌های آماده (جلو، عقب، چرخش) و با Turning Test رابطه‌ی سرعت چپ/راست با جهت چرخش را امتحان کنید؛ همین‌جا می‌فهمید «چپ بزرگ‌تر از راست = چرخش ساعتگرد».

۳) اعتبارسنج مرحله‌ی STRATEGY

در Competition، مرحله‌ی STRATEGY پس از انتخاب ZIP کد را بررسی می‌کند: ساختار پوشه، import‌های مجاز، و یک اجرای آزمایشی چهار ربات. زیر نام تیم VALID یا INVALID می‌آید. کدهای خطای رایج: MISSING_ENTRYPOINT (پوشه‌ی chovgan_team/robot.py در سطح اول ZIP نیست)، IMPORT_ERROR (ماژولی خارج از فهرست مجاز مثل os یا numpy)، UNKNOWN_DEVICE (نام دستگاه اشتباه در getDevice)، PYTHON_SYNTAX_ERROR (خطای نگارشی؛ شماره‌ی خط در پیام هست). تا هر دو تیم VALID نباشند، READY فعال نمی‌شود.

۴) پنل کنترلرها در منوی مکث

در جریان مسابقه Esc و بعد Controller status. برای هر ربات (B1…B4 / Y1…Y4) وضعیت (RUNNING / CRASHED)، فایل اجراشده و آخرین خطوط خروجی print() کد شما دیده می‌شود. اگر رباتی کرش کند فقط همان ربات می‌ایستد، بقیه ادامه می‌دهند و متن خطا (traceback) همین‌جا نشان داده می‌شود؛ پس print() گذاشتن در کد، ساده‌ترین راه اشکال‌زدایی است.

مرحله‌ی STRATEGY با وضعیت VALID
STRATEGY. هر دو تیم کد پایه را بارگذاری کرده‌اند و اعتبارسنج برای هر دو VALID نوشته است. هش بسته و نام تیم از team_name.txt خوانده شده.
مرحله‌ی READY
READY. خلاصه‌ی مسابقه: نام تیم‌ها، فایل هر ربات، و دکمه‌ی شروع. اگر یکی از تیم‌ها INVALID باشد این دکمه قفل می‌ماند.
منوی مکث
منوی مکث (Esc). ادامه، فهرست CAMERA، Controller status، تنظیمات و خروج به منو.
پنل وضعیت کنترلرها
Controller status. وضعیت و خروجی print() هر هشت کنترلر؛ ربات کرش‌کرده با CRASHED و متن خطا مشخص می‌شود.
صفحه‌ی Training
Training. از Movement شروع کنید؛ ZIP را Import و Start کنید.
Robot Lab
Robot Lab. سنسورهای زنده، Motion Presets و Turning Test.

ساده‌ترین کد پایه (U14 و U19)

این یک فایل chovgan_team/robot.py کامل است که به‌تنهایی کار می‌کند (به robot1.py تا robot4.py نیاز ندارد؛ هر چهار ربات همین فایل را اجرا می‌کنند). کار ربات: توپ را پیدا کن، پشت آن قرار بگیر و آن را به سمت دروازه‌ی حریف هل بده. همین کد در اعتبارسنج شبیه‌ساز VALID است و برای هر دو رده‌ی U14 و U19 عیناً قابل استفاده است.

# ساده‌ترین کد پایه‌ی CHOVGAN: دنبال توپ برو و آن را به سمت دروازه‌ی حریف هل بده
import json, math
from controller import Robot

robot = Robot()
team = robot.getName()[0]                      # "B" یا "Y"
left = robot.getDevice("left wheel motor")     # موتور چپ
right = robot.getDevice("right wheel motor")   # موتور راست
gps = robot.getDevice("gps")                   # موقعیت [x, y, h]
compass = robot.getDevice("compass")           # قطب‌نما
ball = robot.getDevice("ball receiver")        # گیرنده‌ی توپ
referee = robot.getDevice("supervisor receiver")  # پیام‌های داور
for device in (gps, compass, ball, referee):
    device.enable(32)
left.setPosition(float("inf"))                 # حالت سرعتی موتورها
right.setPosition(float("inf"))
attack_x = -52.5 if team == "B" else 52.5      # دروازه‌ی حریف (تا پیام داور برسد)
ball_x, ball_y = None, None

while robot.step(32) != -1:
    x, y, _h = gps.getValues()                 # کجا هستم؟
    v = compass.getValues()
    heading = math.atan2(v[0], v[1]) + math.pi / 2   # به کدام سمت نگاه می‌کنم؟
    while referee.getQueueLength() > 0:        # پیام داور: کدام دروازه مال حریف است؟
        msg = json.loads(referee.getString() or "{}")
        referee.nextPacket()
        if msg.get("type") == "chovgan.match_state.v1" and "attack_x" in msg:
            attack_x = float(msg["attack_x"][team])
    while ball.getQueueLength() > 0:           # توپ را می‌بینم؟
        d = ball.getEmitterDirection()         # [جلو, چپ, بالا]
        dist = 1.0 / math.sqrt(ball.getSignalStrength())  # قدرت سیگنال = 1/d²
        ball.nextPacket()
        angle = heading + math.atan2(d[1], d[0])
        ball_x, ball_y = x + dist * math.cos(angle), y + dist * math.sin(angle)
    if ball_x is None:                         # هنوز توپ را ندیده‌ام: بایست
        left.setVelocity(0.0); right.setVelocity(0.0)
        continue
    to_goal = math.atan2(0.0 - ball_y, attack_x - ball_x)   # جهت توپ به دروازه
    tx, ty = ball_x - 3.0 * math.cos(to_goal), ball_y - 3.0 * math.sin(to_goal)
    if math.hypot(x - tx, y - ty) < 2.0:       # پشت توپ هستم: به سمت دروازه هل بده
        tx, ty = attack_x, 0.0
    turn = math.atan2(ty - y, tx - x) - heading            # چقدر باید بچرخم؟
    turn = math.atan2(math.sin(turn), math.cos(turn))      # بین -π و π
    speed = 10.0 if abs(turn) < 0.6 else 2.0   # تا رو به هدف نشده‌ام آرام برو
    turn = max(-6.0, min(6.0, 4.0 * turn))
    left.setVelocity(max(-10.0, min(10.0, speed - turn)))   # چپ>راست = چرخش ساعتگرد
    right.setVelocity(max(-10.0, min(10.0, speed + turn)))

ربات چی کار می‌کند؟ (خط به خط)

آماده‌سازی (خط‌های ۵ تا ۱۸)

Robot() ربات را می‌سازد و getName()[0] حرف تیم را می‌دهد (B آبی، Y زرد). با getDevice دو موتور، GPS، قطب‌نما، گیرنده‌ی توپ و گیرنده‌ی داور گرفته و با enable(32) روشن می‌شوند (۳۲ میلی‌ثانیه = یک گام شبیه‌ساز). setPosition(inf) موتورها را به حالت «سرعتی» می‌برد تا بعداً فقط setVelocity بین −۱۰ و +۱۰ بدهیم. attack_x مختصات x دروازه‌ی حریف است؛ مقدار اولیه برای نیمه‌ی اول حدس زده شده و با اولین پیام داور درست می‌شود.

حلقه‌ی اصلی و موقعیت خودم (خط‌های ۲۰ تا ۲۳)

robot.step(32) یک گام شبیه‌ساز جلو می‌رود؛ وقتی −۱ برگرداند مسابقه تمام شده. gps.getValues() سه عدد [x, y, h] می‌دهد (x در طول زمین، y در عرض، h ارتفاع). قطب‌نما سه عدد می‌دهد و فرمول atan2(v[0], v[1]) + π/2 جهت نگاه ربات را به رادیان برمی‌گرداند.

پیام داور: کدام دروازه؟ (خط‌های ۲۴ تا ۲۸)

گیرنده‌ی supervisor receiver صف پیام‌های JSON داور است. پیام نوع chovgan.match_state.v1 کلید attack_x دارد: attack_x["B"] و attack_x["Y"]، یعنی x دروازه‌ای که هر تیم باید به آن حمله کند. بعد از نیمه، زمین عوض می‌شود و این عدد قرینه می‌شود؛ چون هر بار آن را می‌خوانیم، ربات خودبه‌خود جهت درست را می‌گیرد. (شرط "attack_x" in msg لازم است چون در اجرای آزمایشی اعتبارسنج، پیام اولیه این کلید را ندارد.)

توپ کجاست؟ (خط‌های ۲۹ تا ۳۴)

گیرنده‌ی توپ هر گام یک «مشاهده» در صف می‌گذارد. getEmitterDirection() بردار [جلو, چپ, بالا] نسبت به بدنه‌ی ربات است و getSignalStrength() برابر 1/d²؛ پس فاصله d = 1/√strength. زاویه‌ی توپ نسبت به ربات atan2(چپ, جلو) است؛ با جمع‌کردن آن با جهت ربات و ضرب در فاصله، مختصات جهانی توپ (ball_x, ball_y) به دست می‌آید.

هدف: پشت توپ، بعد دروازه (خط‌های ۳۵ تا ۴۱)

اگر هنوز توپ دیده نشده، ربات می‌ایستد. وگرنه جهت «توپ → دروازه‌ی حریف» را حساب می‌کند و نقطه‌ای ۳ متر پشت توپ (سمت مخالف دروازه) را هدف می‌گیرد. وقتی به ۲ متری آن نقطه رسید، هدف را خود دروازه می‌کند: با حرکت رو به دروازه، توپ که جلوی ربات است هل داده می‌شود.

رانندگی (خط‌های ۴۲ تا ۴۷)

turn اختلاف زاویه‌ی هدف با جهت فعلی است (نرمال‌شده بین −π و π). اگر تقریباً رو به هدفیم با سرعت ۱۰ می‌رویم، وگرنه آرام (۲) تا اول بچرخیم. به موتور چپ speed − turn و به راست speed + turn داده می‌شود: اگر هدف سمت چپ باشد (turn مثبت) موتور راست تندتر می‌چرخد و ربات به چپ می‌پیچد؛ «چپ بزرگ‌تر از راست = چرخش ساعتگرد». max/min مقدار را در بازه‌ی مجاز −۱۰ تا ۱۰ نگه می‌دارد.

مسابقه با کد پایه
همین کد در مسابقه. هر چهار ربات هر تیم به سمت توپ می‌روند، پشت آن قرار می‌گیرند و آن را به سمت دروازه‌ی حریف می‌رانند. (قدم بعدی شما: بر اساس robot.getName() به هر شماره نقش متفاوتی بدهید تا همه روی توپ جمع نشوند.)

افزونه‌ی U14: گوش دادن به تابلوی مربی (Coach Board)

در رده‌ی U14 مربی می‌تواند پیش از مسابقه و در جریان آن از Coach Board برنامه (playbook) را تغییر دهد. شبیه‌ساز این برنامه را به‌صورت پیام chovgan.coach.plan.v1 در همان supervisor receiver می‌فرستد. شش خط زیر را به کد بالا اضافه کنید (کد با این خطوط هم در اعتبارسنج VALID است):

# ۱) قبل از حلقه‌ی اصلی، کنار ball_x, ball_y:
playbook = "BALANCED"                          # U14: برنامه‌ی مربی (ATTACK / BALANCED / DEFEND)

# ۲) داخل حلقه‌ی پیام داور، بعد از شرط match_state:
        if msg.get("type") == "chovgan.coach.plan.v1" and msg.get("team") == team:
            playbook = msg.get("settings", {}).get("playbook", "BALANCED")  # فقط U14

# ۳) بعد از خط speed = ... :
    if playbook == "DEFEND" and abs(x - attack_x) < 60.0:   # DEFEND: جلوتر از وسط زمین نرو
        tx, ty = -attack_x * 0.5, 0.0; turn = math.atan2(math.sin(math.atan2(ty - y, tx - x) - heading), math.cos(math.atan2(ty - y, tx - x) - heading))
    speed = speed if playbook != "ATTACK" else 10.0          # ATTACK: همیشه تمام‌سرعت

ATTACK: ربات حتی هنگام چرخش با سرعت کامل (۱۰) می‌رود. DEFEND: اگر ربات از وسط زمین به دروازه‌ی حریف نزدیک‌تر شده باشد، به جای توپ به نقطه‌ای در نیمه‌ی خودی (نزدیک دروازه‌ی خودمان) برمی‌گردد. BALANCED: همان رفتار کد پایه. پیام‌های مربی فقط برای تیم خودتان می‌آید (msg["team"] == team).

U19: در رده‌ی U19 تابلوی مربی وجود ندارد و شبیه‌ساز هرگز پیام chovgan.coach.plan.v1 نمی‌فرستد؛ این شش خط در U19 بی‌اثر می‌مانند و ضرری هم ندارند، پس می‌توانید یک کد را برای هر دو رده نگه دارید.
Coach Board در U14
Coach Board (فقط U14). انتخاب playbook (ATTACK / BALANCED / DEFEND)، focus، spacing و نقش چهار ربات. هر تغییر با یک شماره‌ی revision به ربات‌های همان تیم فرستاده می‌شود.
آماده‌ی آپلود: پوشه‌ی chovgan_team/ (فقط با همین robot.py) و فایل team_name.txt (نام تیم در یک خط) را با هم انتخاب و ZIP کنید. همین ZIP را هم در Training → Movement تست می‌کنید، هم در مرحله‌ی STRATEGY بارگذاری می‌کنید و هم تحویل می‌دهید. نبود robot1.py تا robot4.py فقط یک هشدار (warning) است، نه خطا.
ربات چوگان چه حسگرهایی دارد؟ (خلاصه‌ی همه‌فهم)

ربات با دو موتور (چپ و راست، سرعت −۱۰ تا +۱۰) راه می‌رود و می‌چرخد و با هل دادن توپ آن را جلو می‌برد؛ دستور «شوت» ندارد. همه‌ی این‌ها را با Python و دستور robot.getDevice("نام حسگر") می‌خوانید؛ جزئیات هر کدام در جدول پایین است.

سنسورها و دستگاه‌های ربات (معرفی کامل)

هر ربات با robot.getDevice("نام") به این دستگاه‌ها دسترسی دارد. نام‌ها را دقیقاً همین‌طور بنویسید. حسگرها را با enable(32) روشن کنید و بعد از هر robot.step(32) مقدار جدید بخوانید.

موتورها: left wheel motor / right wheel motor

دو درایو مجازی ربات چهارپا. اول setPosition(float("inf")) (حالت سرعتی)، بعد setVelocity(v) با v بین −10 تا +10. دو سرعت برابر مثبت = جلو، برابر منفی = عقب، چپ بزرگ‌تر از راست = چرخش ساعتگرد، سرعت نابرابر = مسیر منحنی. فرمان ۱۰ ≈ ۱۴ متر بر ثانیه؛ فرمان ۰ در حدود نیم ثانیه ترمز می‌کند.

GPS: gps

getValues() → [x, y, height] به متر. زمین ۱۰۵×۶۸ متر است؛ x از −52.5 تا +52.5 در طول زمین، y از −34 تا +34 در عرض، مبدأ وسط زمین. دروازه‌ها در x = ±52.5 (عرض ۱۱ متر).

قطب‌نما: compass

getValues() سه عدد می‌دهد؛ جهت ربات (رادیان) = math.atan2(v[0], v[1]) + math.pi/2: صفر یعنی رو به +x، π/2 یعنی رو به +y.

حسگرهای فاصله: distancesensor front / back / left / right

getValue() عددی بین ۰ تا ۱۰۰۰: ۰ یعنی برخورد، ۱۰۰۰ یعنی تا ۱۰ متر چیزی نیست (۳۰۰ ≈ ۳ متر). ربات‌های دیگر و توپ مانع حساب می‌شوند.

گیرنده‌ی توپ: ball receiver

در هر گام یک مشاهده در صف می‌گذارد: getQueueLength()، getEmitterDirection() → بردار واحد [جلو، چپ، بالا] نسبت به خود ربات، getSignalStrength() = ۱/فاصله² (۰٫۰۱ ≈ ۱۰ متر، ۰٫۱۱ ≈ ۳ متر؛ فاصله = 1/math.sqrt(strength))، و بعد nextPacket().

ارتباط تیمی: team emitter / team receiver

send(text) پیام (حداکثر ۴۰۹۶ بایت، ۸ پیام در هر گام) را فقط به سه هم‌تیمی می‌رساند؛ گیرنده صف FIFO است: getQueueLength() / getString() / nextPacket(). تیم حریف هرگز پیام شما را نمی‌گیرد.

پیام‌های داور: supervisor receiver (فقط خواندنی)

رشته‌های JSON: chovgan.match_state.v1 (وضعیت بازی، نیمه، زمان باقی‌مانده، نتیجه و attack_x هر تیم = دروازه‌ای که باید به آن حمله کنید؛ نیمه‌ها عوض می‌شوند) و chovgan.referee.v1 (گل، گل‌به‌خودی، پرتاب، عدم پیشرفت…). در U14 پیام chovgan.coach.plan.v1 تخته مربی هم از همین‌جا می‌آید.

هویت و زمان

robot.getName() → B1…B4 یا Y1…Y4 (از طرف شبیه‌ساز)، robot.getTime() → زمان شبیه‌سازی به ثانیه، robot.step(32) → یک گام ۳۲ میلی‌ثانیه‌ای مشترک برای هر هشت ربات (−1 یعنی پایان).

تماس با توپ فیزیکی است: با راندن ربات به سمت توپ آن را هل می‌دهید و وقتی توپ روبه‌روی ربات در حال حرکت باشد، پای ربات خودکار در جهت حرکت ضربه می‌زند. تابع kick() وجود ندارد. ماژول‌های مجاز: فایل‌های خودتان در chovgan_team/ + کتابخانه‌ی استاندارد (math، json، random، collections، …)؛ os/sys/socket بسته‌اند.
کد پایه

کد پایه‌ی Chovgan: هشت درس Python و یک تیم کامل

برای شبیه‌ساز CHOVGAN 1.0.0. همین ZIP مستقیم در شبیه‌ساز بارگذاری می‌شود. ربات را با فرمان‌های ساده خط‌به‌خط تکان می‌دهید و با یک عدد در robot.py بین درس‌ها و تیم کامل جابه‌جا می‌شوید. آموزش خط‌به‌خط در صفحه‌ی آموزش از صفر و طرح درس جلسه‌به‌جلسه پایین همین صفحه است.

LESSONچه یاد می‌گیرید
۱فرمان‌های ساده: forward، turn_left، turn_right، backward، wait
۲زیر فرمان‌ها: دو موتور چپ و راست و حلقه‌ی اصلی
۳همه‌ی حسگرها: GPS، قطب‌نما، چهار سونار، توپ، جهت حمله
۴قطب‌نما: چرخش دقیق با turn_to
۵GPS: رفتن به هر نقطه با drive_to
۶سونار: قبل از برخورد بایست و دور بزن
۷توپ: پشت توپ برو و به دروازه هل بده
۸پیام تیمی: فقط نزدیک‌ترین ربات سراغ توپ می‌رود
۰تیم کامل: دروازه‌بان، مدافع، مهاجم اول، مهاجم کناری

اجرای درس‌ها

در chovgan_team/robot.py عدد LESSON را بگذارید، chovgan_team و team_name.txt را ZIP کنید و در Training → Movement با Import ZIP اجرا کنید. خروجی print هر ربات در Esc → Controller status دیده می‌شود.

نتیجه‌ی آزمایش ما

هر هشت درس و تیم کامل در خود شبیه‌ساز اجرا شدند: هشت کنترلر فعال، بدون خطا. چرخش‌های turn_to با خطای کمتر از ۳ درجه و drive_to به همه‌ی نقطه‌ها رسید. اعتبارسنج رسمی ZIP را VALID می‌داند. بدون کد، ربات‌ها هیچ حرکتی ندارند.

درس ۱: ربات را خط‌به‌خط تکان بده

class Lesson1Commands(ChovganRobot):
    def run(self):
        self.wait(0.5)        # حسگرها اولین عددشان را بگیرند
        self.turn_to(180)     # رو به -x، جای خالی
        self.forward(2)       # ۲ ثانیه جلو
        self.turn_left(90)    # ۹۰ درجه به چپ
        self.forward(1.5)
        self.turn_right(90)   # ۹۰ درجه به راست
        self.backward(1)      # ۱ ثانیه عقب

فرمان‌ها و حسگرها

self.forward(t, speed=5)     self.backward(t)
self.turn_left(d)            self.turn_right(d)
self.turn_to(h)              # 0=+x  90=+y  180=-x  -90=-y
self.drive_to(x, y)          self.wait(t)    self.stop()
self.set_motors(left, right) # -10 .. 10

self.position()              # GPS (x, y) متر
self.heading_deg()           # قطب‌نما، درجه
self.distance("front")       # سونار، متر
self.ball_distance()         self.ball_angle()
self.ball_position()         self.attack_x

درس ۷: توپ را به دروازه هل بده

bx, by = self.ball_position()
to_goal = math.atan2(0 - by, self.attack_x - bx)
behind = (bx - 4 * math.cos(to_goal), by - 4 * math.sin(to_goal))
self.drive_to(*behind)
self.turn_to(math.degrees(to_goal))
self.forward(1.5, speed=10)
طرح درس

طرح درس Chovgan: جلسه‌به‌جلسه، از اولین حرکت تا تیم کامل

هر جلسه حدود ۹۰ دقیقه است و دقیقاً یکی از درس‌های کد پایه (عدد LESSON در chovgan_team/robot.py) را دنبال می‌کند. همه‌ی کدها با Python نوشته شده‌اند و در خود شبیه‌ساز CHOVGAN 1.0.0 اجرا و آزمایش شده‌اند. U14 می‌تواند جلسه‌های ۱ تا ۸ را آرام‌تر و با تمرین بیشتر جلو ببرد؛ U19 همه‌ی جلسه‌ها را کار می‌کند. آموزش خط‌به‌خط هر درس در صفحه‌ی «آموزش از صفر» و در فایل TUTORIAL-FA.md داخل کد پایه است.

همین طرح درس را به‌صورت فایل جداگانه دانلود کنید:دانلود PDFنسخه‌ی Wordآموزش خط‌به‌خط درس‌ها
۱آشنایی: نصب، منوها و اولین مسابقهبدون کد
هدف

شبیه‌ساز را نصب و اجرا کنند، کد پایه را بارگذاری کنند و یک مسابقه‌ی کامل را از شروع تا نتیجه ببینند.

مفاهیم
  • CHOVGAN-1.0.0-windows-x86_64.zip را باز کنید و CHOVGAN.exe را اجرا کنید. Python جدا لازم نیست.
  • منو: Competition، Training، Robot Lab، Rules & Guide، Settings.
  • زمین ۱۰۵ در ۶۸ متر است. x در طول زمین از ‎-52.5 تا ‎+52.5 و y در عرض از ‎-34 تا ‎+34. دروازه‌ها روی x = ±52.5.
  • هر تیم چهار ربات دارد: B1 تا B4 (آبی) و Y1 تا Y4 (زرد). هر ربات کد خودش را جداگانه اجرا می‌کند.
  • شبیه‌ساز گل، خطا، اوت و شروع مجدد را خودش ثبت می‌کند. نیمه‌ی دوم جای تیم‌ها عوض می‌شود.
  • بدون کد VALID، مسابقه و تمرین شروع نمی‌شوند و ربات‌ها خودبه‌خود حرکت نمی‌کنند.
فعالیت
  • Chovgan-BaseCode.zip را دانلود کنید. Competition → رده → نام تیم‌ها → در STRATEGY همین ZIP را برای هر دو تیم بدهید → READY.
  • در طول بازی Esc بزنید: Controller status را باز کنید و ببینید هر هشت ربات RUNNING هستند.
  • با کلیدهای ۱ تا ۷ نماهای دوربین را عوض کنید. Tactical (کلید ۶) کل زمین را از بالا نشان می‌دهد.
ارزیابی

آبی در نیمه‌ی اول به کدام دروازه حمله می‌کند؟ بعد از نیمه چه می‌شود؟ چرا بدون ZIP بازی شروع نمی‌شود؟

۲اولین برنامه: ربات را خط‌به‌خط تکان بدهکدنویسی · LESSON = 1
هدف

با فرمان‌های ساده یک برنامه‌ی ترتیبی بنویسند و ببینند هر خط دقیقاً چه کاری می‌کند.

مفاهیم
  • forward(t) و backward(t): به مدت t ثانیه مستقیم جلو یا عقب. ربات با قطب‌نما جهتش را نگه می‌دارد.
  • turn_left(d) و turn_right(d): به اندازه‌ی d درجه در جا بچرخ.
  • wait(t): t ثانیه بایست. اول برنامه wait(0.5) می‌گذاریم تا حسگرها اولین عددشان را بگیرند.
  • هر خط تا تمام نشود خط بعدی اجرا نمی‌شود. برنامه مثل یک دستور پخت است.
  • در درس‌های ۱، ۲ و ۴ فقط ربات MOVER (پیش‌فرض ۳) حرکت می‌کند تا ربات‌ها به هم نخورند.
فعالیت
  • در chovgan_team/robot.py بنویسید LESSON = 1، پوشه‌ی chovgan_team و team_name.txt را ZIP کنید.
  • Training → Movement → Import ZIP → Start. خروجی print را در Esc → Controller status ببینید.
  • عددها را عوض کنید: forward(3)، turn_left(45). بعد از هر تغییر Reload code بزنید.
  • چالش: ربات یک مستطیل بکشد و به جای اولش برگردد.
کد اصلی جلسه
self.wait(0.5)
self.turn_to(180)
self.forward(2)
self.turn_left(90)
self.forward(1.5)
self.turn_right(90)
self.backward(1)
ارزیابی

اگر forward(2) را به forward(4) تغییر دهیم چه می‌شود؟ چرا اول wait(0.5) لازم است؟

۳زیر فرمان‌ها: دو موتور و حلقه‌ی اصلیکدنویسی · LESSON = 2
هدف

بفهمند forward و turn در واقع دو عدد سرعت برای دو موتور هستند و حلقه‌ی step چطور زمان را جلو می‌برد.

مفاهیم
  • دو موتور: left wheel motor و right wheel motor. سرعت هر کدام بین ‎-10 و ‎+10. سرعت ۱۰ حدود ۱۴ متر بر ثانیه.
  • هر دو مثبت و برابر = جلو. هر دو منفی = عقب. چپ منفی و راست مثبت = چرخش به چپ. دو مثبت نابرابر = قوس.
  • robot.step(32) زمان بازی را ۳۲ میلی‌ثانیه جلو می‌برد. در کد پایه self.tick() همین کار را می‌کند و حسگرها را هم تازه نگه می‌دارد.
  • جدول PLAN: هر ردیف تا یک زمان مشخص اجرا می‌شود (if t < until).
فعالیت
  • LESSON = 2 و اجرا. هر تغییر حرکت در Controller status چاپ می‌شود.
  • در Robot Lab بخش Turning Test را امتحان کنید و رابطه‌ی سرعت چپ و راست با جهت چرخش را ببینید.
  • یک ردیف به PLAN اضافه کنید که ربات یک دایره‌ی کامل بزند.
کد اصلی جلسه
self.left.setVelocity(5)    # موتور چپ
self.right.setVelocity(5)   # موتور راست: هر دو برابر = جلو
self.tick()                 # ۳۲ میلی‌ثانیه جلو برو
ارزیابی

سرعت چپ ۶ و راست ۳: ربات به کدام سمت قوس می‌زند؟ چرا؟

۴همه‌ی حسگرهاکدنویسی · LESSON = 3
هدف

هر حسگر را بخوانند، واحدش را بدانند و بگویند برای چه کاری مفید است.

مفاهیم
  • GPS: position() جای ربات به متر. قطب‌نما: heading_deg() جهت ربات؛ ۰ = رو به ‎+x، ۹۰ = رو به ‎+y.
  • چهار سونار: distance("front") و back، left، right. فاصله تا نزدیک‌ترین ربات، توپ یا مانع، تا ۱۰ متر.
  • گیرنده‌ی توپ: جهت توپ نسبت به ربات [جلو، چپ، بالا] و قدرت سیگنال = ۱ / فاصله². پس فاصله = 1/√قدرت.
  • ball_angle(): زاویه‌ی توپ نسبت به دماغه؛ مثبت = سمت چپ. ball_position(): جای توپ در زمین.
  • attack_x: دروازه‌ای که باید به آن حمله کنیم. شبیه‌ساز می‌فرستد و نیمه‌ی دوم عوض می‌شود.
فعالیت
  • LESSON = 3 و اجرا. یک جدول بکشید: هر حسگر، عددی که دیدید، واحد، کاربرد.
  • در Robot Lab → Open live sensor practice همان حسگرها را زنده ببینید و با خروجی خودتان مقایسه کنید.
  • توپ را در ذهن جابه‌جا کنید: اگر ball_angle() منفی ۹۰ باشد توپ کجاست؟
کد اصلی جلسه
x, y = self.position()
h = self.heading_deg()
front = self.distance("front")
d = self.ball_distance()
a = self.ball_angle()
ارزیابی

قدرت سیگنال توپ ۰.۰۴ است. توپ چند متر دور است؟ (جواب: ۵ متر)

۵قطب‌نما و چرخش دقیقکدنویسی · LESSON = 4
هدف

با خطای زاویه و کنترل تناسبی ربات را دقیقاً رو به یک جهت بچرخانند.

مفاهیم
  • خطای زاویه = هدف − جهت فعلی، همیشه بین ‎-180 و ‎+180 (کوتاه‌ترین راه).
  • کنترل تناسبی (P): هرچه خطا بیشتر، تندتر بچرخ. نزدیک هدف آرام.
  • ترمز (D): اگر خیلی تند می‌چرخیم، کمی کم کن تا از هدف رد نشویم.
  • turn_to(۰) رو به ‎+x، turn_to(۹۰) رو به ‎+y، turn_to(۱۸۰) رو به ‎-x، turn_to(-90) رو به ‎-y. در آزمایش ما خطا کمتر از ۳ درجه بود.
  • چون هر ضلع مربع جهت مطلق دارد، خطای چرخش‌ها روی هم جمع نمی‌شود.
فعالیت
  • LESSON = 4 و اجرا. heading بعد از هر turn_to را با هدف مقایسه کنید.
  • در chovgan_robot.py ضریب ۴.۰ تابع turn_to را ۱.۰ و بعد ۱۰ کنید و فرقش را ببینید.
  • چالش: یک شش‌ضلعی با turn_to بکشید.
کد اصلی جلسه
for heading in (180, -90, 0, 90):
    self.turn_to(heading)
    self.forward(1.5)
ارزیابی

جهت فعلی ۱۷۰ و هدف ‎-170 است. خطای زاویه چند درجه و ربات به کدام سمت بچرخد؟

۶GPS و رفتن به یک نقطهکدنویسی · LESSON = 5
هدف

ربات را با GPS و قطب‌نما به هر نقطه‌ی زمین بفرستند و گشت بزنند.

مفاهیم
  • جهت نقطه‌ی هدف (tx, ty) از جای فعلی (x, y): atan2(ty - y, tx - x).
  • drive_to: اول رو به نقطه بچرخ، بعد جلو برو، نزدیک نقطه آرام شو و در ۱.۵ متری بایست.
  • نیمه‌ی خودی سمت مخالف attack_x است: ‎-attack_sign. پس همین کد بعد از عوض شدن نیمه هم درست است.
  • در آزمایش ما هر چهار ربات به همه‌ی نقطه‌ها رسیدند و بعد از نیمه سمت درست را گشت زدند.
فعالیت
  • LESSON = 5 و اجرا. پیام arrived هر ربات را در Controller status ببینید.
  • یک نقطه‌ی سوم به گشت اضافه کنید.
  • چالش: هر چهار ربات یک خط افقی روی خط وسط بسازند.
کد اصلی جلسه
home = -self.attack_sign          # نیمه‌ی خودی
self.drive_to(home * 13, y)
self.drive_to(home * 31, y)
ارزیابی

ربات در (0, 0) است و رو به ‎+x. نقطه‌ی (0, 10) در چه جهتی است و ربات اول چند درجه باید بچرخد؟

۷سونار و جلوگیری از برخوردکدنویسی · LESSON = 6
هدف

با if و else روی عدد سونار تصمیم بگیرند: جلو برو یا بایست و بچرخ.

مفاهیم
  • distance("front") کمتر از SAFE متر = چیزی جلوی ماست.
  • مقایسه‌ی چپ و راست: به سمتی بچرخ که سونارش جای بیشتری نشان می‌دهد.
  • ربات‌های دیگر و توپ هر دو مانع حساب می‌شوند.
فعالیت
  • LESSON = 6 و اجرا. پیام obstacle هر ربات را بخوانید.
  • SAFE را ۱.۵ و ۵ کنید. کدام بهتر است؟
  • چالش: اگر پشت ربات هم بسته بود (distance("back")) چه کند؟
کد اصلی جلسه
if self.distance("front") > 3.0:
    self.set_motors(5, 5)
    self.tick()
elif self.distance("left") >= self.distance("right"):
    self.turn_left(60)
else:
    self.turn_right(60)
ارزیابی

سونار جلو ۲، چپ ۸ و راست ۳ است. ربات چه می‌کند؟

۸توپ: پشت توپ برو و به دروازه هل بدهکدنویسی · LESSON = 7
هدف

جای توپ را حساب کنند و توپ را به سمت دروازه‌ی حریف هل بدهند، نه به هر سمتی.

مفاهیم
  • ربات فرمان «شوت» ندارد. توپ را با راندن ربات به سمت آن هل می‌دهیم.
  • اگر مستقیم به توپ بزنیم، توپ هر طرف که رو کرده‌ایم می‌رود؛ حتی به دروازه‌ی خودی.
  • جهت توپ (bx, by) به دروازه: atan2(0 - by, attack_x - bx). نقطه‌ی پشت توپ ۴ متر در خلاف همین جهت است.
  • وقتی پشت توپ رسیدیم: turn_to رو به دروازه و forward با سرعت ۱۰.
فعالیت
  • LESSON = 7 و اجرا (فقط ربات ۳ بازی می‌کند).
  • فاصله‌ی ۴ متر را ۲ و ۶ کنید و نتیجه را مقایسه کنید.
  • در Training → Shooting همین کد را امتحان کنید.
کد اصلی جلسه
bx, by = self.ball_position()
to_goal = math.atan2(0 - by, self.attack_x - bx)
behind = (bx - 4 * math.cos(to_goal), by - 4 * math.sin(to_goal))
self.drive_to(*behind)
self.turn_to(math.degrees(to_goal))
self.forward(1.5, speed=10)
ارزیابی

توپ در (10, 0) است و attack_x = ‎-52.5. نقطه‌ی پشت توپ کجاست؟ (جواب: (14, 0))

۹پیام تیمی: چه کسی سراغ توپ برودکدنویسی · LESSON = 8
هدف

با فرستادن و خواندن پیام JSON کار را بین ربات‌ها تقسیم کنند.

مفاهیم
  • team emitter پیام متنی را فقط به سه هم‌تیمی می‌رساند. حریف نمی‌شنود. حداکثر ۴۰۹۶ بایت.
  • json.dumps یک دیکشنری را به متن تبدیل می‌کند و json.loads برعکس. self.inbox پیام‌های رسیده است.
  • هر ربات فاصله‌اش تا توپ را می‌فرستد. فقط نزدیک‌ترین سراغ توپ می‌رود. دروازه‌بان نامزد نیست.
فعالیت
  • LESSON = 8 و اجرا. ببینید فقط یک ربات سراغ توپ می‌رود.
  • به پیام نقش ربات را هم اضافه کنید.
  • چالش: دومین ربات نزدیک به‌جای ایستادن، ۸ متر پشت توپ منتظر بماند.
کد اصلی جلسه
self.team_emitter.send(json.dumps({"robot": self.name, "dist": mine}))
for msg in self.inbox:
    distances[msg["robot"]] = msg["dist"]
ارزیابی

اگر همه‌ی ربات‌ها پیام بفرستند ولی هیچ‌کدام inbox را نخوانند چه می‌شود؟

۱۰تیم کامل: چهار نقشکدنویسی · LESSON = 0
هدف

کد تیم کامل را بخوانند و برای هر نقش اولین بهبود را بدهند.

مفاهیم
  • robot1.py دروازه‌بان: جلوی دروازه‌ی خودی می‌ماند و با توپ چپ و راست می‌رود؛ اگر توپ نزدیک شد دورش می‌کند.
  • robot2.py مدافع: وسط نیمه‌ی خودی؛ اگر توپ نزدیک‌تر از ۹ متر شد سراغش می‌رود.
  • robot3.py مهاجم: پشت توپ و هل به دروازه. robot4.py مهاجم کناری: وقتی ۳ نزدیک‌تر است، جلوتر و آن طرف زمین منتظر می‌ماند.
  • LESSON = 0 یعنی تیم کامل. در آزمایش ما مقابل تیم ایستای تمرینی ۱ بر ۰ برد و مقابل تیم تمرینی رسمی ۰ بر ۱ باخت.
فعالیت
  • LESSON = 0 و در Training مقابل حریف Baseline بازی کنید.
  • GOAL_OFFSET دروازه‌بان و STRENGTH_ENGAGE مدافع را عوض کنید و اثرش را ببینید.
  • یک ویژگی از درس‌ها (مثلاً سونار درس ۶) را به یکی از نقش‌ها اضافه کنید.
ارزیابی

نقش هر ربات را با یک جمله توضیح دهید. کدام نقش بیشترین اثر را روی گل خوردن دارد؟

۱۱راهبرد، آزمایش و تابلوی مربی (U14)پروژه · LESSON = 0
هدف

با آزمایش‌های تکرارپذیر کد تیم را بهتر کنند. U14 تابلوی مربی را به کد وصل کند.

مفاهیم
  • یک تغییر در هر بار، بعد آزمایش. نتیجه را یادداشت کنید (گل زده، گل خورده، مشکل).
  • Training پنج حالت دارد. Retry همان کد را دوباره اجرا می‌کند و Reload code کد ویرایش‌شده را می‌خواند.
  • U14: پیام chovgan.coach.plan.v1 در self.coach_playbook (ATTACK، BALANCED یا DEFEND). در U19 این پیام نمی‌آید.
فعالیت
  • سه مسابقه‌ی تمرینی مقابل Baseline؛ جدول نتیجه بکشید.
  • U14: اگر coach_playbook برابر DEFEND بود، مهاجم‌ها در نیمه‌ی خودی بمانند.
  • یک اشکال واقعی را با print در Controller status پیدا و رفع کنید.
کد اصلی جلسه
if self.coach_playbook == "DEFEND":
    home = -self.attack_sign * 20
    self.drive_to(home, 0)
ارزیابی

گزارش کوتاه: چه چیزی را عوض کردید، چرا، و نتیجه چه شد؟

۱۲تحویل و مسابقه‌ی آزمایشیمسابقه · LESSON = 0
هدف

ZIP تحویلی درست بسازند و در یک مسابقه‌ی آزمایشی شرکت کنند.

مفاهیم
  • LESSON = 0 باشد. ZIP فقط chovgan_team/ و team_name.txt را در سطح اول دارد.
  • فایل‌های مجاز در ZIP: .py، .json، .md، .txt و .png. ماژول‌های os، sys و socket و کتابخانه‌های بیرونی مثل numpy بسته‌اند.
  • خطاهای رایج STRATEGY: MISSING_ENTRYPOINT، IMPORT_ERROR، UNKNOWN_DEVICE، PYTHON_SYNTAX_ERROR.
  • محل و مهلت تحویل در کانال کمیته فنی اعلام می‌شود.
فعالیت
  • ZIP را بسازید و در Competition → STRATEGY مطمئن شوید VALID است.
  • مسابقه‌ی آزمایشی کلاس: هر تیم مقابل دو تیم دیگر.
  • بازبینی: یک چیز که کار کرد، یک چیز که کار نکرد، قدم بعدی.
ارزیابی

روبریک: اجرا و عملکرد ۴۰٪، درک مفاهیم ۳۰٪، کار تیمی و پیام‌ها ۱۵٪، تحلیل و بهبود ۱۵٪.

نام‌هایی که باید دقیق بنویسید

"gps"                   "compass"
"ball receiver"         "supervisor receiver"
"team emitter"          "team receiver"
"distancesensor front"  "distancesensor back"
"distancesensor left"   "distancesensor right"
"left wheel motor"      "right wheel motor"

TIME_STEP = 32 ms   |  motor speed: -10 .. +10   |  team message <= 4096 bytes
قوانین

خلاصه‌ی قوانین مسابقه (نسخه‌ی ۱۷ اکتبر ۲۰۲۶)

این خلاصه برای فهم سریع است؛ متن کامل و رسمی را از بخش دانلود بگیرید. در صورت اختلاف، آخرین نسخه‌ی رسمی منتشرشده توسط کمیته فنی معتبر است.

CH-1
رده‌ها و سندو رده‌ی کاملاً جدا: U14 و U19. سن مبنا ۳۰ ژوئن ۲۰۲۶: U14 متولدین ۱ ژوئیه ۲۰۱۲ به بعد؛ U19 متولدین ۱ ژوئیه ۲۰۰۷ به بعد. ممکن است مدرک سن خواسته شود.
CH-2
تیم۲ تا ۴ نفر با یک کاپیتان. کاپیتان رابط رسمی برای مسائل فنی، داور و اعتراض‌هاست.
CH-3
ربات‌هادقیقاً ۴ ربات فعال در هر تیم: B1–B4 و Y1–Y4. همه‌ی ربات‌ها امکانات یکسان دارند؛ نقش ثابت اجباری نیست.
CH-4
Coach Board فقط در U14U19 هیچ ورودی تاکتیکی انسانی در حین بازی ندارد. Coach Board در شبیه‌ساز 1.0.0 برای تمرین و مسابقات دوستانه‌ی U14 فعال است؛ استفاده در مسابقات رسمی پس از تصویب ضمیمه توسط کمیته فنی.
CH-5/6
خودمختاری و تعامل با توپهدایت دستی ممنوع. ربات‌ها از طریق SDK رسمی کنترل می‌شوند و توپ را فقط با تعامل فیزیکی مجاز حرکت می‌دهند. تغییر مستقیم مختصات یا سرعت توپ ممنوع. نگه داشتن مداوم توپ خطا نیست.
CH-7
هدف و نتیجهتیمی که گل معتبر بیشتری بزند برنده است؛ تساوی مساوی ثبت می‌شود. امتیازی برای سبک، مالکیت، پاس یا مصاحبه نیست.
CH-9/11
حسگرها و ارتباطفقط دستگاه‌ها و توابع مستند در SDK رسمی مجازند. ارتباط فقط بین ربات‌های یک تیم از طریق Team Communication؛ شنود حریف و کانال‌های شبکه/فایل غیرمجاز ممنوع.
CH-14/15
شروع و زمانشبیه‌ساز توپ و ربات‌ها را در جای اولیه می‌گذارد. مسابقه دو نیمه‌ی ۲ دقیقه‌ای روی ساعت رسمی دارد. تیم‌ها نمی‌توانند ربات خود را جابه‌جا کنند یا ساعت را تغییر دهند.
CH-16
گل و گل به خودیگل فقط وقتی معتبر است که شبیه‌ساز آن را ثبت کند. هر گل یک امتیاز؛ گل به خودی برای حریف.
CH-17–19
خطا، شروع مجدد، توقفهر برخورد خطا نیست؛ تشخیص خطا به‌صورت خودکار در شبیه‌ساز انجام می‌شود. بعد از خطا، شروع مجدد هوایی (Aerial Ball Restart). داور می‌تواند بازی را متوقف یا ربات‌ها را جابه‌جا کند و «عدم پیشرفت» را اعلام کند.
CH-21
تحویل کدیک ZIP شامل کنترلر چهار ربات. ساختار فایل، نقطه‌ی ورود، وابستگی‌های مجاز و روش آپلود را کمیته فنی پیش از مسابقه منتشر می‌کند. پس از مهلت، تغییر کد بدون مجوز ممنوع. سازمان‌دهنده می‌تواند فایل‌ها، وابستگی‌ها و مصرف منابع را اعتبارسنجی کند.
CH-22/23
منابع، اینترنت و هوش مصنوعیکد نباید شبیه‌ساز را مختل کند یا منابع را تمام کند. در طول مسابقه استفاده از اینترنت، API ابری، سرویس AI از راه دور یا سرور کنترل خارجی ممنوع. استفاده از ابزار AI در توسعه، تیم را از فهم و توضیح کد خودش معاف نمی‌کند.
CH-24/25
خرابی فنی و مصاحبهمشکل فنی از طریق کانال رسمی به سرداور گزارش می‌شود؛ خرابی ناشی از کد خود تیم حق بازی مجدد نمی‌دهد. کمیته فنی می‌تواند فهم تیم از کدش را بررسی کند (بدون امتیاز جداگانه).
CH-26–28
انصاف، جریمه و اعتراضدور زدن داور، دسترسی به کد حریف یا خرابکاری عمدی = از اخطار تا حذف. اعتراض فقط پس از پایان دور، توسط کاپیتان، به کمیته فنی.
وضعیت تأیید: مشخصات فنی پیشنهادی (ابعاد زمین، مقیاس حسگرها، ساختار و محدودیت‌های ZIP، قالب پیام داور، ضمیمه‌ی Coach Board، محدودیت منابع) در شبیه‌ساز 1.0.0 پیاده‌سازی و تست شده‌اند ولی تا تصویب کمیته فنی «پیشنهادی» هستند؛ استفاده از Coach Board در مسابقات رسمی U14 تا تصویب ضمیمه غیرفعال است.
دانلود

شبیه‌ساز، قوانین و راهنمای برنامه‌نویسی

ZIPشبیه‌ساز CHOVGAN 1.0.0 برای WindowsCHOVGAN-1.0.0-windows-x86_64.zip · شامل Python و SDK، بدون نصب · دانلود حدود ۶۳ مگابایت، بعد از باز کردن حدود ۱۵۰ مگابایت ZIPکد پایه‌ی تیم + درس‌هاChovgan-BaseCode.zip · هشت درس + تیم چهار رباتی + آموزش مصور، قابل بارگذاری در شبیه‌ساز ZIPتمرین بدون شبیه‌سازChovgan-LocalPractice.zip · زمین متنی ساده، اختیاری PDFکتابچه‌ی قوانین مسابقه ۲۰۲۶FIRA Chovgan Simulation League — Competition Rules (U14/U19) DOCXقوانین — نسخه‌ی Wordهمان سند، قابل ویرایش PDFراهنمای برنامه‌نویسی دانش‌آموزی v1.3Student Programming Guide — Chovgan SDK 1.0، با تصاویر شبیه‌ساز DOCXراهنمای دانش‌آموزی — نسخه‌ی Wordهمان سند، قابل ویرایش GDocقوانین — نسخه‌ی آنلاین (Google Docs)همیشه آخرین ویرایش کمیته فنی GDocراهنمای دانش‌آموزی — نسخه‌ی آنلاین (Google Docs)همیشه آخرین ویرایش کمیته فنی PDFطرح درس Chovgan — نسخه‌ی قابل چاپChovgan-Lesson-Plan-2026.pdf · همان طرح درس صفحه، جلسه‌به‌جلسه DOCXطرح درس — نسخه‌ی WordChovgan-Lesson-Plan-2026.docx · قابل ویرایش برای مربی

به‌روزترین نسخه‌ی فایل‌ها همیشه ابتدا در کانال کمیته فنی منتشر می‌شود.

در یک نگاه

ربات چوگان چه چیزهایی دارد و با چه چیزی بازی می‌کند؟

ربات چوگان یک ربات چهارپای مجازی است که با Python هدایت می‌شود. چشم و گوشش این‌هاست:

  • GPS → «من کجای زمین هستم؟»
  • قطب‌نما → «رو به کدام سمت هستم؟»
  • ۴ حسگر فاصله (جلو/عقب/چپ/راست) → «تا مانع یا ربات بعدی چقدر جا دارم؟»
  • گیرنده‌ی توپ → «توپ کدام طرف و تقریباً چقدر دور است؟»
  • پیام تیم و پیام داور → هماهنگی با هم‌تیمی‌ها و دانستن وضعیت بازی و دروازه‌ی حمله.

و دست و پایش: دو موتور (چپ و راست، سرعت −۱۰ تا +۱۰) برای رفتن و چرخیدن؛ توپ را با هل دادن جلو می‌برد و دستور شوت جداگانه ندارد. دوربین، لیدار یا GPS دقیق‌تر ندارد؛ همه‌ی تصمیم‌ها از همین چند عدد گرفته می‌شود. جزئیات و نام دقیق هر دستگاه در بخش سنسورها.

در یک نگاه

ربات چوگان چه دارد و از چه استفاده می‌کند؟

خلاصه‌ی همه‌فهم؛ جزئیات فنی در بخش «شروع از صفر» است.

ربات چوگان یک ماشین کوچک دو‌چرخ است. شما فقط سرعت چرخ چپ و راستش را تعیین می‌کنید (از −۱۰ تا +۱۰). دکمه‌ی شوت یا پاس ندارد؛ توپ را با هل دادن جلو می‌برد. برای تصمیم‌گیری شش چیز «می‌فهمد»:

  • GPS — کجای زمین هستم؟ (x و y به متر؛ مبدأ وسط زمین)
  • قطب‌نما — رو به کدام طرف ایستاده‌ام؟
  • چهار حسگر فاصله (جلو، عقب، چپ، راست) — تا نزدیک‌ترین مانع چقدر راه است؟ ۰ یعنی برخورد، ۱۰۰۰ یعنی تا ۱۰ متر خالی.
  • گیرنده‌ی توپ — توپ از کدام طرف است و تقریباً چقدر دور؟ (هرچه سیگنال قوی‌تر، توپ نزدیک‌تر)
  • پیام تیم — چهار ربات یک تیم می‌توانند به هم پیام متنی بفرستند؛ حریف نمی‌شنود.
  • پیام داور — بازی در چه وضعی است، چه کسی گل زده، به کدام دروازه حمله کنیم.

از این‌ها چطور استفاده می‌کند؟ با GPS و قطب‌نما جهت دروازه و توپ را حساب می‌کند (هندسه‌ی ساده: فاصله و زاویه)، با حسگرهای فاصله به دیوار و هم‌تیمی نمی‌خورد، با گیرنده‌ی توپ دنبال توپ می‌رود، با پیام تیم نقش‌ها را تقسیم می‌کند (چه کسی حمله کند، چه کسی دفاع) و با پیام داور می‌فهمد نیمه عوض شده یا بازی متوقف است. همه‌ی این‌ها با Python و دستور robot.getDevice("نام") خوانده می‌شود و کد پایه‌ی پایین صفحه نمونه‌ی کاملش را دارد.

کانال لیگ

کانال تلگرام و بله لیگ Chovgan

برای دریافت فایل‌ها، اطلاعیه‌ها و پرسیدن سؤال از کمیته فنی جوین شوید.