vchelaru/FlatRedBall2

最近记录的来源活动: 2026年10月19日 15:04

SkillsMP 收录数据更新: 2026年11月2日 18:02

已收集 skills: 47

GitHub 星标: 15
GitHub Forks: 8

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 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

已展示 40 / 47 个已收集 Skill。