Playmark

תוסף ל-Godot + פלאגין ל-Claude Code

מסמנים תוך כדי משחק. Claude מתקן.

לוחצים CtrlShiftM במשחק Godot שרץ, מסמנים מה לא בסדר וכותבים שורה. Claude Code מקבל את הפריים, את חמש השניות האחרונות, את הלוג ואת הקוד שמתחת לסימון.

v0.3.0Godot 4.5+MITChangelog

הוקלט ב-Godot

Playmark בסצנת צעצוע ב-Godot: סימון על הריבוע הטורקיז, ההערה "Boxy should be orange", שמירה; אחר כך הריבוע הופך לכתום והודעה אומרת Fixed #1.

איך זה עובד

  1. משחקים

    מריצים את המשחק מ-Godot. Playmark שומר את חמש השניות האחרונות.

  2. מסמנים

    CtrlShiftM מקפיא את הפריים. קליק לסיכה, גרירה למסגרת, 1 עד 5 לקטגוריה, ואז הערה.

  3. Claude מתקן

    הפרומפט הבא ב-Claude Code מזכיר את הסימון. /playmark:triage מוצא את הקוד שמתחת לסיכה ומציע תיקון, ובוחרים מה לתקן.

  4. בודקים שוב

    המשחק מראה "Fixed #3" ומשאיר סמן במקום הסימון. חוזרים לשם ובודקים.

לנסות

סימון אחד, תיקון אחד.

הרצה מודרכת על סצנת צעצוע, אותו תהליך כמו ב-Godot. בוחרים שינוי, חמישה צעדים.

  1. הקפאה
  2. סיכה
  3. חותמת
  4. שמירה
  5. Claude
Freeze
Marked #1Art
Fixed by Claude Fixed #1 Boxy: #2EC4B6 → #FF8A1F in look.gd
מה לא בסדר?

במשחק אמיתי

עיצוב מחדש של אויב ב-Wandcraft

Wandcraft הוא רוגלייט בפיקסל ארט. ה-Thornback שלו, אויב שמסתער עליך, נראה כמו כיכר לחם. סימון אחד, באמצע קרב:

Redesign the Thornback: make it look like a charging ram, with curled horns, thorns along its back and a glowing eye.
שכבת Playmark מעל קרב ב-Wandcraft: מסגרת כחולה סביב ה-Thornback, חותמת ART וההערה
הסימון: מסגרת סביב ה-Thornback, ART, ההערה.
  1. המסגרת מצאה את הנוד. enemy.gd מסוג ram, יחד עם מצב הריצה: החדר, הגל, החיים והשרביט.
  2. Claude מצא את הארט. 16 שורות של פיקסלים ב-bestiary.gd, לפי חוקי הפלטה של המשחק.
  3. הציור מחדש. גב גבנוני, קוצים, קרן מסולסלת ועין זוהרת.
  4. בחזרה לקרב. "Fixed #1", והסמן נשאר במקום הסימון.
לפני: כיכר חומה שטוחה עם שלושה עלים ירוקים. אחרי: חיה גבנונית עם קוצים בהירים, קרן מסולסלת, עין כתומה זוהרת וחזה צמרי.
הוקלט ב-Wandcraft

הקרב אחרי התיקון: ה-Thornback החדש מסתער והודעה אומרת Fixed #1.

הסימון

מה Claude מקבל

כל סימון הוא תיקייה ב-.playmark/inbox, מחוץ ל-git כברירת מחדל. זה הסימון האמיתי מהסרטון.

annotated.png: הפריים הקפוא של ארבע הצורות עם סיכה מספר 1 על הריבוע הטורקיז
annotated.png הפריים, עם סיכות ממוספרות
  • annotated.pngהפריים, עם סיכות ממוספרות
  • clip_sheet.pngהשניות האחרונות, מהישן לחדש
  • log.txtאזהרות ושגיאות
  • mark.jsonההערה, הסצנה, הנודים והסקריפטים שמתחת לכל סיכה, מצב המשחק
{
  "seq": 1,
  "category": "art",
  "note": "Boxy should be orange",
  "marks": [{ "type": "pin", "x": 750, "y": 536 }],
  "scene": { "path": "res://shapes.tscn" },
  "under_marks": [{
    "mark": 1,
    "physics": [{
      "path": "Boxy",
      "class": "Area2D",
      "script": "res://shape.gd"
    }]
  }],
  "context": { "look": [ … ] }
}

בפנים

מה זה עושה

התקנה

שלוש פקודות ב-Claude Code

  1. /plugin marketplace add barmoshe/playmark
  2. /plugin install playmark@playmark
  3. /playmark:installבריפו של המשחק

Godot 4.5+Claude CodeNode 18+דסקטופ, נבדק על macOS

בלי Claude Code: מעתיקים את addons/playmark לפרויקט ומפעילים ב-Project Settings, Plugins. עדכונים: claude plugin update playmark.

מאפס

להתחיל איתו משחק חדש

פרויקט Godot ריק עם Playmark כבר בפנים: סצנה אחת שאפשר לשחק, CLAUDE.md שמלמד את הלולאה, וקומיט ראשון. אומרים איזה משחק לבנות, משחקים כל צעד ומסמנים מה לא בסדר.

  1. /playmark:new star-dodger --name "Star Dodger"
  1. בונים צעד. מכניקה אחת, אויב אחד, מסך אחד.
  2. משחקים. CtrlShiftM על מה שלא בסדר.
  3. טריאז'. /playmark:triage מתקן את מה שבוחרים.
  4. קומיט. ואז הצעד הבא.

למה

בניתי את Playmark תוך כדי עבודה על Wandcraft, רוגלייט שבו מתכנתים את השרביט. כשבדקתי את המשחק שלי, כל הזמן שמתי לב לדברים קטנים שלא רציתי לעצור בשבילם ולכתוב. עכשיו אני לוחץ על מקש, מצביע וממשיך לשחק.