사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/ewrogers/megadev-skills --skill megadev-localization시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Megadev localization
Start with the game's existing catalogs, languages, fonts and renderer. Preserve its creative direction. Language Lab's harbor desk, portrait, colors, font, controls and wording illustrate techniques; they are not defaults for a game.
- Read Catalogs and encoding for message/language IDs,
UTF-8 authoring, normalization, substitutions, plurals and fallback.
- Read Fonts and memory for native accents, atlas/glyph
budgets and the additional Main RAM cost of resident Mega CD resources.
- Read Layout and validation for translated expansion,
paging, name/number limits, atomic language changes and evidence boundaries.
Megadev exposes VDP and BIOS facilities, not a Unicode decoder or localization framework. Inspect the selected ewrogers/megadev:latest source before using an API. Do not copy SGDK text/resource functions or assume BIOS printing performs UTF-8 decoding, shaping, glyph fallback or wrapping.
Essential contracts:
- Separate stable message keys from translated prose and game logic. Make locale
identifiers explicit; validate unknown preferences before indexing catalogs.
- Validate the required character repertoire before export. Normalize authoring
consistently, count glyphs/advances rather than UTF-8 bytes and reject missing glyphs. Never silently strip accents or turn unsupported text into random tiles.
- Substitute bounded named values into whole translated messages. Check that
locales agree on placeholders; never use translated text as a printf format. Use explicit language-appropriate plural rules, not English word fragments.
- Budget source/catalog bytes, Main RAM residency, temporary layout storage,
font patterns, tilemaps, palettes and transfers separately. Disc capacity does not make fonts free in Main RAM or VRAM.
- Validate every real text box with the longest supported names, quantities and
variants. Include choices, tooltips, name-entry keys and error messages. A renderer that clips silently is not a translated-layout validator.
- Reuse the existing renderer/input/clock owners. Keep old fonts/text alive until
their page or bank is retired; publish a language change only when its complete layout and matching glyph resources are ready. Clear stale longer text.
Language Lab is a standalone four-locale Latin example. Its offline compiler, native glyph patterns, portable model and safe page publisher work after installation without another skill. The lc_* and ui_* helpers are application code, not SDK APIs or a universal Unicode engine.
Use megadev-ui for general presentation/navigation, megadev-dialogue for conversation progression, megadev-assets for asset preparation, megadev-streaming/megadev-memory for bank lifetimes and megadev-save for versioned preferences. Localization supplies text/repertoire/layout contracts without creating rival drive, input, DMA, save or audio services.
