el4cteo/roblox-skills

roblox-world-building

Building worlds with code - parts, models and pivots, materials, Lighting (LightingStyle, Atmosphere, post-processing), day/night, Terrain API, in-game CSG and destruction (GeometryService Subtract/Union/Fragment), ProceduralModel, EditableMesh/EditableImag…

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/el4cteo/roblox-skills --skill roblox-world-building

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

World building with code

Parts and models

luau
--!strict
local function makePart(size: Vector3, cframe: CFrame, props: { [string]: any }?): Part
	local part = Instance.new("Part")
	part.Anchored = true
	part.Size = size
	part.CFrame = cframe
	part.TopSurface = Enum.SurfaceType.Smooth
	part.BottomSurface = Enum.SurfaceType.Smooth
	for key, value in props or {} do
		(part :: any)[key] = value
	end
	return part -- caller sets Parent last
end

local floor = makePart(Vector3.new(64, 1, 64), CFrame.new(0, 0, 0), {
	Material = Enum.Material.Slate,
	Color = Color3.fromRGB(90, 90, 100),
})
local model = Instance.new("Model")
model.Name = "Arena"
floor.Parent = model
model.WorldPivot = floor.CFrame
model.Parent = workspace
model:PivotTo(CFrame.new(0, 10, 0) * CFrame.Angles(0, math.rad(45), 0))
  • Set properties first, parent last (one replication/physics insert). Anchor static geometry.
  • Move/rotate models with PivotTo/GetPivot; Model.WorldPivot / PrimaryPart define the pivot.
  • Group logically related parts in Models (streaming, LOD, ModelStreamingMode), not giant containers.
  • Decorative parts: CanCollide/CanTouch/CanQuery = false, CastShadow = false for tiny details.
  • Materials: Enum.Material.*; custom looks via MaterialVariant in MaterialService (set

part.MaterialVariant = "Name") or SurfaceAppearance on MeshParts (PBR). Decal.Texture is superseded by ColorMapContent.

  • Many identical meshes are cheap (instanced); many unique meshes/unions are not.

Lighting

PropertyGuidance
Lighting.LightingStyleRealistic (naturalistic) or Soft (stylized). Replaces the superseded Lighting.Technology.
Lighting.PrioritizeLightingQualityPrefer quality (e.g. shadow maps with Soft) vs performance on lower-end devices.
ClockTime / GeographicLatitudeSun position; animate ClockTime for day/night.
Brightness, ExposureCompensation, Ambient/OutdoorAmbientOverall exposure and fill light.
EnvironmentDiffuseScale/EnvironmentSpecularScaleSkybox contribution to lighting and reflections.
ChildrenAtmosphere (haze/density, replaces fog), Sky, Clouds (in Terrain), BloomEffect, ColorCorrectionEffect, ColorGradingEffect, DepthOfFieldEffect, SunRaysEffect, BlurEffect.
luau
--!strict
-- Server: smooth day/night cycle (one full day every 20 minutes).
local Lighting = game:GetService("Lighting")
local RunService = game:GetService("RunService")

local DAY_LENGTH_SECONDS = 20 * 60

RunService.Heartbeat:Connect(function(deltaTime)
	Lighting.ClockTime = (Lighting.ClockTime + deltaTime * 24 / DAY_LENGTH_SECONDS) % 24
end)

For per-frame visual changes, prefer computing ClockTime on each client from workspace:GetServerTimeNow() (no replication traffic, perfectly smooth). Local lights: PointLight, SpotLight, SurfaceLight — few with Shadows = true.

Terrain

luau
--!strict
local terrain = workspace.Terrain

terrain:FillBlock(CFrame.new(0, -10, 0), Vector3.new(512, 20, 512), Enum.Material.Grass)
terrain:FillBall(Vector3.new(0, 0, 0), 24, Enum.Material.Air) -- carve a crater
terrain:FillBlock(CFrame.new(40, -2, 0), Vector3.new(30, 4, 30), Enum.Material.Water)
terrain:FillCylinder(CFrame.new(-40, 5, 0), 20, 8, Enum.Material.Rock)
  • Bulk generation: build a Region3 (aligned with :ExpandToGrid(4)) and use ReadVoxels/WriteVoxels

with materials/occupancy arrays (4-stud voxels), in chunks, yielding between chunks.

  • terrain:Clear(); water look via Terrain.WaterColor, WaterWaveSize, etc.
  • Custom terrain materials (fully launched): up to 62 custom materials painted onto terrain, plus smaller

files and faster loads. Opt in per place: Workspace → Expanded Terrain = Enabled, save, reopen; manage them in Window → 3D → Terrain Materials Manager. Thin terrain can show LOD gaps — keep it thick.

  • Procedural heightmaps: sample math.noise(x * scale, z * scale, seed) with octaves; use a Random.new(seed)

for deterministic worlds; generate on the server or use Parallel Luau for heavy math.

In-game solid modeling and destruction (GeometryService)

luau
--!strict
local GeometryService = game:GetService("GeometryService")

-- Punch a hole through a wall (e.g. explosions, building games).
local function carve(wall: BasePart, cutter: BasePart): { Instance }?
	local ok, results = pcall(function()
		return GeometryService:SubtractAsync(wall, { cutter }, {
			CollisionFidelity = Enum.CollisionFidelity.Default,
			RenderFidelity = Enum.RenderFidelity.Automatic,
			SplitApart = true, -- disconnected pieces become separate parts
		})
	end)
	if not ok or not results then
		return nil
	end
	for _, piece in results do
		if piece:IsA("BasePart") then
			piece.Anchored = wall.Anchored
			piece.Parent = wall.Parent
		end
	end
	wall:Destroy()
	return results
end

return carve
  • UnionAsync, IntersectAsync, SubtractAsync return new unparented parts; FragmentAsync(part, sites)

shatters a part (Voronoi) using points from GenerateFragmentSites; SweepPartAsync extrudes a part along CFrames; CalculateConstraintsToPreserve keeps welds/constraints when replacing parts.

  • Operations are expensive: run on the server, rate-limit, and pool/clean up fragments.

ProceduralModel (parameter-driven models)

ProceduralModel instances regenerate their contents from a generator ModuleScript exposing Attributes (parameters) and OnGenerate(params, targetContainer); works at edit time (undo/redo, Team Create) and runtime. Generate from Studio, Assistant, or the Studio MCP (generate_procedural_model). Creator Store procedural models are sandboxed automatically.

Asset references

Studio saves asset references as Content since Nov 11, 2026. Prefer the *Content properties in new code (Sound.AudioContent, ImageLabel.ImageContent, Trail.TextureContent); the legacy string properties (SoundId, Image, ...) still work. Rojo must be 7.7.1+ (roblox-tooling). From January 19, 2027, meshes and images can get new versions under the same ID: pin one with rbxassetid://ID&version=N.

Runtime meshes and images

AssetService:CreateEditableMesh() / CreateEditableMeshAsync(content) and CreateEditableImage enable runtime geometry and pixel editing (deformable terrain chunks, painting, custom avatars). Published games require the owner to be ID + 13+ verified and Enable Mesh / Image APIs in Creator Dashboard; strict client memory budgets apply; only assets owned by/shared with the game owner can be loaded. Display via AssetService:CreateMeshPartAsync(Content.fromObject(editableMesh)). For many vertices/faces use the EditableMesh batch APIs and parallel queries (released for live games) instead of per-element calls. Players can publish an EditableImage to their inventory from the server with AssetService:PromptCreatePlatformContentAsync(player, image, Enum.AssetType.Image) (pcall; replaces PromptCreateAssetAsync; needs a published place). EditableMesh quad faces are released for published games. AssetService:CreateSurfaceAppearanceAsync also accepts asset IDs and DataModel Content (Studio beta: "Mixed Content for CreateSurfaceAppearanceAsync").

Effects

  • ParticleEmitter (use :Emit(n) for bursts), Beam (between attachments; lasers, ropes), Trail

(swords, projectiles), Highlight (outline/fill; limited count), Explosion (sets off physics — set DestroyJointRadiusPercent = 0 and BlastPressure = 0 for visual-only).

  • Spawn cosmetic effects on clients; destroy or pool them (Debris:AddItem(obj, seconds) is fine).

Related skills

roblox-performance (rendering cost, streaming), roblox-architecture (streaming settings), roblox-studio-mcp (build in Studio through MCP), roblox-physics (constraints, destruction physics).

来自同一仓库

更多 Skills

全部 Skills
el4cteo
社区

roblox-architecture

Roblox project structure and client/server model - replication, where code and assets belong (ServerScriptService, ReplicatedStorage, StarterPlayer), RunContext, service/controller bootstrapping, player/character lifecycle, CollectionService components, attributes, streaming-safe client code, library choices. Use when starting a project, deciding where code goes, or fixing replication/streaming bugs.

1小时安装量
5
GitHub Stars
131
最近更新
11月17日
el4cteo
社区

roblox-audio

Sound and music - the Audio API (AudioPlayer, AudioEmitter, AudioListener, AudioDeviceOutput, Wire, effects, faders), classic Sound/SoundGroup, 2D vs 3D audio, music and SFX volume, client vs server playback, asset permissions, streaming caveats, voice routing, text-to-speech. Use when adding music, sound effects, spatial audio, mixing, or fixing sounds that don't play.

1小时安装量
5
GitHub Stars
131
最近更新
11月17日
el4cteo
社区

roblox-characters-animation

Characters and animation - Humanoid properties/states, spawning (LoadCharacterAsync), health and damage, HumanoidDescription appearance, Animator/AnimationTrack playback, priorities and markers, default animation replacement, Tools, TweenService, IKControl, Character Controller Library (beta). Use when changing movement, abilities, damage, respawn, avatars, animations, tweens, or tools/weapons.

1小时安装量
5
GitHub Stars
131
最近更新
11月17日
el4cteo
社区

roblox-code-review

Review Roblox/Luau code for exploits, data loss, memory leaks, performance problems, lifecycle bugs, policy issues, and deprecated or superseded APIs, using a severity-ranked checklist and the full 2026 deprecation map. Use when reviewing a PR or script, auditing a game before launch, modernizing legacy code, or asked what is wrong with some Roblox code.

1小时安装量
5
GitHub Stars
131
最近更新
11月17日