როგორ შევქმნათ თამაში Roblox-ში AI-სა და Thrixel-ის გამოყენებით

დაწყებამდე დაგჭირდებათ დაყენებული Roblox Studio და Roblox-ის ანგარიში.

1. დააყენეთ Rojo VS Code-ის საშუალებით

1. დააყენეთ Visual Studio Code (VS Code).
2. VS Code-ში დააყენეთ გაფართოება Rojo - Roblox Studio Sync.
3. VS Code-ში გახსენით File > Open Folder და აირჩიეთ თამაშისთვის განკუთვნილი ცარიელი საქაღალდე.
4. ბრძანებების პალიტრის გასახსნელად დააჭირეთ Ctrl + Shift + P-ს (Mac-ზე Cmd + Shift + P). აკრიფეთ „Rojo“ და აირჩიეთ Rojo: Open Menu.
5. თუ მენიუ მიუთითებს, რომ Rojo დაყენებული არ არის, დააწკაპუნეთ Install Rojo now-ზე.
6. დააწკაპუნეთ Install Roblox Studio Plugin-ზე. თუ Studio გახსნილია, გადატვირთეთ. ამის შემდეგ Rojo უნდა გამოჩნდეს Studio-ს Plugins ჩანართში.

2. დაამატეთ Build World უნარი

შედით ანგარიშში

უნარის დაყენებამდე შედით Thrixel-ის ანგარიშში. ბრძანება ყველა აგენტისთვის ერთნაირია და მოითხოვს uv-ს. თუ uv დაყენებული არ არის, ტერმინალში გაუშვით თქვენი ოპერაციული სისტემის შესაბამისი ბრძანება:

curl -LsSf https://astral.sh/uv/install.sh | sh

irm https://astral.sh/uv/install.ps1 | iex

გაუშვით ქვემოთ მოცემული შესვლის ბრძანება. ბრაუზერში გვერდის გახსნის შემდეგ დააწკაპუნეთ Approve-ზე, რათა Thrixel-ის ანგარიში დააკავშიროთ.

uvx thrixel-mcp@latest login

Build World-ის დაყენება

ქვემოთ აირჩიეთ თქვენი პროგრამირების აგენტი. Build World-ს სჭირდება როგორც უნარი, რომელიც ინსტრუქციებს შეიცავს, ისე Thrixel-ის MCP სერვერი, რომელიც 3D რესურსების გენერირების ინსტრუმენტებს აწვდის.

claude plugin marketplace add thrixel/build-world
claude plugin install thrixel@thrixel

codex plugin marketplace add thrixel/build-world
codex plugin add thrixel@thrixel

{
  "mcpServers": {
    "thrixel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["thrixel-mcp@latest"]
    }
  }
}

git clone https://github.com/thrixel/build-world ~/.thrixel/build-world
mkdir -p ~/.cursor/skills
ln -s ~/.thrixel/build-world/skills/build-world ~/.cursor/skills/build-world

git clone https://github.com/thrixel/build-world "$HOME\.thrixel\build-world"
New-Item -ItemType Directory -Force "$HOME\.cursor\skills" | Out-Null
New-Item -ItemType Junction -Path "$HOME\.cursor\skills\build-world" -Target "$HOME\.thrixel\build-world\skills\build-world"

gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
gemini skills install https://github.com/thrixel/build-world --path skills/build-world

Build World-ის დაყენების სახელმძღვანელო ასევე აღწერს ხელით დაყენებას, განახლებებსა და უკვე არსებულ ინსტალაციებთან მუშაობას.

3. მოამზადეთ Roblox Studio

ჩართეთ Studio-ს MCP სერვერი, რათა აგენტმა შეძლოს Studio-ში კოდის გაშვება და თამაშის ეკრანის სურათების გადაღება.

1. გახსენით Roblox Studio და შექმენით ახალი Baseplate. ამით იქმნება ადგილი (place), Roblox-ის ფაილი, რომელიც თამაშის სამყაროს შეიცავს.
2. ფანჯრის ზედა მარჯვენა კუთხეში დააწკაპუნეთ Assistant ხატულაზე.
3. Assistant პანელში გახსენით … > Settings > Manage MCP Servers. ჩართეთ Enable Studio as MCP server. მწვანე ინდიკატორი ადასტურებს, რომ სერვერი მუშაობს.

4. შექმენით Roblox-ის API გასაღები

Rojo 3D მოდელების ფაილებს არ ასინქრონებს. მათ ცალკე ასატვირთად აგენტი Roblox-ის API გასაღებს იყენებს.

1. გადადით Creator Hub-ში თქვენი ავტორიზაციის მონაცემების გვერდზე და დააწკაპუნეთ Create API Key-ზე.
2. Access Permissions-ში დაამატეთ Assets API სისტემა. მფლობელად აირჩიეთ თქვენი ანგარიში და ჩართეთ Read და Write.
3. Accepted IP Addresses-ში დაამატეთ 0.0.0.0/0 ან გამორთეთ IP შეზღუდვები. თუ ეს ველი ცარიელი დარჩება, ატვირთვები ვერ დასრულდება.
4. რადგან ეს გასაღები ნებისმიერი IP მისამართიდან წვდომას უშვებს, მიუთითეთ მოქმედების მოკლე ვადა, მაგალითად 30 დღე.
5. დააწკაპუნეთ Save-ზე და დააკოპირეთ გასაღები. ის მხოლოდ ერთხელ გამოჩნდება.
6. გასაღები შეინახეთ თამაშის საქაღალდეში, ფაილში სახელად roblox_api_key.txt. ეს ფაილი Git-ში არ დაამატოთ.

5. გაუშვით სერვერი

სერვერის გაშვება VS Code-იდან

1. VS Code-ში გახსენით ბრძანებების პალიტრა Ctrl + Shift + P-ით (Mac-ზე Cmd + Shift + P). აკრიფეთ „Rojo“ და აირჩიეთ Rojo: Open Menu.
2. თუ საქაღალდეში Rojo პროექტი ჯერ არ არის, დააწკაპუნეთ Create one now-ზე. Rojo დაამატებს default.project.json ფაილსა და თამაშის საწყის საქაღალდეებს.
3. Projects in this workspace-ში დააწკაპუნეთ პროექტის სახელზე, გაშვების ხატულასთან.

VS Code-ის ქვედა მარჯვენა კუთხეში გამოჩენილი შეტყობინება ადასტურებს, რომ სერვერი უსმენს localhost მისამართის 34872 პორტს. გასაჩერებლად გახსენით Rojo მენიუ და კვლავ დააწკაპუნეთ პროექტზე. სერვერის მუშაობისას გაშვების ხატულა გაჩერების ხატულით იცვლება.

Roblox Studio-ს სერვერთან დაკავშირება

1. Roblox Studio-ში დაუბრუნდით Baseplate ადგილს.
2. გახსენით Plugins ჩანართი და დააწკაპუნეთ Rojo-ზე.
3. მისამართად დატოვეთ localhost, ხოლო პორტად 34872, თუ სერვერს სხვა პორტი არ მიუთითებია.
4. დააწკაპუნეთ Connect-ზე.
5. განყოფილებაში „Sync changes for project“ გადახედეთ ცვლილებებს, რომლებსაც Rojo ადგილზე შეიტანს, და დააწკაპუნეთ Accept-ზე.

Rojo ფანჯარაში ახლა ჩანს პროექტის სახელი, სერვერის მისამართი და Disconnect ღილაკი. Studio დაკავშირებულია და მზად არის ცვლილებების მისაღებად.

თუ Studio ვერ უკავშირდება სერვერს, ბრაუზერში გახსენით http://localhost:34872/. Rojo-ს სტატუსის გვერდის გამოჩენა ადასტურებს, რომ სერვერი მუშაობს.

6. შექმენით თამაში

Thrixel Cubes

Thrixel 3D რესურსების გენერირებისთვის Cubes-ს ჩამოგაჭრით. საერთო ღირებულება დამოკიდებულია გამოყენებულ ოპერაციებსა და თამაშში რესურსების რაოდენობაზე. ზოგ ოპერაციას ფიქსირებული ღირებულება აქვს, სხვები კი გამოყენების მიხედვით ფასდება და საფასური შესრულების შემდეგ ჩამოიჭრება. სრული თამაშის შექმნამ შესაძლოა პროგრამირების აგენტის ტარიფის ლიმიტების დიდი ნაწილიც დახარჯოს. დიდი პროექტის დაწყებამდე შეამოწმეთ ბალანსი, ხოლო მოქმედი ფასები ნახეთ Thrixel-ის ვებსაიტზე.

Build World-ის გაშვება

1. პროგრამირების აგენტი გახსენით იმ საქაღალდეში, რომელიც Rojo პროექტს შეიცავს.
2. შეტყობინება დაიწყეთ თქვენი აგენტის შესაბამისი Build World ბრძანებით:

   აგენტი	ბრძანება
   Claude Code	/thrixel:build-world
   Codex	$build-world
   Cursor	/build-world
   Gemini CLI	/build-world

3. ბრძანების შემდეგ აღწერეთ თამაში. მიუთითეთ „Roblox“, რათა უნარმა შესაბამისი ძრავა გამოიყენოს.
4. აღნიშნეთ, რომ Rojo უკვე მუშაობს, და მიუთითეთ მისი პორტი, რათა აგენტმა მეორე სერვერი არ გაუშვას.

Codex-ში აკრიფეთ $build და თამაშის აღწერის დამატებამდე უნარების ჩამონათვალიდან აირჩიეთ build-world.

/thrixel:build-world შექმენი Roblox-ში დაბრკოლებების გადალახვის თამაში, რომელიც ჰაერში მცურავ კუნძულებზე ვითარდება. Rojo და მისი Studio პლაგინი უკვე გამართულია, ხოლო Rojo ამ საქაღალდეს 34872 პორტზე ემსახურება, ამიტომ სხვა სერვერი არ გაუშვა.

ცვლილებების მიღება Roblox Studio-ში

დადასტურება საჭიროა Rojo-სთან თავდაპირველი დაკავშირებისას. დაკავშირების შემდეგ Rojo ცვლილებებს ასინქრონებს მაშინვე, როგორც კი აგენტი მათ დისკზე შეინახავს.

• დაკავშირებისას: Rojo აჩვენებს განსხვავებებს ფაილებსა და ადგილს შორის. მათ გამოსაყენებლად დააწკაპუნეთ Accept-ზე, ხოლო დაკავშირების გასაუქმებლად Abort-ზე. თუ განსხვავებები არ არის, ის დასტურის გარეშე უკავშირდება.
• აგენტის მუშაობისას: ახალი და შეცვლილი სკრიპტები Studio-ში ავტომატურად ჩნდება. თუ Studio დაიხურა ან კავშირი გაწყდა, აგენტის თხოვნისას კვლავ დააწკაპუნეთ Connect-ზე. აგენტი Rojo-სთან კავშირს თავად ვერ აღადგენს.
• ცვლილებების შესამოწმებლად: Rojo ფანჯარაში დააწკაპუნეთ ბოლო ცვლილების დროზე, რათა გახსნათ View changes. აქ ჩამოთვლილია გამოყენებული ცვლილებები და აღნიშნულია ისინი, რომელთა შესრულებაც ვერ მოხერხდა. Rojo-ს ცვლილებები Studio-ს გაუქმების ისტორიაშიც ჩანს.

სინქრონიზაციამდე ცვლილებების ჯგუფის გადასახედად Rojo ფანჯარაში გახსენით Settings და Confirmation Behavior დააყენეთ მნიშვნელობაზე Always. დააწკაპუნეთ Disconnect-ზე, დაელოდეთ აგენტის მუშაობის დასრულებას, შემდეგ კი დააწკაპუნეთ Connect-ზე, რათა ცვლილებებს ერთად გადახედოთ. ეს შემოწმება დაკავშირებისას ხდება. აქტიური კავშირის დროს შენახული ცვლილებები კვლავ ავტომატურად სინქრონდება.

ორი მოქმედება ხელით უნდა შესრულდეს:

• შეინახეთ შემოტანილი მოდელები. Rojo სკრიპტებსა და ინსტანციებს ასინქრონებს. აგენტი 3D მოდელებს ცალკე ტვირთავს და ReplicatedStorage.Assets-ში ამატებს, ამიტომ ეს მოდელები პროექტის ფაილებში არ ინახება. მათ შესანარჩუნებლად Studio-ში გამოიყენეთ File > Save.
• სინქრონიზებული სკრიპტები პროექტის ფაილებში შეცვალეთ. Rojo-ს ორმხრივი სინქრონიზაცია ნაგულისხმევად გამორთულია. Studio-ში ამ სკრიპტებში შეტანილი ცვლილებები ფაილებში არ გადადის და შესაძლოა გადაიწეროს.

7. გამოაქვეყნეთ თამაში

როცა თამაში გასაზიარებლად მზად იქნება, Studio-ში გამოიყენეთ File > Publish to Roblox.