Contents ≡

Wiki/Session notes

Session 4 · Picking Unity back up

  1. 1Every time you reopen
  2. 2When it won't connect
  3. 3Undoing
  4. 4Adding post-processing again
  5. 5Recording again with Recorder
  6. 6When there's an error
  7. 7Where this comes from

Picking Unity back up

In Session 4 (Sep 19), we built Unity scenes by telling Cursor what to do. These supplementary notes collect what you need to reopen that work at home. Unity MCP is what connects Cursor and Unity, and this page is based on MCP for Unity (CoplayDev).

Once you start building scenes, also read Session 4 · Start Unity MCP with Plan. It covers making a plan in Plan mode before you give instructions.

There is one thing to do every time you reopen a project: start the server in Unity, and check in Cursor that the connection is green. Everything else stays set once you've done it.

Every time you reopen

  1. Open the project you made in class from Unity Hub.
  2. Open Window → MCP for Unity from Unity's top menu.
  3. Click Start Server. After a moment, when the status shows Session Active, Unity is ready.
  4. In Cursor, go to Settings → MCP and check that unityMCP is turned on with a green dot. If it's off, turn it on.
  5. Send "tell me the objects in the current scene" in the Cursor chat. If a list comes back, you're connected.

When it won't connect

  • There's no unityMCP in Cursor at all → Click Configure All Detected Clients in the MCP for Unity window. Clicking it more than once is fine. Then quit and reopen Cursor and check again from step 4.
  • unityMCP has a red dot → Most of the time the server on the Unity side is off. Click Start Server from step 3 and refresh in Cursor.
  • Start Server does nothing → uv, which runs the server, is missing or can't be found. Type uv --version in a terminal and see if a number comes out. If not, install uv and restart Unity.
  • It's a computer you're setting up for the first time → In Unity, go to Window → Package Manager → + → Add package from git URL... and paste the address below. When the install finishes, a setup window appears. Follow it to check Python and uv, then choose Cursor and click Configure Selected.
text
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

Undoing

When you give instructions in words, things sometimes change in ways you didn't intend. So save the scene every time things look right (Ctrl+S, Cmd+S on a Mac).

  • For a single change you just made, first try Ctrl+Z in Unity.
  • If you've given several instructions and don't know where it went wrong, close the scene without saving and reopen the last saved scene.
  • Before a big change, it's reassuring to keep a copy of the scene under another name with File → Save As.
  • Scripts Cursor created can be rolled back with Restore in the Cursor chat. Layout inside the scene does not come back that way, so you need the saves above.

Adding post-processing again

Post-processing adds a layer of texture on top of the finished image, such as glow, color, or film grain. To see it, the scene needs a Volume, and the camera must be set to use it.

To ask Cursor, you can say:

Create a Global Volume in the scene and add Bloom and Vignette. Also turn on Post Processing on the Main Camera.

To do it by hand, follow this order.

  1. Right-click an empty spot in the Hierarchy → Volume → Global Volume.
  2. Select the new Global Volume and click New next to Profile in the Inspector.
  3. Choose effects from Add Override → Post-processing. Glow is Bloom, darkened edges are Vignette, color tone is Color Adjustments, and film grain is Film Grain.
  4. Tick the checkbox to the left of each setting in the effect for its value to apply. When you change a value, the image changes right away.
  5. Select Main Camera and check that Rendering → Post Processing is ticked in the Inspector.

Recording again with Recorder

Recorder saves a scene you run with ▶ as a video file. Use it to make the short videos for the instructor's Figma board too.

  1. The first time, go to Window → Package Manager, set the left side to Unity Registry, find Recorder, and click Install.
  2. Open Window → General → Recorder → Recorder Window.
  3. Choose Add Recorder → Movie. MP4 is a safe format.
  4. Click START RECORDING and the scene runs and recording starts. To stop, click the same button again or turn off ▶.
  5. The file appears in the Recordings folder inside the project folder. You can change where it's saved under Output File in the Recorder window.

When there's an error

  • Red lines in the Console window at the bottom of Unity are errors. If you can't see the Console, open Window → General → Console.
  • Tell Cursor "read the errors in the Unity console and fix them," and it reads them directly through MCP. You can also copy and paste them.
  • If the same error keeps coming after a fix, roll back with the steps above and then ask for one thing at a time.
  • You can also ask on KakaoTalk with one screenshot and one line about what you were doing when it happened. The general steps for when you're stuck are in When you get stuck.

Where this comes from

Session 4 was taught by director Seoyeon Hong. Joonhyung Bae wrote this after sitting in on the class, putting together from personal knowledge the places where people tend to get stuck when redoing it at home. Seoyeon Hong's prompts and work are not included.

There are several MCPs that connect Unity and Cursor, and any of them is fine. This page is based on MCP for Unity (CoplayDev, MIT license), which Joonhyung Bae chose, and it may differ from what was used in class. Button names and the install address follow its official documentation.

Materials for 2026 Open Circuit Busan: Art & Tech Practice · Written and planned by Joonhyung Bae