Setup overview¶
The Setup tab in MkDocs groups everything you need before (and beside) day-to-day Unreal work: Visual Studio + Unreal, optional coding agents for engineers, and ChatGPT project files for designers and others who prefer that stack.
It also explains how design, art, narrative, audio, and production can use assistants without rewriting Unreal internals or inventing undocumented systems.
Flow¶
- Rephrased MCP (required for all engineers): Rephrased MCP — install,
/onboard. It runs your own convention review, the team review server, wiki search, and devlog. After the 5.8 editor opens, suggested Unreal MCP for levels, assets, and PIE. - Programmers: First day (engineering) — setup + weekly workflow. Optional pages only if the current task needs them.
- VS and Unreal — Epic 5.8, VS 2026
.vsconfig. - First build/open: everyone → Building Rephrased. Programming engineers can also use Building an Unreal project for IDE debugging.
- Coding agent (optional): pick the Setup page for your IDE — Cursor, Claude Code, Codex, Antigravity. ChatGPT and Codex are the same app; use Codex for this repo, or ChatGPT Work with this Git repo attached as a project.
- Non-programming teammates can still use the Markdown bundle under ChatGPT Project files in this same tab.
Recommended stack by role¶
| Role | Typical stack | Prefer when |
|---|---|---|
| Gameplay programmers | Coding agent at repo root | Editing C++/project files |
| Tech artists / tooling-friendly designers | Light coding agent + Unreal Editor | Scripted content that touches Git |
| Core art / UX / narrative / audio | ChatGPT Project bundle | Brainstorming, tone checks, spreadsheets, critiques |
| Direction / producers | ChatGPT Project bundle | Status summaries, meeting notes scoped to milestones |
Drag-in Markdown bundle for ChatGPT¶
Use the files inside wiki/AI/ChatGPTProject/:
- Read HowToAttach.md.
- Sync
Rephrased-TeamContext.md,Communication-Defaults.md, andDiscipline-Brief.mdinto a private ChatGPT Project. - Re-upload whenever those files gain a changelog entry referencing policy shifts.
MkDocs publishes the same Markdown under Setup → ChatGPT Project files.
Discipline cheat sheet¶
- Design: Assistants help structure pillars, pacing notes, spreadsheets. Final puzzle contracts + acceptance tests live on the wiki with front matter and change history.
- Art: Moodboards & naming ok; exported hero assets ship only after discipline lead confirms technical constraints (profiles, LOD, materials).
- Narrative: Summaries/outline passes ok; spoiler-sensitive beats stay cohort-private; do not publish unreleased story text to unmanaged third-party workspaces.
- Audio: Naming + technical note drafting ok; Wwise/integration specifics follow audio lead directives.
- Production: Scheduling prose + RACI scaffolding ok; do not leak roster contact data or grades.
Detailed guardrail copy also lives in Discipline-Brief.md for model retrieval.
Safety defaults¶
- Assume USC / AGP privacy rules; default to private ChatGPT Projects and course-approved accounts.
- Never paste keys, tokens, grade data, or unreleased IP into consumer tools without director approval.
- When unsure whether a fact exists in repo, ask a human or paste the excerpt—models must not fabricate file paths.
Change history¶
- 2026-08-26 — Gabriel Li — Setup flow updated for org repo, VS-once team workflow, and one build script for everyone.
- 2026-08-14 — Gabriel Li — Programmer step is First day (engineering). Setup page renamed Rephrased MCP; Unreal MCP labeled suggested; ChatGPT+Codex are one app — use Codex, or ChatGPT Work with this repo as a project.
- 2026-08-13 — Gabriel Li — Linked Unreal MCP (5.8 editor tools) next to required team MCP; dropped named-skill wording for design docs.
- 2026-08-12 — Gabriel Li — VS/Unreal setup step points at UE 5.8 and VS 2026.
- 2026-08-10 — Gabriel Li — MCP flow step matches local uvx toolkit + onboarding register.
- 2026-05-23 — Gabriel Li — Antigravity (Gemini) in Setup flow; generic coding-agent wording; flow step numbering; engineer VS build vs designer batch script split.
- 2026-05-18 — Gabriel Li — Added Codex to Setup flow and programmer workflow options.
- 2026-05-09 — Gabriel Li — Added AI hub with ChatGPT Project bundle guidance and cross-discipline matrix.