菜单
Load when working with LÖVE 2D, the LÖVE engine, love2d, .love archives, Lua 5.1/LuaJIT 2.1 game development, or LÖVE callbacks, modules, conf.lua, and packaging.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Provides an interface to the user's keyboard. Use this skill when working with keyboard operations, key events, text input, or any keyboard-related operations in LÖVE games.
Can simulate 2D rigid body physics in a realistic manner. This module is based on Box2D, and this API corresponds to the Box2D API as closely as possible. Use this skill when working with physics operations, collision detection, rigid body dynamics, or any physics-related operations in LÖVE games.
The primary responsibility for the love.graphics module is the drawing of lines, shapes, text, Images and other Drawable objects onto the screen. Its secondary responsibilities include loading external files (including Images and Fonts) into memory, creating specialized objects (such as ParticleSystems or Canvases) and managing screen geometry. LÖVE's coordinate system is rooted in the upper-left corner of the screen, which is at location (0, 0). The x axis is horizontal: larger values are further to the right. The y axis is vertical: larger values are further towards the bottom. In many cases, you draw images or shapes in terms of their upper-left corner. Many of the functions are used to manipulate the graphics coordinate system, which is essentially the way coordinates are mapped to the display. You can change the position, scale, and even rotation in this way. Use this skill when working with drawing operations, sprites, animations, shaders, or any visual rendering in LÖVE games.
Load for objective audio analysis from ffmpeg metrics - spectral statistics, spectrograms, loudness, EBU R128, LUFS, LU, RMS, dBFS, dBTP, true peak, crest factor, dynamic range, and noise floor. Covers the aspectralstats, astats, ebur128, and loudnorm filters: what each metric measures, how ffmpeg computes it, its units and range, and the external loudness standards and platform targets. Use when reading or producing ffmpeg audio measurements, even when the user names only a metric, filter, or standard.
Use when the user mentions `gh`, `gh api`, the GitHub CLI, the GitHub API, or wants to view, query, search, or change GitHub. Covers querying the GitHub API, raw API calls, PRs/pull requests, issues, workflows/Actions/CI, releases, repos, notifications, status, and any task that views or queries GitHub data.
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
| name | love |
| description | Load when working with LÖVE 2D, the LÖVE engine, love2d, .love archives, Lua 5.1/LuaJIT 2.1 game development, or LÖVE callbacks, modules, conf.lua, and packaging. |
Use expert LÖVE 2D judgement across the LÖVE 11.x API, Lua 5.1/LuaJIT 2.1 idioms, game loop callbacks, graphics, audio, physics, input, filesystem, threads, math, shaders, packaging, and performance. Target the LÖVE runtime semantics, not stock Lua: assume LuaJIT, 1-based indexing, and the LÖVE event loop unless told otherwise.
Verify callback names, module functions, enums, and constants against the current LÖVE wiki or Context7 before recommending APIs. Names move between versions (notably 0.10 → 11.x); do not rely on memory.
| Need | Source |
|---|---|
| LÖVE API surface and callbacks | Start at references/api/love/SKILL.md (vendored index describing every love.* module); it cross-links each per-module reference via ../love-*/SKILL.md. Fall back to Context7 love2d docs for version-specific changes. |
| Library APIs | Library README/source (HUMP, anim8, bump, STI, etc); Shove (https://github.com/Oval-Tutu/shove); smiti18n (https://github.com/Oval-Tutu/smiti18n) |
| Platform packaging | bootstrap-love2d-project (https://github.com/Oval-Tutu/bootstrap-love2d-project); LÖVE wiki "Game Distribution" page |
The references/api/ tree is a verbatim snapshot of the per-module LÖVE API skills from RedKenrok/skills (MIT, Ron Dekker). See references/api/UPSTREAM.md for commit and retrieval metadata, and references/api/LICENSE-upstream.md for the license text.
love.load, love.update(dt), love.draw, love.quit, love.run (override only for custom loops).love.keypressed/released, love.mousepressed/released/moved/wheelmoved, love.textinput, love.touchpressed/released/moved, love.gamepadpressed/released/axis, love.joystick*.love.resize, love.focus, love.visible, love.displayrotated, love.lowmemory, love.threaderror, love.errorhandler.dt is seconds since the last frame. Multiply all movement, timers, and physics steps by dt; never assume a fixed framerate.conf.lua configures t.window, t.modules, t.identity, t.version, t.console, and t.audio. Disable unused modules (t.modules.physics = false, etc.) to cut startup cost when packaging.main.lua and conf.lua at the root; package as a .love zip (no top-level folder) for distribution, or fuse with the LÖVE binary per platform.love.graphics.push/pop/translate/rotate/scale for transforms; reset state explicitly after custom blend modes, shaders, or canvases.love.graphics.clear only inside love.draw or canvas passes; do not call it from update.SpriteBatch, text with Text, and static geometry with Mesh to cut draw calls.setCanvas(nil) to restore the screen; respect canvas formats and MSAA capability via love.graphics.getCanvasFormats.TransformMatrix, ProjectionMatrix, love_PixelColor, VaryingTexCoord). Validate with love.graphics.newShader error returns.love.graphics.setDefaultFilter("nearest", "nearest") for pixel art; pair with integer scaling.love.audio.newSource(path, "static" | "stream"). Use "static" for short sfx (decoded once), "stream" for music.:clone() or use love.audio.play(source, true) style pooling.:setRelative(true) for HUD-attached sounds.love.audio.setVolume master and per-source :setVolume separately; expose both as user settings.love.keyboard.isDown, love.mouse.isDown, love.joystick:isGamepadDown. Use callbacks for edge events.love.keyboard.setKeyRepeat deliberately; default is off.love.textinput provides UTF-8 text; do not derive text from keypressed.gamepad* callbacks (SDL mappings) over raw joystick* axes/buttons.love.filesystem is sandboxed. Read access covers the game source (zip or directory); write access only the save directory (love.filesystem.getSaveDirectory).love.filesystem.read/write/append/lines, not stock io.*, for portability and sandbox compliance.t.identity in conf.lua or love.filesystem.setIdentity) controls the save directory name; set it before any writes.love.filesystem.load(path) returns a chunk; prefer it over loadstring/loadfile for sandboxed code.love.thread.newThread(source) runs Lua in isolation; share via love.thread.getChannel(name) with push/pop/demand/peek/supply.love.filesystem, love.image, love.sound, love.data, love.timer, love.system, love.event, love.thread. No graphics/audio/window calls.love.timer.getDelta, getFPS, getTime, and sleep cover frame timing; for fixed-step logic, accumulate dt and step in fixed slices.love.physics wraps Box2D. Set the meter with love.physics.setMeter before creating worlds; Box2D works in metres, not pixels.world:update(dt). Use callbacks via world:setCallbacks(beginContact, endContact, preSolve, postSolve)."static", "dynamic", or "kinematic". Apply forces/impulses, do not teleport dynamic bodies without body:setAwake(true).love.math.random*, love.math.newRandomGenerator, and love.math.noise are deterministic and seedable; prefer them over stock math.random for reproducibility.love.data provides pack/unpack, encode/decode (base64, hex), compress/decompress (lz4, zlib, gzip), and hash (md5, sha1, sha256, sha512).love.timer.getFPS, love.graphics.getStats (drawcalls, canvasswitches, textures, fonts, images, drawcallsbatched).newImage/newFont.local sin = math.sin).love.graphics.setCanvas to render expensive static content once, then draw the canvas each frame..love is a zip with main.lua at the root. Test with love path/to/game.love.love.exe + .love then ship the LÖVE DLLs from the same release..love into LÖVE.app/Contents/Resources/, update Info.plist (CFBundleIdentifier, CFBundleName), then re-sign.org.love2d.love.conf.lua to shrink runtime memory and startup.love.graphics.print ignores the current font's line height unless you use printf with a wrap limit.Image:setFilter("nearest", "nearest", 0) per-image overrides the default filter.love.event.quit only triggers after the current frame; do not assume immediate exit.require paths use dots, not slashes, and are rooted at the game directory.pairs/ipairs corrupts iteration; build a removal list and apply after the loop.goto, no integer division //, no bitwise operators in the language. Use bit (LuaJIT built-in: bit.band, bor, bxor, lshift, rshift, arshift, bnot).__pairs/__ipairs metamethods, no table.pack/table.unpack (use unpack), no integer subtype.\z, no \xNN in pure 5.1 (LuaJIT accepts \xNN); prefer string.char for portability.#t is only defined for sequences (no nil holes); track length explicitly for sparse arrays.local M = {} modules returning the table; avoid module(...) (deprecated).require("ffi")) is LuaJIT-only and bypasses the LÖVE sandbox; use it sparingly and never with untrusted input.goto, //, bitwise operators, _ENV, table.unpack).dt.love.filesystem save directory; never os.execute or stock io.open for game data.