pixi-vn-assets

Registers and loads image, audio, and video assets in Pixi'VN projects via manifests and bundles.

145|9|Updated Feb 14, 2024
One-click install
npx skills add https://github.com/DRincs-Productions/pixi-vn --skill pixi-vn-assets-drincs-productions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pixi-vn-assets
Source: https://github.com/DRincs-Productions/pixi-vn/tree/main/skills/assets
Command: npx skills add https://github.com/DRincs-Productions/pixi-vn --skill pixi-vn-assets-drincs-productions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deciding where game assets should live (local files vs. remote hosting), how to register them so code can reference them safely, and when to load them without causing visible stalls is a recurring source of bugs in Pixi'VN projects. This Skill provides the exact conventions and file locations for managing assets correctly. ## Core Features & Use Cases - Local vs. online asset strategy: Explains when to keep files in src/assets (processed by PixiJS AssetPack into public/assets with an auto-generated manifest) versus hosting them on a CORS-enabled CDN, GitHub raw, or cloud storage. - Manifest and bundle registration: Shows the single edit point (src/assets/index.ts) for adding online assets, and how to name bundles after label ids, route paths, or character ids. - Loading strategy: Covers Assets.init, blocking vs. background bundle loading at startup, per-label via Game.onLoadingLabel, and per-route via router loaders. - Use Case: You need to add a background music track hosted on a CDN and a set of local character sprites. This Skill tells you to drop the sprites into src/assets, register the CDN URL as an alias in src/assets/index.ts, and background-load the audio bundle at startup. ## Quick Start Use the pixi-vn-assets skill to register my hosted background music and local character sprites in the assets manifest and set up bundle loading at startup.

Frequently Asked Questions about pixi-vn-assets

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

FAQPage Schema
How do I add online assets to a Pixi'VN project?

Add online assets by editing src/assets/index.ts, the single registration point in official templates. Append a new bundle to the manifest with an alias and the remote src URL, ensuring the host allows CORS requests so the browser does not block loading.

How does PixiJS AssetPack handle local assets in Pixi'VN?

AssetPack watches the src/assets folder, optimizes files into public/assets, and auto-generates src/assets/manifest.gen.json with bundles and aliases. It runs on every change during vite dev and once before production builds, and is pre-configured in official templates.

Should I edit manifest.gen.json directly in Pixi'VN?

No, manifest.gen.json is auto-generated by AssetPack and any manual edit is overwritten on the next run. If an alias is wrong, fix the file path or name under src/assets and let AssetPack regenerate the manifest.

When should I load asset bundles in a Pixi'VN game?

Load bundles blocking at startup only for the first screen's assets, background-load larger bundles at startup, and use Game.onLoadingLabel to background-load each label's bundle when it starts. Router loaders can await route-specific bundles with a pending component.

Why should game code reference assets by alias instead of path?

Referencing by manifest alias decouples code from file locations and hosting providers, so moving a file or switching CDNs does not break references. Loading by raw path or URL is strongly discouraged for this reason.