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 件を表示しています。