skills.rest
rednblackgames
rednblackgamesOFFICIAL
Explore all skills by this author →
WebsiteGitHub

hyperlap2d-mcp

Drive the HyperLap2D 2D scene editor through its MCP server tools.

444|77|Updated Jul 17, 2020
Search Tags:#mcp#libgdx#entity management#scene automation#game level design#hyperlap2d#2d scene editor
One-click install
npx skills add https://github.com/rednblackgames/HyperLap2D --skill hyperlap2d-mcp-rednblackgames
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperlap2d-mcp
Source: https://github.com/rednblackgames/HyperLap2D
Command: npx skills add https://github.com/rednblackgames/HyperLap2D --skill hyperlap2d-mcp-rednblackgames

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building or inspecting HyperLap2D scenes by hand through the editor UI is slow and error-prone, especially when placing many entities at correct world-unit coordinates. This Skill documents the editor's MCP server so an AI client can create, modify, and verify scenes programmatically. ## Core Features & Use Cases - Entity and component authoring: Create images, sprites, spine animations, composites, labels, lights, and primitives, then edit validated component fields (physics, shaders, shapes, layout) through the same panels the UI uses. - Scene structure management: Control per-composite layers, absolute z-index ordering, scene settings (gravity, lighting, shaders), and capture whole-scene or region screenshots for visual verification. - Use Case: Ask the AI to build a tiled platformer level: it reads pixelsPerWU, previews assets, groups tiles into composites with correct local coordinates, orders groups back-to-front, places lights next to the objects they illuminate, and returns a screenshot for your review. ## Quick Start Connect your MCP client to the running HyperLap2D editor at http://127.0.0.1:8765/mcp and ask the AI to list the current scene's assets and build a small scene from them.

Frequently Asked Questions about hyperlap2d-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect an MCP client to the HyperLap2D editor?▼

Start the editor with a project and scene loaded, enable the MCP Server plugin under Settings → Plugins, then point your MCP client at http://127.0.0.1:<port>/mcp using Streamable HTTP transport. The server starts and stops live when the plugin is toggled.

How do I place entities at the right position in a HyperLap2D scene?▼

Entity coordinates are world units, not pixels, so read pixelsPerWU first via get_scene_settings or get_asset_dimensions. Compute placement from each asset's world size (pixelWidth / pixelsPerWU) rather than guessing from asset names.

Why is my entity hidden or missing after creating it in HyperLap2D?▼

Sibling composites draw in creation order, so an entire composite can be hidden behind a later one. Check zIndex values in list_entities and use set_z_index on the composite, not the child, before suspecting a wrong position.

Can I resize a primitive entity with update_transform in HyperLap2D?▼

No, width and height edits are refused on primitives because their visual size comes from polygon vertices, not DimensionsComponent. Use scaleX/scaleY to resize, or recreate the primitive with the desired width and height at creation time.

What are the limitations of the HyperLap2D MCP screenshot tool?▼

Screenshots do not render lights, which is a known limitation. Very large scenes or regions are capped to the GPU's maximum texture size per side while preserving aspect ratio.

Related Skills

Explore More Design & Creative Skills→
arnaudruffinarnaudruffin

animations

Creates and manages persistent and per-sprite animations in a multi-scene game.

Community
Advanced
NagyViktNagyVikt
2

phaser-2d-game

Implement 2D browser games with Phaser, TypeScript, and Vite.

Community
Intermediate
brunoolfbrunoolf

threejs-shaders

Write custom GLSL shaders for Three.js ShaderMaterial and extend built-in materials.

Community
Intermediate
Polyphase-LabsPolyphase-Labs
49

polyphase-controller

Automates scene authoring via REST calls to the Polyphase editor's scene, nodes, and play endpoints.

Official
Advanced