vchelaru/FlatRedBall2

최근 기록된 소스 활동: 2026년 10월 19일 15:04

SkillsMP 카탈로그 업데이트: 2026년 11월 2일 18:02

수집된 skills: 47

GitHub 스타: 15
GitHub 포크: 8

AI 어시스턴트로 설치

이 프롬프트를 복사해 사용 중인 AI 어시스턴트에 입력하세요.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/vchelaru/FlatRedBall2.

저장소 README

README 원본 파일: README.md

README 원본 보기

README 전체 펼치기

# FlatRedBall2 [![NuGet](https://img.shields.io/nuget/vpre/FlatRedBall2.Kni?label=NuGet)](https://www.nuget.org/packages/FlatRedBall2.Kni) [![NuGet](https://img.shields.io/nuget/vpre/FlatRedBall.AnimationChain.MonoGame?label=AnimationEditor%20MonoGame)](https://www.nuget.org/packages/FlatRedBall.AnimationChain.MonoGame) [![NuGet](https://img.shields.io/nuget/vpre/FlatRedBall.AnimationChain.KNI?label=AnimationEditor%20KNI)](https://www.nuget.org/packages/FlatRedBall.AnimationChain.KNI) [![Join the chat](https://img.shields.io/discord/586997072373481494)](https://discord.gg/tG5RBgw) > **Early Preview** — This engine is in active development. APIs will change between releases. FlatRedBall2 is the next generation of [FlatRedBall](https://github.com/vchelaru/FlatRedBall) — a 2D game engine with 20+ years of iteration behind it, rebuilt from the ground up on modern .NET. It is built on [KNI](https://github.com/kniEngine/kni), an XNA-compatible framework that runs on desktop and in the browser (via Blazor WASM) from a single codebase. ## Samples Each sample is a complete runnable game built on the engine — open the source to see real usage patterns. | Sample | Description | Play | |--------|-------------|------| | [ShmupSpace](samples/ShmupSpace/) | Shoot-em-up | [▶ Play in browser](https://vchelaru.github.io/FlatRedBall2/ShmupSpace/) | | [PlatformKing](samples/PlatformKing/) | Platformer | [▶ Play in browser](https://vchelaru.github.io/FlatRedBall2/PlatformKing/) | | [Solitaire](samples/Solitaire/) | Klondike solitaire | [▶ Play in browser](https://vchelaru.github.io/FlatRedBall2/Solitaire/) | ## Tools **AnimationEditor** — author and preview sprite animation chains (`.achx`). Self-contained downloads (no .NET install required): | Platform | Download | |---|---| | Windows (x64) | [AnimationEditor-win-x64.zip](https://github.com/vchelaru/FlatRedBall2/releases/latest/download/AnimationEditor-win-x64.zip) | | macOS (Apple Silicon) | [AnimationEditor-osx-arm64.zip](https://github.com/vchelaru/FlatRedBall2/releases/latest/download/AnimationEditor-osx-arm64.zip) | | macOS (Intel) | [AnimationEditor-osx-x64.zip](https://github.com/vchelaru/FlatRedBall2/releases/latest/download/AnimationEditor-osx-x64.zip) | | Linux (x64) | [AnimationEditor-linux-x64.tar.gz](https://github.com/vchelaru/FlatRedBall2/releases/latest/download/AnimationEditor-linux-x64.tar.gz) | The downloads above always resolve to the latest published release; older release downloads are on the [Releases page](https://github.com/vchelaru/FlatRedBall2/releases). Binaries are unsigned, so Windows SmartScreen and macOS Gatekeeper warn on first run. See the [install guide](docs/animationeditor/install.md) for the steps for each platform. ## Features - **Screens & Entities** — structured game object model with lifecycle hooks (`CustomInitialize`, `CustomActivity`, `CustomDestroy`) - **Collision relationships** — declarative move/bounce collision between entity groups; one call to wire up an entire system - **Shapes & physics** — built-in `AARect`, `Circle`, and `Polygon` with kinematic physics - **Platformer & top-down movement** — first-class built-in behaviors; no custom physics code required - **Gum UI integration** — full [MonoGame Gum](https://github.com/vchelaru/Gum) support for menus, HUDs, and in-game UI - **Input system** — keyboard, gamepad, and input interfaces for action binding - **Camera** — configurable 2D camera with world/screen coordinate transforms - **Async support** — async/await compatible throughout the game loop - **Hot reload** — all content files reload at runtime without restarting - **Extensive XML documentation** — every public API documented; IntelliSense covers everything - **AI assistant support** — ships with skill files in `/frb-skills/` for any AI coding tool ## Quick Start Requires the **.NET 10 SDK** ([install guide](https://docs.flatredball.com/flatredball2/setup#prerequisites)). ``` dotnet new install FlatRedBall2.Templates dotnet new frb2-desktop -n YourGameName cd YourGameName/YourGameName.Desktop dotnet run ``` A window opens showing "Hello from FlatRedBall 2" — if you see that, everything works. `dotnet new` uses whichever template version is installed locally and never updates it on its own. Re-run `dotnet new install FlatRedBall2.Templates` before each new project to pick up the latest version. See the **[full setup guide](https://docs.flatredball.com/flatredball2/setup)** for prerequisites, multi-platform (desktop + web) projects, manually wiring FlatRedBall2 into an existing project, and troubleshooting. ## Working with AI Assistants FlatRedBall2 ships with skill files in [`/frb-skills/`](frb-skills/) — plain Markdown guides covering common engine tasks (entities, collision, physics, animation, audio, and more). Copy them into your game repo so your AI coding assistant has engine context without you pasting anything manually. Add the skill files to your project. Run these from your project's root folder (e.g. `YourGameName/`): ``` dotnet new install FlatRedBall2.Templates # also updates an older install dotnet new frb2-skills ``` This creates a `frb-skills/` folder in the current directory. Most AI tools can be pointed at that folder or configured to load files from it automatically. **Claude Code** — copy the skills into `.claude/skills/` so they are picked up automatically. Run from the same project root: ``` # macOS / Linux mkdir -p .claude/skills && cp -r frb-skills/. .claude/skills/ # Windows (PowerShell or cmd) xcopy /E /I frb-skills .claude\skills ``` You can keep `frb-skills/` as the source of truth and gitignore `.claude/skills/`, or drop `frb-skills/` and commit `.claude/skills/` directly — either works. **Other AI tools** — paste the relevant file from `frb-skills/` into your context window before starting a task. Each file is self-contained. ## FlatRedBall vs FlatRedBall2 FlatRedBall (FRB1) has been in active use since the early 2000s. FlatRedBall2 is a clean-slate rewrite that keeps the things that worked — the screen/entity model, collision relationships, shape-based physics — while fixing the things that didn't. The biggest workflow change: FRB1 centered on Glue, a Windows-only visual editor that generated code and managed assets. FRB2 drops the editor entirely — everything is code. The API has been unified from scratch rather than grown organically, which eliminates a lot of the inconsistencies that accumulated in FRB1 over two decades. Third-party libraries (Gum, Tiled) use their standard MonoGame versions rather than FRB1's modified forks, so ecosystem updates flow in automatically. FRB2 does not have a migration path from FRB1 projects. It is a fresh start with familiar concepts. ## Contributing Contributions welcome. Before submitting a PR: - Run `dotnet test tests/FlatRedBall2.Tests/` — all tests must pass - Engine behavior changes require a failing test first (see `.claude/skills/engine-tdd`) - Code style rules are in `.claude/code-style.md` ## License [MIT](LICENSE)

저장소 README를 불러오는 중…

이 저장소의 skills

소프트웨어 개발자

직업 카테고리 1개 · 21% 분류됨

skill

직업 분류

설명

업데이트

performance

미분류

FlatRedBallService.Performance — opt-in rolling FPS/timing/collision stats; StartupProfiler for one-time boot/load timing. Triggers: PerformanceMonitor, GenerateReport, FPS, frame time, DeepCollisionCount, StartupProfiler, ProfileStartup, "why is my game…

원문 언어: 영어

2026-10-19

multiplatform-conversion

미분류

Adding a KNI BlazorGL (Blazor WebAssembly / browser) head to a FlatRedBall2 desktop project. Use when the user mentions web deployment, browser/WASM/itch.io targets, KNI, or asks to add web support to an existing game, or hits a browser-only failure…

원문 언어: 영어

2026-10-19

content-hot-reload

미분류

Content hot-reload in FlatRedBall2. Use when watching content files (JSON configs, PNGs, TMX maps, etc.) for changes during development and reloading them without killing the game. Covers Screen.WatchContentDirectory, source/output mapping, debouncing, and…

원문 언어: 영어

2026-10-19

gum-integration

미분류

Gum Integration in FlatRedBall2. Use when working with UI, HUD, menus, buttons, labels, text display, StackPanel, Panel, layout, Gum Forms controls, Add, AddOverlay, screen-space vs world-space UI, blurry or low-res text, FontSize, text opacity/alpha, or any…

원문 언어: 영어

2026-10-19

shapes

미분류

Working with Shapes in FlatRedBall2. Use when working with AARect, Circle, Polygon, TileShapes, shape creation, visibility, color, IsFilled, OutlineThickness, or visual properties of shapes. Also covers SolidSides for one-way platforms and tile grids. Trigger…

원문 언어: 영어

2026-10-19

orchestrator

미분류

Minigame orchestrator for FlatRedBall2. Designs a small retro game (user-provided or random), delegates implementation to a fresh sub-agent, builds it, and reports friction. Use when the user says 'make a random game', 'use the orchestrator', or similar.

원문 언어: 영어

2026-10-18

sample-project-setup

미분류

Sample Project Setup for FlatRedBall2. Use when creating a new sample project, setting up a .csproj or .slnx, or wiring the KNI content pipeline. Covers the checklist for new sample projects.

원문 언어: 영어

2026-10-18

audio

미분류

Audio in FlatRedBall2. Use when working with sound effects, background music, AudioManager, loading Song or SoundEffect, volume control, or collision sound triggers.

원문 언어: 영어

2026-10-18

content-and-assets

미분류

Content and Assets in FlatRedBall2. Use when working with loading textures, fonts, sprites, content pipeline, .mgcb setup, or ContentLoader. Also trigger when the user asks about displaying text (use Gum Labels) or graphics without custom art (use Shapes).

원문 언어: 영어

2026-10-18

engine-overview

미분류

Engine overview for FlatRedBall2. Start here for any game development task. Covers what the engine does automatically vs what game code must implement, the frame loop, bootstrapping, and known stubs. Trigger when starting a new game, needing to understand the…

원문 언어: 영어

2026-10-18

automation-mode

미분류

Automation mode in FlatRedBall2. Use when an external agent (AI or script) needs to drive a running game: stepping frames, injecting input, querying entity state, or forcing entity values over stdin/stdout. Covers EnableAutomationMode, the NDJSON command…

원문 언어: 영어

2026-10-17

gumcli

미분류

Gum CLI tool for FlatRedBall2. Trigger at game/sample START — before any code is written — to ask the user whether the project will use Gum and which mode (code-only, project+dynamic, or project+codegen). Covers locating gumcli.exe, running gumcli new,…

원문 언어: 영어

2026-10-17

tmx

미분류

TMX map file creation and editing for FlatRedBall2. Use when creating or modifying Tiled .tmx level files, placing collision tiles, resizing maps, or adding layers. Covers the base template, StandardTileset tile IDs, layer conventions, and CSV tile data…

원문 언어: 영어

2026-10-17

camera

미분류

Camera in FlatRedBall2. Use when working with camera setup, background color, world bounds, window resolution, scrolling, screen shake, coordinate conversion between world and screen space, AspectPolicy / ResizeMode / DominantAxis, or…

원문 언어: 영어

2026-10-17

entities-and-factories

미분류

Entities and Factories in FlatRedBall2. Use when working with Entity subclasses, generic Factory types, spawning/creating/destroying entities, entity lifecycle, Add, shape children, Gum visuals attached to an entity, CustomInitialize/CustomActivity, or…

원문 언어: 영어

2026-10-17

animation-editor

미분류

FlatRedBall2 AnimationEditor (Avalonia) — where the source lives, project layout, and the two-panel model. Triggers: AnimationEditor, AnimationEditorAvalonia, .achx editing, wireframe/preview panels, animationeditor label.

원문 언어: 영어

2026-10-15

animation

미분류

Sprite animation in FlatRedBall2. Use for AnimationChain, AnimationChainList, AnimationPlayer, AchxLoader, .achx/.achj files, Aseprite/.ase loading, Sprite.PlayAnimation, frame-based texture flipping, looping/non-looping animations,…

원문 언어: 영어

2026-10-15

persistence

미분류

Saving and loading game data with Engine.Storage, same code on desktop and web. Triggers: save game, high score, settings file, StorageName, IStorageBackend, localStorage, IsPersistent.

원문 언어: 영어

2026-10-15

tile-grid

미분류

Programmatic tile grid in FlatRedBall2. Use when building a code-driven grid at runtime (city builders, dungeon generators, puzzle games, cellular automata) — NOT loading a TMX map from Tiled. Covers the data/visual split, world↔tile coordinate conversion,…

원문 언어: 영어

2026-10-15

glue-project-loading

미분류

Run an FRB1/Glue project's .gluj/.glsj/.glej data directly in FRB2, with no Glue codegen. Triggers: GlueProject, GlueScreen, GlueEntity, EngineInitSettings.GlueProjectFile, GlueTypeMap, .gluj, CustomVariables by name.

원문 언어: 영어

2026-10-14

levels

미분류

Level Data in FlatRedBall2. Use when working with level layouts, level progression, loading TMX maps, generating collision from tile layers, or transitioning between levels. Covers TMX-based level setup, TileShapes generation, and level advancement patterns.

원문 언어: 영어

2026-10-13

collision-relationships

미분류

Collision Relationships in FlatRedBall2. Use when working with AddCollisionRelationship, MoveFirstOnCollision, BounceOnCollision, MoveBothOnCollision, CollisionOccurred / CollisionStarted / CollisionEnded events, collision response, collision setup,…

원문 언어: 영어

2026-10-13

input-system

미분류

Input System in FlatRedBall2. Use when working with keyboard, mouse, cursor, gamepad, touch input, key bindings, or input handling. Covers IKeyboard, ICursor, IGamepad, KeyboardInput2D, KeyboardPressableInput, GamepadInput2D, GamepadDPadInput2D,…

원문 언어: 영어

2026-10-13

engine-tdd

미분류

Test-first discipline for FlatRedBall2 engine changes. Triggers whenever editing any file under src/ for a behavior change (bug fix or feature). Not for XML docs, renames, style-only edits, or sample code.

원문 언어: 영어

2026-10-13

animation-editor-screenshots

미분류

Headless screenshots of the AnimationEditor UI, for doc pages and for the before/after shots every visual change must show in chat. Triggers: "take a screenshot", before/after, visual change, DocScreenshots, ScreenshotCapture, DocScreenshotManifest.

원문 언어: 영어

2026-10-09

agentic-eval

미분류

Patterns and techniques for evaluating and improving AI agent outputs. Use this skill when: - Implementing self-critique and reflection loops - Building evaluator-optimizer pipelines for quality-critical generation - Creating test-driven code refinement…

원문 언어: 영어

2026-10-08

animation-editor-rendering

미분류

SkiaSharp rendering & performance in the AnimationEditor — GPU vs CPU draw paths, SKImage/SKBitmap gotchas, diagnosing slow frames. Triggers: ICustomDrawOperation, DrawFrameCore, WireframeControl.DrawOp, GrContext, SKImage, F3 diagnostics overlay,…

원문 언어: 영어

2026-10-08

animation-editor-testing

미분류

AE tests — Core first, [AvaloniaFact] only for real UI, Windows Sandbox for installer/OS integration. Triggers: AnimationEditor.App.Tests, Core.Tests, TestServices, CreateMainWindow, Sandbox.Tests, Velopack install, registry.

원문 언어: 영어

2026-10-08

animation-editor-tiled

미분류

AnimationEditor Tiled .tsx support — opening a tileset as a native project. Triggers: .tsx, TsxWriter, NativeTsxAnimationSync, IsNativeTsxProject, ParentId, multi-tile animation.

원문 언어: 영어

2026-10-08

docs-writing

미분류

Writing FlatRedBall2 user docs in this repo's own docs/ folder (GitBook-synced). Triggers: new FlatRedBall2 tutorial/how-to pages, docs/SUMMARY.md, docs/.gitbook/assets.

원문 언어: 영어

2026-10-08

skill-change-logging

미분류

Log every FlatRedBall2 skill modification to .claude/skill_change_log.jsonl with exact added/removed line counts, motivating sample project, and concise reason. Use whenever creating, editing, deleting, or restructuring any skill.

원문 언어: 영어

2026-10-08

skills-writer

미분류

Creates and updates skill files (.claude/skills/*/SKILL.md). Triggers: creating/updating a skill, documenting a subsystem for agent context.

원문 언어: 영어

2026-10-08

desktop-distribution

미분류

Shipping a desktop FRB2 build — self-contained per-RID publish and the macOS .app layout. Triggers: PublishProfile, SelfContained, RuntimeIdentifier, osx-arm64, Contents/MacOS, Contents/Resources.

원문 언어: 영어

2026-10-08

path-and-pathfollower

미분류

Use when working with Path, PathFollower, patrol routes, scripted movement, arc geometry, or trajectory rendering in FlatRedBall2.

원문 언어: 영어

2026-10-08

shadowdusk

미분류

Cross-platform HLSL shader compiler for MonoGame/KNI/FNA — avoids the Windows/Wine requirement. Triggers: ShadowDusk, mgfxc replacement, compiling .fx on macOS/Linux, ShadowDusk.Compiler, ShadowDuskCLI.

원문 언어: 영어

2026-10-08

gum-packaging

미분류

Bundle a Gum project into a single .gumpkg file (tar+brotli) for distribution. Trigger when shipping a built game, optimizing initial load on web/BlazorGL, or when the user mentions 'gum pack', '.gumpkg', or wants fewer loose Content files. Covers gumcli…

원문 언어: 영어

2026-10-07

hex-grid

미분류

Axial hex grids and sparse hex collision in FlatRedBall2. Triggers: HexGrid, HexCoordinate, HexOrientation, HexShapes, pointy-top or flat-top cells.

원문 언어: 영어

2026-09-24

shaders

소프트웨어 개발자

Custom shaders in FlatRedBall2. Use when adding .fx shader files or troubleshooting shader compilation errors (libmojoshader, Wine).

원문 언어: 영어

2026-08-23

platformer-movement

소프트웨어 개발자

Platformer Movement in FlatRedBall2. Use when implementing platformer mechanics including jumping, ground detection, PlatformerBehavior, PlatformerValues, double jump, air control, variable-height jumps, or side-scrolling movement. Trigger on any…

원문 언어: 영어

2026-08-23

screens

소프트웨어 개발자

Screens in FlatRedBall2. Use when working with screen lifecycle, screen transitions, MoveToScreen, passing data between screens, CustomInitialize/CustomActivity/CustomDestroy, starting the first screen, pause menu, or pausing/resuming a screen. Trigger on any…

원문 언어: 영어

2026-08-10

수집된 skill 47개 중 40개를 표시합니다.