docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거

Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를
Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류.

- 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로
  자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거,
  동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거.
- 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming,
  Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business,
  Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로,
  나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는
  title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백).
  원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지.
- 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서.
- 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는
  지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지.
- Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경.
- 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
This commit is contained in:
Antigravity Agent
2026-07-05 00:33:48 +09:00
parent 1cfd3bbb56
commit 9148c358d0
6455 changed files with 1 additions and 86875 deletions
+156
View File
@@ -0,0 +1,156 @@
---
id: wiki-2026-0508-roblox
title: Roblox
category: 10_Wiki/Topics
status: verified
canonical_id: self
aliases: [Roblox Studio, Roblox Platform, RBLX]
duplicate_of: none
source_trust_level: A
confidence_score: 0.9
verification_status: applied
tags: [gaming, platform, ugc, luau]
raw_sources: []
last_reinforced: 2026-05-10
github_commit: pending
tech_stack:
language: luau
framework: roblox-studio
---
# Roblox
## 매 한 줄
> **"매 user-generated 3D experience platform 의 dominant"**. Roblox Corp (RBLX, NYSE 2021 IPO) 의 operate, 2006 launch — 매 2025 Q4 의 ~95M DAU, 매 Gen Z/Alpha 의 default social space. 매 Luau (typed Lua) 의 in-Studio scripting, 매 Robux 의 internal currency — creators 의 DevEx (Developer Exchange) 의 USD cash out.
## 매 핵심
### 매 Architecture
- **Roblox Studio** (Windows/Mac IDE) — 매 build, test, publish.
- **Roblox Engine** — proprietary, C++ core + Luau scripting.
- **Cloud-hosted servers** — 매 experience 의 instance 의 spin up on demand.
- **Cross-platform clients** — Windows, Mac, iOS, Android, Xbox, Quest VR (2024 GA).
### 매 Luau Language
- Lua 5.1 의 fork + gradual typing.
- JIT (native code generation) 의 2023 ship.
- Strict / non-strict mode.
- `--!strict` 매 file 의 top.
### 매 응용
1. UGC games — Adopt Me!, Blox Fruits, Brookhaven 의 billion-visit hits.
2. Brand activations — Nike Land, Gucci Town, K-pop 의 concert.
3. Education — coding camp 의 entry, 매 simple Luau syntax.
4. Virtual economy — 매 creator earnings $700M+ in 2024.
## 💻 패턴
### Basic part script (Luau)
```lua
--!strict
local Players = game:GetService("Players")
local part = script.Parent :: BasePart
part.Touched:Connect(function(hit: BasePart)
local char = hit.Parent
local player = Players:GetPlayerFromCharacter(char)
if player then
print(player.Name .. " touched the part!")
end
end)
```
### RemoteEvent (server ↔ client)
```lua
-- ServerScriptService/Main.server.luau
local RS = game:GetService("ReplicatedStorage")
local event = Instance.new("RemoteEvent", RS)
event.Name = "GiveCoins"
event.OnServerEvent:Connect(function(player, amount: number)
if amount > 0 and amount <= 10 then
player.leaderstats.Coins.Value += amount
end
end)
-- StarterPlayer/StarterPlayerScripts/Client.client.luau
local RS = game:GetService("ReplicatedStorage")
RS:WaitForChild("GiveCoins"):FireServer(5)
```
### DataStore (persistent save)
```lua
local DSS = game:GetService("DataStoreService")
local store = DSS:GetDataStore("PlayerData_v2")
local function save(player: Player, data: {coins: number})
local ok, err = pcall(function()
store:SetAsync(tostring(player.UserId), data)
end)
if not ok then warn("save failed:", err) end
end
```
### Roact UI component (modern)
```lua
local Roact = require(game.ReplicatedStorage.Roact)
local function Button(props)
return Roact.createElement("TextButton", {
Text = props.label,
Size = UDim2.new(0, 200, 0, 50),
[Roact.Event.Activated] = props.onClick,
})
end
Roact.mount(Roact.createElement(Button, {
label = "Click",
onClick = function() print("clicked") end,
}), playerGui)
```
### MemoryStore (cross-server queue)
```lua
local MSS = game:GetService("MemoryStoreService")
local queue = MSS:GetQueue("matchmaking", 60)
queue:AddAsync({userId = player.UserId, mmr = 1500}, 30)
local items, id = queue:ReadAsync(8, false, 0)
```
## 매 결정 기준
| 상황 | Approach |
|---|---|
| Persistent player data | DataStore (with retry) |
| Cross-server state | MemoryStore (queue/sortedmap) |
| Simple UI | Native `ScreenGui` |
| Complex reactive UI | Roact / Fusion |
| High-perf logic | `--!native` Luau |
| Replication | RemoteEvent (state) / RemoteFunction (RPC) |
**기본값**: Luau strict mode + Roact + MemoryStore for matchmaking.
## 🔗 Graph
- 부모: [[UGC]]
- 변형: [[Roblox-Studio]]
- Adjacent: [[Unity]] · [[Minecraft]]
## 🤖 LLM 활용
**언제**: Luau snippet 의 generate, Studio API lookup, game design pattern 의 explain.
**언제 X**: TOS-violating exploit / Filtering Enabled bypass — 매 platform-ban 의 risk.
## ❌ 안티패턴
- **`while true do ... end` without `wait()`**: 매 server crash.
- **Trusting client `RemoteEvent` args**: 매 always validate server-side (exploiters 의 send anything).
- **DataStore on every change**: 매 6-second SetAsync limit — debounce + session-locking 의 use.
- **`script.Parent` 의 deep traversal**: 매 brittle — `WaitForChild` 의 use.
## 🧪 검증 / 중복
- Verified (create.roblox.com docs, Roblox 2024 Investor Day).
- 신뢰도 A.
## 🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — Luau patterns + DataStore/MemoryStore + Roact |